Orderwise Update Delivery Address
Updates a delivery address in an Orderwise customer's address book, and sets it as the default when the customer has no default delivery address yet.
What it does
- Updates a delivery address in an Orderwise customer's address book.
- Sets the updated address as the customer's default delivery address when
Default Address Foundisfalse. - Returns whether Orderwise updated the address, along with the Orderwise response.
This action doesn't change the address on an existing sales order. To change a sales order's address, use Orderwise Update Sales Order Delivery Address.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| Customer ID | String | Yes | Orderwise customer ID. |
| Delivery Address ID | String | Yes | ID of the delivery address in the customer's address book. |
| New Delivery Object | Object | Yes | Object with address1, address2, city, zip, country_name and country_code. address1 is required. |
| Default Address Found | Boolean | No | Whether the customer already has a default delivery address, typically from Orderwise Check Default Customer Address. When false, the updated address becomes the default. |
| Safe Mode | Boolean | No | If on, errors are returned in the outputs instead of stopping the flow. Off by default. |
Outputs
| Name | Type | Description |
|---|---|---|
| Success | Boolean | Whether Orderwise updated the address. |
| Response | Object | The response body from Orderwise. |
| Error Message | String | Error details when Safe Mode is on and the action fails. |
Notes
- The action authenticates with the Orderwise module connection only, so it has no credential inputs. Set up an Orderwise connection before you use the action. The connection's
base_urlmust be anhttpsURL. - Each run exchanges the connection's login for a bearer token, then calls Orderwise with that token. The action doesn't cache the token.
- The action maps the address fields to Orderwise as follows:
citytotown,ziptopostcode,country_nametocountryandcountry_codetocountryCode. It sends missing or empty fields as empty text. - If
New Delivery Objecthas noaddress1, the action fails and sends nothing to Orderwise. Default Address Foundonly changes the default when it's exactlyfalse. When it'strueor empty, the action leaves the customer's default address unchanged.- Customer ID and Delivery Address ID can contain only letters, digits,
-and_. The action converts numbers such as1001.0to1001, and rejects any other value before it calls Orderwise. - Each request times out after 3 seconds to connect and 10 seconds to read. The action doesn't retry failed requests or follow redirects.
- When the action fails, the error includes the HTTP status and Orderwise's own error message, capped at 200 characters. For example:
RuntimeError: Orderwise request failed with status 409: Order is locked. Errors never include the connection's credentials or the token. - Safe Mode: when off, any failure stops the flow. When on, the action returns
Success = falseand the error inError Message, and the flow continues.
Updated 1 day ago
Did this page help you?
