Создать черновик платёжного реестра

POST

https://business.tbank.ru/openapi/api/v1/self-employed/payment-registry/create

Метод для создания черновика платёжного реестра.

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

Вы можете добавлять в реестр самозянятых, которые находятся в статусах ACTIVE и FIRED.

Чтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/payment-registry/manage — Добавление и получение информации о платёжных реестрах по самозанятым компании с ИНН {inn} и КПП {kpp}.

Ограничение на использование метода — 1 запрос в секунду.

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

correlationId

String<uuid>

Идентификатор, связывающий запрос создания с запросом получения ответа.

companyAccountNumber

String

Номер счёта компании, с которого будут списаны деньги для оплаты реестра — при наличии РКО в Т-Банке.
Если номер счёта не передан, средства спишутся с основного счёта компании.

registryCreateType

String (SelfEmployedRegistryCreateTypeRequest)

Requirements: [IGNORE_ERRORS, FAIL_ERRORS]

Может принимать одно из двух значений:

IGNORE_ERRORS — реестр будет создан из всех корректных платежей, его идентификатор вернётся в поле paymentRegistryId метода Получить результат создания черновика платёжного реестра. Если корректных платежей нет, реестр не создастся.
FAIL_ERRORS — если есть ошибочные платежи, реестр не создастся.

Значение по умолчанию — FAIL_ERRORS.

payments

Array of objects ()

Список платежей внутри реестра.

Required

number

Integer<int32>

Идентификатор платежа на стороне клиента.

Required

accountNumber

String

Номер счёта самозанятого.

Required

paymentPurpose

String

Назначение платежа.

Required

selfEmployedInfo

Object

Данные самозанятого.

Required

firstName

String

Имя (кириллица).

Required

lastName

String

Фамилия (кириллица).

middleName

String

Отчество (кириллица).

Required

sum

Number

Сумма платежа в рублях.

revenueTypeCode

String

Requirements: [1, 2, 3, 4, 5]

Код вида дохода.

collectionAmount

Number

taxHolding

Boolean

true — Т-Банк переведёт 6% от суммы платежа на налоговую копилку для последующей оплаты налогов;
false — самозанятый получит полную сумму и налог удержан не будет.

Значение по умолчанию — false.

incomeType

String (SelfEmployedIncomeType)

Requirements: [FROM_LEGAL_ENTITY, FROM_INDIVIDUAL]

Может принимать одно из двух значений:

FROM_LEGAL_ENTITY — самозанятые получают доход от юридического лица;
FROM_INDIVIDUAL — самозанятые получают доход от физического лица.

Значение по умолчанию — FROM_LEGAL_ENTITY.

Ответ

200

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Обратиться в поддержку

Получить консультацию по интеграции