Actions12
Overview
This node integrates with the Shipentegra API to create manual shipping orders. It is designed for logistics and e-commerce workflows where users need to manually input order details, package specifications, shipping costs, and recipient addresses to generate shipping orders programmatically.
Common scenarios include:
- Creating a shipment order for a customer purchase that requires manual entry of package and shipping details.
- Automating the creation of shipping orders in bulk from custom data sources.
- Integrating with other systems to streamline logistics operations without using predefined templates.
Practical example:
A user receives an order from their online store and wants to create a shipping order with specific package dimensions, weight, and shipping cost. They use this node to input all relevant details including items, address, and currency, then send the order to Shipentegra for processing.
Properties
| Name | Meaning |
|---|---|
| Package Quantity | Number of packages to ship (1 to 100,000). |
| Shipping Amount | Cost of shipping (minimum 0.01). |
| Currency | Currency code for the shipping amount. Supported ISO currency codes like USD, EUR, GBP, etc. |
| Description | Description of the order (5 to 50 characters). |
| Weight (Kg) | Total weight of the package(s) in kilograms. |
| Height (Cm) | Package height in centimeters. |
| Width (Cm) | Package width in centimeters. |
| Length (Cm) | Package length in centimeters. |
| Reference 1 | Optional reference field (up to 40 characters). |
| IOSS Number | Optional Import One-Stop Shop number (up to 33 characters). |
| Number | Optional order number or identifier (up to 128 characters). |
| Address Name | Name for the address record (1 to 80 characters). |
| Remember My Address | Boolean flag indicating whether to save this address for future orders. |
| Shipping Address | Fixed collection containing: |
| - Recipient Name (2-128 chars) | |
| - Street Address (5-255 chars) | |
| - Country (ISO code) | |
| - City (2-128 chars) | |
| - State (optional, max 128 chars) | |
| - Postal Code (1-20 chars) | |
| - Email (optional, max 60 chars) | |
| - Phone (optional, max 25 chars) | |
| Order Items | Collection of one or more items, each with: |
| - Name (3-512 chars) | |
| - Quantity (1 to 100,000) | |
| - Unit Price (min 0.01) | |
| - SKU (optional, max 128 chars) | |
| - GTIP code (optional) | |
| - Image URL (optional, max 255 chars) |
Output
The node outputs JSON data representing the created manual order as returned by the Shipentegra API. This typically includes order identifiers, status, and any metadata related to the shipment.
If the node supports binary data output (not explicitly shown here), it would represent files such as shipping labels or documents associated with the order.
Dependencies
- Requires an API key credential for authenticating with the Shipentegra public API.
- The base URL for API requests is
https://publicapi.shipentegra.com/v1. - The node expects JSON content type and accepts JSON responses.
- No additional environment variables are indicated.
Troubleshooting
- Validation errors: Input fields have strict length and value constraints (e.g., description length, numeric ranges). Ensure all required fields meet these criteria.
- Authentication failures: Verify that the API key credential is correctly configured and has necessary permissions.
- API errors: If the Shipentegra API returns errors, check the request payload for correctness, especially nested collections like shipping address and order items.
- Missing required fields: Required properties such as shipping amount, currency, description, address name, shipping address, and order items must be provided.
- Network issues: Confirm network connectivity to the Shipentegra API endpoint.
Links and References
- Shipentegra API Documentation (assumed base URL)
- ISO Currency Codes: https://www.iso.org/iso-4217-currency-codes.html
- Country ISO Codes: https://www.iso.org/iso-3166-country-codes.html