Platitun · API · Документы и реквизиты · Статус и налоговый номер

Статус и налоговый номер

PUT /api/v1/papers/status

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

Наименование организации от запроса НЕ принимается вовсе: площадка достаёт его из реестра по номеру, а вы подтверждаете, что это вы. Так ловятся и опечатка в цифре, и чужой номер.

Закрытый или приостановленный администратором продавец НЕ снимает запрет сам — ни кнопкой, ни программой: реестр подтверждает существование организации, а не право торговать здесь.

У РАБОТАЮЩЕГО продавца неудачная сверка прежние данные НЕ трогает: в отказе будет keptPrevious=true, торговля продолжается, а заявка уходит администратору. Опечатка в одной цифре не должна стоить витрины.

Поля запроса

Поле	Тип	Что это
`sellerType` обязательно	`string`	ooo, ip или self_employed.
`inn` обязательно	`string`	Налоговый номер: десять знаков у ООО, двенадцать у остальных. Проверяется контрольной суммой.

Поля ответа

Поле	Тип	Что это
`registryName`	`string`	Наименование, найденное в реестре.
`needsConfirm`	`boolean`	Надо ли подтвердить наименование. Пока не подтверждено — порог не закрыт и товар на витрину не выйдет.

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

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

Код	Что случилось и что делать
`choose_status`	Статус должен быть одним из: ooo, ip, self_employed.
`inn_bad_ooo`	Налоговый номер организации — десять знаков и должен сходиться по контрольной сумме.
`inn_bad_person`	Налоговый номер человека — двенадцать знаков и должен сходиться по контрольной сумме.
`blocked_cannot_self_restore`	Закрытый или приостановленный администратором продавец не снимает запрет сам. Напишите в поддержку.
`registry_failed`	Сверка с реестром не сошлась. Внутри отказа названы повод и, если запись закрыта, её дата. У работающего продавца прежние данные при этом сохранены — смотрите keptPrevious.

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

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