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

Свой порог продавца

GET /api/v1/papers

Область ключа: documents · только чтение

Что заполнено и что мешает выйти на витрину: ник, оферта, статус с ИНН, сверка наименования по реестру, реквизиты выплат, согласие на передачу данных в банк. Номер счёта отдаётся только последними четырьмя знаками.

Тестовой учётной записи бумаги не нужны: у неё порог считается закрытым без документов — ровно для этого признак и заведён.

Согласие на передачу данных в банк — единственное в пороге, чего ключ не сделает: пути для него нет и не будет. Закон требует оформлять согласие отдельно от других документов, и документ согласия прямо говорит, что через API его дать нельзя. Даётся отметкой в кабинете.

Поля ответа

Поле	Тип	Что это
`nickname`	`string\|null`	Ник, который видит покупатель.
`sellerType`	`string\|null`	ooo, ip или self_employed.
`inn`	`string\|null`	Налоговый номер, как он записан.
`offerAcceptedAt`	`string\|null`	Когда принята оферта продавца.
`registry`	`object`	Сверка с реестром: найденное наименование, когда проверяли, подтверждено ли, и код причины, если не сошлось.
`payout`	`object`	Реквизиты: способ, последние четыре знака счёта, БИК, получатель, заполнено ли всё.
`bankConsent`	`object`	Согласие на передачу данных в банк: нужно ли оно (самозанятому и ИП — да), дано ли в действующей редакции, с какой редакцией и когда дано, когда отозвано. Только на чтение.
`listable`	`boolean`	Пускают ли карточки на витрину прямо сейчас.

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

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

Код	Что случилось и что делать
`not_found`	Записи нет или она не ваша. Условие владения стоит в самом запросе к базе, поэтому чужая запись выглядит как отсутствующая.

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

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