Золотенков

Создать заказ покупателя

POST 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) либо частота обращений