Customs Manifest endpoint
A customs manifest is a consolidated list of shipments (parcels) which are being transported together for a given day (picked up at the same time). The customs manifest (or consignment) is a milestone which triggers the data to be sent to the customs broker so that the clearing procedure can start. We as Seven Senders will clear the goods on a consignment level.
Preconditions
The array of shipments declared in the manifest should be previously created using the existing Single API endpoints: POST Customs Shipment.
POST Customs Manifest Parameters
With POST Customs Manifest method, you can submit the consolidated list of shipments which should be transported together for a given day (picked up at the same time). Once submitted the manifest cannot be updated. If the customs manifest was declared with an error in it, then please reach out to your Seven Senders contact as quickly as possible.
| Parameter | M/O | Type | Example | Description |
|---|---|---|---|---|
| shipment_ids | m | array | ["5857965", "5857966", "5857967", "5857968", "5857969", "5857966", "5857066", "5857166", "5857266", "5857366"] | List the id’s of all the shipments that you wish to include in the manifest. |
| pieces | m | number | “11” | The number of outer containers the parcels on the manifest are packed into (e.g. the number of pallets, if palletized, or the number of boxes, if packed into boxes). |
| reference | o | string | “ref54321” | The reference that you wish to assign to the manifest. |
| manifest_id | m | string | “M12345” | Unique ID of your manifest. The manifest_id for us is a unique value across all customers. To reduce errors our recommendation is to work with prefix: CustomerName_ Please do not use / as special character in this field. |
| comment | o | string | “comment” | Any additional comment you would like to include in the manifest. |
| consignment_id | o | string | “123456” | The Seven Senders ID of the consignment on which all mentioned shipments will be transported. This is an optional field, it might be helpful for Seven Senders to be provided. If not known, please leave it empty. |
| consignment_net_weight | m | number | 101.2 | The net weight of the consignment (sum of shipment, net weight). |
| consignment_gross_weight | m | number | 141.46 | The gross weight of the consignment (sum of shipment, gross weight). |
| consignment_total_weight | m | number | 449.46 | The total weight of the consignment (the consignment gross weight plus the dispatching unit and its protective packaging, e.g. the weight of the all of the pallets and their external protection material). |
| consignment_weight_um | m | string | “K” | The unit of the weight(s) you are submitting for the consignment: K = kilos, G = grams, L = pounds, O = ounces. |
| pieces_unit_type | m | string | “Pallet” | The type of outer containers the parcels on the manifest are packed into (e.g. pallets, boxes). |
Agenda: m = mandatory, o = optional.
GET Customs Manifest
With GET Customs Manifest method, you can retrieve a single manifest that has previously been created. This endpoint offers to filter manifests based on manifest_id or/and shipment_id.
