---
title: "Create Shipment"
method: POST
path: "/v4/shipments/dpdnl"
tags: ["Shipments"]
---

# Create Shipment

`POST /v4/shipments/dpdnl`

Create a DPD Netherlands shipment. This will return an image of the shipping label in PDF or PNG format.

## Request body

- DpdNetherlandsShipmentRequestCarrierSpecificsPackageDetailsDpdNetherlandsLabelFormatCreateShipmentRequest — Create Shipment Request
  - `ShipmentInformation` DpdNetherlandsLabelFormatShipmentInformation, required — Used to provide shipment-level information such as service code, content type, general goods description, total shipment weight and value etc.
    - `Action` 'Process' | 'Create' | 'Allocate' — Indicates the operation to be performed for the shipment, determines the shipment status that is set on shipment creation and whether a shipment tracking number and labels are generated. <br /> <br />Valid values are: <br /><ul><li>**Process:** Creates a shipment tracking number, generates and prints a label for each package in the shipment, and returns the labels in the **createShipment** response. With this action, the shipment status is set to **Ready to Manifest**.</li><li>**Create:** Creates the shipment but does not allocate a tracking number, print the labels or return them in the **createShipment** response. The label(s) must be printed before the shipment is ready to manifest.</li><li>**Allocate:** Creates the tracking number and label but does not print the labels or return them in the **createShipment** response. The label(s) must be printed before the shipment is ready to manifest.</li></ul> <br />***Note:** By default, this field is set to Process.*
    - `LabelFormat` 'PDF' | 'PNG' | 'ZPL203DPI' | 'ZPL300DPI' | 'QRCode' | 'QRCodeAndPDF' — Sets the label format that will be returned in the createShipment Response. <br />Valid values are: <br />**PDF** - returns a Base64-encoded PDF <br />**PNG** - returns a Base64-encoded PNG <br />**ZPL203DPI** - returns Base 64 encoded text for Zebra printer at 203 DPI <br />**ZPL300DPI** - returns Base 64 encoded text for Zebra printer at 300 DPI <br />**QRCode** - returns the DPD Netherlands specific QR code label <br />**QRCodeAndPDF** - returns the DPD Netherlands specific QR code label with PDF label <br />Defaults to PDF if not populated.
    - `ContentType` 'NDX' | 'DOX' | 'HV', required — Defines the type of contents being shipped. This helps the carrier manage the shipment according to its content type. <br /> <br />Valid values are: <br /><ul><li>**NDX** - Non Documents</li><li>**DOX** - Documents</li><li>**HV** - Non Documents of High Value</li></ul>
    - `ServiceCode` string, required — A valid unique code identifying the service selected for the shipment's delivery and collection address, which determines pricing, delivery speed, and other service attributes.
    - `DescriptionOfGoods` string, required — A general description of the items being shipped, which may include details such as type, quantity, and specifications. This field provides clarity about the contents for customs and handling purposes.
    - `BusinessTransactionType` 'B2C' | 'B2B' | 'D2C' | 'C2B' — Specifies the nature of the commercial transaction type associated with the shipment. <br /> <br />Valid values are: <br /> <br />**B2C** - Business to Consumer <br />**B2B** - Business to Business <br />**D2C** - Direct to Consumer <br />**C2B** - Consumer to Business (that is, a returns shipment) <br /> <br />***Note:** By default, this field is set to B2C.*
    - `ShipmentDate` string, date, nullable — The scheduled date for the shipment to be shipped, which cannot be in the past and must not exceed 28 days into the future. If omitted, it defaults to the current date.
    - `DeclaredValue` number, double, nullable — The declared monetary value assigned to the shipment in the specified currency. If provided, it must equal or exceed the sum of all item values. If not provided, it defaults to the sum of all item values. <br /> <br />***Note:** For Non-Consignment Services where multiple packages are declared, use the declared value at the package level instead.*
    - `DeclaredWeight` number, double, nullable — The total weight of the shipment in the unit of measure specified in the **WeightUnitOfMeasure** field. This weight should meet or exceed the weight of all packages or items and is required for consignment services. The minimum allowed weight is 0.001 Kg and the maximum is dependent on the carrier, service, and destination. <br /> <br />***Note:** For all Non-Consignment Services, use the declared weight at the package level instead.*
    - `CurrencyCode` string, nullable — The three-letter ISO code indicating the currency in which any monetary value is specified (for example, USD, EUR). This ensures clarity for payment and invoicing purposes.
    - `WeightUnitOfMeasure` 'KG' | 'Grams' — The unit of measure used for all weight values in the shipment, expressed in grams and kilograms, for example, **DeclaredWeight**, **ItemWeight**. This is crucial for accurately describing shipment weight. <br /> <br />***Note:** By default, this field is set to KG.*
    - `DimensionsUnitOfMeasure` 'CM' | 'MM' — The unit of measure used for all the dimensions (length, width, height) values of the packages being shipped, allowing for measurements in millimeters and centimeters. This ensures consistency in how dimensions are handled. <br /> <br />***Note:** By default, this field is set to CM.*
    - `ContainerId` string, nullable — A unique identifier assigned by the system or by you (alias) to the container in a shipment, so that the shipment can be added to the existing container when the shipment is created. <br /> <br />If a valid **ContainerId** is specified, the shipments in the request will be automatically allocated to that container upon creation. If the **ContainerId** is provided, then the **Process** action is required.<br /> <br />***Note:** The container must already exist for the same Carrier and Shipping Location as the shipment.*
  - `Shipper` Shipper, required — Used to provide shipper details such as address, contact details, VAT and EORI number etc.
    - `ShippingAccountId` string, required — A unique identifier assigned by the system (shippingAccountId) or by you (alias) to the shipping account for which the shipment is being created.
    - `ShippingLocationId` string, nullable — A unique identifier assigned by the system (shippingLocationId) or by you (alias) to the shipping location for which the shipment is being created. <br /> <br />***Note:** This field is mandatory if more than one shipping location is available for the shipping account.*
    - `Reference1` string, nullable — The shipper's reference for this shipment. This is usually the shipper's order number that is provided to the receiver when the order was made. <br /> <br />***Note:** This information may be required based on the customer account settings in the GUI.*
    - `Reference2` string, nullable — An optional field that allows for additional identifying information that assists in shipment tracking and referencing.
    - `DepartmentNumber` string, nullable — An optional field where the shipper can specify the department number associated with the shipment.
    - `EoriNumber` string, nullable — The EORI (Economic Operators Registration and Identification) number for the shipper, which must start with the ISO Alpha-2 Country Code followed by up to 15 alphanumeric characters. For Northern Ireland, it starts with XI. <br /> <br />***Note:** Make sure to provide this information here—not in the **Customs** object. This field is mandatory for B2B shipments from Great Britain to Northern Ireland.*
    - `VatNumber` string, nullable — The VAT (Value Added Tax) number for the shipper, which is required for business transactions, helping to ensure compliance with tax regulations. <br /> <br />***Note:** Make sure to provide this information here—not in the **Customs** object.*
    - `Address` ShipperAddress — The complete address of the shipper's location, consisting of multiple components including street information, locality, and so on. <br /> <br />***Note:** If this information is not provided, then the shipping location's address will be used.*
      - `AddressId` string, nullable — A unique identifier for the address. This information ensures that each address can be distinctly referenced and managed within the system. <br /> <br />***Note:** If this information is provided, then all the fields under the **Address** object are ignored and the stored address in the **Address Book** will be used.*
      - `ContactName` string, nullable — The name of the primary contact person for the shipment at the address. <br /><br />***Note:** Either the **Contact Name** or **Company Name** must be provided.*
      - `CompanyName` string, nullable — The name of the company associated with the shipment at the address.<br /><br />***Note:** Either the **Contact Name** or **Company Name** must be provided.*
      - `ContactEmail` string, email, nullable — The email address of the contact person for any communication regarding the shipment at the address.
      - `ContactPhone` string, nullable — The contact phone number associated with the shipping location, facilitating communication regarding shipments or deliveries. <br /> <br />***Note:** Characters like +, /, -, or space are supported.*
      - `Line1` string, nullable — The first line of the address, typically containing the primary address information such as house number and street name. <br /><br />***Note:** This information is required if the address is not used from the stored addresses in the **Address Book**.*
      - `Line2` string, nullable — An optional second line for the address, often used for additional details like apartment numbers or suite designations.
      - `Line3` string, nullable — A third optional line in the address to include any further address specifications, allowing for more detailed address information if necessary.
      - `Town` string, nullable — The town or city, indicating the specific locality where the address is situated. <br /><br />***Note:** This information is required if the address is not used from the stored addresses in the **Address Book**.*
      - `Postcode` string, nullable — The postal or ZIP code corresponding to the shipping location, used for mail sorting and to identify specific geographic areas. <br /><br />***Note:** This information is required for the addresses in the UK and for some outside it. To check for the postcode requirements, refer to the **Countries** API.*
      - `County` string, nullable — The county, state, or province in which the shipping location resides, providing additional geographical context for the address.<br /><br />***Note:** This information may be required depending on the country. If the country is USA, Australia, or Canada, then it must be a valid state code or name, respectively. To check for the county/state/province requirements, refer to the **Countries** API.*
      - `CountryCode` string, nullable — An abbreviation representing the country of the shipping location, typically following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom. <br /> <br />***Note:** This information is required if the address is not used from the stored addresses in the **Address Book**.*
      - `What3Words` string, nullable — A three-word location identifier provided by the What3words service, offering a precise way to define locations using a unique combination of three words, for example, the front door of 10 Downing Street in London is identified by slurs.this.shark.
  - `Destination` Destination, required — An object providing details on the shipment destination, such as receiver and contact details.
    - `EoriNumber` string, nullable — The EORI (Economic Operators Registration and Identification) number for the receiver, which must start with the ISO Alpha-2 Country Code followed by up to 15 alphanumeric characters. For Northern Ireland, it starts with XI. <br /> <br />***Note:** This field is mandatory for B2B shipments from GB to Northern Ireland or if the receiver is a business. Make sure to provide this information here—not in the **Customs** object.*
    - `VatNumber` string, nullable — The VAT (Value Added Tax) number for the receiver, which, if applicable, is used for tax compliance. <br /> <br />***Note:** This field is mandatory if the receiver is a business. Make sure to provide this information here—not in the **Customs** object.*
    - `Address` DestinationAddress, required — The complete address of the receiver's location, consisting of multiple components including street information, locality, and so on.
      - `AddressId` string, nullable — A unique identifier for the address. This information ensures that each address can be distinctly referenced and managed within the system. <br /> <br />***Note:** If this information is provided, then all the fields under the **Address** object are ignored and the stored address in the **Address Book** will be used.*
      - `ContactName` string, nullable — The name of the primary contact person for the shipment at the address. <br /><br />***Note:** Either the **Contact Name** or **Company Name** must be provided.*
      - `CompanyName` string, nullable — The name of the company associated with the shipment at the address.<br /><br />***Note:** Either the **Contact Name** or **Company Name** must be provided.*
      - `ContactEmail` string, email, nullable — The email address of the contact person for any communication regarding the shipment at the address.
      - `ContactPhone` string, nullable — The contact phone number associated with the receiver, facilitating communication regarding shipments or deliveries. <br /> <br />***Note:** Characters like +, /, -, or space are supported.*
      - `Line1` string, nullable — The first line of the address, typically containing the primary address information such as house number and street name. <br/> <br/> ***Note:** Characters like +, /, -, or space are supported.*
      - `Line2` string, nullable — An optional second line for the address, often used for additional details like apartment numbers or suite designations.
      - `Line3` string, nullable — A third optional line in the address to include any further address specifications, allowing for more detailed address information if necessary.
      - `Town` string, nullable — The town or city, indicating the specific locality where the shipping location is situated. <br/> <br/> ***Note:** This information is required if the address is not used from the stored addresses in the **Address Book**.*
      - `Postcode` string, nullable — The postal or ZIP code corresponding to the shipping location, used for mail sorting and to identify specific geographic areas.<br/> <br/> ***Note:** This information is only required for the addresses in the UK and for some outside it. To check for the postcode requirements, refer to the **Countries** API.*
      - `County` string, nullable — The county, state, or province in which the shipping location resides, providing additional geographical context for the address.<br/> <br/> ***Note:** This information may be required depending on the country. If the country is USA, Australia, or Canada, then it must be a valid state code or name, respectively. To check for the county/state/province requirements, refer to the **Countries** API.*
      - `CountryCode` string, nullable — An abbreviation representing the country of the shipping location, following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom. <br /> <br />***Note**: This information is only required if the address is not used from the stored addresses in the **Address Book***
      - `What3Words` string, nullable — A three-word location identifier provided by the What3words service, offering a precise way to define locations using a unique combination of three words, for example, the front door of 10 Downing Street in London is identified by slurs.this.shark.
  - `CarrierSpecifics` DpdNetherlandsShipmentRequestCarrierSpecifics — DPD Netherlands-specific features that can be used when creating a DPD NL shipment.
    - `Enhancements` DpdNetherlandsServiceEnhancement[], nullable — An array of objects that specifies the particular enhancement code that is being applied to the shipment, allowing customers to select the desired enhancement that can modify the shipping experience according to their preferences.
      - `Code` 'Email' | 'Sms', required — This object specifies the particular enhancement code that is being applied to the shipment, allowing customers to select multiple enhancements that can modify the shipping experience according to their preferences. <br /> <br />Valid values are the following: <br /><ul><li>**Email:** Delivery updates are sent via email. To use this enhancement code, the destination **ContactEmail** must be provided with a valid email address.</li><li>**SMS:** Delivery updates are sent via SMS. To use this enhancement code, the destination **ContactPhone** field must be provided with a valid phone number.</li></ul>
  - `Packages` PackageDetails[], required — Used to provide information on the packages that are being sent in this shipment.<br /> <br />***Note:** You must add at least one package to the shipment.*
    - `PackageOccurrence` integer, nullable — A unique identifier for each package within the shipment that is used to match a returned package ID to this package. This field can also be used to assign items to a specific package. <br /> <br />***Note:** For Royal Mail dutiable multi-package shipments that are not using a consignment service, items must be assigned to a package so that accurate customs information is given. Therefore, if the shipment contains more than one package, and it is not using a consignment service, then the **PackageOccurrence** is required.*
    - `DeclaredWeight` number, double, nullable — The total weight of the package being declared in the unit of measure specified in the **WeightUnitOfMeasure** field. <br /> <br />***Note:** The minimum allowed weight is 0.001 kg and the maximum weight is dependent on the carrier, service and destination. This field is mandatory for shipments using non-consignment services.*
    - `DeclaredValue` number, double, nullable — The declared monetary value of the package specified in the **CurrencyCode** field. <br /> <br />***Note:** If provided, then the declared value must meet or exceed the sum of all item values assigned to this package. Otherwise, it defaults to this sum. This value can be used for non-consignment services, though it is not mandatory.*
    - `Dimensions` Dimensions — Used to provide the maximum allowable dimensions for packages. It specifies the limits that must not be exceeded for packages to be eligible for the shipping service and package type. <br /> <br />***Note:** The Dimensions object in the request is optional, but if it is provided, then all of the fields in the object (width, length, and height) must be populated. The maximum dimensions accepted are dependent on the service and the package type.*
      - `Length` number, double, required — The length of the shipment package in the unit of measure specified in the **UnitOfMeasure** field. <br /> <br />***Note:** The maximum accepted length is dependent on the service and package type.*
      - `Width` number, double, required — The width of the shipment package in the unit of measure specified in the **UnitOfMeasure** field. <br /> <br />***Note:** The maximum accepted width is dependent on the service and package type.*
      - `Height` number, double, required — The height of the shipment package in the unit of measure specified in the **UnitOfMeasure** field. <br /> <br />***Note:** The maximum accepted height is dependent on the service and package type.*
  - `Items` Item[], nullable — Used to provide information on the individual goods/products being shipped within the package. This includes vital details, such as SKU code for inventory tracking, quantity of each item, description for clarity, and shipping specifics like weight, customs classifications (HS Code), and country of origin. <br /> <br />***Note:** The item information is only required for dutiable shipments. Non-Dutiable and Documents Only (DOX) shipments do not require item information. Please be advised that the item verification on a shipment is done via Hurricane services; therefore, it should be enabled. The maximum number of distinct items that will be verified in a single shipment is 15.*
    - `SkuCode` string, nullable — A unique Stock Keeping Unit (SKU) code assigned to the item. This code is used for tracking inventory, helping users identify specific items easily.
    - `PackageOccurrence` integer, nullable — A unique identifier for each package within the shipment that is used to assign items to a specific package. <br /> <br />***Note:** The package occurence provided here must exist on one of the packages in the **Packages** object. If multiple packages exist and a consignment service is not used, this field is mandatory to ensure each package occurrence is distinct.*
    - `Quantity` integer, required — The quantity of this item in the package being shipped.
    - `Description` string, nullable — A brief summary providing details about the specifc item being shipped, outlining its type, features, uses, and any pertinent information that helps users understand the item, such as 'skirt' instead of 'ladies clothing.' <br /> <br />***Note:** This information is mandatory for dutiable shipments unless a SKU Code of a stored product is provided.If a SKU Code of a stored product is present and this field is left blank, it will be automatically populated from the stored product; if both are provided, the input in this field takes precedence.*
    - `Value` number, double, nullable — The monetary value of a single instance of the item, in the currency specified in the **CurrencyCode** field. <br /> <br />***Note:** This information is mandatory for dutiable shipments unless a SKU Code of a stored product is provided.If a SKU Code of a stored product is present and this field is left blank, it will be automatically populated from the stored product; if both are provided, the input in this field takes precedence.*
    - `Weight` number, double, nullable — The weight of a single instance of the item, in the unit of measure specified in the **WeightUnitOfMeasure** field. This is required for dutiable shipments unless a SKU Code from the stored product is used. If the SKU Code is available and the weight is left blank, it will be populated from the stored product; otherwise, the provided weight will be used. <br /> <br />***Note:** The maximum allowed weight is 1000 KG.For non-dutiable shipments, a weight of 0 is accepted.For dutiable shipments, an item weight of 1 gram or greater must be provided.*
    - `ImageURL` string, uri, nullable — This field provides the URL of the product image with the shipment details. This helps customers visually identify the product when selecting items for return in the Returns system.
    - `HSCode` string, nullable — The Harmonized System (HS) code used by customs to determine potential duties and taxes for the product. This code ranges from 6 to 13 alphanumeric characters, depending on specific services or destinations. Some countries may also use the HS codes of other character lengths. <br /> <br />***Note:** Characters like space and dot are supported.* <br /> <br />For more information on HS Codes and to find the correct HS Codes for your items, refer to the following link: https://www.gov.uk/trade-tariff
    - `CountryOfOrigin` string, nullable — An abbreviation representing the country where the item was manufactured or produced, following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom. This information is important for customs declarations and compliance with import/export regulations. <br /> <br />***Note:** Depending on the carrier and destination country, this information may be required for dutiable shipments.*
    - `ManufactureProductId` string, nullable — A unique manufacturer identifier for the item being shipped, for example, proprietary manufacturer code, model number, or internal code. This field is used to reference the shipped item and supports carrier-specific requirements.
    - `StandardisedProductId` string, nullable — A globally recognised product identifier for the item being shipped, for example, GTIN, EAN, and UPC. This field is used for standardised item identification and supports carrier-specific requirements for customs and risk assessment.
    - `SupplementaryUnits` number, double, nullable — This field specifies any additional unit of measurements that supplement the primary unit of measurements for the item being shipped. <br />For example: The HS code for PVC Black Flooring Roll 2.5mm is 391890. HMRC/Tariff determines that you provide a supplementary unit in square metres (MTK) with HS code 391890. <br /> <br />***Note:** For B2B shipments to Northern Ireland, this field is optional if the HMRC/Tariff determines that the Tariff/Harmonisation Code provided requires a supplementary unit.* <br />*You can enter values to a maximum of 6 decimal places.*
  - `Customs` Customs — Used to provide information for customs clearance related to the shipment. This includes, reasons for export, applicable incoterms, any pre-registration numbers and type required, shipping and other charges, as well as details about the invoice and whether an export licence is needed. It ensures compliance with international shipping regulations.
    - `ReasonForExport` string, nullable — Identifies the purpose of the export, such as sale, gift, or return. This information is useful for customs processing to determine the appropriate tariffs and requirements.<br>This field is mandatory for Yodel international shipments.</br>The following values are accepted:</br><ul><li>Sales</li><li>Gift</li><li>Sample</li><li>Personal</li></ul>
    - `Incoterms` 'DDU' | 'DDP' | 'DAP' | 'DAT' — Specifies the International Commercial Terms (Incoterms) applicable to the shipment, governing responsibilities and financial obligations. <br /> <br />Valid values include the following: <br /><ul><li>**DDU** — Delivered Duty Unpaid. The receiver is responsible for paying customs duties and taxes.</li><li>**DDP** — Delivered Duty Paid. The seller is responsible for paying customs duties and taxes.</li><li>**DAP** — Delivered At Place. The receiver is responsible for paying customs duties and taxes.</li><li>**DAT** — Delivered At Terminal. The receiver is responsible for paying customs duties and taxes.</li></ul> <br />***Note:** By default, this field is set to DDU if not provided for dutiable shipments. Please be advised that this information is not required for non-dutiable shipments.*
    - `PreRegistrationNumber` string, nullable — A number for tax pre-registration in countries where required for compliance during DDU shipments.<br /> <br />If applicable, this number is required for countries operating a Tax Pre-Registration scheme (for example, VOEC in Norway, GST in Australia) when shipping under DDU Incoterms. If not provided and DDU is specified, any pre-registration numbers configured in the Customs Settings GUI for the account will be used. <br /> <br />***Note:** VAT and EORI numbers should be provided in the Shipper and receiver **VatNumber** and **EoriNumber** fields, not in this field.*
    - `PreRegistrationType` string, nullable — The type of pre-registration number provided in the **PreRegistrationNumber** element, specifying the registration scheme type. This field is mandatory if a **PreRegistrationNumber** is provided. Otherwise, it is ignored. <br /> <br />***Note:** VAT and EORI numbers should be provided in the Shipper and receiver **VatNumber** and **EoriNumber** fields, not in this field.*
    - `ShippingCharges` number, double, nullable — The postage amount paid by the customer for the international shipments, which can be 0.00 if free delivery is offered. This amount is used for calculating customs fees and should be in the currency specified in the **ShipmentInformation** > **Currency** field.
    - `OtherCharges` number, double, nullable — The additional costs charged to the customer beyond standard shipping, such as insurance fees. This field can be left blank or set to 0.00 if no additional charges apply. Values should be in the currency specified in the **ShipmentInformation** > **Currency** field.
    - `QuotedLandedCost` number, double, nullable — The total cost quoted to the customer when the shipment reaches the destination, including duties and taxes, and must be expressed in the currency specified in the **ShipmentInformation** > **Currency** field. <br /> <br />***Note:** This information is required for some international destinations when the shipment incoterms are DDP.*
    - `InvoiceNumber` string, nullable — A specific number that is associated with a shipment. This is useful for tracking, billing, and reconciliation purposes. <br /> <br />***Note:** When sending an item to an overseas address and a Commercial or Proforma invoice is available, the **InvoiceNumber** and **InvoiceDate** should be provided to support customs processing.If provided, it will be displayed on commercial invoices generated for the shipment. Please be advised that this field is required if the **InvoiceDate** is provided.*
    - `InvoiceDate` string, date, nullable — The date on which the invoice was created. This information is useful for record-keeping, billing cycles, and tracking payment due dates. <br /> <br />***Note:** The **InvoiceDate** must be in the YYYY-MM-DD format. This field is ignored if the **InvoiceNumber** is not provided. If the **InvoiceNumber** is provided without the invoice date, then the **InvoiceDate** defaults to today's date.*
    - `ExportLicenceRequired` boolean, nullable — A boolean flag indicating whether an export licence is needed for the shipment, particularly for goods predominantly used for military purposes. If required, the export licence should be affixed to the outside of the package. <br /> <br />***Note:** To learn more about the types of items requiring an export licence, refer to the UK Government website.*
    - `Airn` string, nullable — The AIRN (Address Identification Reference Number) is the generic name given to a national identification number for the overseas recipient of an item. This is required by certain countries for customs clearance. <br /> <br />***Note:** If the AIRN is available, then it should be provided for items being exported to countries where the customs/tax authority requests one, such as Russia and Brazil.*
  - `ReturnToSender` ReturnToSender — Used to provide the address details to be used when returning the shipment back to the sender. <br /> <br />***Note:** If this information is not provided, then the shipping location's address is used.*
    - `Address` ReturnToSenderAddress — The complete address of the return to sender location, consisting of multiple components including street information, locality, and so on.
      - `AddressId` string, nullable — A unique identifier for the address. This information ensures that each address can be distinctly referenced and managed within the system. <br /> <br />***Note:** If this information is provided, then all the fields under the **Address** object are ignored and the stored address in the **Address Book** will be used.*
      - `ContactName` string, nullable — The name of the primary contact person for the shipment at the address. <br /><br />***Note:** Either the **Contact Name** or **Company Name** must be provided.*
      - `CompanyName` string, nullable — The name of the company associated with the shipment at the address.<br /><br />***Note:** Either the **Contact Name** or **Company Name** must be provided.*
      - `ContactEmail` string, email, nullable — The email address of the contact person for any communication regarding the shipment at the address.
      - `ContactPhone` string, nullable — The contact phone number associated with the return to sender address, facilitating communication regarding shipments or deliveries. <br /> <br />***Note:** Characters like +, /, -, or space are supported.*
      - `Line1` string, nullable — The first line of the address, typically containing the primary address information such as house number and street name. <br/> <br/> ***Note:** Characters like +, /, -, or space are supported.*
      - `Line2` string, nullable — An optional second line for the address, often used for additional details like apartment numbers or suite designations.
      - `Line3` string, nullable — A third optional line in the address to include any further address specifications, allowing for more detailed address information if necessary.
      - `Town` string, nullable — The town or city, indicating the specific locality where the shipping location is situated. <br/> <br/> ***Note:** This information is required if the address is not used from the stored addresses in the **Address Book**.*
      - `Postcode` string, nullable — The postal or ZIP code corresponding to the shipping location, used for mail sorting and to identify specific geographic areas.<br/> <br/> ***Note:** This information is only required for the addresses in the UK and for some outside it. To check for the postcode requirements, refer to the **Countries** API.*
      - `County` string, nullable — The county, state, or province in which the shipping location resides, providing additional geographical context for the address.<br/> <br/> ***Note:** This information may be required depending on the country. If the country is USA, Australia, or Canada, then it must be a valid state code or name, respectively. To check for the county/state/province requirements, refer to the **Countries** API.*
      - `CountryCode` string, nullable — An abbreviation representing the country of the shipping location, following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom. <br /> <br />***Note**: This information is only required if the address is not used from the stored addresses in the **Address Book***
      - `What3Words` string, nullable — A three-word location identifier provided by the What3words service, offering a precise way to define locations using a unique combination of three words, for example, the front door of 10 Downing Street in London is identified by slurs.this.shark.

