# Delivery note from Order creation

Creating delivery note from existing order.

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

## Path parameters:

  - `code` (string, required)
    Order code
    Example: "2018000053"

## Header parameters:

  - `Content-Type` (string, required)

## Request fields (application/json):

  - `data` (object, required)

  - `data.code` (string, required)
    Delivery note code.

  - `data.date` (string)
    Document creation date.

## Response 201 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 null)

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

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

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

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

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

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

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

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

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

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

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

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

  - `data.deliveryNote.billingAddress.vatIdValidationStatus` (any)
    Info, whether VAT ID has been verified, enum [unverified, verified, waiting]
    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 null)

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

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

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

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

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

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

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

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

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

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

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

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

  - `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 null)

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

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

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

  - `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.code` (string,null, required)
    variant code (product)

  - `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.parameterName.subscription` (boolean,null)

  - `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.items.specificSurchargeParameters.name` (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

  - `metadata` (object, required)

  - `metadata.requestId` (string, required)
    Request identifier. Useful for logging/reporting purposes.

## 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

  - `metadata` (object)

  - `metadata.requestId` (string, required)
    Request identifier. Useful for logging/reporting purposes.

## Response 409 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

  - `metadata` (object)

  - `metadata.requestId` (string, required)
    Request identifier. Useful for logging/reporting purposes.

## Response 422 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

  - `metadata` (object)

  - `metadata.requestId` (string, required)
    Request identifier. Useful for logging/reporting purposes.