Actions3
- Order Actions
Overview
This node integrates with the Bol.com Retailer API to manage orders, specifically enabling the shipment of order items. The "Ship Order" operation allows users to mark an order item as shipped by providing shipment details such as transporter information and tracking codes. This is useful for e-commerce sellers using Bol.com who want to automate updating their order shipment status directly from n8n workflows.
Practical examples include:
- Automatically marking orders as shipped when a package is dispatched.
- Sending shipment details like transporter and track & trace codes to Bol.com to keep customers informed.
- Integrating with logistics systems to update Bol.com order statuses in real-time.
Properties
| Name | Meaning |
|---|---|
| Order ID | The unique identifier of the order item to ship |
| Transporter Code | The transporter company handling the shipment. Options: PostNL, DHL, DPD, UPS, GLS, Other |
| Track and Trace | The tracking code provided by the transporter for shipment tracking |
| Shipment Reference | Your own reference identifier for this shipment |
| Shipping Label Code | The shipping label code used if utilizing Bol.com's logistics services |
Output
The node outputs JSON data representing the response from the Bol.com Retailer API after attempting to ship the order item. This typically includes confirmation details about the shipment or error information if the request failed.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token configured in n8n to access the Bol.com Retailer API.
- The node uses the base URL
https://api.bol.comand expects JSON content-type headers. - Proper credentials must be set up in n8n to authorize requests.
Troubleshooting
Common issues:
- Invalid or missing Order ID will cause the API call to fail.
- Incorrect transporter code or missing required shipment details may result in errors.
- Network or authentication failures can prevent successful API communication.
Error messages:
- Errors returned from the Bol.com API will be included in the node output if "Continue On Fail" is enabled.
- Typical errors might indicate invalid parameters or authorization problems.
Resolutions:
- Verify that the Order ID corresponds to an existing order item.
- Ensure all required fields (Order ID, Transporter Code) are correctly filled.
- Confirm that the API credentials are valid and have necessary permissions.
- Check network connectivity and API endpoint availability.