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

Изменить карточку поставщика

PATCH https://mrp.zolotenkov.ru/api/external/v1/suppliers/{id}

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

Правит реквизиты уже заведенного контрагента. Присланные поля перезаписываются, отсутствующие сохраняют прежнее значение; очистить необязательный реквизит можно пустой строкой. Мягко удаленный поставщик (ZOL-8330) не правится: он отвечает 404, как и чужой.

Параметры пути

  • id целое число обязателен

    id поставщика

Заголовки

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

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

Тело запроса

Формат — application/json.

  • address строка необязателен может быть пустым
  • currency строка необязателен может быть пустым
  • email строка необязателен может быть пустым
  • inn строка необязателен может быть пустым
  • kpp строка необязателен может быть пустым
  • name строка необязателен может быть пустым
  • notes строка необязателен может быть пустым
  • phone строка необязателен может быть пустым

Ответы

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