Зарегистрировать доход самозанятого

/api/v1/self-employed/taxpayers/{inn}/receipts

POST

https://secured-openapi.tbank.ru/api/v1/self-employed/taxpayers/{inn}/receipts

Метод для регистрации дохода самозанятого в налоговой, если он подключён к Т-Банку.

⚠️ Вызовы метода платные. Чтобы ознакомиться с тарифами, напишите на smz_fns_team@tinkoff.ru.

Чтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/taxpayers/create-receipt — Зарегистрировать доход самозанятого.

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

Авторизация

Security

Bearer API Token

MTLS-сертификат

Запрос

Path parameters

Required

inn

String

Requirements: Value must match regular expression ^(\d{12})$

ИНН

Header parameters

Required

Idempotency-Key

String<uuid>

Ключ идемпотентности. Подробнее.

Request body schema application/json

oneOf

CreateForeignAgencyReceiptRequest

Required

incomeType

String

Requirements: [FROM_INDIVIDUAL, FROM_LEGAL_ENTITY, FROM_FOREIGN_AGENCY]

От кого самозанятый получил доход:

• FROM_INDIVIDUAL — от физического лица;
• FROM_LEGAL_ENTITY — от компании;
• FROM_FOREIGN_AGENCY — от иностранной компании.

incomeReceivedAt

String<date-time>

Дата и время получения дохода в UTC. Ожидается в ISO-8601 формате yyyy-MM-ddTHH:mm<.fff>, где:

• HH — часы в 24-часовой нотации. Допускаются значения от 00 до 23.
• .fff — опциональная часть, содержащая доли секунд. Допускается не больше трёх знаков.
• TZDSuffix — опциональный суффикс. Допускается значение Z или +00:00.

services

Array of objects ()

Список услуг.

Required

name

String

Название услуги.

Required

price

Number

Цена.

Required

customerOrganization

String

Название организации, которой самозанятый оказывал услуги.

CreateIndividualReceiptRequest

Required

incomeType

String

Requirements: [FROM_INDIVIDUAL, FROM_LEGAL_ENTITY, FROM_FOREIGN_AGENCY]

От кого самозанятый получил доход:

• FROM_INDIVIDUAL — от физического лица;
• FROM_LEGAL_ENTITY — от компании;
• FROM_FOREIGN_AGENCY — от иностранной компании.

incomeReceivedAt

String<date-time>

Дата и время получения дохода в UTC. Ожидается в ISO-8601 формате yyyy-MM-ddTHH:mm<.fff>, где:

• HH — часы в 24-часовой нотации. Допускаются значения от 00 до 23.
• .fff — опциональная часть, содержащая доли секунд. Допускается не больше трёх знаков.
• TZDSuffix — опциональный суффикс. Допускается значение Z или +00:00.

services

Array of objects ()

Список услуг.

Required

name

String

Название услуги.

Required

price

Number

Цена.

CreateLegalEntityReceiptRequest

Required

incomeType

String

Requirements: [FROM_INDIVIDUAL, FROM_LEGAL_ENTITY, FROM_FOREIGN_AGENCY]

От кого самозанятый получил доход:

• FROM_INDIVIDUAL — от физического лица;
• FROM_LEGAL_ENTITY — от компании;
• FROM_FOREIGN_AGENCY — от иностранной компании.

incomeReceivedAt

String<date-time>

Дата и время получения дохода в UTC. Ожидается в ISO-8601 формате yyyy-MM-ddTHH:mm<.fff>, где:

• HH — часы в 24-часовой нотации. Допускаются значения от 00 до 23.
• .fff — опциональная часть, содержащая доли секунд. Допускается не больше трёх знаков.
• TZDSuffix — опциональный суффикс. Допускается значение Z или +00:00.

services

Array of objects ()

Список услуг.

Required

name

String

Название услуги.

Required

price

Number

Цена.

Required

customerInn

String

Requirements: Value must match regular expression ^(\d{10})$

ИНН покупателя-компании.

Required

customerOrganization

String

Название организации, которой самозанятый оказывал услуги.

Ответ

200

OK

400

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

401

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

403

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

422

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

429

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

500

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

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

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

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

Loading...