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

Изменить карточку покупателя

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

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

Правит реквизиты уже заведенного контрагента. Присланные поля перезаписываются, отсутствующие сохраняют прежнее значение; очистить необязательный реквизит можно пустой строкой.

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

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

    id покупателя

Заголовки

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

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

Тело запроса

Формат — application/json.

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

    Адрес доставки по умолчанию.

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

    Юридический адрес.

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

    Страна, ISO-3166-1 alpha-2.

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

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

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

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

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

    Наименование под УПД.

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

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

Ответы

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