метод REST scope: sale

sale.shipmentitem.add

Добавить элемент в табличную часть отгрузки

Кто может выполнять: администратор

Описание

Метод sale.shipmentitem.add добавляет элемент в табличную часть отгрузки.

Параметры

fields object обязательный

Значения полей для создания элемента табличной части отгрузки

Параметр fields

orderDeliveryId sale_order_shipment.id обязательный

Идентификатор отгрузки

basketId sale_basket_item.id обязательный

Идентификатор корзины

quantity double обязательный

Количество товара

xmlId string необязательный

Внешний идентификатор.

Можно использовать для синхронизации текущей товарной позиции доставки с аналогичной позицией во внешней системе

Примеры запроса

-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"orderDeliveryId":33,"basketId":18,"quantity":1}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sale.shipmentitem.add

Ответ

HTTP-статус: 200

{
    "result":{
        "shipmentItem":{
            "basketId":2716,
            "dateInsert":"2024-04-11T09:10:34+03:00",
            "id":7,
            "orderDeliveryId":2431,
            "quantity":3,
            "reservedQuantity":0,
            "xmlId":"myXmlId"
        }
    },
    "time":{
        "start":1712819431.708122,
        "finish":1712819435.985352,
        "duration":4.2772300243377686,
        "processing":4.085968971252441,
        "date_start":"2024-04-11T10:10:31+03:00",
        "date_finish":"2024-04-11T10:10:35+03:00"
    }
}

Возвращаемые данные

result object

Корневой элемент ответа

shipmentItem sale_order_shipment_item

Объект с информацией о добавленном элементе табличной части отгрузки

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error":201250000001,
    "error_description":"Duplicate entry for key [basketId, orderDeliveryId]"
}
Код Описание Значение
201250000001 Элемент с указанными значениями полей basketId и orderDeliveryId уже существует.

Для изменения значения количества товара воспользуйтесь методом sale.shipmentitem.update

201240400002 Отгрузка не найдена. Некорректное значение переданного параметра orderDeliveryId
201240400003 Корзина не найдена. Некорректное значение переданного параметра basketId
200040300020 Недостаточно прав для добавления элемента в табличную часть отгрузки
100 Не указан или пустой параметр fields
0 Не переданы обязательные поля
0 Другие ошибки (например, фатальные ошибки)

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.