Actions12
Overview
This node integrates with the Shipentegra API to create shipping labels, specifically supporting the operation "Create Shipentegra Label" under the "Default" resource. It is designed to facilitate the generation of shipping labels for orders by providing detailed shipment information such as order ID, store ID, package contents, weight, currency, and sender address.
Common scenarios where this node is beneficial include:
- E-commerce platforms automating label creation for shipments.
- Logistics services needing to generate standardized shipping labels programmatically.
- Businesses managing multiple stores or orders requiring batch label creation.
Practical example: An online store can use this node to automatically generate shipping labels for each new order, specifying declared items, weights, and sender details, streamlining the fulfillment process.
Properties
| Name | Meaning |
|---|---|
| Special Service | A string field to specify any special service required for the shipment. |
| Order ID | Numeric identifier of the order for which the label is being created (minimum 1). |
| Store ID | Numeric identifier of the store related to the order (minimum 1). |
| Number | A string field likely representing a reference number or shipment number. |
| Verpackg | Boolean flag indicating packaging status or requirement (true/false). |
| Content | Description of the shipment content as a string. |
| Weight | Numeric value representing the weight of the shipment (minimum 0). |
| IOSS Number | String field for the Import One-Stop Shop (IOSS) number, used in EU VAT declarations. |
| Currency | Currency code for declared prices; options include standard ISO currency codes like EUR, USD, GBP, etc., plus an option for "None". |
| Items | Collection of declared items in the shipment. Each item includes: - Item ID (number) - Declared Quantity (number) - Declared Price (number, minimum 0.01) - GTIP (string, likely a customs tariff code) |
| Ship From | Sender address information including: - Name (required) - Address 1 (required) - Address 2 (optional) - State (optional) - City (required) - Zip Code (optional) - Phone (optional) |
Output
The node outputs JSON data containing the response from the Shipentegra API after attempting to create the shipping label. This typically includes label details such as tracking numbers, label URLs or files, and confirmation of the shipment creation.
If binary data is returned (e.g., PDF label files), it would represent the actual shipping label document ready for printing or further processing.
Dependencies
- Requires an API key credential for authenticating with the Shipentegra API.
- The base URL for API requests is
https://publicapi.shipentegra.com/v1. - The node expects JSON content type and accepts JSON responses.
- Language preference can be set via credentials but defaults to English (
en-US).
Troubleshooting
- Invalid or missing API credentials: Ensure that a valid API key or authentication token is configured in the node credentials.
- Missing required fields: Fields like Order ID, Store ID, and mandatory sender address fields must be provided; otherwise, the API may reject the request.
- Incorrect data types or out-of-range values: For example, numeric fields have minimum and maximum constraints; violating these will cause errors.
- API rate limits or connectivity issues: Network problems or exceeding API usage limits can result in failed requests.
- Currency code not supported: Use one of the predefined currency options; unsupported codes may cause errors.
To resolve errors, verify all required inputs, check API credentials, and consult the Shipentegra API documentation for specific error messages.
Links and References
- Shipentegra API Documentation (example link, replace with actual)
- ISO Currency Codes Reference
- n8n Documentation on Creating Custom Nodes