Actions12
Overview
The "Create SE-USPS Label" operation in the Shipentegra node allows users to generate shipping labels specifically for USPS shipments within the Shipentegra platform. This operation is useful for e-commerce businesses, logistics providers, or any user needing to create USPS shipping labels programmatically as part of their order fulfillment process. By automating label creation, users can streamline shipping workflows, reduce manual errors, and integrate label generation into larger automation pipelines.
Practical examples include:
- Automatically generating USPS shipping labels when an order is placed on an online store.
- Creating labels for international shipments with customs information.
- Integrating with warehouse management systems to print labels during packing.
Properties
| Name | Meaning |
|---|---|
| Special Service | A string value specifying any special service required for the shipment. |
| Order ID | Numeric identifier of the order associated with the label (minimum 1). |
| Store ID | Numeric identifier of the store from which the order originates (minimum 1). |
| Number | A string representing a number related to the shipment (context-specific). |
| Verpackg | Boolean flag indicating whether packaging is included or required. |
| Content | Description of the shipment content as a string. |
| Weight | Numeric weight of the shipment (minimum 0). |
| IOSS Number | String representing the Import One-Stop Shop (IOSS) number for EU VAT purposes, relevant for customs declarations. |
| Currency | Currency code for declared values; options include standard ISO currency codes such as USD, EUR, GBP, etc., and also some historical or special codes. Default is None (""). |
| Items | Collection of declared items included in the shipment. Each item includes: - Item ID (number) - Declared Quantity (number) - Declared Price (number) - GTIP (string, likely a product classification 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 USPS label. This typically includes details about the generated label such as tracking numbers, label URLs, shipment status, and other metadata returned by the API.
If the label includes binary data (e.g., PDF or image of the label), it would be provided in the binary output field, allowing direct download or printing of the label.
Dependencies
- Requires an active Shipentegra API credential configured in n8n with appropriate permissions.
- The node communicates with the Shipentegra public API endpoint at
https://publicapi.shipentegra.com/v1. - Proper API authentication token or key must be set up in the credentials.
- Network access to the Shipentegra API is necessary.
Troubleshooting
Common issues:
- Missing or invalid API credentials will cause authentication failures.
- Invalid or incomplete sender address fields may result in validation errors.
- Incorrect currency codes or missing required item details can cause request rejections.
- Weight or quantity values outside allowed ranges may trigger errors.
Error messages:
- Authentication errors: Verify that the API key/token is correctly configured and has not expired.
- Validation errors: Check that all required fields (e.g., sender name, address, city) are filled and valid.
- API limit or quota exceeded: Ensure your Shipentegra account has sufficient quota or contact support.
Resolution tips:
- Double-check all input properties for correctness and completeness.
- Review API documentation for required fields and constraints.
- Test with minimal valid data to isolate issues.
- Enable detailed logging in n8n to capture full API responses for debugging.
Links and References
- Shipentegra API Documentation (general reference for API endpoints and payloads)
- USPS Shipping Guidelines (for understanding USPS label requirements)
- ISO Currency Codes (reference for currency property options)