Создать заказ покупателя
https://mrp.zolotenkov.ru/api/external/v1/sales-orders
Требуемое право ключа: write:sales.order.create
Заводит заказ покупателя вместе со строками. Обязателен Idempotency-Key: повтор с тем же ключом вернет прежний ответ и второго заказа не создаст.
Заголовки
-
Idempotency-Keyстрока обязателенОбязателен. Повтор с тем же ключом возвращает прежний ответ и второго заказа не создает. Ответ на повтор помечен заголовком
Idempotency-Replayed: true— по коду ответа повтор от первичного вызова не отличается.
Тело запроса
Формат — application/json.
-
created_dateдата и время необязателен может быть пустымДата документа. Не прислали — «сейчас».
-
currencyстрока необязателен может быть пустым -
customer_idцелое число обязателен -
customer_referenceстрока необязателен может быть пустым«Доп. № заказа клиента», до 255 символов. Пробелы по краям отрезаются; пустая строка значит «номера нет».
-
delivery_dateдата и время необязателен может быть пустым -
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строка необязателен может быть пустым -
numberстрока необязателен может быть пустымНомер документа. Не прислали — система выдает следующий сама, тем же счетчиком, что и интерфейс.
-
priorityцелое число необязателен может быть пустым -
shipping_feeобъект необязателен
Ответы
- 201 Заказ создан
- 400 Некорректное тело либо ссылка на строку другого клиента
- 401 Ключ не передан, недействителен или отозван
- 403 У ключа нет права
write:sales.order.create - 404 Покупатель не найден
- 409 Номер заказа уже занят (document_number_taken) либо Idempotency-Key повторен с другим телом
- 422 Дата документа попадает в закрытый учетный период (inventory_period_closed)
- 429 Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений