# Create order

Used to create an order.
Created order is stored in our system, but not submitted to the carrier yet.
Order submission is done in separate step using _SubmitOrderEndpoint_.

Endpoint: POST /integration/v1/orders
Version: 0.0.1
Security: Bearer

## Header parameters:

  - `X-Sender-Profile` (string, required)

## Request fields (application/json):

  - `carrierPid` (integer, required)
    Public identifier of the carrier chosen for the delivery of the package.
Available carriers can be obtained using RefreshEndpoint.

  - `consignee` (object, required)

  - `consignee.name` (string,null, required)
    Name of the consignee.
This can be a company name or full name of the recipient.
    Example: "John Doe"

  - `consignee.firstName` (string, required)
    First name of the recipient.
    Example: "John"

  - `consignee.lastName` (string, required)
    Last name of the recipient.
    Example: "Doe"

  - `consignee.email` (string, required)
    Email of the recipient.
    Example: "john.doe@gmail.com"

  - `consignee.phoneNumber` (string, required)
    Phone number of the recipient in international format (starting with +).
    Example: "+421907654123"

  - `parcelCount` (integer, required)
    Number of parcels in the shipment.

  - `expectedWeight` (number, required)
    Total weight in kilograms of the shipment (sum of parcel weights).

  - `deliveryNote` (string,null)
    Delivery note.
    Example: "Please, leave it behind the door."

  - `clientReference` (string, required)
    The identifier that links the package in the Poiint system with the order in the client's e-shop.
    Example: "A-1234567"

  - `enrichments` (object)

  - `enrichments.cod` (object)

  - `enrichments.cod.amount` (number, required)
    Amount of the money.
    Example: 4.99

  - `enrichments.cod.currency` (string, required)
    Currency ISO code from ISO 4217.
    Example: "EUR"

  - `enrichments.parcelValue` (object)

  - `enrichments.icc` (boolean)
    True, if ID card check is requested.

  - `deliveryAddress` (object)

  - `deliveryAddress.country` (string, required)
    ISO 3166-1 alpha-2 code of the country.
    Example: "SK"

  - `deliveryAddress.zipCode` (string, required)
    Valid zip code of the country without whitespaces.
    Example: "90901"

  - `deliveryAddress.city` (string, required)
    Name of the city.
    Example: "Skalica"

  - `deliveryAddress.street` (string, required)
    Name of the street.
In case of a parcel shop delivery, house number can be part of the street.
    Example: "Mallého"

  - `deliveryAddress.houseNumber` (string, required)
    House number.
In case of a parcel shop delivery, house number can be part of the street.
    Example: "22"

  - `parcelShop` (object)

  - `parcelShop.id` (string, required)

  - `parcelShop.address` (object, required)

## Response 200 fields (application/json):

  - `id` (string, required)
    Identifier of the order in Poiint Business database.
This identifier can be used to submit existing order.
    Example: "5f7d212d-de28-42fa-aa40-2eb0883cc4ce"

  - `poiintId` (string, required)
    Identifier of the order printed on the packet labels.
This identifier can be used to track the status of the order via our official website.
It has a fixed format (P + 13 digits).
    Example: "P0123456789999"

## Response 400 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

  - `errors` (object)


## Response 401 fields