Incoterms

The Warehouse API currently supports all Incoterm values for Incoterm 2020, as well as six additional values. This optional field can be passed for any order as required with the below values. For additional details regarding Incoterms and their definition we recommend the free PDF provided by the International Chamber of Commerce available here.

To pass an Incoterm, a forwardingData object with an incoTerm string value must be included in the Order body. Below is an example of this.

warning

Warehouse API currently does not validate based on the warehouse country and the country that the order is being shipped to. If an invalid value is passed our warehousing teams have been taught to override this. Future versions of WAPI will throw a 400 error if an international incoterm is used for domestic orders or if a domestic incoterm is used for an international order.

Example Request

{
    "WarehouseCode": "LAW",
    "PrimaryReference": "12345678901",
    "ShipToAddress": {
        "Address": {
            "AddressLine1": "123 Street",
            "Country": "CA"
        }
    },
    "TransportDetail": {
        "carrierCode" : "FX",
        "serviceLevelCode": "GND",
    },
    "forwardingData": {
        "incoTerm" : "DDP",
    },
    "OrderLines": [
        {
            "ProductCode": "MyProduct",
            "Quantity": 1.0
        }
    ]
}

Incoterm Accepted Values

Value	Description	International	Domestic
PPD	Prepaid		✔️
CLT	Collect		✔️
C3P	Collect 3rd Party		✔️
FCD	Collect COD		✔️
CFR	Cost And Freight	✔️
CIF	Cost, Insurance And Freight	✔️
CIP	Carriage and Insurance Paid To	✔️
CPT	Carriage Paid To	✔️
DAP	Delivered At Place	✔️
DAT	Delivered At Terminal	✔️
DDP	Delivered Duty Paid	✔️
DPU	Delivered at Place Unloaded	✔️
EXW	Ex Works	✔️
FAS	Free Alongside Ship	✔️
FC1	FCA - Free Carrier (seller is responsible for origin and loading)	✔️
FC2	FCA - Free Carrier (buyer is responsible for origin and loading)	✔️
FCA	FCA - Free Carrier (seller is responsible for origin, buyer for loading)	✔️
FOB	Free On Board	✔️