⚡ Label Workflow

Depending on the product scope you are integrating (e.g., tracking notifications, customs) and your preferred integration approach, different API workflows may apply. The following outlines the two main integration approaches:

• Synchronous approach: Creating orders and labels at the same time within the Seven Senders system.
• Asynchronous approach: Creating orders and labels separately within the Seven Senders system.

In the synchronous approach, the Post Orders request becomes unnecessary. All parameters typically submitted through the Post Orders request may be passed directly within the Post Labels request.

Workflow: Synchronous Order and Labels Creation

Synchronous approach: Creating orders and labels at the same time within the Seven Senders system.

flowchart LR
    Auth[Authentication] --> PostLabels[POST Labels]
    PostLabels --> GetLabelDownload[GET Label-Download]

Workflow: Asynchronous Orders and Labels Creation

Asynchronous approach: Creating orders and labels separately within the Seven Senders system.

flowchart LR
    Auth[Authentication] --> PostOrders[POST Orders]
    PostOrders[POST Orders] --> PostLabels[POST Labels]
    PostLabels[POST Labels] --> GetLabelDownload[GET Label-Download]

Workflow: Labels and Customs Creation

If you are handling customs clearance through Seven Senders in addition to generating labels, you must transmit the customs shipment data via the API. Depending on whether you are using the Seven Senders Flex product, either one or two additional API calls are required.

flowchart LR
    Authentication[Authentication] --> POSTLabels[POST Labels]

    POSTLabels[POST Labels] --> GETLabel-Download[GET Label-Download]
    POSTLabels[POST Labels] --> POSTCustomsShipment[POST Customs Shipment]
    
    POSTCustomsShipment[POST Customs Shipment] --> POSTCustomsManifest[POST Customs Manifest]
    POSTCustomsShipment[POST Customs Shipment] --> NoManifestForFlex[Not needed for Seven Senders Flex Customers]

For a comprehensive overview of Customs Shipments and Customs Manifests, please refer to the dedicated documentation in the Customs section [here].

ℹ️

Simplified overview:

• Creating the Customs Shipment does not need to occur immediately after Labels generation.
  • It must, however, be completed before manifesting or before the shipment is transported into the customs region.
• We recommend doing this early to allow sufficient time to correct any potential errors (such as missing or invalid data

🚧

Issues transmitting customs data via API?

If your system is technically unable to transmit customs data via the API (e.g., if the required data cannot be provided), please contact your integration manager to identify alternative solution options. Standardized file-exchange processes may be available.