Actions12
Overview
The node integrates with the Shipentegra API to create a SE-DHL Ecommerce shipping label. This operation is useful for e-commerce businesses or logistics providers who need to generate DHL shipping labels for their orders programmatically. By automating label creation, users can streamline their shipping workflows, reduce manual errors, and improve operational efficiency.
Typical use cases include:
- Automatically generating DHL shipping labels when an order is placed in an online store.
- Integrating label creation into a larger fulfillment automation workflow.
- Managing multiple shipments with detailed item declarations and sender information.
Properties
| Name | Meaning |
|---|---|
| Special Service | A string specifying any special service required for the shipment. |
| Order ID | Numeric identifier of the order for which the label is being created. |
| Store ID | Numeric identifier of the store associated with the order. |
| Number | A string representing a reference number related to the shipment. |
| Verpackg | Boolean flag indicating whether packaging is included (true/false). |
| Content | Description of the shipment content as a string. |
| Weight | Numeric value representing the weight of the shipment. |
| IOSS Number | String containing the Import One-Stop Shop (IOSS) number for EU VAT purposes. |
| Currency | Currency code for declared values. Options include standard ISO currency codes such as EUR, USD, GBP, etc., plus "None" for no currency specified. |
| Items | Collection of declared items in the shipment. Each item includes: - Item ID (number) - Declared Quantity (number) - Declared Price (number) - 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 creating the SE-DHL Ecommerce label. This typically includes details about the generated shipping label such as tracking numbers, label URLs, and shipment confirmation data.
If the API returns binary data (e.g., PDF label files), the node would handle this accordingly, but based on the provided information, the output focuses on JSON structured data describing the label and shipment.
Dependencies
- Requires an API key credential for authenticating with the Shipentegra API.
- The node uses the Shipentegra public API endpoint at
https://publicapi.shipentegra.com/v1. - Proper configuration of the API key and language preference in n8n credentials is necessary.
- The user must ensure that all required fields (such as sender address and item details) are correctly populated to avoid API errors.
Troubleshooting
- Missing Required Fields: Errors may occur if mandatory fields like sender name, address line 1, city, or item details are missing. Ensure all required properties are filled.
- Invalid Currency Codes: Using unsupported or empty currency codes might cause API rejection. Use one of the listed ISO currency codes or "None" if not applicable.
- API Authentication Failures: If the API key is invalid or missing, authentication errors will be returned. Verify the API key credential setup.
- Weight or Quantity Out of Range: Values outside allowed ranges (e.g., negative weights or zero quantities) can cause validation errors.
- Network Issues: Connectivity problems to the Shipentegra API endpoint will prevent label creation.
- To resolve errors, check the error message returned by the API, verify input data correctness, and confirm credential validity.
Links and References
- Shipentegra API Documentation (for detailed API specs)
- DHL Ecommerce Shipping Guidelines (for understanding label requirements)
- ISO Currency Codes Reference: https://www.iso.org/iso-4217-currency-codes.html