Работа с приходными накладными

Изменено Пн, 13 Ноя, 2023 на 4:11 PM


Получить информацию о приходной накладной


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

Статья помогла?

Отлично!

Спасибо за ваш отзыв

Извините, что не удалось помочь!

Спасибо за ваш отзыв

Расскажите, как мы можем улучшить эту статью!

Выберите хотя бы одну причину
Требуется проверка CAPTCHA.

Комментарий отправлен

Мы ценим вашу помощь и постараемся исправить статью