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 Found is false.
  • 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

NameTypeRequiredDescription
Customer IDStringYesOrderwise customer ID.
Delivery Address IDStringYesID of the delivery address in the customer's address book.
New Delivery ObjectObjectYesObject with address1, address2, city, zip, country_name and country_code. address1 is required.
Default Address FoundBooleanNoWhether the customer already has a default delivery address, typically from Orderwise Check Default Customer Address. When false, the updated address becomes the default.
Safe ModeBooleanNoIf on, errors are returned in the outputs instead of stopping the flow. Off by default.

Outputs

NameTypeDescription
SuccessBooleanWhether Orderwise updated the address.
ResponseObjectThe response body from Orderwise.
Error MessageStringError 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_url must be an https URL.
  • 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: city to town, zip to postcode, country_name to country and country_code to countryCode. It sends missing or empty fields as empty text.
  • If New Delivery Object has no address1, the action fails and sends nothing to Orderwise.
  • Default Address Found only changes the default when it's exactly false. When it's true or 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 as 1001.0 to 1001, 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 = false and the error in Error Message, and the flow continues.


Did this page help you?