Actions20
Overview
This node integrates with the ShipTown API to manage orders and other resources such as activities, products, inventory, warehouses, and users. Specifically for the Order - Update operation, it allows updating an existing order by specifying its ID and providing additional properties in JSON format. This is useful in scenarios where you need to modify order details dynamically within an automated workflow, such as updating shipping information, changing quantities, or adjusting order status.
Practical examples:
- Automatically update order details after receiving new customer information.
- Modify order properties based on inventory changes or shipment updates.
- Integrate with external systems to keep order data synchronized.
Properties
| Name | Meaning |
|---|---|
| Order ID | The unique numeric identifier of the order to update. |
| Additional Fields | A collection of optional fields; currently supports a JSON object named "Properties" which contains additional order properties to update. |
The Additional Fields > Properties expects a JSON object string representing key-value pairs of order attributes to be updated.
Output
The node outputs the JSON response returned by the ShipTown API after updating the order. This typically includes the updated order details as a JSON object reflecting the changes made.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token credential configured in n8n to authenticate requests to the ShipTown API.
- The base URL for the API is taken from the credential's domain configuration.
- The node uses HTTP methods (PUT) to interact with the ShipTown REST API endpoints.
Troubleshooting
Common issues:
- Invalid or missing Order ID will cause the API request to fail.
- Malformed JSON in the "Properties" field can lead to parsing errors or rejected requests.
- Insufficient permissions or invalid API credentials will result in authentication errors.
- Network connectivity issues may prevent successful API calls.
Error messages and resolutions:
"error": "Order not found": Verify that the provided Order ID exists in ShipTown."error": "Invalid JSON": Ensure the JSON in the Properties field is correctly formatted.- Authentication errors: Check that the API key credential is valid and has necessary permissions.
- Timeout or network errors: Confirm network access to the ShipTown API endpoint.
Links and References
- ShipTown API Documentation (for detailed API endpoint info)
- n8n documentation on HTTP Request Node for understanding how API calls are made within workflows.