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

Изменено Пн, 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

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