Platitun · API · Документы и реквизиты · Подтвердить наименование

Подтвердить наименование

POST /api/v1/papers/registry-confirm

Область ключа: documents · изменяет данные, нужен заголовок Idempotency-Key

Вы подтверждаете, что найденное в реестре наименование — ваше. До подтверждения порог не закрыт. Сменили номер — подтверждать надо заново: иначе чужое наименование считалось бы подтверждённым с прошлого раза.

Поля ответа

Поле	Тип	Что это
`confirmed`	`boolean`	Подтверждено.
`already`	`boolean`	Было подтверждено и раньше: повтор не ошибка, но и не новое событие.

Поводы отказа

Отказ по правилам приходит как {"error":"rejected","refusal":{"kind":"…"}} с кодом 409. Общие для всех путей отказы — в разделе правил.

Код	Что случилось и что делать
`registry_nothing_to_confirm`	Подтверждать нечего: наименование в реестре ещё не найдено. Сначала задайте статус и номер.

Рядом в этом разделе

GET /api/v1/papers — Свой порог продавца
PUT /api/v1/papers/nickname — Ник продавца
POST /api/v1/papers/offer — Принять оферту продавца
PUT /api/v1/papers/status — Статус и налоговый номер
PUT /api/v1/papers/payout — Реквизиты выплат