## Response `200`

The shipment was created successfully.

- DpdNetherlandsLabelFormatPackageResponseDetailsCreateShipmentResponse — Create Shipment Response
  - `ConsignmentShipmentId` string, uuid, nullable — A unique identifier assigned to the shipment by the carrier. This ID is useful for tracking and managing the shipment throughout its transit journey and can be used in future queries or to reference the specific shipment. <br /> <br />***Note:** This field is only populated if a consignment service was used in the request.*
  - `ConsignmentTrackingNumber` string, nullable — A unique identifier assigned to the entire consignment shipment by the carrier. This number allows shippers and recipients to track the status and location of the entire shipment throughout its transit. It is useful for monitoring progress, ensuring timely delivery, and addressing any issues that may arise during transportation. <br /> <br />***Note:** This field is only populated if the service is a consignment service.*
  - `ConsignmentCarrierTrackingUrl` string, uri, nullable — A URL link provided by the carrier that allows the shipper and recipients to access real-time tracking information about the consignment shipment. This link directs users to the carrier's website where they can view detailed status updates and current location of the shipment. <br /> <br />***Note:** This field is only populated if this feature is available and the service is a consignment service.*
  - `Labels` string, nullable — Returns the generated shipping labels for the shipment. This field is populated only if the requested action was "Process." The labels include the necessary barcodes and shipping information required for effective transit and delivery of the packages. ***Note:** This field returns the labels only if the **ReturnLabelsAtPackageLevel** field is set to false.*
  - `LabelFormat` 'PDF' | 'PNG' | 'ZPL203DPI' | 'ZPL300DPI' | 'QRCode' | 'QRCodeAndPDF' — Sets the label format that will be returned in the createShipment Response. <br />Valid values are: <br />**PDF** - returns a Base64-encoded PDF <br />**PNG** - returns a Base64-encoded PNG <br />**ZPL203DPI** - returns Base 64 encoded text for Zebra printer at 203 DPI <br />**ZPL300DPI** - returns Base 64 encoded text for Zebra printer at 300 DPI <br />**QRCode** - returns the DPD Netherlands specific QR code label <br />**QRCodeAndPDF** - returns the DPD Netherlands specific QR code label with PDF label <br />Defaults to PDF if not populated.
  - `Packages` PackageResponseDetails[], nullable — An array that details information about each package included in the shipment. This includes essential data, such as package occurrence and tracking information. Each package is clearly documented to facilitate tracking and handling.
    - `ShipmentId` string, uuid, nullable — A unique identifier associated with the specific shipment containing the package. This ID is crucial for linking the package to its overall shipment, aiding in organisation and tracking. <br /> <br />***Note:** This field is only populated if the service is a non-consignment service.*
    - `PackageOccurrence` integer — Identifies the sequential number or occurrence of the package provided in the request for the shipment. It allows for easy differentiation of multiple packages and helps manage inventory or logistics operations related to the shipment.
    - `TrackingNumber` string, nullable — The specific tracking number assigned to the package occurrence by the carrier. This number can be used to track the package's status and location during its transit.
    - `CarrierTrackingUrl` string, uri, nullable — A unique URL provided for each package that allows shippers and recipients to track the specific package directly on the carrier's website. This link leads to a dedicated tracking page where detailed updates can be accessed. <br /> <br />***Note:** This field is only populated, if this feature is available.*
    - `Label` string, nullable — This field provides the Base64-encoded label for each package in the shipment only if the **ReturnLabelsAtPackageLevel** field is set to True. If **ReturnLabelsAtPackageLevel** is not specified, or is set to False, then this field will not be returned, and instead, the main body of the Create Shipment response will include the label data.
  - `Documents` string, nullable — This object is only returned if the shipment is dutiable and the requested action was "Process." This object includes any requisite documentation necessary for customs clearance and compliance, ensuring that all regulatory requirements are met for international shipments.
  - `DocumentFormat` 'PDF' | 'PNG' | 'ZPL203DPI' | 'ZPL300DPI' — Specifies the format in which the documents related to the shipment are provided. For example, a Base 64 encoded PDF, PNG or ZPL203DPI, and ZPL300DPI. <br /> <br />This format is crucial for ensuring that the documents can be easily accessed, printed, and utilised during shipping and customs processes.

## Other responses

- `400` — Invalid request response.
- `401` — Unauthorized
- `403` — Forbidden
- `404` — The carrier was not found.
- `500` — Internal Server Error

---

[API](https://skmtc.dev/intersoftsapient/apis/sapient-core-api.md) · [All operations](https://skmtc.dev/intersoftsapient/apis/sapient-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intersoftsapient/sapient-core-api/revisions/3315ad0b5875/schema)