Sign in

v1

latestOpenAPI 3.0.12026-07-242073551.1 MB
Shipping Accounts

Get Account

Provides details for a DHL Express account. <br />Information about the account number, alias, account type, and contact details is included in the response.

get/v4/shippingAccounts/dhlexpress/{shippingAccountId}

Path parameters

shippingAccountIdstring required

Shipping Account Identifier <br />SAPIENT Shipping Account Id (assigned by SAPIENT) or Alias (assigned by you).

Response

Returns the shipping account.

ShippingAccountIdstring uuid required

A unique identifier for each shipping account assigned by the system (ShippingAccountId), allowing for efficient reference and management of individual accounts within the system.

CarrierCodestring required

A unique identifier for the carrier associated with the shipping account. This code is typically alphanumeric and helps in identifying the specific carrier linked to the shipping account.

AccountNumberstring required

The number assigned to the shipping account by the carrier, typically used for tracking shipments and billing purposes.

AccountType'Sandbox' | 'Production' required

Indicates whether the account is set up as a "sandbox" or "production" account. A Sandbox account is for testing and development, while a Production account is used for live shipments and transactions.

AccountNamestring required

The official name of the shipping account as designated by the user or organisation, aiding in easy identification and reference of accounts.

AccountAliasstring required

A unique, user-defined name for the shipping account, providing a convenient way to reference the account in a more memorable manner.

AccountStatusstring required

The current status of the shipping account, which could denote whether it is enabled, disabled, or confirmed, helping users understand the account's usability.

ContactNamestring required

The name of the primary contact person for the shipping account, facilitating communication regarding shipping and account-related matters.

ContactNumberstring tel required

The phone number associated with the shipping account's primary contact person, facilitating communication regarding shipping inquiries, account management, and issue resolution.

IsArchiveLabelsboolean

Indicates whether DHL waybill documents are available for download as PDF. <br /> <br />Valid values are the following: <br /><ul><li>True - the way bill documents will be available for download in PDF format</li><li>False - the way bill documents will not be available for download</li></ul>

IsPaperlessTradeEnabledboolean

Indicates whether the documents are submitted electronically. <br /> <br />Valid values are the following: <br /><ul><li>True - the documents can be submitted electronically</li><li>False - the documents cannot be submitted electronically</li></ul>

PaperlessTradeInvoiceOption'DhlGenerated' | 'SapientGenerated'

Specifies the DHL Paperless Trade (PLT) invoice option for electronically transmitting commercial invoice documentation. <br /> <br />Valid values are the following: <br /><ul><li>DhlGenerated: This value allows DHL to create the invoice and send it electronically to the customs agency.</li><li>SapientGenerated: This value generates the invoice from the shipment data in SAPIENT and sends it to DHL.</li></ul><i>Note: This field is only applicable if the IsPaperlessTradeEnabled field is set to true.</i>

LastUpdatedBystring required

The identifier (such as a username or system account) of the individual or system that last modified the shipping account information, ensuring accountability.

LastUpdatedDateUtcstring date-time required

A timestamp indicating the last time the shipping account details were updated, formatted in Coordinated Universal Time (UTC).

Example response

{
  "CarrierCode": "RM",
  "AccountNumber": "0123456789",
  "AccountName": "AB VideoGames",
  "AccountAlias": "JSL",
  "AccountStatus": "Enabled",
  "ContactName": "John Smith",
  "ContactNumber": "0123456789",
  "LastUpdatedBy": "User A"
}