Получить информацию о приходной накладной
Route: https://cdek.orderadmin.ru/api/storage/movements/document/<id> Method: GET Headers: Accept: application/json Authorization: basic
Пример ответа:
{
"id": 123,
"type": "products",
"extDate": {
"date": "2022-08-31 03:00:00.000000",
"timezone_type": 1,
"timezone": "+03:00"
},
"comment": null,
"extId": null,
"state": "closed",
"_embedded": {
"warehouse": {
"id": 1,
"type": "virtual",
"name": "Тестовый склад",
"state": "active"
}
}
}Описание полей:
| Поле | Описание |
|---|---|
| id | Уникальный идентификатор сущности |
| type | Тип приемной накладной |
| extDate | Предполагаемая дата приемки |
| comment | Описание приемки (необязательно) |
| extId | Для нужд разработчиков интеграций |
| state | Состояние приемки |
| warehouse/id | Склад, на котором будет происходить приемка |
Типы приемных накладных:
| Тип | Описание |
|---|---|
| products | Приемка товаров и размещение на полках |
| palletized | Приемка паллеты (без размещения на полках) |
Состояния:
| Состояние | Описание |
|---|---|
| new | Новая, не обработана складом |
| confirmed | Товар принят, идет размещение |
| closed | Товар принят и размещен на полках |
Информация о товарах в приходной накладной
Route: https://cdek.orderadmin.ru/api/storage/movements/document/item?filter[0][type]=eq&filter[0][field]=document&filter[0][value]=<id> Method: GET Headers: Accept: application/json Authorization: basic
Пример ответа:
{
"_links": {
"self": {
"href": "https://cdek.orderadmin.ru/api/storage/movements/document/item?filter%5B0%5D%5Btype%5D=eq&filter%5B0%5D%5Bfield%5D=document&filter%5B0%5D%5Bvalue%5D=222&page=1"
},
"first": {
"href": "https://cdek.orderadmin.ru/api/storage/movements/document/item?filter%5B0%5D%5Btype%5D=eq&filter%5B0%5D%5Bfield%5D=document&filter%5B0%5D%5Bvalue%5D=222"
},
"last": {
"href": "https://cdek.orderadmin.ru/api/storage/movements/document/item?filter%5B0%5D%5Btype%5D=eq&filter%5B0%5D%5Bfield%5D=document&filter%5B0%5D%5Bvalue%5D=222&page=1"
}
},
"_embedded": {
"document_item_id": [
{
"id": 333,
"sku": "18963284789",
"quantityExpected": 1,
"quantityReal": 0,
"quantityPlace": 0,
"_embedded": {
"productOffer": {
"id": 111,
"article": "433332",
"name": "BOOK",
"type": "simple",
"image": null,
"barcodes": [
"9785171380960"
],
"sku": null,
"dimensions": {
"x": "150",
"y": "200",
"z": "50"
},
"weight": 250,
"volume": 1500000,
"purchasingPrice": 2,
"price": 300,
"state": "normal",
"extId": null,
},
"document": {
"id": 222,
"state": "closed",
"type": "products",
"extDate": "2022-08-31 03:00:00+03",
"comment": null,
"extId": null
}
}
}
]
},
"page_count": 1,
"page_size": 25,
"total_items": 3,
"page": 1
}Поля ответа:
| Поле | Название |
|---|---|
| id | Уникальный идентификатор сущности |
| sku | Идентификатор для приемки (sku, штрих-код или артикул) |
| quantityExpected | Ожидаемое кол-во |
| quantityReal | Реальное кол-во. Доступно только для confirmed или closed |
| _embedded/productOffer | Информация о товаре |
| _embedded/document | Информация о накладной |
Получить список приходных накладных
Route: https://cdek.orderadmin.ru/api/storage/movements/document Method: GET Headers: Accept: application/json Authorization: basic
Пример ответа:
{
"_links": {
"self": {
"href": "https://cdek.orderadmin.ru/api/storage/movements/document?page=1"
},
"first": {
"href": "https://cdek.orderadmin.ru/api/storage/movements/document"
},
"last": {
"href": "https://cdek.orderadmin.ru/api/storage/movements/document?page=4"
},
"next": {
"href": "https://cdek.orderadmin.ru/api/storage/movements/document?page=2"
}
},
"_embedded": {
"movement_acceptance": [ /* объекты приходных накладных */ ]
},
"page_count": 4,
"page_size": 25,
"total_items": 96,
"page": 1
}Создание приходной накладной
Route: https://cdek.orderadmin.ru/api/storage/movements/document Method: POST Headers: Accept: application/json Authorization: basic
Пример json для запроса:
{
"type": "products",
"comment": "Комментарий",
"extId": "внешний id, для нужд разработчиков",
"warehouse": "id склада пользователя",
"extDate": "2022-05-22"
}Добавление товара в приходную накладную
Route: https://cdek.orderadmin.ru/api/storage/movements/document/item/bulk Method: POST Headers: Accept: application/json Authorization: basic
Пример json для запроса:
[
/* Блок для каждого товара */
{
"create": {
"productOffer": {
/* id товара */
"id": 123123,
"shop": 101354
},
"shop": 101354,
/* id созданной приходной накладной */
"document": 123456,
"sku": "идентификатор товара для приемки",
/* ожидаемое количество */
"quantityExpected": 2
}
}
]В поле sku нужно передать идентификатор, который будет находиться на упаковке вашего товара (sku, штрих-код или артикул).
Комментарии в json только для информации. Перед отправкой данных на сервер комментарии следует удалить.
Поиск приходной накладной по extId
https://cdek.orderadmin.ru/api/storage/movements/document?filter[0][type]=eq&filter[0][field]=extId&filter[0][value]="extId" Method: GET Headers: Accept: application/json Authorization: basic
Статья помогла?
Отлично!
Спасибо за ваш отзыв
Извините, что не удалось помочь!
Спасибо за ваш отзыв
Комментарий отправлен
Мы ценим вашу помощь и постараемся исправить статью