v1

latestOpenAPI 3.1.02026-07-2277219695.0 KB

Customs Declarations

Create a new customs declaration

Creates a new customs declaration object

post/customs/declarations

Headers

SHIPPO-API-VERSIONstring

Example:2018-02-08

Optional string used to pick a non-default API version to use. See our API version guide.

Request body

aes_itnstring

required if eel_pfc is AES_ITN

AES / ITN reference of the shipment.

b13a_filing_option'FILED_ELECTRONICALLY' | 'SUMMARY_REPORTING' | 'NOT_REQUIRED'

B13A Option details are obtained by filing a B13A Canada Export Declaration via the Canadian Export Reporting System (CERS). More information on reporting commercial exports from Canada. Allowed values available here

b13a_numberstring

must be provided if and only if b13a_filing_option is provided

Represents the Proof of Report (POR) Number when b13a_filing_option is FILED_ELECTRONICALLY; the Summary ID Number when b13a_filing_option is SUMMARY_REPORTING; or the Exemption Number when b13a_filing_option is NOT_REQUIRED.

certificatestring

Certificate reference of the shipment.

certifyboolean required

Expresses that the certify_signer has provided all information of this customs declaration truthfully.

certify_signerstring required

Name of the person who created the customs declaration and is responsible for the validity of all information provided.

commercial_invoiceboolean

contents_explanationstring

required if contents_type is OTHER

Explanation of the type of goods of the shipment.

disclaimerstring

Disclaimer for the shipment and customs information that have been provided.

Carrier-Specific Constraints:

Carrier	Constraints
FedEx	Max 554 characters

exporter_referencestring

Exporter reference of an export shipment.

importer_referencestring

Importer reference of an import shipment.

is_vat_collectedboolean

Indicates whether the shipment's destination VAT has been collected. May be required for some destinations.

invoicestring

Invoice reference of the shipment.

licensestring

License reference of the shipment.

metadatastring

A string of up to 100 characters that can be filled with any additional information you want to attach to the object.

notesstring

Additional notes to be included in the customs declaration.

Type of goods of the shipment.
Allowed values available here

eel_pfc'NOEEI_30_37_a' | 'NOEEI_30_37_h' | 'NOEEI_30_37_f' | 'NOEEI_30_36' | 'AES_ITN'

EEL / PFC type of the shipment. For most shipments from the US to CA, NOEEI_30_36 is applicable; for most other shipments from the US, NOEEI_30_37_a is applicable. Allowed values available here

incoterm'DDP' | 'DDU' | 'FCA' | 'DAP' | 'eDAP'

The incoterm reference of the shipment. FCA is available for DHL Express and FedEx only. eDAP is available for DPD UK only. DAP is available for DHL Express, FedEx, and DPD UK. If expecting DAP for other carriers, please use DDU. Allowed values available here Carrier-specific restrictions are in the table below.

Carrier-Specific Constraints:

Carrier	Constraints
FedEx	Must be one of DDP, DDU, FCA, DAP

non_delivery_option'ABANDON' | 'RETURN' required

Indicates how the carrier should proceed in case the shipment can't be delivered. Allowed values available here

testboolean

Example request

{
  "b13a_filing_option": "FILED_ELECTRONICALLY",
  "certify": true,
  "certify_signer": "Shawn Ippotle",
  "contents_explanation": "T-Shirt purchase",
  "duties_payor": {
    "account": "2323434543",
    "type": "THIRD_PARTY",
    "address": {
      "name": "Patrick Kavanagh",
      "zip": "80331",
      "country": "DE"
    }
  },
  "exporter_identification": {
    "eori_number": "PL123456790ABCDE",
    "tax_id": {
      "number": "123456789",
      "type": "EIN"
    }
  },
  "invoice": "#123123",
  "metadata": "Order ID #123123",
  "address_importer": {
    "name": "Shwan Ippotle",
    "company": "Shippo",
    "street1": "Blumenstraße",
    "street_no": "22",
    "city": "München",
    "state": "CA",
    "zip": "80331",
    "country": "DE",
    "phone": "80331",
    "email": "shippotle@shippo.com",
    "is_residential": true
  },
  "contents_type": "MERCHANDISE",
  "eel_pfc": "NOEEI_30_37_a",
  "incoterm": "DDP",
  "items": [
    {
      "description": "T-Shirt",
      "mass_unit": "lb",
      "metadata": "Order ID \"123454\"",
      "net_weight": "5",
      "quantity": 20,
      "sku_code": "HM-123",
      "hs_code": "0901.21",
      "value_amount": "200",
      "value_currency": "USD"
    }
  ],
  "non_delivery_option": "RETURN",
  "test": true
}

