Customs
=======

Information required for international shipments to pass customs.

Attributes
----------

==================  ====================================================================================================  =============================================================================  ===========
Attribute           Type                                                                                                  Required                                                                       Description
==================  ====================================================================================================  =============================================================================  ===========
content_type        string enum: ``gifts`` ``documents`` ``merchandise`` ``sample_merchandise`` ``returned_merchandise``  ✓                                                                              The type of items contained in the shipment.
non_delivery        string enum: ``return`` ``abandon``                                                                   ✓                                                                              What should be done with the shipment when delivery is not possible.
incoterm            string enum: ``DDP`` ``DAP``                                                                          ✓                                                                              Specify if the sender or receiver is responsible for import charges and risks. DDP (Delivered Duty Paid, sender) or DAP (Delivered At Place, receiver).
shipping_value      :doc:`price </api/resources/common-objects/prices>`                                                                                                                                  The shipping cost paid by the customer, for tax and duty purposes.
invoice_number      string                                                                                                Required for: ``merchandise`` ``sample_merchandise`` ``returned_merchandise``  The number of the invoice attached to the package.
license_number      string                                                                                                                                                                               A license number related to shipment items if available.
certificate_number  string                                                                                                                                                                               A certificate number related to shipment items if available.
==================  ====================================================================================================  =============================================================================  ===========

Example
-------

Gift
____

.. code-block:: json

    {
      "content_type": "gifts",
      "non_delivery": "abandon",
      "shipping_value": {
        "amount": 995,
        "currency": "EUR"
      },
      "incoterm": "DDP"
    }

Merchandise
___________

.. code-block:: json

    {
      "content_type": "merchandise",
      "non_delivery": "return",
      "incoterm": "DAP",
      "shipping_value": {
        "amount": 995,
        "currency": "EUR"
      },
      "invoice_number": "2018-1302",
      "license_number": "NH132-1324",
      "certificate_number": "KC2-5SH-4113"
    }