Формирование ШК места к заказу
Метод используется для формирования ШК места в формате pdf к заказу/заказам.
Во избежание перегрузки платформы нельзя передавать более 100 номеров заказов в одном запросе.
Запрос на формирование ШК места к заказу
Для использования необходимо отправить POST-запрос на URL:
Среда | URL |
---|---|
тестовая | https://api.edu.cdek.ru/v2/print/barcodes |
боевая | https://api.cdek.ru/v2/print/barcodes |
Тело запроса
Необходимо передавать в формате JSON (Content-Type: application/json).
Поддерживаются следующие поля:
№ | Название поля | Описание | Тип поля | Обяз. для заполн. |
---|---|---|---|---|
1 | orders | Список заказов | order[ ] | да |
1.1 | order_uuid | Идентификатор заказа в ИС СДЭК | UUID | да, если не передан cdek_number |
1.2 | cdek_number | Номер заказа СДЭК | long | да, если не передан order_uuid |
2 | copy_count | Число копий. По умолчанию 1 | integer | нет |
3 | format | Формат печати. Может принимать значения: A4, A5, A6, A7 (A - буква латинского алфавита). По умолчанию A4 | string(2) | нет |
4 | lang | Язык печатной формы. Возможные языки в кодировке ISO - 639-3: Русский - RUS Английский - ENG | string(3) | нет |
Ответ на формирование ШК места к заказу
Ответ возвращается в формате JSON:
№ | Название поля | Описание | Тип поля | Обяз. для заполн. |
---|---|---|---|---|
1 | entity | Информация о ШК месте к заказу | entity | нет |
1.1 | uuid | Идентификатор ШК места к заказу в ИС СДЭК | UUID | нет |
2 | requests | Информация о запросе над ШК местом к заказу | request[] | да |
2.1 | request_uuid | Идентификатор запроса в ИС СДЭК | UUID | нет |
2.2 | type | Тип запроса Может принимать значения: CREATE, UPDATE, DELETE, AUTH, GET | string() | да |
2.3 | date_time | Дата и время установки текущего состояния запроса (формат yyyy-MM-dd'T'HH:mm:ssZ) | datetime | да |
2.4 | state | Текущее состояние запроса ACCEPTED - пройдена предварительная валидация и запрос принят | string() | да |
2.5 | errors | Ошибки, возникшие в ходе выполнения запроса | error[] | нет |
2.5.1 | code | Код ошибки | string() | да |
2.5.2 | message | Описание ошибки | string() | да |
Полученный uuid необходимо использовать в методе "Получение ШК места к заказу" для получения ссылки на скачивание pdf-файла |
{ "orders": [ { "order_uuid": "72753034-bd61-45fc-be66-da4a03ed2ed8" } ], "copy_count": 1, "format": "A4" } |
{ "entity": { "uuid": "72753034-c617-46ef-b70a-8f5f520b6be4" }, "requests": [ { "request_uuid": "72753034-e836-499d-bee7-e02053498521", "type": "CREATE", "state": "ACCEPTED", "date_time": "2020-03-19T11:25:53+0700", "errors": [], "warnings": [] } ] } |
© 2000—2024, Курьерская компания СДЭК