Response

Customs declaration

aes_itnstring

required if eel_pfc is AES_ITN

AES / ITN reference of the shipment.

b13a_filing_optionstring

b13a_numberstring

must be provided if and only if b13a_filing_option is provided

certificatestring

Certificate reference of the shipment.

certifyboolean required

Expresses that the certify_signer has provided all information of this customs declaration truthfully.

certify_signerstring required

Name of the person who created the customs declaration and is responsible for the validity of all information provided.

commercial_invoiceboolean

contents_explanationstring

required if contents_type is OTHER

Explanation of the type of goods of the shipment.

disclaimerstring

Disclaimer for the shipment and customs information that have been provided.

Carrier-Specific Constraints:

Carrier	Constraints
FedEx	Max 554 characters

exporter_referencestring

Exporter reference of an export shipment.

importer_referencestring

Importer reference of an import shipment.

is_vat_collectedboolean

Indicates whether the shipment's destination VAT has been collected. May be required for some destinations.

invoicestring

Invoice reference of the shipment.

licensestring

License reference of the shipment.

metadatastring

A string of up to 100 characters that can be filled with any additional information you want to attach to the object.

notesstring

Additional notes to be included in the customs declaration.

address_importerstring

Object ID of the Importer address.

contents_typestring required

Type of goods of the shipment.
Allowed values available here

eel_pfcstring

EEL / PFC type of the shipment. For most shipments from the US to CA, NOEEI_30_36 is applicable; for most other shipments from the US, NOEEI_30_37_a is applicable. Allowed values available here

incotermstring

Carrier-Specific Constraints:

Carrier	Constraints
FedEx	Must be one of DDP, DDU, FCA, DAP

itemsstring[] required

Distinct Parcel content items as Customs Items object_ids.

non_delivery_optionstring required

Indicates how the carrier should proceed in case the shipment can't be delivered. Allowed values available here

object_createdstring date-time

Date and time of object creation.

object_idstring

Unique identifier of the given object.

object_ownerstring

Username of the user who created the object.

object_state'VALID' | 'INVALID'

Indicates the validity of the enclosing object

object_updatedstring date-time

Date and time of last object update.

testboolean

Indicates whether the object has been created in test mode.

Example response

{
  "b13a_filing_option": "FILED_ELECTRONICALLY",
  "certify": true,
  "certify_signer": "Shawn Ippotle",
  "contents_explanation": "T-Shirt purchase",
  "duties_payor": {
    "account": "2323434543",
    "type": "THIRD_PARTY",
    "address": {
      "name": "Patrick Kavanagh",
      "zip": "80331",
      "country": "DE"
    }
  },
  "exporter_identification": {
    "eori_number": "PL123456790ABCDE",
    "tax_id": {
      "number": "123456789",
      "type": "EIN"
    }
  },
  "invoice": "#123123",
  "metadata": "Order ID #123123",
  "address_importer": "257ba08436604d2aaf069caafe7acb2a",
  "contents_type": "MERCHANDISE",
  "eel_pfc": "NOEEI_30_37_a",
  "incoterm": "DDP",
  "items": [
    "5087f181d1dc4b14b73fdbf636498886"
  ],
  "non_delivery_option": "RETURN",
  "object_created": "2014-07-17T01:01:08.306Z",
  "object_id": "e2197a54da9d470480f4f8796cc419cb",
  "object_owner": "shippotle@shippo.com",
  "object_updated": "2014-07-17T01:01:08.306Z",
  "test": true
}