Send a despatch advice

Despatch advice process

As supplier you can send either a new or updated despatch advice to Tradecloud.

Note

When a purchase order number is provided, but the item is not or partly provided, the item in the despatch advice will be enriched if Tradecloud can find the purchase order.

Endpoint

Caution

The shipment module is under development. The API and documentation may change.

Use the Send despatch advice to send a despatch advice to Tradecloud.

Note

When sending a despatch advice the provided buyer account number will be verified.

Despatch advice

• header: the despatch advice header, see Despatch advice header
• lines: the despatch advice lines, see Despatch advice line. The total number of lines is limited to 500 lines per shipment.
• erpIssueDateTime: local date and time at which the despatch advice of this shipment was issued in the supplier’s ERP system

Despatch advice header

• supplierCompanyId: the optional Tradecloud company identifier of the supplier. You only have to provide a companyId when your integration user account has authorization for multiple companies.
• buyerAccountNumber: the buyer account code or number as known in the supplier’s ERP system
• despatchAdviceNumber: the unique despatch advice number as provided by the supplier
• shipment: the shipment related to this despatch advice:

Despatch advice shipment

• shipmentNumber: the related shipment number as known in the supplier’s ERP system.

Caution

The shipmentNumber must not contain whitespace characters.

• shipmentCompanyName: the shipment company name, like the carrier or courier name.
• trackingNumber: the tracking number of the shipment as provided by the carrier or courier
• departure: the departure location and date of a shipment, see Shipment departure
• destination: the next destination location and scheduled arrival date/time, see Shipment next destination
• finalDestination: the final destination location and scheduled arrival date/time, see Shipment final destination

Shipment departure

• location: the departure location, see Shipment location
• actualDate: the actual departure local date

Shipment next destination

• location: the location where the shipment should arrive next, see Shipment location

Scheduled start and end date/times indicate the scheduled time window of arrival:

• scheduledStartDate: start local date of the arrival time window
• scheduledStartTime: start local time of the arrival time window
• scheduledEndDate: end local date of the arrival time window
• scheduledEndTime: end local time of the arrival time window

Shipment final destination

• location: the location where the shipment should arrive finally, see Shipment location

Scheduled start and end date/times indicate the scheduled time window of arrival:

• scheduledStartDate: start local date of the arrival time window.
• scheduledStartTime: start local time of the arrival time window.
• scheduledEndDate: end local date of the arrival time window.
• scheduledEndTime: end local time of the arrival time window.

Shipment location

• locationType: a location type according to Incoterms 2020:

  • AgreedPlace (used with EXW, FCA)
  • PortOfLoading (used with FAS, FOB)
  • PortOfDestination (used with CFR, CIF)
  • PlaceOfDestination (used with CPT, CIP)
  • FinalDestination (used with DAP, DPU, DDP)

• id: the required identifier for the location, in context of idScheme

• idScheme: scheme, providing context to the location identifier. For example GLN

• names: one or more location names. It is recommended to provide at least one name.

• addressLines: one or more location address lines

• postalCode: location postal code

• city: location city

• countryCodeIso: country code

Despatch advice line

• despatchAdviceLinePosition the position in the despatch advice as provided by the supplier. The position is unique within the despatch advice and immutable.
• purchaseOrderNumber: the related purchase order number as provided by the buyer
• purchaseOrderLinePosition: the line position in the purchase order as provided by the buyer
• item: the item that is shipped, see Despatch advice item
• despatchQuantity the despatched quantity of this purchase order line or delivery schedule position.
• backorderQuantity: the backorder quantity of this purchase order line or delivery schedule position.

Despatch advice item

• buyerItemNumber: the required item code or number as provided by the buyer
• buyerItemRevision: the revision of the item as provided by the buyer
• buyerItemName: the short name of this item as provided by the buyer
• supplierItemNumber: the supplier item code or number as known in the supplier’s ERP system
• supplierItemRevision: the revision (or version) as known in the supplier’s ERP system
• supplierItemName: the short name of this item as known in the supplier’s ERP system
• purchaseUnitOfMeasureIso: the purchase unit of measure for this item, passed through as-is. No standard is enforced; UN/ECE Recommendation No. 20 is recommended if you want a standard