Skip to main content

Shipments - Parties and customs

· 2 min read

In a greater effort to improve customs in Shipmondo, a number of fields have been introduced to shipments:

  • parties array
  • pickup_details object
  • delivery_details object
  • service_point_id string
  • customs > freight_cost float
  • customs > insurance_cost float

At the same time a number of fields have been deprecated:

  • sender object
  • receiver object
  • pick_up object
  • bill_to object
  • service_point object
  • return_to object
  • customs > billed_to_custom_invoice_text string
  • customs > sender_custom_invoice_text string
  • customs > receiver_custom_invoice_text string

There are no current plan to remove these fields, but it is recommended to stop using them from now on, as new features will only be added to parties.

Guides​

Check out the new guide for parties for further details of the structure of parties.

Also check out the new guide for migration to parties from the deprecated address objects.

Also check out the updated API reference for reference of the stucture of each new field.

Examples​

Parties​

{
  ...
  "parties": [
    {
      "type": "sender",
      "name": "Min Virksomhed ApS",
      "attention": "Lene Hansen",
      "address1": "Hvilehøjvej 25",
      "address2": null,
      "postal_code": "5220",
      "city": "Odense SØ",
      "state": null,
      "country_code": "DK",
      "email": "info@minvirksomhed.dk",
      "phone": "70400407",
      "attributes": [
        {
          "name": "vat_no",
          "value": "DK12345678"
        }
      ]
    },
    {
      "type": "receiver",
      "name": "Lene Hansen",
      "attention": null,
      "address1": "Skibhusvej 52",
      "address2": null,
      "postal_code": "5000",
      "city": "Odense C",
      "state": null,
      "country_code": "DK",
      "email": "lene@email.dk",
      "phone": "12345678",
      "attributes": [
        {
          "name": "vat_no",
          "value": "DK12345678"
        }
      ]
    }
  ],
  ...
}

Pickup and delivery details​

{
  ...
   "pickup_details": {
    "date": "2025-10-01",
    "from": "08:00:00",
    "to": "10:00:00",
    "instruction": "Pickup at gate 17"
  },
  "delivery_details": {
    "date": "2025-10-01",
    "from": "08:00:00",
    "to": "10:00:00",
    "instruction": "Place in garage"
  }
  ...
}

Service point ID​

{
  ...
  "service_point_id": "12345",
  ...
}

Freight and insurance cost​

{
  ...
  "customs": {
    "freight_cost": 100.5,
    "insurance_cost": 50.42
  }
  ...
}