Золотенков
Выпустить ключ

Создать поставщика

POST https://mrp.zolotenkov.ru/api/external/v1/suppliers

Требуемое право ключа: write:purchase.supplier.create

Заводит карточку контрагента. Возвращенный id — тот самый supplier_id, который требует тело POST /purchase-orders: до ZOL-11168 узнать его снаружи было нечем, и на пустом учете вся ветка закупок вместе с приходами открывалась только руками в интерфейсе. Обязателен Idempotency-Key: повтор с тем же ключом вернет прежний ответ и второй карточки не создаст.

Заголовки

  • Idempotency-Key строка обязателен

    Обязателен, до 200 символов. Повтор с тем же ключом возвращает прежний ответ и второй карточки не создает. Ответ на повтор помечен заголовком Idempotency-Replayed: true — по коду ответа повтор от первичного вызова не отличается.

Тело запроса

Формат — application/json.

  • address строка необязателен может быть пустым
  • currency строка необязателен может быть пустым

    Валюта расчетов, трехбуквенный код. По умолчанию валюта учета.

  • email строка необязателен может быть пустым
  • inn строка необязателен может быть пустым

    ИНН. Повтор в пределах учета отвечает 409.

  • kpp строка необязателен может быть пустым
  • name строка обязателен

    Название контрагента. Единственное обязательное поле. У покупателя это же поле называется title — имена полей у двух справочников исторически разошлись, и переименование сломало бы уже выпущенные ключи.

  • notes строка необязателен может быть пустым
  • phone строка необязателен может быть пустым

Ответы

  • 201 Карточка поставщика создана. Повтор с прежним Idempotency-Key отвечает тем же кодом и тем же телом — новой карточки не появляется
  • 400 Некорректное тело запроса
  • 401 Ключ не передан, недействителен или отозван
  • 403 У ключа нет права write:purchase.supplier.create
  • 409 Idempotency-Key повторен с другим телом либо ИНН уже занят другим поставщиком этого учета
  • 429 Превышена частота обращений (rate_limited) либо исчерпан суточный предел документов ключа (document_quota_exceeded). Задержка до повтора — в заголовке Retry-After