# Detail of delivery note

Additional information about one delivery note.

This endpoint has several sections, which are only sent when requested in the  parameter (see
Section on demand).

Value | Section
--------|------
| Item surcharge parameters

Endpoint: GET /api/delivery-notes/{code}
Version: 1.0.0
Security: shoptetAccessToken, shoptetPrivateApiToken

## Path parameters:

  - `code` (string, required)
    Example: "0000000003"

## Query parameters:

  - `include` (string)
    Optional parts of response
    Example: "surchargeParameters"

## Header parameters:

  - `Content-Type` (string, required)

## Response 200 fields (application/json):

  - `data` (object, required)

  - `data.deliveryNote` (object, required)

  - `data.deliveryNote.code` (string, required)
    variant code (product)

  - `data.deliveryNote.isValid` (boolean, required)
    Is the delivery note valid?

  - `data.deliveryNote.orderCode` (string,null, required)
    purchase order number. Caution! This does not have to be just a number, it can also contain letters, a dash, etc.

  - `data.deliveryNote.creationTime` (string,null, required)
    date of issue, in ISO 8601 format

  - `data.deliveryNote.changeTime` (string,null, required)
    date of last change, in ISO 8601 format

  - `data.deliveryNote.billingAddress` (object, required)
    invoicing address

  - `data.deliveryNote.billingAddress.company` (string,null, required)
    name of purchaser''s company (or )

  - `data.deliveryNote.billingAddress.fullName` (string,null, required)
    name of purchaser (or )

  - `data.deliveryNote.billingAddress.street` (string,null, required)
    street of purchaser (or )

  - `data.deliveryNote.billingAddress.houseNumber` (string,null, required)
    street number (or )

  - `data.deliveryNote.billingAddress.city` (string,null, required)
    city/town (village) (or )

  - `data.deliveryNote.billingAddress.district` (string,null, required)
    county (or )

  - `data.deliveryNote.billingAddress.additional` (string,null, required)
    additional address information (or )

  - `data.deliveryNote.billingAddress.zip` (string,null, required)
    ZIP or postal code (or )

  - `data.deliveryNote.billingAddress.countryCode` (string,null, required)
    tree-character ISO country code (ISO 4217)

  - `data.deliveryNote.billingAddress.regionName` (string,null, required)
    region name (or )

  - `data.deliveryNote.billingAddress.regionShortcut` (string,null, required)
    region abbreviation (or )

  - `data.deliveryNote.billingAddress.companyId` (string,null, required)
    Company registration number. (can be )

  - `data.deliveryNote.billingAddress.vatId` (string,null, required)
    VAT identification number. (can be )

  - `data.deliveryNote.billingAddress.vatIdValidationStatus` (any)
    Info, whether VAT ID has been verified, enum [, , ]
    Enum: "unverified", "verified", "waiting", null

  - `data.deliveryNote.billingAddress.taxId` (string,null, required)
    TAX identification number. For Czech address, taxId is same as vatId. (can be )

  - `data.deliveryNote.deliveryAddress` (object,null, required)

  - `data.deliveryNote.addressesEqual` (boolean, required)
    Are the billing and delivery addresses the same?

  - `data.deliveryNote.customer` (object, required)

  - `data.deliveryNote.customer.guid` (any, required)
    customer identifier (can be )

  - `data.deliveryNote.customer.phone` (string,null, required)
    customer phone (can be )

  - `data.deliveryNote.customer.email` (string,null, required)
    customer e-mail (can be )

  - `data.deliveryNote.customer.remark` (string,null, required)
    remark for the customer (can be )

  - `data.deliveryNote.items` (array, required)
    content of the delivery note

  - `data.deliveryNote.items.productGuid` (any, required)
    global unique permanent product identifier

  - `data.deliveryNote.items.itemType` (string, required)
    item type

  - `data.deliveryNote.items.name` (string,null, required)
    product name

  - `data.deliveryNote.items.variantName` (string,null, required)
    variant name

  - `data.deliveryNote.items.brand` (string,null, required)
    brand (or manufacturer, possibly)

  - `data.deliveryNote.items.amount` (string,null, required)
    quantity

  - `data.deliveryNote.items.amountUnit` (string,null, required)
    unit of quantity

  - `data.deliveryNote.items.remark` (string,null, required)
    remark

  - `data.deliveryNote.items.weight` (any)

  - `data.deliveryNote.items.surchargeParameters` (array)

  - `data.deliveryNote.items.surchargeParameters.parameterName` (object)

  - `data.deliveryNote.items.surchargeParameters.parameterName.code` (string,null)

  - `data.deliveryNote.items.surchargeParameters.parameterName.name` (string)

  - `data.deliveryNote.items.surchargeParameters.parameterValue` (object)

  - `data.deliveryNote.items.surchargeParameters.parameterValue.valueIndex` (string,null)

  - `data.deliveryNote.items.surchargeParameters.parameterValue.description` (string)

  - `data.deliveryNote.items.specificSurchargeParameters` (array)

  - `data.deliveryNote.items.specificSurchargeParameters.relationId` (string, required)

  - `data.deliveryNote.documentRemark` (string,null, required)
    remark for the document.

  - `errors` (array,null, required)

  - `errors.errorCode` (string, required)
    Short text error identification

  - `errors.message` (string, required)
    Descriptive error message

  - `errors.instance` (string, required)
    Identification of the entity referenced

## Response 404 fields (application/json):

  - `data` (object,null)

  - `errors` (array,null)

  - `errors.errorCode` (string, required)
    Short text error identification

  - `errors.message` (string, required)
    Descriptive error message

  - `errors.instance` (string, required)
    Identification of the entity referenced