Изменить заказ покупателя
https://mrp.zolotenkov.ru/api/external/v1/sales-orders/{id}
Требуемое право ключа: write:sales.order.update
Меняет только переданные поля заказа. Завершенный заказ изменению не подлежит.
Параметры пути
-
idцелое число обязателенid заказа покупателя
Заголовки
-
Idempotency-Keyстрока обязателенОбязателен. Повтор с тем же ключом возвращает прежний ответ. Ответ на повтор помечен заголовком
Idempotency-Replayed: true— по коду ответа повтор от первичного вызова не отличается.
Тело запроса
Формат — application/json.
-
currencyстрока необязателен может быть пустым -
customer_idцелое число необязателен может быть пустым -
customer_referenceстрока необязателен может быть пустым«Доп. № заказа клиента», до 255 символов. Пробелы по краям отрезаются. Пустая строка стирает номер — то же значение, что и пустое поле в карточке заказа;
nullи отсутствие поля его не трогают. -
delivery_dateдата и время необязателен может быть пустым -
itemsмассив объектов необязателен может быть пустымПрислали
items— набор строк заказа заменяется присланным целиком: строки, которых в нем нет, из заказа удаляются. Не прислали — строки не трогаются вовсе. -
items.discount_pctдесятичная дробь необязателен может быть пустымСкидка строки в процентах, от 0 до 100; отсутствие поля означает ноль.
-
items.item_variant_idцелое число обязателен -
items.priceдесятичная дробь обязателенЦена за единицу без НДС и без скидки строки.
-
items.quantityдесятичная дробь обязателен -
items.storage_place_idцелое число необязателен может быть пустымСклад отгрузки строки, номер из
GET /storage-places. Не прислали — строке ставится склад продаж по умолчанию: склад из настроек продаж, а если он не задан — склад с отметкой «по умолчанию», затем склад с наименьшим номером. У строки заказа склад есть всегда. -
items.tax_rateдесятичная дробь необязателен может быть пустымСтавка НДС в процентах; отсутствие поля и ноль означают «налога нет».
-
notesстрока необязателен может быть пустым -
priorityцелое число необязателен может быть пустым -
shipping_feeобъект необязателен
Ответы
- 200 Заказ изменен
- 400 Некорректное тело либо ссылка на строку другого клиента
- 401 Ключ не передан, недействителен или отозван
- 403 У ключа нет права
write:sales.order.update - 404 В этом учете такого заказа или покупателя нет
- 409 Заказ уже завершен (sales_order_not_editable) либо Idempotency-Key повторен с другим телом
- 422 Правка задевает строку, отгруженную в закрытом учетном периоде: ее нельзя удалить, заменить в ней товар, изменить цену или НДС, а количество — сделать меньше отгруженного там (inventory_period_closed)
- 429 Превышена частота обращений. Задержка до повтора — в заголовке
Retry-After