# Integration

## Create order

 - [POST /integration/v1/orders](https://docs.business.poiint.sk/openapi/integration/createorder.md): 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_.

## Submit order

 - [POST /integration/v1/orders/{id}/submit](https://docs.business.poiint.sk/openapi/integration/submitorder.md): Used to submit existing order identified by id in the route parameter.
Order submission means that the order is sent to the system of a carrier specified on the order.
After this step, the order can no longer be modified.
Order cannot be submitted more than once.
For orders with a carrier that has configured an irregular pickup type, it is necessary to specify the pickup date in a request body.

## Print labels

 - [GET /integration/v1/orders/labels](https://docs.business.poiint.sk/openapi/integration/printlabels.md): Used to print labels for given orders.
Labels can be printed only for submitted orders with regular pickup.
A maximum of 100 labels can be printed at a time.

## Refresh

 - [POST /integration/v1/refresh](https://docs.business.poiint.sk/openapi/integration/refresh.md): Used to obtain the access token and current configuration.
Access token is required for authorization of requests for order creation and submission.
The configuration provides information about delivery options of the carriers (which carriers can be used for delivery in given country).
The configuration also includes information about enrichments and validation rules for the given carrier.

## Get unavailable pickup dates

 - [GET /integration/v1/unavailable-pickup-dates](https://docs.business.poiint.sk/openapi/integration/getunavailablepickupdates.md): The function returns the days on which it is not possible to pick up the order by the carrier.
Only 30 days from current date are taken into account.
It is supposed to be used in combination with date picker component to ensure selection of a valid pickup date by the client.
Note that, pickup date selection makes sense only for carriers that support irregular pickup type.