openapi: "3.0.1"
info:
title: "T-API"
license:
name: "Apache 2.0"
version: "1.0"
x-logo:
url: "https://business.t-static.ru/static/projects/openapi/logo.svg"
backgroundColor: "#616871"
externalDocs:
description: "T-API"
url: "https://developer.tbank.ru/docs/api"
tags:
- name: "T-Business ID. Информация о компании"
description: "Методы для получения данных о компании и ее реквизитов."
x-parent-tag: "T-ID"
- name: "T-ID. Информация о пользователе"
description: "Методы принадлежат API T-ID и нужны для получения информации о физ\
ических лицах. Доступно только для партнерской интеграции.\n\n## Получение уче\
тных данных\n\nПользователь должен дать согласие на предоставление следующих д\
анных: «Полное имя», «email», «Номер телефона». Перечень `scopes` у токена для\
\ получения учетных данных:\n* profile;\n* phone;\n* email.\n\n### Входные пар\
аметры\n\n* Заголовок `Authorization = Bearer \\\\{access_token}`.\n* Поля фор\
мы `application/x-www-form-urlencoded`:\n* `client_id` — ID клиента;\n* `client_secret`\
\ — пароль клиента.\n\n### Формат ответа\n\nОтвет метода представлен в формате\
\ `application/json`. Поля JSON-документа зависят от scopes, нефиксированный с\
писок:\n\n* `sub` — идентификатор авторизированного пользователя;\n* `name` —\
\ фамилия, имя;\n* `gender` — пол;\n* `birthdate` — дата рождения в формате `yyyy-mm-dd`;\n\
* `family_name` — фамилия;\n* `given_name` — имя;\n* `middle_name` — отчество\
;\n* `phone_number` — телефон в формате `+ (международный идентификатор страны\
)(номер абонента)`;\n* `email` — адрес электронной почты.\n\n#### Пример запро\
са\n\nPOST https://id.tbank.ru/userinfo/userinfo
\n\n\n#### Пример\
\ ответа\n\n {`\"email\": \"tbank@mail.ru\", \"email_verified\": false,\
\ \"family_name\": \"Иванов\", \"birthdate\": \"2000-01-01\", \"sub\": \"923d4812-148c-45v4-a56b-eed15cdd2857\"\
, \"name\": \"Иванов Олег\", \"gender\": \"male\", \"phone_number\": \"+79998887766\"\
, \"phone_number_verified\" : true, \"middle_name\": \"Юрьевич\", \"given_name\"\
: \"Олег\"`}
"
x-parent-tag: "T-ID"
- name: "T-ID. Делегированная идентификация"
description: "Методы для проверки информации о физическом лице по 115 ФЗ."
x-parent-tag: "T-ID"
- name: "Счета и выписки"
description: "Методы для получения выписок и информации по расчетным и инвестици\
онным счетам организаций."
- name: "Платежи"
description: "Методы для совершения платежей, создания черновиков, платежных пор\
учений и платежей через СБП."
- name: "Зарплатный проект"
description: "Методы для перевода денег сотрудникам и выпуска зарплатных карт."
- name: "Выплаты самозанятым"
description: "Методы для работы с выплатами самозанятым — добавление самозанятых\
\ по реквизитам, создание черновиков анкет и платежных реестров, подписание и\
\ оплата реестров, получение информации о самозанятых.\n\nПеред интеграцией ре\
комендуем изучить сценарии использования методов и последовательность их вызов\
а. Подробнее."
- name: "Самозанятые"
description: "Методы для работы с самозанятыми — привязка самозанятых к Т-Банку\
, проверка статуса, формирование чеков и выполнение других операций от имени с\
амозанятого в налоговой.\n\nВызовы методов [Аннулировать доход самозанятого](/docs/api/post-api-v-1-self-employed-taxpayers-inn-receipts-receiptid-cancel),\
\ [Зарегистрировать доход самозанятого](/docs/api/post-api-v-1-self-employed-taxpayers-inn-receipts)\
\ и [Отправить запрос на подключение самозанятого к Т-Банку](/docs/api/post-api-v-1-self-employed-taxpayers-inn-bind)\
\ платные. Чтобы ознакомиться с тарифами, напишите на [smz_fns_team@tbank.ru](mailto:smz_fns_team@tbank.ru)."
- name: "Выставление счетов"
description: "Методы для работы с выставленными счетами."
- name: "Номинальные счета"
description: "Методы для работы с номинальными счетами."
- name: "Безакцептные списания"
description: "Методы для работы с безакцептными списаниями."
- name: "Специальные счета"
description: "Методы для работы со специальными счетами — тендерными, номинальны\
ми и так далее: получение информации по картотекам, блокировкам, картотекам ЭТ\
П (электронная торговая площадка) и списаниям в бюджет."
- name: "Безопасная сделка"
description: "Методы для поддержания процесса безопасной сделки. Доступно только\
\ в Self-сценарии."
- name: "Торговый эквайринг"
description: "Методы для получения подробной информации по операциям в терминале\
.\n\n\nТорговый эквайринг — услуга банка по приему безналичной оплаты в торгов\
ой точке."
- name: "Проверка контрагентов"
description: "Методы для получения информации о любых юридических лицах и ИП, ко\
гда-либо существовавших в России, по данным из открытых источников — ФНС, СПАР\
К, Госзакупки, ФССП.\n\nЕсли данные неточные, напишите в поддержку Т-Бизнеса."
- name: "Бизнес-карты"
description: "Методы для получения данных по картам компании и установки по ним\
\ лимитов."
- name: "Удаленная идентификация сотрудников"
description: "Методы предназначены для проведения удаленной идентификации сотруд\
ников компании-клиента Т-Бизнеса — без очной встречи с представителем банка.\n\
\n\nДля проведения удаленной идентификации создается заявка, к которой прикреп\
ляются необходимые копии документов — например, скан паспорта.\nПосле этого по\
дготовленную заявку можно использовать в целевом действии,\nдля которого нужен\
\ идентифицированный сотрудник — например, выпуск для него виртуальной бизнес\
-карты.\n\n\nУдаленная идентификация не имеет ценности сама по себе, поэтому з\
аявка запускается в работу в рамках целевого действия."
- name: "Рейтинги продуктов"
description: "Методы для пагинированного получения рейтингов на товары."
- name: "Корзина. Работа с заказом"
description: "Методы для работы с заказами в системе Корзина."
- name: "Кредитные продукты"
description: "Методы для работы с универсальным кредитным адаптером банка."
- name: "Интернет-эквайринг. Диспуты"
description: "Методы для обмена информацией по оспариваемым операциям между банк\
ом и компанией.\n\nДиспут (опротестование) — процесс оспаривания операции клие\
нтом или банком в соответствии с [порядком проведения претензионной работы](https://acdn.tinkoff.ru/static/documents/18e1262d-051a-4e99-b5e1-b8879b4437cc.pdf)."
- name: "Партнерская доставка"
description: "Методы для создания задания представителю Т-Банка: удостоверить ли\
чность, сделать фотографии документов, провести опрос, доставить и активироват\
ь продукты.\n\n\nДоступно только для прямой интеграции.\n\n\nЧтобы подключитьс\
я к линии доставки Т-Банка, напишите на openapi@tinkoff.ru."
- name: "Декларации 3-НДФЛ"
description: "Методы для получения данных, которые нужны партнеру для формирован\
ия налоговой декларации по форме 3-НДФЛ. Для работы с методами нужен уникальны\
й идентификатор заявки — `taxRequestId` (UUID)."
- name: "T-ID"
description: "T-ID — единая точка авторизации для всего Т-Банка, которая упрощае\
т пользователям вход на ваш сайт и в приложение."
- name: "Бенефициары и реквизиты"
description: "Методы для работы с бенефициарами и реквизитами бенефициаров. Дост\
упно для Self-сценария. \n\n\nВажно:\n* Если бенефициар участвует в нескольких\
\ сделках, его данные нужно добавить только 1 раз\n — даже если сделки соверша\
ются в рамках нескольких номинальных счетов.\n* Первые указанные реквизиты бен\
ефициара считаются реквизитами по умолчанию и\n подставляются в сделках автома\
тически.\n* Если вам нужно использовать другие реквизиты, создайте новые и ука\
жите ID этих реквизитов\n у реципиента на этапе сделки.\nЧтобы установить эти\
\ реквизиты как реквизиты по умолчанию, используйте метод\n [Установить банков\
ские реквизиты бенефициара по умолчанию](/docs/api/post-api-v-1-nominal-accounts-beneficiaries-beneficiaryid-bank-details-bankdetailsid-set-default).\n\
\ Если владелец денежных средств меняется, но их нужно оставить на номинальном\
\n счете, вы можете перевести денежные средства на виртуальный счет. Для этого\
\ используйте метод [Создать реципиента в этапе сделки](/docs/api/post-api-v-1-nominal-accounts-deals-dealid-steps-stepid-recipients):\n\
\ в параметре `keepOnVirtualAccount` передайте `true`.\n\n\n\n ⚠️ Если вы испо\
льзуете управление расчетами через номинальные счета, пользоваться другими кан\
алами вывода средств с номинальных счетов — например, личный кабинет, метод пл\
атежа — нельзя.\n Если использовать другие способы, биллинг с учетом средств н\
а виртуальных счетах будет работать некорректно.\n"
x-parent-tag: "Номинальные счета"
- name: "Биллинг"
description: "Методы для работы с номинальными счетами — идентификация пополнени\
й, просмотр остатков и холдов на виртуальных счетах бенефициаров, контроль вып\
олнения операций по сделкам и выплаты с виртуальных счетов на реальные счета б\
ез создания сделок.\n\nОграничение на использование методов — 10 запросов в се\
кунду.\n\nЕсли вы управляете расчетами через номинальные счета, пользоваться д\
ругими каналами вывода средств с номинальных счетов — например, личный кабинет\
\ или метод платежа — нельзя. Если использовать другие способы, биллинг с учет\
ом средств на виртуальных счетах будет работать некорректно."
x-parent-tag: "Номинальные счета"
- name: "Депоненты и реципиенты"
description: "Методы для управления отправителями — депонентами (deponents) и по\
лучателями денежных средств — реципиентами (recipients). Доступно для Self-сце\
нария. \n\n\nВажно:\n* В рамках сделки и этапа может быть несколько отправител\
ей (deponents) и несколько получателей (recipients).\n* Прикрепить одного и то\
го же бенефициара в рамках одного этапа как отправителя (deponent) больше\nодн\
ого раза не получится.\n* Прикрепить одного и того же бенефициара в рамках одн\
ого этапа как получателя (recipient) больше\nодного раза — можно.\n* Идентифик\
ация получателя происходит по ID реципиента (`recipientId`), отправителя — по\
\ ID бенефициара (`beneficiaryId`).\n\n\n\n ⚠️ Если вы используете управление\
\ расчетами через номинальные счета, пользоваться другими каналами вывода сред\
ств с номинальных счетов — например, личный кабинет, метод платежа — нельзя.\n\
\ Если использовать другие способы, биллинг с учетом средств на виртуальных сч\
етах будет работать некорректно.\n"
x-parent-tag: "Номинальные счета"
- name: "Налоговые консультации"
description: "Методы для получения данных, которые нужны партнеру для предоставл\
ения налоговой консультации по вопросу клиента. Для работы с методами нужен ун\
икальный идентификатор заявки — `taxRequestId` (UUID)."
- name: "Партнерские методы для работы с заявкой на выдачу кредита наличными"
description: "Методы для работы с заявкой на на выдачу кредита наличными."
- name: "Партнерские методы для работы с заявкой на покупку в кредит (Prod)"
description: "Методы для работы с заявкой на покупку в кредит в точках продаж."
- name: "Партнерские методы для работы с заявкой на покупку в кредит (Test)"
description: "Демо-методы для тестирования работы с заявкой на пос-кредит в точк\
ах продаж."
- name: "Платежные требования"
description: "Методы для работы с платежными требованиями — создание, получение\
\ списка платежных требований и деталей, отзыв.\n\nПлатежное требование — это\
\ платежный документ, по которому происходит списание денежных средств по треб\
ованию получателя со счета плательщика, в том числе безакцептное."
x-parent-tag: "Безакцептные списания"
- name: "Правила"
description: "Методы для работы с платежными правилами. Доступно для прямой инте\
грации.\n\nПлатежное правило — это принцип, по которому происходит автоматичес\
кое списание денежных средств с плательщика."
x-parent-tag: "Безакцептные списания"
- name: "Соглашения"
description: "Методы для работы с соглашениями о безакцептном списании. Доступно\
\ для прямой интеграции.\n\nБезакцептное списание — это списание денег со счет\
а плательщика без его дополнительного подтверждения в рамках соглашения о зара\
нее данном акцепте.\n\nЕсли вы хотите использовать безакцептные списания со сч\
етов контрагентов, перед началом работы с методами убедитесь, что вы согласова\
ли шаблон соглашения с банком и выбрали счет, на который хотите получать деньг\
и. С этим поможет менеджер в чате.\n\nСоглашение о безакцептном списании — это\
\ юридическое основание для безакцептного списания. В соглашении плательщик за\
ранее дает свое согласие на последующие списания с его счета без дополнительно\
го подтверждения. Соглашение можно заключить как по стандартному шаблону, кото\
рый предлагает банк, так и изменить шаблон под потребности получателя денег. П\
олучатель денег может встроить в свой интерфейс функционал для быстрого подпис\
ания контрагентами своего шаблона соглашения.\n\nЕсли у вас есть вопросы или п\
редложения, напишите на [non_acceptance_debiting@tbank.ru](mailto:non_acceptance_debiting@tbank.ru)."
x-parent-tag: "Безакцептные списания"
- name: "Управление сделками"
description: "Методы для работы с номинальными счетами — управление сделками (CRUD).\n\
\nОграничение на использование методов — 10 запросов в секунду.\n\n[Пример раб\
оты со сделками и этапами](https://business.t-static.ru/static/images/opensme/nominal-accounts/deal-flow.svg)\n\
\nЕсли вы управляете расчетами через номинальные счета, пользоваться другими к\
аналами вывода средств с номинальных счетов — например, личный кабинет или мет\
од платежа — нельзя. Если использовать другие способы, биллинг с учетом средст\
в на виртуальных счетах будет работать некорректно."
x-parent-tag: "Номинальные счета"
- name: "Управление этапами сделок"
description: "Методы для работы с номинальными счетами — управление этапами сдел\
ок (CRUD).\n\nОграничение на использование методов — 10 запросов в секунду.\n\n\
[Пример работы со сделками и этапами](https://business.t-static.ru/static/images/opensme/nominal-accounts/deal-flow.svg)\n\
\nВажно:\n\n* Если платеж не может быть выплачен, статус этапа переходит в `PAYMENT_FAILED`.\
\ На этом статусе этапа можно изменить реквизиты получателя денежных средств —\
\ реципиента — через метод [Обновить банковские реквизиты у реципиента в этапе\
\ сделки](/docs/api/post-api-v-1-nominal-accounts-deals-dealid-steps-stepid-recipients-recipientid-update-bank-details).\n\
\n* Отменить эту сделку нельзя — при попытке совершения платежа на реальный сч\
ет мы считаем, что деньги уже принадлежат получателю и должны быть выплачены е\
му в каком-либо виде. Если деньги должны остаться на номинальном счете, в мето\
де [Создать реципиента на этапе сделки](/docs/api/post-api-v-1-nominal-accounts-deals-dealid-steps-stepid-recipients)\
\ в реквизитах реципиента передайте `keepOnVirtualAccount = true`.\n\nЕсли вы\
\ управляете расчетами через номинальные счета, пользоваться другими каналами\
\ вывода средств с номинальных счетов — например, личный кабинет или метод пла\
тежа — нельзя. Если использовать другие способы, биллинг с учетом средств на в\
иртуальных счетах будет работать некорректно."
x-parent-tag: "Номинальные счета"
paths:
/api/clfm/create:
post:
tags:
- "Партнерские методы для работы с заявкой на выдачу кредита наличными"
summary: "Получить данные о клиенте и создать заявку"
description: "Синхронный метод для предоставления данных о клиенте — по этим\
\ данным будет создана\nзаявка. \n\nВ ответе возвращаются ссылка и идентиф\
икатор заявки — по этой ссылке партнер направляет клиента и запускает проц\
есс \nвыдачи с нашей стороны.\n"
operationId: "postApiV1ClfmAppCreate"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
content:
application/json:
schema:
type: "object"
properties:
fio:
type: "object"
properties:
lastName:
type: "string"
description: "Фамилия клиента."
format: "string"
firstName:
type: "string"
description: "Имя клиента."
format: "string"
middleName:
type: "string"
description: "Отчество клиента."
format: "string"
description: "ФИО клиента."
birthDate:
type: "string"
description: "Дата рождения клиента в формате `yyyy-MM-dd`."
format: "date"
phone:
pattern: "\\+\\d*"
type: "string"
description: "Номер телефона клиента в международном формате."
format: "string"
example: "+79631111112"
email:
type: "string"
description: "Электронная почта клиента."
format: "email"
required: true
responses:
"200":
description: "Заявка создана"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "id"
- "url"
type: "object"
properties:
id:
type: "string"
description: "Уникальный идентификатор созданной заявки."
format: "string"
url:
type: "string"
description: "Ссылка на созданную заявку. По ней нужно направи\
ть клиента, чтобы начать процесс выдачи."
format: "url"
description: "Успешный ответ"
example:
id: "02xHUBXDYZSMwIlgJhYYz8CLM"
url: "https://forma.tbank.ru/cashloan/applications/02xHUBXDYZSMwIlgJhYYz8CLM"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
INVALID_JSON:
summary: "Некорректный JSON"
value:
errorId: "8f8cb741-a07d-41ea-b2b0-2617937f54e7"
errorMessage: "Получен некорректный JSON."
errorCode: "INVALID_JSON"
INVALID_PHONE:
summary: "Неверный формат номера телефона"
value:
errorId: "c584b8c6-0e78-49e2-8647-69a2751dd035"
errorMessage: "Ошибка валидации. Неверный формат номера телефо\
на."
errorCode: "INVALID_PHONE"
errorDetails:
phone: "Неверный формат номера телефона. Используйте междуна\
родный формат."
INVALID_BIRTHDATE:
summary: "Неверный формат даты рождения"
value:
errorId: "0f79caf4-06d0-4c9b-89ad-55f3b4ba4ba0"
errorMessage: "Ошибка валидации. Неверный формат даты рождения\
."
errorCode: "INVALID_BIRTHDATE"
errorDetails:
birtDate: "Неверный формат даты рождения. Используйте `yyyy-MM-dd`."
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/clfm/demo:
post:
tags:
- "Партнерские методы для работы с заявкой на выдачу кредита наличными"
summary: "Получить данные о клиенте и создать демо-заявку"
description: " Синхронный метод для проверки корректности интеграции, аналог\
ичен методу Получить да\
нные о клиенте и создать заявку. Создает «прозрачную» для продуктового\
\ процесса заявку."
operationId: "postApiV1ClfmAppDemo"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
content:
application/json:
schema:
type: "object"
properties:
fio:
type: "object"
properties:
lastName:
type: "string"
description: "Фамилия клиента."
format: "string"
firstName:
type: "string"
description: "Имя клиента."
format: "string"
middleName:
type: "string"
description: "Отчество клиента."
format: "string"
description: "ФИО клиента."
birthDate:
type: "string"
description: "Дата рождения клиента в формате `yyyy-MM-dd`."
format: "date"
phone:
pattern: "\\+\\d*"
type: "string"
description: "Номер телефона клиента в международном формате."
format: "string"
example: "+79631111112"
email:
type: "string"
description: "Электронная почта клиента."
format: "email"
required: true
responses:
"200":
description: "Заявка создана"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "id"
- "url"
type: "object"
properties:
id:
type: "string"
description: "Уникальный идентификатор созданной заявки."
format: "string"
url:
type: "string"
description: "Ссылка на созданную заявку. По ней нужно направи\
ть клиента, чтобы начать процесс выдачи."
format: "url"
description: "Успешный ответ"
example:
id: "02xHUBXDYZSMwIlgJhYYz8CLM"
url: "https://forma.tbank.ru/cashloan/applications/02xHUBXDYZSMwIlgJhYYz8CLM"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
INVALID_JSON:
summary: "Некорректный JSON"
value:
errorId: "8f8cb741-a07d-41ea-b2b0-2617937f54e7"
errorMessage: "Получен некорректный JSON."
errorCode: "INVALID_JSON"
INVALID_PHONE:
summary: "Неверный формат номера телефона"
value:
errorId: "c584b8c6-0e78-49e2-8647-69a2751dd035"
errorMessage: "Ошибка валидации. Неверный формат номера телефо\
на."
errorCode: "INVALID_PHONE"
errorDetails:
phone: "Неверный формат номера телефона. Используйте междуна\
родный формат."
INVALID_BIRTHDATE:
summary: "Неверный формат даты рождения"
value:
errorId: "0f79caf4-06d0-4c9b-89ad-55f3b4ba4ba0"
errorMessage: "Ошибка валидации. Неверный формат даты рождения\
."
errorCode: "INVALID_BIRTHDATE"
errorDetails:
birtDate: "Неверный формат даты рождения. Используйте `yyyy-MM-dd`."
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/offline/partners/v1/create:
post:
tags:
- "Партнерские методы для работы с заявкой на покупку в кредит (Prod)"
summary: "Создать новую заявку"
description: "Метод создает кредитную заявку в системе Т-Банк Кредит Брокер\
.\n\nВ ответе возвращается ссылка с ссылочной авторизацией для продолжения\
\ заявочного процесса внутри личного кабинета агента."
operationId: "createTcbAppV1"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
content:
application/json:
schema:
required:
- "orderNumber"
- "type"
type: "object"
properties:
agentLogin:
pattern: "^[9]{1}[0-9]{9}$"
type: "string"
description: "Номер телефона агента, под которым он заведен в TCB."
orderNumber:
maxLength: 50
minLength: 1
type: "string"
description: "Номер заказа на стороне продавца."
format: "string"
order:
required:
- "items"
type: "object"
properties:
firstPayment:
minimum: 0
type: "integer"
description: "Первоначальный взнос."
format: "int32"
items:
maxItems: 99
minItems: 1
type: "array"
items:
required:
- "name"
- "price"
- "quantity"
type: "object"
properties:
name:
maxLength: 255
minLength: 1
type: "string"
description: "Наименование товара."
format: "string"
quantity:
minimum: 0
type: "integer"
description: "Количество товара."
format: "int32"
price:
minimum: 0
type: "number"
description: "Стоимость 1 единицы товара."
format: "double"
externalId:
minLength: 1
type: "string"
description: "Идентификатор товара."
format: "string"
description: "Товары в корзине."
description: "Модель заказа клиента в запросе создания заявки."
type:
required:
- "isCreditCard"
- "isPos"
type: "object"
properties:
isPos:
type: "boolean"
description: "Флаг отправки заявки на POS-кредит."
format: "boolean"
isCreditCard:
type: "boolean"
description: "Флаг отправки заявки на кредитную карту."
format: "boolean"
description: "Объект с информацией по запрашиваемым продуктам."
isCallSigning:
type: "boolean"
description: "Флаг телефонного заполнения. По умолчанию — `false`."
format: "boolean"
isOnlyCredit:
type: "boolean"
description: "Флаг отключения рассрочек, возможно оформление тол\
ько кредитов. По умолчанию — `false`."
format: "boolean"
values:
type: "object"
properties:
contact:
type: "object"
properties:
fio:
required:
- "firstName"
- "lastName"
type: "object"
properties:
firstName:
pattern: "^[а-яА-ЯёЁ\\-\\s]{1,}$"
type: "string"
description: "Имя клиента."
format: "string"
lastName:
pattern: "^[а-яА-ЯёЁ\\-\\s]{1,}$"
type: "string"
description: "Фамилия клиента."
format: "string"
middleName:
pattern: "^[а-яА-ЯёЁ\\-\\s]{1,}$"
type: "string"
description: "Отчество клиента."
format: "string"
description: "ФИО клиента."
mobilePhone:
pattern: "^[9]{1}[0-9]{9}$"
type: "string"
description: "Номер телефона клиента."
birthDate:
type: "string"
description: "Дата рождения клиента."
format: "date"
isResident:
type: "boolean"
description: "Флаг резидента РФ."
format: "boolean"
description: "Модель данных клиента."
description: "Данные клиента."
webhookURL:
pattern: "^https?:\\/\\/(?:www\\.)?[-a-zA-Z0-9@:%._\\+~#=]{1,256}\\\
.[a-zA-Z0-9()]{1,6}\\b(?:[-a-zA-Z0-9()@:%_\\+.~#?&\\/=]*)$"
type: "string"
description: "URL для отправки вебхуков. Если не указан, использ\
уется URL из настроек точки."
format: "url"
pointId:
maxLength: 50
minLength: 1
type: "string"
description: "Внешний идентификатор точки."
format: "string"
companyId:
maxLength: 100
minLength: 1
type: "string"
description: "Внешний идентификатор компании."
format: "string"
agentId:
maxLength: 100
minLength: 1
type: "string"
description: "Внешний идентификатор агента."
format: "string"
creditCards:
type: "object"
additionalProperties:
required:
- "ean"
type: "object"
properties:
ean:
maxLength: 13
pattern: "^\\d{13}$"
type: "string"
description: "Штрихкод кредитной карты. Допускаются только\
\ цифры."
format: "string"
description: "Объект с кредитными картами."
example:
skb-card:
ean: 123456789101
kvk-card:
ean: 123456789101
description: "Модель запроса на создание заявки"
required: true
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "id"
- "link"
type: "object"
properties:
id:
type: "string"
description: "ID заявки в системе TCB."
format: "uuid"
link:
type: "string"
description: "Ссылка для перехода в личный кабинет TCB."
format: "url"
example:
id: "21dc246d-ff4b-451b-a1f6-c746579bfb26"
link: "https://forma.tbank.ru/auth/authorize?auth_token={access_token}&redirect_uri={redirectUrl}&client_id=tcb&response_type=code"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при некорректном запросе:
value:
errorId: "170e4a82-9c62-4fb0-8055-45e810630754"
errorMessage: "Выберите хотя бы один тип заявки."
errorCode: "INVALID_REQUEST"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка авторизации агента:
value:
errorId: "170e4a82-9c62-4fb0-8055-45e810630754"
errorMessage: "Агент не имеет достаточно прав для создания зая\
вок на текущей компании. Обратитесь в поддержку брокера."
errorCode: "AUTH_FORBIDDEN"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/offline/partners/v1/demo/create:
post:
tags:
- "Партнерские методы для работы с заявкой на покупку в кредит (Test)"
summary: "Создать новую заявку"
description: "Метод создает кредитную заявку в системе Т-Банк Кредит Брокер\
.\n\nВ ответе возвращается ссылка с ссылочной авторизацией для продолжения\
\ заявочного процесса внутри личного кабинета агента."
operationId: "createTcbAppV1Demo"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
content:
application/json:
schema:
required:
- "orderNumber"
- "type"
type: "object"
properties:
agentLogin:
pattern: "^[9]{1}[0-9]{9}$"
type: "string"
description: "Номер телефона агента, под которым он заведен в TCB."
orderNumber:
maxLength: 50
minLength: 1
type: "string"
description: "Номер заказа на стороне продавца."
format: "string"
order:
required:
- "items"
type: "object"
properties:
firstPayment:
minimum: 0
type: "integer"
description: "Первоначальный взнос."
format: "int32"
items:
maxItems: 99
minItems: 1
type: "array"
items:
required:
- "name"
- "price"
- "quantity"
type: "object"
properties:
name:
maxLength: 255
minLength: 1
type: "string"
description: "Наименование товара."
format: "string"
quantity:
minimum: 0
type: "integer"
description: "Количество товара."
format: "int32"
price:
minimum: 0
type: "number"
description: "Стоимость 1 единицы товара."
format: "double"
externalId:
minLength: 1
type: "string"
description: "Идентификатор товара."
format: "string"
description: "Товары в корзине."
description: "Модель заказа клиента в запросе создания заявки."
type:
required:
- "isCreditCard"
- "isPos"
type: "object"
properties:
isPos:
type: "boolean"
description: "Флаг отправки заявки на POS-кредит."
format: "boolean"
isCreditCard:
type: "boolean"
description: "Флаг отправки заявки на кредитную карту."
format: "boolean"
description: "Объект с информацией по запрашиваемым продуктам."
isCallSigning:
type: "boolean"
description: "Флаг телефонного заполнения. По умолчанию — `false`."
format: "boolean"
isOnlyCredit:
type: "boolean"
description: "Флаг отключения рассрочек, возможно оформление тол\
ько кредитов. По умолчанию — `false`."
format: "boolean"
values:
type: "object"
properties:
contact:
type: "object"
properties:
fio:
required:
- "firstName"
- "lastName"
type: "object"
properties:
firstName:
pattern: "^[а-яА-ЯёЁ\\-\\s]{1,}$"
type: "string"
description: "Имя клиента."
format: "string"
lastName:
pattern: "^[а-яА-ЯёЁ\\-\\s]{1,}$"
type: "string"
description: "Фамилия клиента."
format: "string"
middleName:
pattern: "^[а-яА-ЯёЁ\\-\\s]{1,}$"
type: "string"
description: "Отчество клиента."
format: "string"
description: "ФИО клиента."
mobilePhone:
pattern: "^[9]{1}[0-9]{9}$"
type: "string"
description: "Номер телефона клиента."
birthDate:
type: "string"
description: "Дата рождения клиента."
format: "date"
isResident:
type: "boolean"
description: "Флаг резидента РФ."
format: "boolean"
description: "Модель данных клиента."
description: "Данные клиента."
webhookURL:
pattern: "^https?:\\/\\/(?:www\\.)?[-a-zA-Z0-9@:%._\\+~#=]{1,256}\\\
.[a-zA-Z0-9()]{1,6}\\b(?:[-a-zA-Z0-9()@:%_\\+.~#?&\\/=]*)$"
type: "string"
description: "URL для отправки вебхуков. Если не указан, использ\
уется URL из настроек точки."
format: "url"
pointId:
maxLength: 50
minLength: 1
type: "string"
description: "Внешний идентификатор точки."
format: "string"
companyId:
maxLength: 100
minLength: 1
type: "string"
description: "Внешний идентификатор компании."
format: "string"
agentId:
maxLength: 100
minLength: 1
type: "string"
description: "Внешний идентификатор агента."
format: "string"
creditCards:
type: "object"
additionalProperties:
required:
- "ean"
type: "object"
properties:
ean:
maxLength: 13
pattern: "^\\d{13}$"
type: "string"
description: "Штрихкод кредитной карты. Допускаются только\
\ цифры."
format: "string"
description: "Объект с кредитными картами."
example:
skb-card:
ean: 123456789101
kvk-card:
ean: 123456789101
description: "Модель запроса на создание заявки"
required: true
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "id"
- "link"
type: "object"
properties:
id:
type: "string"
description: "ID заявки в системе TCB."
format: "uuid"
link:
type: "string"
description: "Ссылка для перехода в личный кабинет TCB."
format: "url"
example:
id: "21dc246d-ff4b-451b-a1f6-c746579bfb26"
link: "https://forma.tbank.ru/auth/authorize?authToken={accessToken}&redirect_uri={redirectUrl}&client_id=tcb&responseType=code"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при некорректном запросе:
value:
errorId: "170e4a82-9c62-4fb0-8055-45e810630754"
errorMessage: "Выберите хотя бы один тип заявки."
errorCode: "INVALID_REQUEST"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка авторизации агента:
value:
errorId: "170e4a82-9c62-4fb0-8055-45e810630754"
errorMessage: "Агент не имеет достаточно прав для создания зая\
вок на текущей компании. Обратитесь в поддержку брокера."
errorCode: "AUTH_FORBIDDEN"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/offline/partners/v1/demo/orders/{orderNumber}/cancel:
post:
tags:
- "Партнерские методы для работы с заявкой на покупку в кредит (Test)"
summary: "Отменить заявку"
description: "Метод отменяет заявку по вашему идентификатору — номеру заказа\
. После вызова метода заявка в личном кабинете агента перейдет в статус `О\
тменена`."
operationId: "cancelTcbAppV1Demo"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "orderNumber"
in: "path"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Номер заказа на стороне продавца."
format: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка авторизации агента:
value:
errorId: "170e4a82-9c62-4fb0-8055-45e810630754"
errorMessage: "Не найдена заявка с номером заказа {orderNumber}."
errorCode: "NOT_FOUND"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/offline/partners/v1/demo/orders/{orderNumber}/commit:
post:
tags:
- "Партнерские методы для работы с заявкой на покупку в кредит (Test)"
summary: "Сохранить номер чека под заявкой"
description: "Метод сохраняет номер чека под заявкой в системе TCB."
operationId: "commitTcbAppV1Demo"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "orderNumber"
in: "path"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Номер заказа на стороне продавца."
format: "string"
requestBody:
content:
application/json:
schema:
required:
- "invoiceNumber"
type: "object"
properties:
invoiceNumber:
maxLength: 250
type: "string"
description: "Номер чека на стороне партнера."
format: "string"
description: "Модель запроса на коммит."
required: true
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка авторизации агента:
value:
errorId: "170e4a82-9c62-4fb0-8055-45e810630754"
errorMessage: "Не найдена заявка с номером заказа {orderNumber}."
errorCode: "NOT_FOUND"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/offline/partners/v1/demo/orders/{orderNumber}/info:
get:
tags:
- "Партнерские методы для работы с заявкой на покупку в кредит (Test)"
summary: "Получить информацию по заявке"
description: "Метод возвращает актуальную информацию по заявке. Набор возвра\
щаемых полей может меняться в зависимости от статуса заявки."
operationId: "infoTcbAppV1Demo"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "orderNumber"
in: "path"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Номер заказа на стороне продавца."
format: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "createdAt"
- "id"
- "orderNumber"
- "status"
type: "object"
properties:
id:
type: "string"
description: "ID заявки в системе TCB."
format: "uuid"
orderNumber:
maxLength: 50
type: "string"
description: "Номер заказа на стороне продавца."
format: "string"
status:
type: "string"
description: "Статус заявки."
enum:
- "new"
- "inprogress"
- "wait-offers"
- "approved"
- "signing"
- "signed"
- "rejected"
- "canceled"
- "error"
createdAt:
type: "string"
description: "Дата и время создания заявки."
format: "dateTime"
firstName:
pattern: "^[а-яА-ЯёЁ\\-\\s]{1,}$"
type: "string"
description: "Имя клиента."
format: "string"
lastName:
pattern: "^[а-яА-ЯёЁ\\-\\s]{1,}$"
type: "string"
description: "Фамилия клиента."
format: "string"
middleName:
pattern: "^[а-яА-ЯёЁ\\-\\s]{1,}$"
type: "string"
description: "Отчество клиента."
format: "string"
mobilePhone:
pattern: "^[9]{1}[0-9]{9}$"
type: "string"
description: "Номер телефона клиента."
email:
maxLength: 150
type: "string"
description: "Электронная почта клиента."
format: "string"
chosenPosOfferId:
maxLength: 50
type: "string"
description: "ID выбранного оффера (POS)."
format: "string"
chosenCardOfferId:
maxLength: 50
type: "string"
description: "ID выбранного оффера (карта)."
format: "string"
orderAmount:
type: "number"
description: "Стоимость товаров из корзины."
format: "double"
transferAmount:
type: "number"
description: "Сумма перевода партнеру."
format: "double"
offers:
maxItems: 99
type: "array"
items:
required:
- "bankId"
- "bankName"
- "id"
- "status"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID оффера."
format: "string"
status:
type: "string"
description: "Статус оффера."
enum:
- "waiting"
- "approved"
- "rejected"
- "error"
- "signing"
- "signed"
- "canceled"
firstPayment:
type: "number"
description: "Первоначальный взнос."
format: "double"
orderAmount:
type: "number"
description: "Стоимость товаров из корзины."
format: "double"
creditAmount:
type: "number"
description: "Сумма кредита."
format: "double"
discount:
type: "number"
description: "Скидка по рассрочке в процентах."
format: "double"
discountAmount:
type: "number"
description: "Скидка по рассрочке в рублях."
format: "double"
limit:
type: "number"
description: "Лимит по кредитной карте."
format: "double"
rate:
type: "number"
description: "Ставка по кредиту."
format: "double"
productCode:
type: "string"
description: "Идентификатор продукта."
format: "string"
product:
type: "string"
description: "Тип продукта."
enum:
- "credit"
- "installment_credit"
- "creditcard"
term:
type: "integer"
description: "Срок кредита."
format: "int32"
monthlyPayment:
type: "number"
description: "Ежемесячный платеж по кредиту."
format: "double"
signingTypes:
maxItems: 5
type: "array"
description: "Типы подписания."
items:
type: "string"
enum:
- "partner"
- "ses"
- "sms"
bankId:
type: "string"
description: "ID банка."
format: "string"
bankName:
type: "string"
description: "Название банка."
format: "string"
chosenServices:
maxItems: 3
type: "array"
description: "Выбранные банковские дополнительные услуги\
."
items:
type: "string"
enum:
- "life_insurance"
- "lost_work_insurance"
- "sms_bank"
loanNumber:
type: "string"
description: "Номер договора."
format: "string"
accountNumber:
pattern: "^\\d{1,20}$"
type: "string"
description: "Номер счета клиента."
format: "string"
description: "Модель оффера от банка."
order:
required:
- "items"
type: "object"
properties:
items:
minimum: 1
maxItems: 99
type: "array"
items:
required:
- "name"
- "price"
- "quantity"
type: "object"
properties:
name:
maxLength: 255
minLength: 1
type: "string"
description: "Наименование товара."
format: "string"
quantity:
minimum: 0
type: "integer"
description: "Количество товара."
format: "int32"
price:
minimum: 0
type: "number"
description: "Стоимость 1 единицы товара."
format: "double"
externalId:
minLength: 1
type: "string"
description: "Идентификатор товара."
format: "string"
description: "Товары в корзине."
boxedServices:
type: "object"
properties:
lifeInsurance:
required:
- "amount"
- "name"
- "term"
type: "object"
properties:
name:
type: "string"
description: "Наименование услуги."
format: "string"
amount:
type: "number"
description: "Стоимость услуги."
format: "double"
term:
type: "integer"
description: "Срок услуги."
format: "int32"
discountedAmount:
type: "number"
description: "Сумма услуги с вычетом скидки."
format: "double"
description: "Коробочная услуга «Капитал Life»."
pushSms:
required:
- "amount"
- "name"
- "term"
type: "object"
properties:
name:
type: "string"
description: "Наименование услуги."
format: "string"
amount:
type: "number"
description: "Стоимость услуги."
format: "double"
term:
type: "integer"
description: "Срок услуги."
format: "int32"
discountedAmount:
type: "number"
description: "Сумма услуги с вычетом скидки."
format: "double"
description: "Коробочная услуга «ПУШСМС»."
warranty:
required:
- "amount"
- "name"
- "params"
type: "object"
properties:
name:
type: "string"
description: "Наименование услуги."
format: "string"
amount:
type: "number"
description: "Стоимость услуги."
format: "double"
params:
maxItems: 99
type: "array"
items:
required:
- "idCertificate"
- "price"
- "term"
type: "object"
properties:
term:
type: "integer"
description: "Срок услуги."
format: "int32"
price:
type: "number"
description: "Стоимость услуги."
format: "double"
idCertificate:
type: "string"
description: "Номер сертификата."
format: "string"
name:
type: "string"
description: "Название товара."
format: "string"
discountedAmount:
type: "number"
description: "Сумма услуги с вычетом скидки."
format: "double"
description: "Коробочная услуга «Гарантия на технику»."
teco:
required:
- "amount"
- "name"
- "tecoId"
- "term"
type: "object"
properties:
name:
type: "string"
description: "Наименование услуги."
format: "string"
amount:
type: "number"
description: "Стоимость услуги."
format: "double"
term:
type: "integer"
description: "Срок услуги."
format: "int32"
tecoId:
type: "string"
description: "Теко ID."
format: "string"
discountedAmount:
type: "number"
description: "Сумма услуги с вычетом скидки."
format: "double"
description: "Коробочная услуга «ТЕКО»."
description: "Коробочные услуги."
description: "Модель заказа клиента."
example:
id: "21dc246d-ff4b-451b-a1f6-c746579bfb2"
orderNumber: "№12345678"
status: "approved"
createdAt: "2012-04-23T18:25:43.511Z"
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
mobilePhone: "9898882365"
email: "bka@gmail.com"
chosenPosOfferId: "21dc246d-ff4b-451b-a1f6-c746579bfb3"
chosenCardOfferId: "12d8ee08-f08b-45ac-b891-1717ea93506c"
orderAmount: 10000
transferAmount: 10000
order:
items:
- name: "iphone 11"
quantity: 2
price: 60000
- name: "dyson x"
quantity: 1
price: 45000
boxedServices:
warranty:
name: "Услуга-1"
amount: 45
params:
- term: 4
name: "что-то"
price: 11658
idCertificate: "test_id"
pushSms:
name: "Услуга-2"
amount: 40
term: 6
lifeInsurance:
name: "Услуга-3"
amount: 2423
term: 6
discountedAmount: 2423
teco:
name: "Услуга-4"
amount: 2423
term: 6
tecoId: "64c87fda60b2a35a104a6dbb"
discountedAmount: 2423
offers:
- id: "undefined"
status: "rejected"
bankId: "otp"
bankName: "ОТП"
- id: "24dc246d-ff4b-451b-a1f6-c746579bfb7"
status: "signed"
firstPayment: 0
orderAmount: 10000
creditAmount: 10000
product: "credit"
term: 6
discount: 0.0
discountAmount: 0.0
monthlyPayment: 1500
bankId: "kvk"
bankName: "Т-Банк"
loanNumber: "№234234234"
accountNumber: "40701810000010000038"
signingTypes:
- "ses"
- "partner"
chosenServices:
- "sms_bank"
- "life_insurance"
- "lost_work_insurance"
- id: "12d8ee08-f08b-45ac-b891-1717ea93506c"
status: "approved"
limit: 100000
product: "creditcard"
bankId: "kvk-card"
bankName: "Т-Банк"
signingTypes:
- "ses"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка авторизации агента:
value:
errorId: "170e4a82-9c62-4fb0-8055-45e810630754"
errorMessage: "Не найдена заявка с номером заказа {orderNumber}."
errorCode: "NOT_FOUND"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/offline/partners/v1/orders/{orderNumber}/cancel:
post:
tags:
- "Партнерские методы для работы с заявкой на покупку в кредит (Prod)"
summary: "Отменить заявку"
description: "Метод отменяет заявку по вашему идентификатору — номеру заказа\
. После вызова метода заявка в личном кабинете агента перейдет в статус `О\
тменена`."
operationId: "cancelTcbAppV1"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "orderNumber"
in: "path"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Номер заказа на стороне продавца."
format: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка авторизации агента:
value:
errorId: "170e4a82-9c62-4fb0-8055-45e810630754"
errorMessage: "Не найдена заявка с номером заказа {orderNumber}."
errorCode: "NOT_FOUND"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/offline/partners/v1/orders/{orderNumber}/commit:
post:
tags:
- "Партнерские методы для работы с заявкой на покупку в кредит (Prod)"
summary: "Сохранить номер чека под заявкой"
description: "Метод сохраняет номер чека под заявкой в системе TCB."
operationId: "commitTcbAppV1"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "orderNumber"
in: "path"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Номер заказа на стороне продавца."
format: "string"
requestBody:
content:
application/json:
schema:
required:
- "invoiceNumber"
type: "object"
properties:
invoiceNumber:
maxLength: 250
type: "string"
description: "Номер чека на стороне партнера."
format: "string"
description: "Модель запроса на коммит."
required: true
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка авторизации агента:
value:
errorId: "170e4a82-9c62-4fb0-8055-45e810630754"
errorMessage: "Не найдена заявка с номером заказа {orderNumber}."
errorCode: "NOT_FOUND"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/offline/partners/v1/orders/{orderNumber}/info:
get:
tags:
- "Партнерские методы для работы с заявкой на покупку в кредит (Prod)"
summary: "Получить информацию по заявке"
description: " Метод возвращает актуальную информацию по заявке. Набор возвр\
ащаемых полей может меняться в зависимости от статуса заявки.\n\nЧтобы опе\
ративно отслеживать изменения статуса заявки на покупку товаров в кредит,\
\ вы можете воспользоваться вебхуком Статус заявки на товарный кредит."
operationId: "infoTcbAppV1"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "orderNumber"
in: "path"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Номер заказа на стороне продавца."
format: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "createdAt"
- "id"
- "orderNumber"
- "status"
type: "object"
properties:
id:
type: "string"
description: "ID заявки в системе TCB."
format: "uuid"
orderNumber:
maxLength: 50
type: "string"
description: "Номер заказа на стороне продавца."
format: "string"
status:
type: "string"
description: "Статус заявки."
enum:
- "new"
- "inprogress"
- "wait-offers"
- "approved"
- "signing"
- "signed"
- "rejected"
- "canceled"
- "error"
createdAt:
type: "string"
description: "Дата и время создания заявки."
format: "dateTime"
firstName:
pattern: "^[а-яА-ЯёЁ\\-\\s]{1,}$"
type: "string"
description: "Имя клиента."
format: "string"
lastName:
pattern: "^[а-яА-ЯёЁ\\-\\s]{1,}$"
type: "string"
description: "Фамилия клиента."
format: "string"
middleName:
pattern: "^[а-яА-ЯёЁ\\-\\s]{1,}$"
type: "string"
description: "Отчество клиента."
format: "string"
mobilePhone:
pattern: "^[9]{1}[0-9]{9}$"
type: "string"
description: "Номер телефона клиента."
email:
maxLength: 150
type: "string"
description: "Электронная почта клиента."
format: "string"
chosenPosOfferId:
maxLength: 50
type: "string"
description: "ID выбранного оффера (POS)."
format: "string"
chosenCardOfferId:
maxLength: 50
type: "string"
description: "ID выбранного оффера (карта)."
format: "string"
orderAmount:
type: "number"
description: "Стоимость товаров из корзины."
format: "double"
transferAmount:
type: "number"
description: "Сумма перевода партнеру."
format: "double"
offers:
maxItems: 99
type: "array"
items:
required:
- "bankId"
- "bankName"
- "id"
- "status"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID оффера."
format: "string"
status:
type: "string"
description: "Статус оффера."
enum:
- "waiting"
- "approved"
- "rejected"
- "error"
- "signing"
- "signed"
- "canceled"
firstPayment:
type: "number"
description: "Первоначальный взнос."
format: "double"
orderAmount:
type: "number"
description: "Стоимость товаров из корзины."
format: "double"
creditAmount:
type: "number"
description: "Сумма кредита."
format: "double"
discount:
type: "number"
description: "Скидка по рассрочке в процентах."
format: "double"
discountAmount:
type: "number"
description: "Скидка по рассрочке в рублях."
format: "double"
limit:
type: "number"
description: "Лимит по кредитной карте."
format: "double"
rate:
type: "number"
description: "Ставка по кредиту."
format: "double"
productCode:
type: "string"
description: "Идентификатор продукта."
format: "string"
product:
type: "string"
description: "Тип продукта."
enum:
- "credit"
- "installment_credit"
- "creditcard"
term:
type: "integer"
description: "Срок кредита."
format: "int32"
monthlyPayment:
type: "number"
description: "Ежемесячный платеж по кредиту."
format: "double"
signingTypes:
maxItems: 5
type: "array"
description: "Типы подписания."
items:
type: "string"
enum:
- "partner"
- "ses"
- "sms"
bankId:
type: "string"
description: "ID банка."
format: "string"
bankName:
type: "string"
description: "Название банка."
format: "string"
chosenServices:
maxItems: 3
type: "array"
description: "Выбранные банковские дополнительные услуги\
."
items:
type: "string"
enum:
- "life_insurance"
- "lost_work_insurance"
- "sms_bank"
loanNumber:
type: "string"
description: "Номер договора."
format: "string"
accountNumber:
pattern: "^\\d{1,20}$"
type: "string"
description: "Номер счета клиента."
format: "string"
description: "Модель оффера от банка."
order:
required:
- "items"
type: "object"
properties:
items:
minimum: 1
maxItems: 99
type: "array"
items:
required:
- "name"
- "price"
- "quantity"
type: "object"
properties:
name:
maxLength: 255
minLength: 1
type: "string"
description: "Наименование товара."
format: "string"
quantity:
minimum: 0
type: "integer"
description: "Количество товара."
format: "int32"
price:
minimum: 0
type: "number"
description: "Стоимость 1 единицы товара."
format: "double"
externalId:
minLength: 1
type: "string"
description: "Идентификатор товара."
format: "string"
description: "Товары в корзине."
boxedServices:
type: "object"
properties:
lifeInsurance:
required:
- "amount"
- "name"
- "term"
type: "object"
properties:
name:
type: "string"
description: "Наименование услуги."
format: "string"
amount:
type: "number"
description: "Стоимость услуги."
format: "double"
term:
type: "integer"
description: "Срок услуги."
format: "int32"
discountedAmount:
type: "number"
description: "Сумма услуги с вычетом скидки."
format: "double"
description: "Коробочная услуга «Капитал Life»."
pushSms:
required:
- "amount"
- "name"
- "term"
type: "object"
properties:
name:
type: "string"
description: "Наименование услуги."
format: "string"
amount:
type: "number"
description: "Стоимость услуги."
format: "double"
term:
type: "integer"
description: "Срок услуги."
format: "int32"
discountedAmount:
type: "number"
description: "Сумма услуги с вычетом скидки."
format: "double"
description: "Коробочная услуга «ПУШСМС»."
warranty:
required:
- "amount"
- "name"
- "params"
type: "object"
properties:
name:
type: "string"
description: "Наименование услуги."
format: "string"
amount:
type: "number"
description: "Стоимость услуги."
format: "double"
params:
maxItems: 99
type: "array"
items:
required:
- "idCertificate"
- "price"
- "term"
type: "object"
properties:
term:
type: "integer"
description: "Срок услуги."
format: "int32"
price:
type: "number"
description: "Стоимость услуги."
format: "double"
idCertificate:
type: "string"
description: "Номер сертификата."
format: "string"
name:
type: "string"
description: "Название товара."
format: "string"
discountedAmount:
type: "number"
description: "Сумма услуги с вычетом скидки."
format: "double"
description: "Коробочная услуга «Гарантия на технику»."
teco:
required:
- "amount"
- "name"
- "tecoId"
- "term"
type: "object"
properties:
name:
type: "string"
description: "Наименование услуги."
format: "string"
amount:
type: "number"
description: "Стоимость услуги."
format: "double"
term:
type: "integer"
description: "Срок услуги."
format: "int32"
tecoId:
type: "string"
description: "Теко ID."
format: "string"
discountedAmount:
type: "number"
description: "Сумма услуги с вычетом скидки."
format: "double"
description: "Коробочная услуга «ТЕКО»."
description: "Коробочные услуги."
description: "Модель заказа клиента."
example:
id: "21dc246d-ff4b-451b-a1f6-c746579bfb2"
orderNumber: "№12345678"
status: "approved"
createdAt: "2012-04-23T18:25:43.511Z"
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
mobilePhone: "9898882365"
email: "bka@gmail.com"
chosenPosOfferId: "21dc246d-ff4b-451b-a1f6-c746579bfb3"
chosenCardOfferId: "12d8ee08-f08b-45ac-b891-1717ea93506c"
orderAmount: 10000
transferAmount: 10000
order:
items:
- name: "iphone 11"
quantity: 2
price: 60000
- name: "dyson x"
quantity: 1
price: 45000
boxedServices:
warranty:
name: "Услуга-1"
amount: 45
params:
- term: 4
name: "что-то"
price: 11658
idCertificate: "test_id"
pushSms:
name: "Услуга-2"
amount: 40
term: 6
lifeInsurance:
name: "Услуга-3"
amount: 2423
term: 6
discountedAmount: 2423
teco:
name: "Услуга-4"
amount: 2423
term: 6
tecoId: "64c87fda60b2a35a104a6dbb"
discountedAmount: 2423
offers:
- id: "undefined"
status: "rejected"
bankId: "otp"
bankName: "ОТП"
- id: "24dc246d-ff4b-451b-a1f6-c746579bfb7"
status: "signed"
firstPayment: 0
orderAmount: 10000
creditAmount: 10000
product: "credit"
term: 6
discount: 0.0
discountAmount: 0.0
monthlyPayment: 1500
bankId: "kvk"
bankName: "Т-Банк"
loanNumber: "№234234234"
accountNumber: "40701810000010000038"
signingTypes:
- "ses"
- "partner"
chosenServices:
- "sms_bank"
- "life_insurance"
- "lost_work_insurance"
- id: "12d8ee08-f08b-45ac-b891-1717ea93506c"
status: "approved"
limit: 100000
product: "creditcard"
bankId: "kvk-card"
bankName: "Т-Банк"
signingTypes:
- "ses"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка авторизации агента:
value:
errorId: "170e4a82-9c62-4fb0-8055-45e810630754"
errorMessage: "Не найдена заявка с номером заказа {orderNumber}."
errorCode: "NOT_FOUND"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/agreements:
get:
tags:
- "Соглашения"
summary: "Получить список соглашений"
description: " Метод для получения списка соглашений с актуальными статусами\
, в которых компания является получателем или плательщиком."
operationId: "getApiV1Nonacceptance-AgreementsList"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "limit"
in: "query"
description: "Максимальное количество соглашений, которое нужно вывести. З\
начение по умолчанию — `50`."
required: false
style: "form"
explode: true
schema:
type: "integer"
format: "int32"
default: 50
- name: "offset"
in: "query"
description: "Количество соглашений, которые нужно пропустить. Значение по\
\ умолчанию — `0`."
required: false
style: "form"
explode: true
schema:
type: "integer"
format: "int32"
default: 0
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "limit"
- "offset"
- "size"
- "total"
type: "object"
properties:
offset:
type: "integer"
description: "Количество соглашений, которое было пропущено."
format: "int32"
limit:
type: "integer"
description: "Максимальное количество соглашений, которое могл\
о быть выведено."
format: "int32"
size:
type: "integer"
description: "Количество соглашений в ответе."
format: "int32"
total:
type: "integer"
description: "Общее количество соглашений."
format: "int32"
results:
maxItems: 50
type: "array"
description: "Результат."
nullable: true
items:
required:
- "id"
type: "object"
properties:
id:
type: "string"
description: "ID соглашения."
format: "uuid"
type:
type: "string"
description: " Тип участия в соглашении:\n\n`Recipient`\
\ — в качестве получателя;\n\n`Payer` — в качестве пла\
тельщика."
enum:
- "Recipient"
- "Payer"
status:
type: "string"
description: " Статус соглашения:\n\n* `Pending` — ожида\
ет подписания одной или двумя сторонами.\n\n* `Signed`\
\ — подписано, ожидает регистрации на стороне банка. К\
ак правило, это занимает не больше двух дней.\n\n* `Active`\
\ — соглашение активно, можно производить списания.\n\n\
* `Terminated` — соглашение расторгнуто одной из сторо\
н.\n\n* `Outdated` — срок соглашения истек, производит\
ь списания нельзя.\n\n* `Error` — при обработке соглаш\
ения произошла ошибка. "
enum:
- "Pending"
- "Active"
- "Signed"
- "Terminated"
- "Error"
- "Outdated"
example:
offset: 60
limit: 10
size: 1
total: 61
results:
- id: "4ec482b3-b314-4089-88c2-2b6fba9424ef"
type: "Recipient"
status: "Active"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "bcadsa12"
errorCode: "VALIDATION_ERROR"
errorMessage: "offset: value must be greater than 0"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/agreements/url:
get:
tags:
- "Соглашения"
summary: "Получить URL страницы для контрагента"
description: " Метод для получения URL для создания нового соглашения.\n\nКо\
гда плательщик переходит по URL, открывается окно, в котором он указывает\
\ свои реквизиты и детали соглашения — срок действия, максимальная сумма п\
латежа.\n\nОбсудите предполагаемые суммы платежей со своим контрагентом. В\
\ рамках соглашения с плательщика за раз не может быть списана сумма больш\
е той, которая указана в соглашении."
operationId: "getApiV1Nonacceptance-AgreementUrl"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "url"
type: "object"
properties:
url:
type: "string"
description: "URL для контрагента, который ведет на форму подп\
исания соглашения."
format: "string"
example:
url: "https://business.tbank.ru/nonacceptance-debits/form/3fa85f64-5717-4562-b3fc-2c963f66afa6"
"400":
description: "Не найдена форма для соглашения о безакцептных списаниях"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "bcadsa12"
errorCode: "NOT_FOUND"
errorMessage: "Resource not found"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/agreements/{agreementId}:
get:
tags:
- "Соглашения"
summary: "Получить детали соглашения"
description: " Метод отдает информацию о реквизитах плательщика и получателя\
, статусе соглашения, максимальной сумме платежа по договору. Чтобы измени\
ть детали соглашения, напишите в чат.\n\nЧтобы оперативно отслеживать инфо\
рмацию о создании или обновлении соглашения о безакцептном списании, вы мо\
жете воспользоваться вебхуком Обновление соглашения о безакцептном списании."
operationId: "getApiV1Nonacceptance-AgreementDetails"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "agreementId"
in: "path"
description: "ID соглашения."
required: true
style: "simple"
explode: false
schema:
type: "string"
format: "uuid"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "id"
- "number"
- "payerRequisites"
- "recipientRequisites"
- "startDate"
type: "object"
properties:
id:
type: "string"
description: "ID соглашения."
format: "uuid"
number:
type: "string"
description: "Номер соглашения."
format: "string"
recipientRequisites:
type: "object"
properties:
name:
maxLength: 300
type: "string"
description: "Наименование."
nullable: true
address:
type: "string"
description: "Полный юридический адрес."
format: "string"
nullable: true
inn:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН."
nullable: true
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "КПП."
nullable: true
ogrn:
pattern: "^(\\d{13}|\\d{15})$"
type: "string"
description: "ОГРН."
nullable: true
signerName:
type: "string"
description: "ФИО представителя."
format: "string"
nullable: true
signerPosition:
type: "string"
description: "Должность представителя."
format: "string"
nullable: true
signerDocument:
type: "string"
description: "Документ-обоснование должности представителя\
."
format: "string"
nullable: true
accountNumber:
pattern: "^(\\d{20})$"
type: "string"
description: "Расчетный счет."
nullable: true
accountCurrency:
pattern: "^(\\d{3})$"
type: "string"
description: "Валюта расчетного счета."
nullable: true
corAccountNumber:
pattern: "^(\\d{20})$"
type: "string"
description: "Корреспондентский счет."
nullable: true
bic:
pattern: "^(\\d{9})$"
type: "string"
description: "БИК."
nullable: true
bankName:
maxLength: 300
type: "string"
description: "Наименование банка."
nullable: true
description: "Реквизиты получателя."
payerRequisites:
type: "object"
properties:
name:
maxLength: 300
type: "string"
description: "Наименование."
nullable: true
address:
type: "string"
description: "Полный юридический адрес."
format: "string"
nullable: true
inn:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН."
nullable: true
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "КПП."
nullable: true
ogrn:
pattern: "^(\\d{13}|\\d{15})$"
type: "string"
description: "ОГРН."
nullable: true
signerName:
type: "string"
description: "ФИО представителя."
format: "string"
nullable: true
signerPosition:
type: "string"
description: "Должность представителя."
format: "string"
nullable: true
signerDocument:
type: "string"
description: "Документ-обоснование должности представителя\
."
format: "string"
nullable: true
accountNumber:
pattern: "^(\\d{20})$"
type: "string"
description: "Расчетный счет."
nullable: true
accountCurrency:
pattern: "^(\\d{3})$"
type: "string"
description: "Валюта расчетного счета."
nullable: true
corAccountNumber:
pattern: "^(\\d{20})$"
type: "string"
description: "Корреспондентский счет."
nullable: true
bic:
pattern: "^(\\d{9})$"
type: "string"
description: "БИК."
nullable: true
bankName:
maxLength: 300
type: "string"
description: "Наименование банка."
nullable: true
description: "Реквизиты плательщика."
startDate:
type: "string"
description: "Дата подписания соглашения."
format: "date-time"
endDate:
type: "string"
description: "Дата окончания действия соглашения."
format: "date-time"
nullable: true
maxSum:
type: "number"
description: "Максимальная сумма платежа."
format: "decimal"
nullable: true
currency:
pattern: "^(\\d{3})$"
type: "string"
description: "Валюта максимальной суммы."
nullable: true
reason:
type: "string"
description: "Документ-основание для заключения соглашения."
format: "string"
nullable: true
status:
type: "string"
description: " Статус соглашения:\n\n* `Pending` — ожидает под\
писания одной или двумя сторонами.\n\n* `Signed` — подписано\
, ожидает регистрации на стороне банка. Как правило, это зан\
имает не больше двух дней.\n\n* `Active` — соглашение активн\
о, можно производить списания.\n\n* `Terminated` — соглашени\
е расторгнуто одной из сторон.\n\n* `Outdated` — срок соглаш\
ения истек, производить списания нельзя.\n\n* `Error` — при\
\ обработке соглашения произошла ошибка. "
enum:
- "Pending"
- "Active"
- "Signed"
- "Terminated"
- "Error"
- "Outdated"
example:
id: "4ec482b3-b314-4089-88c2-2b6fba9424ef"
number: "236383626412/2022-08-05/25.421"
startDate: "2022-08-05T18:08:17.338628Z"
endDate: "2023-08-06T18:00:00Z"
maxSum: 1000.0
currency: "643"
reason: "На основании договора №7345 от 01.02.2018"
status: "Pending"
recipientRequisites:
name: "ООО \"Ромашка\""
address: "г. Москва, ул. Производственная, 12 корпус 3, 067889"
inn: "1234567890"
kpp: "123456789"
ogrn: "1234567891234"
signerName: "Иванов Иван Иванович"
signerPosition: "Главный бухгалтер"
signerDocument: "На основании доверенности №123412355 от 10.05.2018"
accountNumber: "12345678900987654321"
accountCurrency: "643"
corAccountNumber: "30101810145250000974"
bic: "044525974"
bankName: "АО «ТБанк»"
payerRequisites:
name: "ИП Петров Петр Иванович"
address: "г. Москва, ул. Производственная, д.15, 067889"
inn: "1234567890"
kpp: "123456789"
ogrn: "1234567891234"
signerName: "Петров Петр Иванович"
signerPosition: ""
signerDocument: "Выписка из ЕГРЮЛ"
accountNumber: "12345678900987654321"
accountCurrency: "643"
corAccountNumber: "30101810145250000974"
bic: "044525974"
bankName: "АО «ТБанк»"
"400":
description: "Соглашение не найдено"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "bcadsa12"
errorCode: "NOT_FOUND"
errorMessage: "Resource not found"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/agreements/{agreementId}/file:
get:
tags:
- "Соглашения"
summary: "Получить детали соглашения в PDF"
description: "Метод для получения PDF-файла с текстом соглашения. Файл закод\
ирован в `base64`."
operationId: "getApiV1Nonacceptance-AgreementDetails-file"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "agreementId"
in: "path"
description: "ID соглашения."
required: true
style: "simple"
explode: false
schema:
type: "string"
format: "uuid"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "content"
- "filename"
type: "object"
properties:
filename:
type: "string"
description: "Имя файла."
format: "string"
content:
type: "string"
description: "Base64-encoded файл в формате PDF с текстом согл\
ашения."
format: "byte"
example:
content: "UERGIGZpbGUgc2hvdWxkIGJlIGhlcmU="
filename: "1234-010122.pdf"
"400":
description: "Соглашение не найдено"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "bcadsa12"
errorCode: "NOT_FOUND"
errorMessage: "Resource not found"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/chargebacks:
get:
tags:
- "Интернет-эквайринг. Диспуты"
summary: "Получить информацию о диспутах компании"
description: "Метод для получения информации по всем диспутам компании за за\
прашиваемый период. Включает в себя как новые диспуты, так и старые, по ко\
торым были изменения за период."
operationId: "getChargebacks"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "beginDate"
in: "query"
description: "Дата начала."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "date"
- name: "endDate"
in: "query"
description: "Дата окончания."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "date"
responses:
"200":
description: "OK"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "data"
type: "object"
properties:
message:
maxLength: 300
type: "string"
description: "Результат обработки запроса."
data:
maxItems: 500
type: "array"
description: "Информация по каждому диспуту."
items:
required:
- "attachments"
- "cbkAmt"
- "channel"
- "chargebackStage"
- "reasonCode"
- "status"
type: "object"
properties:
channel:
type: "string"
description: "Канал:\n- `ON-US` — карты Т-Банка;\n- `OFF-US`\
\ — карты сторонних банков."
enum:
- "ON-US"
- "OFF-US"
origTrxnDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2})$"
type: "string"
description: "Дата и время оригинальной транзакции в фор\
мате `yyyy-mm-dd'T'HH:mm:ss`."
cardNumber:
maxLength: 100
pattern: "\\*{2,}"
type: "string"
description: "Маскированный номер карты клиента."
merchantName:
maxLength: 100
type: "string"
description: "Название мерчанта."
submerchantId:
type: "integer"
description: "Идентификатор точки."
format: "int64"
trxnAmt:
type: "number"
description: "Сумма транзакции в рублях."
cbkAmt:
type: "number"
description: "Сумма оспаривания."
cbkCur:
maxLength: 100
type: "string"
description: "Валюта оспаривания."
paymentId:
maxLength: 100
type: "string"
description: "Идентификатор платежа (orderId)."
terminalId:
maxLength: 100
type: "string"
description: "Идентификатор терминала."
arn:
maxLength: 100
type: "string"
description: "ARN (Acquirer Reference Number), состоит и\
з 23 цифр."
rrn:
maxLength: 100
type: "string"
description: "Retrieval Reference Number."
reasonCode:
maxLength: 100
type: "string"
description: "Код причины оспаривания."
status:
maxLength: 100
type: "string"
description: "Статус диспута:\n- `Вернули держателю` — д\
испут проиграли и сумма вернулась физическому лицу.\n\
- `Нужен ответ` — Т-Банк требует от вас ответа на дисп\
ут: согласны с претензией или нет, а также документы,\
\ подтверждающие позицию компании в случае несогласия\
\ с диспутом.\n- `В работе` — ответ от компании получе\
н, диспут в обработке на стороне Т-Банка или стороне э\
митента.\n- `Выиграли` — диспут закрыт в пользу компан\
ии.\n- `Решение по Арбитражу` — диспут закрыт по итога\
м рассмотрения в Арбитражном комитете платежной систем\
ы. Решение ПС может быть передано по запросу."
chargebackStage:
maxLength: 100
type: "string"
description: "Стадия диспута."
retentionDate:
type: "string"
description: "Дата удержания средств с ТСП."
format: "date"
moneyTransferDate:
type: "string"
description: "Дата зачисления средств в ТСП."
format: "date"
text:
maxLength: 5000
type: "string"
description: "Текст сообщения."
deadline:
type: "string"
description: "Дата, до которой ожидаем получить ответ."
format: "date"
attachments:
maxItems: 100
type: "array"
description: "Файлы, прикрепленные к диспуту."
items:
maxLength: 100
type: "string"
description: "Ссылка на файл в data.tinkoff."
firstCbkDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2})$"
type: "string"
description: "Дата и время открытия спора в формате `yyyy-mm-dd'T'HH:mm:ss`."
description: "Информация о диспуте."
firstCbkDate:
type: "string"
description: "Дата и время открытия спора."
format: "datetime"
description: "Общий формат ответа."
example:
message: "OK"
data:
- channel: "ON-US"
origTrxnDate: "2023-01-31T17:25:14"
cardNumber: "553691******6876"
merchantName: "WIldberries"
submerchantId: 123456
trxnAmt: 5000.5
cbkAmt: 4000
cbkCur: "RUB"
paymentId: "klkjhgfdsdtyuio1kjh2g"
terminalId: "1234567"
arn: "12345678909876543212451"
rrn: "987654321234"
reasonCode: "4837"
status: "Нужен ответ"
chargebackStage: "Чарджбэк"
retentionDate: "2023-02-10"
moneyTransferDate: "2023-02-10"
text: "Добрый день! По указанной ниже операции поступила претенз\
ия от держателя карты. Он утверждает, что данную операцию не с\
овершал."
deadline: "2023-02-14"
attachments:
- "d7cf8082-8f8c-47a8-v80a-51aac30ba315/example.png"
- "80b5a5c0-5a48-4bb8-9f71-0ed9bf8d1955/example.pdf"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "cf92ecba-7ac9-4799-856d-eb450ce1875b"
errorMessage: "Мерчант не подключен к интернет-эквайрингу"
errorCode: "INVALID_DATA"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/chargebacks/download/files:
post:
tags:
- "Интернет-эквайринг. Диспуты"
summary: "Получить файлы по мерчанту"
description: "Метод для получения файлов по определенному мерчанту."
operationId: "getFiles"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
content:
application/json:
schema:
required:
- "files"
type: "object"
properties:
files:
maxItems: 20
type: "array"
description: "Список ссылок на файлы."
items:
type: "string"
required: true
responses:
"200":
description: ""
headers:
Content-Disposition:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Файл для скачивания."
example: "attachment; filename=\"files.zip\""
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/octet-stream:
schema:
type: "string"
format: "binary"
example: "binary data"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "cf92ecba-7ac9-4799-856d-eb450ce1875b"
errorMessage: "Мерчант не подключен к интернет-эквайрингу"
errorCode: "INVALID_DATA"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "cf92ecba-7ac9-4799-856d-eb450ce1875b"
errorMessage: "Файл не найден"
errorCode: "NOT_FOUND"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/chargebacks/replies:
post:
tags:
- "Интернет-эквайринг. Диспуты"
summary: "Отправить ответы по диспутам"
description: "Метод для отправки ответов по диспутам компании. Возвращает ре\
зультаты обработки по каждому ответу."
operationId: "saveChargebackReplies"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
content:
application/json:
schema:
required:
- "chargebacksReply"
type: "object"
properties:
chargebacksReply:
maxItems: 100
type: "array"
description: "Ответы компании на диспуты."
items:
required:
- "arn"
- "channel"
- "isAccepted"
- "paymentId"
- "replyText"
type: "object"
properties:
channel:
type: "string"
description: "Канал:\n- `ON-US` — карты Т-Банка;\n- `OFF-US`\
\ — карты сторонних банков."
enum:
- "ON-US"
- "OFF-US"
arn:
maxLength: 100
type: "string"
description: "ARN (Acquirer Reference Number), состоит из\
\ 23 цифр."
paymentId:
maxLength: 100
type: "string"
description: "Идентификатор платежа (orderId)."
isAccepted:
type: "boolean"
description: "Флаг, согласна ли компания с чарджбэком. Для\
\ `true` передайте сумму в параметре `acceptedAmount`."
acceptedAmount:
type: "number"
description: "Сумма, которую компания готова возместить кл\
иенту."
replyText:
maxLength: 5000
type: "string"
description: "Текст ответа на диспут."
replyAttachments:
maxItems: 100
type: "array"
description: "Файлы, прикрепленные к ответу."
items:
maxLength: 1000
type: "string"
description: "В процессе доработок. Передайте ссылки на\
\ файлы в любом облачном хранилище или сами файлы поба\
йтово."
description: "Ответ компании на диспут."
description: "Запрос от компании по отправке ответов на диспуты."
required: true
responses:
"200":
description: "OK"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "data"
type: "object"
properties:
message:
maxLength: 300
type: "string"
description: "Результат обработки запроса."
data:
maxItems: 100
type: "array"
description: "Информация по каждому диспуту."
items:
required:
- "channel"
- "paymentId"
- "result"
type: "object"
properties:
channel:
type: "string"
description: "Канал:\n- `ON-US` — карты Т-Банка;\n- `OFF-US`\
\ — карты сторонних банков."
enum:
- "ON-US"
- "OFF-US"
arn:
maxLength: 100
type: "string"
description: "ARN (Acquirer Reference Number), состоит и\
з 23 цифр."
paymentId:
maxLength: 100
type: "string"
description: "Идентификатор платежа (orderId)."
result:
type: "string"
description: "Результат обработки ответа по конкретному\
\ диспуту."
enum:
- "OK"
- "ERROR"
resultMessage:
maxLength: 300
type: "string"
description: "Текст ошибки."
description: "Результат обработки каждого ответа компании на\
\ диспут."
description: "Информация по каждому диспуту."
example:
message: "OK"
data:
- channel: "ON-US"
arn: "12345678909876543212345"
paymentId: "rtyuio2hj34k5h6lgee"
result: "OK"
- channel: "OFF-US"
arn: "0987654321234567890987"
paymentId: "1111udfifjdj9922jjl"
result: "ERROR"
resultMessage: "acceptedAmt больше, чем сумма чарджбэка"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "cf92ecba-7ac9-4799-856d-eb450ce1875b"
errorMessage: "Мерчант не подключен к интернет-эквайрингу"
errorCode: "INVALID_DATA"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/chargebacks/upload-files:
post:
tags:
- "Интернет-эквайринг. Диспуты"
summary: "Загрузить файлы"
description: "Метод для загрузки файлов мерчантом."
operationId: "uploadFiles"
parameters:
- name: "Content-Disposition"
in: "header"
required: true
style: "simple"
explode: false
schema:
pattern: "^[a-zA-Z0-9\\._-]+$"
type: "string"
description: "Имя загружаемого файла."
example: "attachment; filename=\"file.pdf\""
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
content:
application/octet-stream:
schema:
type: "string"
format: "binary"
example: "binary data"
responses:
"200":
description: "OK"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
maxItems: 10
type: "array"
items:
required:
- "fileName"
- "path"
type: "object"
properties:
fileName:
maxLength: 300
type: "string"
description: "Оригинальное название файла."
path:
maxLength: 300
type: "string"
description: "ID файла в нашей системе."
examples:
Ссылки на файлы:
value:
- fileName: "order.jpg"
path: "ba73db63-7b54-4e3c-822c-480f65e09124.jpg"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "cf92ecba-7ac9-4799-856d-eb450ce1875b"
errorMessage: "Мерчант не подключен к интернет-эквайрингу"
errorCode: "INVALID_DATA"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/company:
get:
tags:
- "T-Business ID. Информация о компании"
summary: "Получить информацию о компании"
description: "Метод для получения информации о компании — название, город, р\
еквизиты, банк, ОПФ, система налогообложения."
operationId: "getApiV1Company"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
responses:
"200":
description: "Информация о компании"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "bank"
- "city"
- "name"
- "requisites"
type: "object"
properties:
name:
maxLength: 1000
type: "string"
description: "Название компании."
city:
maxLength: 1000
type: "string"
description: "Город."
requisites:
required:
- "address"
- "fullName"
- "inn"
type: "object"
properties:
fullName:
maxLength: 1000
type: "string"
description: "Полное название компании."
foreignName:
maxLength: 1000
type: "string"
description: "Зарубежное название компании."
address:
maxLength: 3000
type: "string"
description: "Адрес."
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
description: "ИНН."
kpp:
maxLength: 20
type: "string"
description: "КПП."
ogrn:
maxLength: 100
type: "string"
description: "ОГРН."
description: "Реквизиты компании."
bank:
required:
- "bankAddress"
- "bankBic"
- "bankInn"
- "bankName"
- "corrAccount"
type: "object"
properties:
bankName:
maxLength: 1000
type: "string"
description: "Название банка."
bankAddress:
maxLength: 3000
type: "string"
description: "Адрес банка."
corrAccount:
maxLength: 100
type: "string"
description: "Корреспондентский счет."
bankInn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
description: "ИНН."
bankBic:
maxLength: 100
type: "string"
description: "БИК."
description: "Информация о банке."
registrationDate:
type: "string"
description: "Дата регистрации."
format: "date"
opf:
maxLength: 100
type: "string"
description: "Организационно-правовая форма."
taxationScheme:
type: "string"
description: "Система налогообложения: \n\n* `USN_INCOMES` — у\
прощенная система налогообложения;\n * `USN_INCOMES_MINUS_EXPENSES`\
\ — УСН «Доходы минус расходы»;\n * `AUSN_INCOMES` — автомат\
изированная УСН;\n * `AUSN_INCOMES_MINUS_EXPENSES` — автомат\
изированная УСН «Доходы минус расходы»;\n * `OSNO` — общая с\
истема налогообложения;\n * `NPD` — налог на профессиональны\
й доход;\n * `ESHN` — единый сельскохозяйственный налог;\n *\
\ `ENVD` — единый налог на вмененный доход для отдельных вид\
ов деятельности."
enum:
- "USN_INCOMES"
- "USN_INCOMES_MINUS_EXPENSES"
- "AUSN_INCOMES_MINUS_EXPENSES"
- "AUSN_INCOMES"
- "OSNO"
- "NPD"
- "ESHN"
- "ENVD"
example:
name: "ООО \"Рога и Копыта\""
city: "Москва"
requisites:
fullName: "Общество с ограниченной ответственностью \"Рога и Коп\
ыта\""
address: "г. Москва"
inn: "1234567890"
kpp: "123456789"
ogrn: "5183493905840938503"
bank:
bankName: "Воскресенье"
bankAddress: "г. Москва, ул. Правобережная 8"
corrAccount: "85452134134134"
bankInn: "1234567890"
bankBic: "68590468905486"
registrationDate: "2019-01-01"
taxationScheme: "OSNO"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/consult/requests/attachments:
get:
tags:
- "Налоговые консультации"
summary: "Скачать вложение (файл) из чата"
description: "Метод возвращает файл из чата по заявке (`taxRequestId`) по ег\
о идентификатору — `attachmentId`.\n\nЕсли файл не будет найден или будет\
\ недоступен для скачивания (после закрытия запроса), вернется ошибка."
operationId: "consultDownloadAttachment"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "attachmentId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "ID вложения."
format: "uuid"
- name: "taxRequestId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "ID заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
Content-Disposition:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Файл для скачивания."
example: "attachment; filename=\"mockAttachment.txt\""
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/octet-stream:
schema:
type: "string"
format: "binary"
example: "binary data"
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/consult/requests/attachments/upload:
post:
tags:
- "Налоговые консультации"
summary: "Загрузить произвольный файл"
description: "Метод для загрузки произвольного файла, который можно прикрепи\
ть как вложение к заявке с ID `taxRequestId`. После успешной загрузки верн\
ется ID файла — `attachmentId`."
operationId: "consultUploadAttachment"
parameters:
- name: "X-Content-File-Name"
in: "header"
description: "Имя файла."
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Имя файла."
example: "mockAttachment.txt"
- name: "X-Content-File-Type"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Тип файла."
example: "text/plain"
- name: "X-Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности. Подробнее."
format: "uuid"
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "ID заявки."
format: "uuid"
requestBody:
content:
application/octet-stream:
schema:
type: "string"
format: "binary"
example: "binary data"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "attachmentId"
type: "object"
properties:
attachmentId:
type: "string"
description: "ID вложения."
format: "uuid"
example:
attachmentId: "54593069-1789-4a7d-b729-37406bd1fc0e"
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/consult/requests/comment:
get:
tags:
- "Налоговые консультации"
summary: "Получить данные о заявке"
description: "Метод возвращает актуальные данные о заявке."
operationId: "consultGetRequestInfo"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "ID заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "clientFullName"
- "clientId"
- "createdAt"
- "hasUnreadMessages"
- "requestType"
- "status"
type: "object"
properties:
clientId:
type: "string"
description: "Идентификатор клиента."
format: "uuid"
clientFullName:
maxLength: 200
type: "string"
description: "ФИО клиента."
requestType:
type: "string"
description: "Тип заявки."
enum:
- "Comment"
- "Declaration"
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
hasUnreadMessages:
type: "boolean"
description: "Флаг наличия непрочитанных сообщений в чате."
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
createdAt:
type: "string"
description: "Дата создания в формате `ISO-8601`."
format: "dateTime"
example:
clientId: "1453dd48-53ea-4aab-a200-597b57daf809"
clientFullName: "Иванов Иван Иванович"
requestType: "Declaration"
status: "New"
hasUnreadMessages: false
casVersion: 1
createdAt: "2023-02-21T07:14:04.622Z"
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/consult/requests/comment/chat:
get:
tags:
- "Налоговые консультации"
summary: "Получить список сообщений по налоговой консультации"
description: "Возвращает список сообщений чата с клиентом по налоговой консу\
льтации по ID заявки `taxRequestId`."
operationId: "consultGetChatHistory"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "limit"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "integer"
description: "Желаемое количество элементов."
- name: "offset"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "integer"
description: "Позиция начала списка."
- name: "taxRequestId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "ID заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "meta"
- "values"
type: "object"
properties:
meta:
required:
- "count"
- "offset"
- "total"
type: "object"
properties:
offset:
type: "integer"
description: "Позиция начала списка."
count:
type: "integer"
description: "Количество элементов в ответе."
total:
type: "integer"
description: "Общее количество элементов."
description: "Информация для пагинации."
values:
maxItems: 1000
type: "array"
description: "Сообщения в чате."
items:
required:
- "authorType"
- "createdAt"
- "id"
type: "object"
properties:
id:
type: "string"
description: "ID сообщения."
format: "uuid"
authorType:
type: "string"
description: "Тип автора сообщения."
enum:
- "Manager"
- "Client"
text:
maxLength: 1000
type: "string"
description: "Текст сообщения."
attachments:
maxItems: 1000
type: "array"
description: "ID вложений, приложенных к сообщению."
items:
required:
- "createdAt"
- "id"
- "mime"
- "name"
- "size"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID вложения."
name:
maxLength: 100
type: "string"
description: "Название файла."
mime:
maxLength: 100
type: "string"
description: "Тип содержимого файла."
size:
type: "integer"
description: "Размер файла в байтах."
createdAt:
type: "string"
description: "Дата загрузки документа в формате `ISO-8601`."
format: "dateTime"
createdAt:
type: "string"
description: "Дата создания сообщения в формате `ISO-8601`."
format: "dateTime"
example:
meta:
offset: 0
count: 10
total: 100
values:
- id: "17cf5b26-a9b4-4531-bd19-186dbfc64a0a"
authorType: "Client"
text: "Прикладываю справку"
attachments:
- id: "cb4bc60f-101d-4ba2-a4fb-94dcf1208d31"
name: "mockAttachment.txt"
mime: "text/plain"
size: 10
createdAt: "2023-11-22T14:12:37.933204Z"
createdAt: "2023-11-22T14:12:37.933204Z"
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/consult/requests/comment/chat/send:
post:
tags:
- "Налоговые консультации"
summary: "Отправить сообщение в чат с клиентом"
description: "Метод отправляет сообщение с возможными вложениями в чат с кли\
ентом."
operationId: "consultSendChat"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "ID заявки."
format: "uuid"
requestBody:
content:
application/json:
schema:
type: "object"
properties:
text:
maxLength: 1000
type: "string"
description: "Текст сообщения."
attachments:
maxItems: 1000
type: "array"
description: "Вложения. Значение не передается, либо передается\
\ список ID вложений."
items:
type: "string"
description: "ID вложения."
format: "uuid"
example:
message:
text: "Прикладываю справку"
attachments:
- "cb4bc60f-101d-4ba2-a4fb-94dcf1208d30"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
example: {}
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/consult/requests/comment/workflow/cancel:
post:
tags:
- "Налоговые консультации"
summary: "Отменить заявку"
description: "Метод переводит заявку типа «Комментарий» в статус `Cancelled`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `Cancelled`, метод вернет данные в\
\ 200 ответе. Если актуальная версия заявки не совпадает с версией, переда\
нной в HTTP-заголовке, вернется 422 ошибка."
operationId: "consultUpdateStatusCancelled"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "Уникальный ID заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "Cancelled"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/consult/requests/comment/workflow/clarification:
post:
tags:
- "Налоговые консультации"
summary: "Требуются уточнения по заявке"
description: "Метод переводит заявку типа «Комментарий» в статус `Clarification`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `Clarification`, метод вернет данны\
е в 200 ответе. Если актуальная версия заявки не совпадает с версией, пере\
данной в HTTP-заголовке, вернется 422 ошибка."
operationId: "consultUpdateStatusClarification"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "Уникальный ID заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "Clarification"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/consult/requests/comment/workflow/decline:
post:
tags:
- "Налоговые консультации"
summary: "Отклонить заявку"
description: "Метод переводит заявку типа «Комментарий» в статус `Declined`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `Declined`, метод вернет данные в 200\
\ ответе. Если актуальная версия заявки не совпадает с версией, переданной\
\ в HTTP-заголовке, вернется 422 ошибка."
operationId: "consultUpdateStatusDeclined"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "Уникальный ID заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "Declined"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/consult/requests/comment/workflow/payment-done:
post:
tags:
- "Налоговые консультации"
summary: "Отметить оплату заявки"
description: "Метод переводит заявку типа «Комментарий» в статус `PaymentDone`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `PaymentDone`, метод вернет данные\
\ в 200 ответе. Если актуальная версия заявки не совпадает с версией, пере\
данной в HTTP-заголовке, вернется 422 ошибка."
operationId: "consultUpdateStatusPaymentDone"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "Уникальный ID заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "PaymentDone"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/consult/requests/comment/workflow/pending-payment:
post:
tags:
- "Налоговые консультации"
summary: "Отметить необходимость оплаты заявки"
description: "Метод переводит заявку типа «Комментарий» в статус `PendingPayment`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `PendingPayment`, метод вернет данн\
ые в 200 ответе. Если актуальная версия заявки не совпадает с версией, пер\
еданной в HTTP-заголовке, вернется 422 ошибка."
operationId: "consultUpdateStatusPendingPayment"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "Уникальный ID заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "PendingPayment"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/consult/requests/comment/workflow/ready:
post:
tags:
- "Налоговые консультации"
summary: "Завершить заявку"
description: "Метод переводит заявку типа «Комментарий» в статус `PartnerReady`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `PartnerReady`, метод вернет данные\
\ в 200 ответе. Если актуальная версия заявки не совпадает с версией, пере\
данной в HTTP-заголовке, вернется 422 ошибка."
operationId: "consultUpdateStatusReady"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "Уникальный ID заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "PartnerReady"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/consult/requests/comment/workflow/start-review:
post:
tags:
- "Налоговые консультации"
summary: "Взять заявку в анализ"
description: "Метод переводит заявку типа «Комментарий» в статус `Preprocess`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `Preprocess`, метод вернет данные в\
\ 200 ответе. Если актуальная версия заявки не совпадает с версией, переда\
нной в HTTP-заголовке, вернется 422 ошибка."
operationId: "consultUpdateStatusStartReview"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "Уникальный ID заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "Preprocess"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/consult/requests/comment/workflow/start-work:
post:
tags:
- "Налоговые консультации"
summary: "Взять заявку в работу"
description: "Метод переводит заявку типа «Комментарий» в статус `PartnerInProgress`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `PartnerInProgress`, метод вернет д\
анные в 200 ответе. Если актуальная версия заявки не совпадает с версией,\
\ переданной в HTTP-заголовке, вернется 422 ошибка."
operationId: "consultUpdateStatusPartnerInProgress"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "Уникальный ID заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "PartnerInProgress"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/counterparty/contracts:
get:
tags:
- "Проверка контрагентов"
summary: "Получить список контрактов"
description: "Метод для получения списка контрактов."
operationId: "getApiV1CounterpartyContracts"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "limit"
in: "query"
required: true
style: "form"
explode: true
schema:
maximum: 100
minimum: 1
type: "integer"
format: "int32"
- name: "offset"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "integer"
format: "int32"
- name: "ogrn"
in: "query"
description: "Основной государственный регистрационный номер."
required: true
style: "form"
explode: true
schema:
pattern: "^\\d{13,15}$"
type: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "companyCard"
- "data"
type: "object"
properties:
companyCard:
required:
- "pages"
- "requisites"
- "statusType"
type: "object"
properties:
statusType:
type: "string"
description: "Статус компании."
enum:
- "active"
- "reorganizing"
- "liquidating"
- "liquidated"
- "bankrupting"
- "unknown"
requisites:
required:
- "ogrn"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
shortName:
type: "string"
format: "string"
nullable: true
fullName:
type: "string"
format: "string"
nullable: true
dateReg:
type: "string"
format: "date"
nullable: true
terminationDt:
type: "string"
format: "date"
nullable: true
status:
type: "string"
format: "string"
nullable: true
authorizedCapitalAmount:
type: "number"
format: "double"
nullable: true
ogrnAssignDate:
type: "string"
format: "date"
nullable: true
legalAddress:
type: "string"
format: "string"
nullable: true
city:
type: "string"
format: "string"
nullable: true
description: "Реквизиты."
pages:
maxItems: 20
type: "array"
items:
required:
- "page"
type: "object"
properties:
page:
type: "string"
description: "Код страницы."
enum:
- "okved"
- "contract"
- "license"
- "history"
- "trafficLight"
- "relatedCompanies"
- "feedback"
- "financialStatements"
- "enforcementProceedings"
- "inspections"
description: "Информация о странице."
description: "Карточка компании."
data:
required:
- "items"
- "total"
type: "object"
properties:
total:
type: "integer"
format: "int64"
items:
maxItems: 100
type: "array"
items:
required:
- "contractId"
- "counterpartyOgrn"
- "role"
type: "object"
properties:
contractId:
pattern: "^(\\d{19})$"
type: "string"
counterpartyOgrn:
pattern: "^\\d{13,15}$"
type: "string"
purchaseObjectTypeName:
type: "string"
format: "string"
nullable: true
stageCode:
type: "string"
description: "Статус контракта:\n\n\n* `execution` —\
\ исполнение;\n\n* `stopped` — аннулировано;\n\n*\
\ `completed` — исполнение завершено;\n\n* `canceled`\
\ — исполнение прекращено;\n\n* `unknown` — неизве\
стный статус."
enum:
- "execution"
- "completed"
- "canceled"
- "stopped"
- "unknown"
role:
type: "string"
description: "Роль в контракте."
enum:
- "supplier"
- "customer"
price:
type: "number"
format: "double"
nullable: true
description: "Гос. контракты компании."
example:
companyCard:
statusType: "active"
requisites:
inn: "000000000000"
ogrn: "1000000000000"
kpp: "000000000"
shortName: "ПАО \"НАЗВАНИЕ\""
fullName: "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"НАЗВАНИЕ\""
dateReg: "1996-06-21"
terminationDt: "2020-11-20"
status: "Действующая организация"
authorizedCapitalAmount: 3975771140
ogrnAssignDate: "2000-01-01"
legalAddress: "119019, г Москва, ул Арбат"
city: "Москва"
pages:
- page: "okved"
- page: "contract"
- page: "license"
- page: "history"
- page: "trafficLight"
- page: "feedback"
- page: "financialStatements"
data:
total: 164
items:
- contractId: "0173200000000000071"
counterpartyOgrn: "1000000000000"
purchaseObjectTypeName: "Услуги"
stageCode: "completed"
role: "supplier"
price: 612000
- contractId: "1490000000000000006"
counterpartyOgrn: "1000000000000"
purchaseObjectTypeName: "Услуги"
stageCode: "execution"
role: "supplier"
price: 664976
- contractId: "1870000000000000002"
counterpartyOgrn: "1000000000000"
purchaseObjectTypeName: "Услуги"
stageCode: "execution"
role: "supplier"
price: 6000000
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "INVALID"
errorMessage: "Некорректный ОГРН: 1000000000000"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "NO_DATA"
errorMessage: "Данные не найдены: ОГРН 000000000000000"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/counterparty/excerpt:
get:
tags:
- "Проверка контрагентов"
summary: "Получить общую выписку для проверки контрагента по ОГРН/ОГРНИП"
description: "Метод для получения выписки по контрагенту — тип компании, вып\
иска по организации, выписка по ИП, общая информация о компании."
operationId: "getApiV1CounterpartyExcerpt"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "ogrn"
in: "query"
description: "Основной государственный регистрационный номер."
required: true
style: "form"
explode: true
schema:
pattern: "^\\d{13,15}$"
type: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "companyCard"
- "companyType"
- "excerpt"
type: "object"
properties:
companyType:
type: "string"
description: "Тип компании."
enum:
- "entrepreneur"
- "company"
companyExcerpt:
required:
- "address"
- "bankruptcyMessage"
- "expressExcerpt"
- "fts"
- "includeInList"
- "leaders"
- "okved"
- "phones"
type: "object"
properties:
shortName:
maxLength: 1000
type: "string"
description: "Краткое наименование компании."
nullable: true
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
description: "ИНН."
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
description: "ОГРН."
nullable: true
okpo:
pattern: "^(\\d{8}|\\d{10})$"
type: "string"
description: "ОКПО."
nullable: true
isActing:
type: "boolean"
description: "Признак действующей компании."
nullable: true
normName:
maxLength: 1000
type: "string"
description: "Нормализованное наименование компании."
nullable: true
shortNameRus:
maxLength: 1000
type: "string"
description: "Краткое наименование компании."
nullable: true
shortNameEn:
maxLength: 1000
type: "string"
description: "Краткое наименование компании на английском\
\ языке."
nullable: true
dateFirstReg:
type: "string"
description: "Дата регистрации."
format: "date"
nullable: true
fullNameRus:
maxLength: 1000
type: "string"
description: "Полное наименование компании на русском."
nullable: true
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "КПП."
nullable: true
bik:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "БИК."
nullable: true
email:
type: "string"
description: "Электронная почта."
format: "email"
nullable: true
www:
maxLength: 512
type: "string"
description: "Веб-сайт."
nullable: true
registerNumber:
maxLength: 512
type: "string"
description: "Регистрационный номер."
nullable: true
okato:
required:
- "value"
type: "object"
properties:
value:
type: "string"
format: "string"
code:
pattern: "^(\\d{2,11})$"
type: "string"
nullable: true
regionName:
maxLength: 512
type: "string"
description: "Название региона."
nullable: true
regionCode:
type: "integer"
description: "Код региона."
format: "int32"
nullable: true
description: "ОКАТО."
status:
required:
- "code"
- "isActing"
type: "object"
properties:
isActing:
type: "boolean"
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
text:
type: "string"
format: "string"
nullable: true
type:
type: "string"
format: "string"
nullable: true
code:
type: "integer"
format: "int32"
groupId:
type: "integer"
format: "int32"
nullable: true
groupName:
type: "string"
format: "string"
nullable: true
description: "Статус."
phones:
maxItems: 200
type: "array"
items:
type: "object"
properties:
code:
pattern: "^\\d{3,5}$"
type: "string"
description: "Зоновый код (код города/оператора)."
nullable: true
number:
pattern: "^\\d{5,7}$"
type: "string"
description: "Местный номер."
nullable: true
description: "Номера телефонов."
finance:
type: "object"
properties:
balanceType:
type: "integer"
format: "int64"
nullable: true
periods:
maxItems: 200
type: "array"
description: "Бухгалтерская отчетность."
nullable: true
items:
type: "object"
properties:
periodName:
maxLength: 512
type: "string"
description: "Отчетный период."
nullable: true
dateBegin:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Начало периода."
format: "string"
nullable: true
dateEnd:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Конец периода."
format: "string"
nullable: true
data:
maxItems: 200
type: "array"
nullable: true
items:
type: "object"
properties:
form:
maxLength: 512
type: "string"
description: "Форма."
nullable: true
section:
maxLength: 512
type: "string"
description: "Раздел."
nullable: true
name:
maxLength: 512
type: "string"
description: "Наименование."
nullable: true
code:
maxLength: 512
type: "string"
description: "Код."
nullable: true
value:
maxLength: 512
type: "string"
description: "Значение."
nullable: true
id:
type: "integer"
description: "Идентификатор списка."
format: "int32"
nullable: true
leaders:
maxItems: 500
type: "array"
description: "Руководители."
items:
type: "object"
properties:
actualDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Дата актуальности."
format: "string"
nullable: true
name:
type: "string"
description: "Наименование."
format: "string"
nullable: true
position:
type: "string"
description: "Должность."
format: "string"
nullable: true
managementCompany:
type: "string"
format: "string"
nullable: true
managementCompanyINN:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
structure:
type: "object"
properties:
countCoownerFCSM:
type: "integer"
description: "Количество совладельцев (данные компании\
/ФСФР)."
format: "int32"
nullable: true
countCoownerRosstat:
type: "integer"
description: "Количество совладельцев (Росстат)."
format: "int32"
nullable: true
countCoownerEGRUL:
type: "integer"
description: "Количество совладельцев (ЕГРЮЛ)."
format: "int32"
nullable: true
countBranch:
type: "integer"
description: "Количество филиалов (данные компании)."
format: "int32"
nullable: true
countBranchRosstat:
type: "integer"
description: "Количество филиалов (Росстат)."
format: "int32"
nullable: true
countBranchEGRUL:
type: "integer"
description: "Количество филиалов (ЕГРЮЛ)."
format: "int32"
nullable: true
countCoownerDKCPFR:
type: "integer"
format: "int32"
nullable: true
countCoownerUkrStat:
type: "integer"
format: "int32"
nullable: true
countAffiliatedCompany:
type: "integer"
format: "int32"
nullable: true
countAffiliatedCompanyFCSM:
type: "integer"
description: "Количество дочерних компаний (данные ком\
пании)."
format: "int32"
nullable: true
countAffiliatedCompanyRosstat:
type: "integer"
description: "Количество дочерних компаний (Росстат)."
format: "int32"
nullable: true
countAffiliatedCompanyEGRUL:
type: "integer"
description: "Количество дочерних компаний (ЕГРЮЛ)."
format: "int32"
nullable: true
nonprofitOrganizationRosstat:
type: "integer"
description: "Количество некоммерческих партнерств (Ро\
сстат)."
format: "int32"
nullable: true
activeBranchesRosstatNumber:
type: "integer"
format: "int32"
nullable: true
activeAffiliatedCompaniesNumber:
type: "integer"
format: "int32"
nullable: true
proceedings:
required:
- "active"
- "executed"
type: "object"
properties:
active:
type: "integer"
description: "Количество непогашенных обязательств."
format: "int32"
executed:
type: "integer"
description: "Количество погашенных обязательств."
format: "int32"
charterCapital:
type: "object"
properties:
value:
maxLength: 512
type: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
currencyCode:
maxLength: 512
type: "string"
nullable: true
currencyName:
maxLength: 512
type: "string"
nullable: true
charterCapitalHistory:
maxItems: 200
type: "array"
description: "История изменения уставного капитала."
nullable: true
items:
type: "object"
properties:
value:
maxLength: 512
type: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
currencyCode:
maxLength: 512
type: "string"
nullable: true
currencyName:
maxLength: 512
type: "string"
nullable: true
companyWithSameInfo:
type: "object"
properties:
telephoneCount:
required:
- "value"
type: "object"
properties:
value:
type: "integer"
format: "int32"
phoneCode:
pattern: "^\\d{3,5}$"
type: "string"
description: "Зоновый код (код города/оператора)."
nullable: true
phoneNumber:
pattern: "^\\d{5,7}$"
type: "string"
description: "Местный номер."
nullable: true
phoneList:
maxItems: 500
type: "array"
nullable: true
items:
required:
- "value"
type: "object"
properties:
value:
type: "integer"
format: "int32"
phoneCode:
pattern: "^\\d{3,5}$"
type: "string"
description: "Зоновый код (код города/оператора\
)."
nullable: true
phoneNumber:
pattern: "^\\d{5,7}$"
type: "string"
description: "Местный номер."
nullable: true
addressCount:
type: "integer"
format: "int32"
nullable: true
addressWithoutRoomCount:
type: "integer"
format: "int32"
nullable: true
addressNotAffiliatedCount:
type: "integer"
format: "int32"
nullable: true
addressFTSCount:
type: "integer"
format: "int32"
nullable: true
managerCountInCountry:
type: "integer"
format: "int32"
nullable: true
managerCountInRegion:
type: "integer"
format: "int32"
nullable: true
managerInnCount:
type: "integer"
format: "int32"
nullable: true
companyLiquidatedWithSameInfo:
type: "object"
properties:
addressCount:
type: "integer"
format: "int32"
nullable: true
addressWithoutRoomCount:
type: "integer"
format: "int32"
nullable: true
arbitrationCases:
type: "object"
properties:
cases:
maxItems: 200
type: "array"
nullable: true
items:
required:
- "defendant"
- "plaintiff"
- "thirdOrOtherPerson"
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
plaintiff:
required:
- "casesNumber"
- "sum"
type: "object"
properties:
casesNumber:
type: "integer"
format: "int32"
sum:
type: "string"
format: "string"
defendant:
required:
- "casesNumber"
- "sum"
type: "object"
properties:
casesNumber:
type: "integer"
format: "int32"
sum:
type: "string"
format: "string"
thirdOrOtherPerson:
required:
- "casesNumber"
type: "object"
properties:
casesNumber:
type: "integer"
format: "int32"
total:
type: "integer"
format: "int32"
nullable: true
considered:
type: "integer"
format: "int32"
nullable: true
appealed:
type: "integer"
format: "int32"
nullable: true
decisionsAndRulings:
type: "integer"
format: "int32"
nullable: true
completed:
type: "integer"
format: "int32"
nullable: true
federalTaxRegistrationPayment:
type: "object"
properties:
regDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
regAuthority:
maxLength: 1000
type: "string"
nullable: true
regAuthorityAddress:
maxLength: 1000
type: "string"
nullable: true
regAuthorityCode:
maxLength: 512
type: "string"
nullable: true
federalTaxRegistrationCurrent:
type: "object"
properties:
regDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
regAuthority:
maxLength: 1000
type: "string"
nullable: true
regAuthorityAddress:
maxLength: 1000
type: "string"
nullable: true
regAuthorityCode:
maxLength: 512
type: "string"
nullable: true
okved:
maxItems: 2500
type: "array"
description: "ОКВЭД."
items:
required:
- "isMain"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
description: "Код."
nullable: true
name:
maxLength: 1000
type: "string"
description: "Наименование."
nullable: true
isMain:
type: "boolean"
description: "Признак основного ОКВЭД."
isMainEgrul:
type: "boolean"
description: "Признак основного ОКВЭД по данным ЕГРЮ\
Л."
nullable: true
isMainRosstat:
type: "boolean"
description: "Признак основного ОКВЭД по данным Росс\
тата."
nullable: true
stateContracts:
type: "object"
properties:
federalLaw94:
maxItems: 200
type: "array"
description: "Данные о госконтрактах за соответствующи\
й год."
nullable: true
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
description: "Значение года."
format: "int32"
tenders:
type: "object"
properties:
admittedNumber:
type: "integer"
description: "Число допусков к тендеру."
format: "int32"
nullable: true
notAdmittedNumber:
type: "integer"
description: "Число недопусков к тендеру."
format: "int32"
nullable: true
winnerNumber:
type: "integer"
description: "Число выигрышей тендеров."
format: "int32"
nullable: true
contracts:
type: "object"
properties:
signedNumber:
type: "integer"
description: "Число подписанных контрактов."
format: "int32"
nullable: true
sum:
type: "string"
description: "Контрактов подписано на сумму\
, рубли."
format: "string"
nullable: true
federalLaw223:
maxItems: 200
type: "array"
description: "Данные о тендерах за соответствующий год\
."
nullable: true
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
description: "Значение года."
format: "int32"
tenders:
type: "object"
properties:
admittedNumber:
type: "integer"
description: "Число допусков к тендеру."
format: "int32"
nullable: true
notAdmittedNumber:
type: "integer"
description: "Число недопусков к тендеру."
format: "int32"
nullable: true
winnerNumber:
type: "integer"
description: "Число выигрышей тендеров."
format: "int32"
nullable: true
contracts:
type: "object"
properties:
signedNumber:
type: "integer"
description: "Число подписанных контрактов."
format: "int32"
nullable: true
sum:
type: "string"
description: "Контрактов подписано на сумму\
, рубли."
format: "string"
nullable: true
address:
maxItems: 200
type: "array"
description: "Местонахождение."
items:
type: "object"
properties:
postCode:
pattern: "^(\\d{6})$"
type: "string"
nullable: true
address:
maxLength: 1000
type: "string"
nullable: true
streetName:
maxLength: 1000
type: "string"
nullable: true
buildingNumber:
maxLength: 512
type: "string"
nullable: true
fiasGUID:
type: "string"
format: "uuid"
nullable: true
isHouseFiasGUID:
type: "boolean"
nullable: true
fiasCode:
maxLength: 512
type: "string"
nullable: true
fiasRegion:
maxLength: 512
type: "string"
nullable: true
fiasArea:
maxLength: 512
type: "string"
nullable: true
fiasCity:
maxLength: 512
type: "string"
nullable: true
fiasPlace:
maxLength: 512
type: "string"
nullable: true
fiasPlan:
maxLength: 512
type: "string"
nullable: true
fiasStreet:
maxLength: 512
type: "string"
nullable: true
actualDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
buildingType:
maxLength: 512
type: "string"
nullable: true
businessCenterName:
maxLength: 512
type: "string"
nullable: true
fts:
maxItems: 200
type: "array"
items:
type: "object"
properties:
endDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Контрактов подписано на сумму, рубли."
format: "string"
nullable: true
income:
type: "string"
format: "string"
nullable: true
expenses:
type: "string"
format: "string"
nullable: true
taxes:
type: "object"
properties:
sum:
type: "string"
format: "string"
nullable: true
tax:
maxItems: 200
type: "array"
nullable: true
items:
type: "object"
properties:
id:
type: "integer"
format: "int32"
nullable: true
name:
type: "string"
format: "string"
nullable: true
sum:
type: "string"
format: "string"
nullable: true
taxArrears:
type: "object"
properties:
tax:
maxItems: 200
type: "array"
nullable: true
items:
required:
- "id"
type: "object"
properties:
id:
type: "integer"
description: "Идентификатор налога/сбора."
format: "int64"
name:
type: "string"
description: "Наименование налога/сбора."
format: "string"
nullable: true
finesSum:
type: "string"
description: "Сумма задолженности по пени."
format: "string"
nullable: true
penaltiesSum:
type: "string"
description: "Сумма задолженности по штраф\
ам."
format: "string"
nullable: true
sum:
type: "string"
format: "string"
nullable: true
taxPenalties:
type: "object"
properties:
sum:
type: "string"
format: "string"
nullable: true
includeInList:
maxItems: 200
type: "array"
items:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
bankruptcyMessage:
maxItems: 3000
type: "array"
items:
type: "object"
properties:
idType:
type: "integer"
format: "int64"
nullable: true
messageType:
type: "string"
format: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
decisionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
caseNumber:
type: "string"
format: "string"
nullable: true
caseId:
type: "integer"
format: "int64"
nullable: true
expressExcerpt:
required:
- "companyType"
- "frozenAccountDecisions"
- "negativeLists"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
description: "ИНН."
nullable: true
companyType:
type: "string"
description: "Тип компании."
enum:
- "entrepreneur"
- "company"
companyWithSameInfo:
required:
- "sameAddress"
- "sameManager"
- "samePhone"
type: "object"
properties:
sameManager:
type: "object"
properties:
manager:
maxLength: 512
type: "string"
nullable: true
managerCountInCountry:
type: "integer"
format: "int32"
nullable: true
managerInnCount:
type: "integer"
format: "int32"
nullable: true
sameAddress:
type: "object"
properties:
address:
maxLength: 1000
type: "string"
nullable: true
addressCount:
type: "integer"
format: "int32"
nullable: true
samePhone:
type: "object"
properties:
phoneCode:
pattern: "^\\d{3,5}$"
type: "string"
description: "Зоновый код (код города/оператор\
а)."
nullable: true
phoneNumber:
pattern: "^\\d{5,7}$"
type: "string"
description: "Местный номер."
nullable: true
phoneCount:
type: "integer"
format: "int32"
nullable: true
negativeLists:
maxItems: 200
type: "array"
description: "Негативные списки, в которых состоит ком\
пания."
items:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
status:
required:
- "code"
- "isActing"
type: "object"
properties:
isActing:
type: "boolean"
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
text:
type: "string"
format: "string"
nullable: true
type:
type: "string"
format: "string"
nullable: true
code:
type: "integer"
format: "int32"
groupId:
type: "integer"
format: "int32"
nullable: true
groupName:
type: "string"
format: "string"
nullable: true
description: "Статус."
okvedInfo:
required:
- "okvedCount"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
nullable: true
name:
type: "string"
format: "string"
nullable: true
okvedCount:
type: "integer"
format: "int32"
netIncome:
required:
- "dateBegin"
- "dateEnd"
- "periodName"
- "sum"
type: "object"
properties:
periodName:
maxLength: 512
type: "string"
dateBegin:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
dateEnd:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
sum:
maxLength: 512
type: "string"
taxYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
financeYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
stateContractYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
activeProceedingsCount:
type: "integer"
description: "Количество активных исполнительных произ\
водств (долгов)."
format: "int32"
nullable: true
bankruptcyMessage:
type: "object"
properties:
idType:
type: "integer"
format: "int64"
nullable: true
messageType:
type: "string"
format: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
decisionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
caseNumber:
type: "string"
format: "string"
nullable: true
caseId:
type: "integer"
format: "int64"
nullable: true
frozenAccountDecisions:
maxItems: 200
type: "array"
description: "Есть решение о приостановлении операций\
\ по счетам."
items:
type: "object"
properties:
sparkId:
required:
- "isEven"
- "isOne"
- "isPowerOfTwo"
- "isZero"
- "sign"
type: "object"
properties:
isPowerOfTwo:
type: "boolean"
readOnly: true
isZero:
type: "boolean"
readOnly: true
isOne:
type: "boolean"
readOnly: true
isEven:
type: "boolean"
readOnly: true
sign:
type: "integer"
format: "int32"
readOnly: true
reason:
type: "object"
properties:
id:
type: "integer"
format: "int32"
nullable: true
name:
maxLength: 1000
type: "string"
nullable: true
taxAuthority:
type: "object"
properties:
code:
maxLength: 512
type: "string"
nullable: true
name:
maxLength: 1000
type: "string"
nullable: true
bank:
type: "object"
properties:
sparkId:
required:
- "isEven"
- "isOne"
- "isPowerOfTwo"
- "isZero"
- "sign"
type: "object"
properties:
isPowerOfTwo:
type: "boolean"
readOnly: true
isZero:
type: "boolean"
readOnly: true
isOne:
type: "boolean"
readOnly: true
isEven:
type: "boolean"
readOnly: true
sign:
type: "integer"
format: "int32"
readOnly: true
bik:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
name:
maxLength: 512
type: "string"
nullable: true
number:
maxLength: 512
type: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
arbitrationCasesInfo:
required:
- "count"
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
count:
type: "integer"
format: "int32"
description: "Выписка по организации."
entrepreneurExcerpt:
required:
- "bankruptcyMessage"
- "expressExcerpt"
- "includeInList"
- "okved"
- "phoneList"
- "submittedStatements"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
ogrnip:
pattern: "^\\d{15}$"
type: "string"
nullable: true
okpo:
pattern: "^(\\d{8}|\\d{10})$"
type: "string"
nullable: true
birthDate:
type: "string"
format: "date"
nullable: true
birthPlace:
type: "string"
format: "string"
nullable: true
fullNameRus:
type: "string"
format: "string"
nullable: true
sex:
type: "string"
enum:
- "man"
- "woman"
- "undefined"
dateReg:
type: "string"
format: "date"
nullable: true
okato:
required:
- "value"
type: "object"
properties:
value:
type: "string"
format: "string"
code:
pattern: "^(\\d{2,11})$"
type: "string"
nullable: true
regionName:
maxLength: 512
type: "string"
description: "Название региона."
nullable: true
regionCode:
type: "integer"
description: "Код региона."
format: "int32"
nullable: true
description: "ОКАТО."
okopf:
type: "object"
properties:
code:
pattern: "^(\\d{5})$"
type: "string"
nullable: true
name:
maxLength: 512
type: "string"
nullable: true
phoneList:
maxItems: 200
type: "array"
items:
type: "object"
properties:
code:
pattern: "^\\d{3,5}$"
type: "string"
description: "Зоновый код (код города/оператора)."
nullable: true
number:
pattern: "^\\d{5,7}$"
type: "string"
description: "Местный номер."
nullable: true
description: "Номера телефонов."
status:
required:
- "code"
- "isActing"
type: "object"
properties:
isActing:
type: "boolean"
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
text:
type: "string"
format: "string"
nullable: true
type:
type: "string"
format: "string"
nullable: true
code:
type: "integer"
format: "int32"
groupId:
type: "integer"
format: "int32"
nullable: true
groupName:
type: "string"
format: "string"
nullable: true
description: "Статус."
includeInList:
maxItems: 200
type: "array"
items:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
federalTaxRegistrationPayment:
type: "object"
properties:
regDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
regAuthority:
maxLength: 1000
type: "string"
nullable: true
regAuthorityAddress:
maxLength: 1000
type: "string"
nullable: true
regAuthorityCode:
maxLength: 512
type: "string"
nullable: true
federalTaxRegistrationCurrent:
type: "object"
properties:
regDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
regAuthority:
maxLength: 1000
type: "string"
nullable: true
regAuthorityAddress:
maxLength: 1000
type: "string"
nullable: true
regAuthorityCode:
maxLength: 512
type: "string"
nullable: true
citizenship:
required:
- "code"
- "name"
type: "object"
properties:
code:
type: "integer"
format: "int32"
name:
type: "string"
format: "string"
okved:
maxItems: 2500
type: "array"
items:
required:
- "isMain"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
description: "Код."
nullable: true
name:
maxLength: 1000
type: "string"
description: "Наименование."
nullable: true
isMain:
type: "boolean"
description: "Признак основного ОКВЭД."
isMainEgrul:
type: "boolean"
description: "Признак основного ОКВЭД по данным ЕГРЮ\
Л."
nullable: true
isMainRosstat:
type: "boolean"
description: "Признак основного ОКВЭД по данным Росс\
тата."
nullable: true
registrationInFunds:
type: "object"
properties:
pensionFund:
required:
- "regAuthority"
- "registerNumber"
- "registrationDate"
type: "object"
properties:
registrationDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
deregistrationDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
registerNumber:
type: "string"
format: "string"
regAuthority:
type: "string"
format: "string"
socialInsuranceFund:
required:
- "regAuthority"
- "registerNumber"
- "registrationDate"
type: "object"
properties:
registrationDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
deregistrationDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
registerNumber:
type: "string"
format: "string"
regAuthority:
type: "string"
format: "string"
compulsoryMedicalInsuranceFund:
required:
- "regAuthority"
- "registerNumber"
- "registrationDate"
type: "object"
properties:
registrationDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
deregistrationDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
registerNumber:
type: "string"
format: "string"
regAuthority:
type: "string"
format: "string"
submittedStatements:
maxItems: 200
type: "array"
items:
type: "object"
properties:
form:
type: "string"
format: "string"
nullable: true
submissionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
availabilityDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
grn:
type: "string"
format: "string"
nullable: true
decisionType:
type: "string"
format: "string"
nullable: true
stateContracts:
type: "object"
properties:
federalLaw94:
maxItems: 200
type: "array"
description: "Данные о госконтрактах за соответствующи\
й год."
nullable: true
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
description: "Значение года."
format: "int32"
tenders:
type: "object"
properties:
admittedNumber:
type: "integer"
description: "Число допусков к тендеру."
format: "int32"
nullable: true
notAdmittedNumber:
type: "integer"
description: "Число недопусков к тендеру."
format: "int32"
nullable: true
winnerNumber:
type: "integer"
description: "Число выигрышей тендеров."
format: "int32"
nullable: true
contracts:
type: "object"
properties:
signedNumber:
type: "integer"
description: "Число подписанных контрактов."
format: "int32"
nullable: true
sum:
type: "string"
description: "Контрактов подписано на сумму\
, рубли."
format: "string"
nullable: true
federalLaw223:
maxItems: 200
type: "array"
description: "Данные о тендерах за соответствующий год\
."
nullable: true
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
description: "Значение года."
format: "int32"
tenders:
type: "object"
properties:
admittedNumber:
type: "integer"
description: "Число допусков к тендеру."
format: "int32"
nullable: true
notAdmittedNumber:
type: "integer"
description: "Число недопусков к тендеру."
format: "int32"
nullable: true
winnerNumber:
type: "integer"
description: "Число выигрышей тендеров."
format: "int32"
nullable: true
contracts:
type: "object"
properties:
signedNumber:
type: "integer"
description: "Число подписанных контрактов."
format: "int32"
nullable: true
sum:
type: "string"
description: "Контрактов подписано на сумму\
, рубли."
format: "string"
nullable: true
arbitrationCases:
type: "object"
properties:
cases:
maxItems: 200
type: "array"
nullable: true
items:
required:
- "defendant"
- "plaintiff"
- "thirdOrOtherPerson"
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
plaintiff:
required:
- "casesNumber"
- "sum"
type: "object"
properties:
casesNumber:
type: "integer"
format: "int32"
sum:
type: "string"
format: "string"
defendant:
required:
- "casesNumber"
- "sum"
type: "object"
properties:
casesNumber:
type: "integer"
format: "int32"
sum:
type: "string"
format: "string"
thirdOrOtherPerson:
required:
- "casesNumber"
type: "object"
properties:
casesNumber:
type: "integer"
format: "int32"
total:
type: "integer"
format: "int32"
nullable: true
considered:
type: "integer"
format: "int32"
nullable: true
appealed:
type: "integer"
format: "int32"
nullable: true
decisionsAndRulings:
type: "integer"
format: "int32"
nullable: true
completed:
type: "integer"
format: "int32"
nullable: true
executionProceedings:
required:
- "active"
- "executed"
type: "object"
properties:
active:
type: "integer"
description: "Количество непогашенных обязательств."
format: "int32"
executed:
type: "integer"
description: "Количество погашенных обязательств."
format: "int32"
bankruptcyMessage:
maxItems: 3000
type: "array"
items:
type: "object"
properties:
idType:
type: "integer"
format: "int64"
nullable: true
messageType:
type: "string"
format: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
decisionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
caseNumber:
type: "string"
format: "string"
nullable: true
caseId:
type: "integer"
format: "int64"
nullable: true
expressExcerpt:
required:
- "companyType"
- "frozenAccountDecisions"
- "negativeLists"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
description: "ИНН."
nullable: true
companyType:
type: "string"
description: "Тип компании."
enum:
- "entrepreneur"
- "company"
companyWithSameInfo:
required:
- "sameAddress"
- "sameManager"
- "samePhone"
type: "object"
properties:
sameManager:
type: "object"
properties:
manager:
maxLength: 512
type: "string"
nullable: true
managerCountInCountry:
type: "integer"
format: "int32"
nullable: true
managerInnCount:
type: "integer"
format: "int32"
nullable: true
sameAddress:
type: "object"
properties:
address:
maxLength: 1000
type: "string"
nullable: true
addressCount:
type: "integer"
format: "int32"
nullable: true
samePhone:
type: "object"
properties:
phoneCode:
pattern: "^\\d{3,5}$"
type: "string"
description: "Зоновый код (код города/оператор\
а)."
nullable: true
phoneNumber:
pattern: "^\\d{5,7}$"
type: "string"
description: "Местный номер."
nullable: true
phoneCount:
type: "integer"
format: "int32"
nullable: true
negativeLists:
maxItems: 200
type: "array"
description: "Негативные списки, в которых состоит ком\
пания."
items:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
status:
required:
- "code"
- "isActing"
type: "object"
properties:
isActing:
type: "boolean"
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
text:
type: "string"
format: "string"
nullable: true
type:
type: "string"
format: "string"
nullable: true
code:
type: "integer"
format: "int32"
groupId:
type: "integer"
format: "int32"
nullable: true
groupName:
type: "string"
format: "string"
nullable: true
description: "Статус."
okvedInfo:
required:
- "okvedCount"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
nullable: true
name:
type: "string"
format: "string"
nullable: true
okvedCount:
type: "integer"
format: "int32"
netIncome:
required:
- "dateBegin"
- "dateEnd"
- "periodName"
- "sum"
type: "object"
properties:
periodName:
maxLength: 512
type: "string"
dateBegin:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
dateEnd:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
sum:
maxLength: 512
type: "string"
taxYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
financeYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
stateContractYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
activeProceedingsCount:
type: "integer"
description: "Количество активных исполнительных произ\
водств (долгов)."
format: "int32"
nullable: true
bankruptcyMessage:
type: "object"
properties:
idType:
type: "integer"
format: "int64"
nullable: true
messageType:
type: "string"
format: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
decisionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
caseNumber:
type: "string"
format: "string"
nullable: true
caseId:
type: "integer"
format: "int64"
nullable: true
frozenAccountDecisions:
maxItems: 200
type: "array"
description: "Есть решение о приостановлении операций\
\ по счетам."
items:
type: "object"
properties:
sparkId:
required:
- "isEven"
- "isOne"
- "isPowerOfTwo"
- "isZero"
- "sign"
type: "object"
properties:
isPowerOfTwo:
type: "boolean"
readOnly: true
isZero:
type: "boolean"
readOnly: true
isOne:
type: "boolean"
readOnly: true
isEven:
type: "boolean"
readOnly: true
sign:
type: "integer"
format: "int32"
readOnly: true
reason:
type: "object"
properties:
id:
type: "integer"
format: "int32"
nullable: true
name:
maxLength: 1000
type: "string"
nullable: true
taxAuthority:
type: "object"
properties:
code:
maxLength: 512
type: "string"
nullable: true
name:
maxLength: 1000
type: "string"
nullable: true
bank:
type: "object"
properties:
sparkId:
required:
- "isEven"
- "isOne"
- "isPowerOfTwo"
- "isZero"
- "sign"
type: "object"
properties:
isPowerOfTwo:
type: "boolean"
readOnly: true
isZero:
type: "boolean"
readOnly: true
isOne:
type: "boolean"
readOnly: true
isEven:
type: "boolean"
readOnly: true
sign:
type: "integer"
format: "int32"
readOnly: true
bik:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
name:
maxLength: 512
type: "string"
nullable: true
number:
maxLength: 512
type: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
arbitrationCasesInfo:
required:
- "count"
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
count:
type: "integer"
format: "int32"
description: "Выписка по ИП."
companyCard:
required:
- "pages"
- "requisites"
- "statusType"
type: "object"
properties:
statusType:
type: "string"
description: "Статус компании."
enum:
- "active"
- "reorganizing"
- "liquidating"
- "liquidated"
- "bankrupting"
- "unknown"
requisites:
required:
- "ogrn"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
shortName:
type: "string"
format: "string"
nullable: true
fullName:
type: "string"
format: "string"
nullable: true
dateReg:
type: "string"
format: "date"
nullable: true
terminationDt:
type: "string"
format: "date"
nullable: true
status:
type: "string"
format: "string"
nullable: true
authorizedCapitalAmount:
type: "number"
format: "double"
nullable: true
ogrnAssignDate:
type: "string"
format: "date"
nullable: true
legalAddress:
type: "string"
format: "string"
nullable: true
city:
type: "string"
format: "string"
nullable: true
description: "Реквизиты."
pages:
maxItems: 20
type: "array"
items:
required:
- "page"
type: "object"
properties:
page:
type: "string"
description: "Код страницы."
enum:
- "okved"
- "contract"
- "license"
- "history"
- "trafficLight"
- "relatedCompanies"
- "feedback"
- "financialStatements"
- "enforcementProceedings"
- "inspections"
description: "Информация о странице."
description: "Карточка компании."
excerpt:
required:
- "checkResult"
- "contractSummary"
- "contracts"
- "financialStatementsResponse"
- "founders"
- "history"
- "leaders"
- "licenseSummary"
- "licenses"
- "okvedSummary"
- "relatedCompanies"
- "relationSummary"
- "requisites"
- "trafficLightColors"
type: "object"
properties:
requisites:
type: "object"
properties:
legalForm:
type: "string"
format: "string"
nullable: true
organizationSizeDesc:
type: "string"
format: "string"
nullable: true
entityRegistrationDate:
type: "string"
format: "date"
nullable: true
regAuthorityAddressTxt:
type: "string"
format: "string"
nullable: true
regAuthorityName:
type: "string"
format: "string"
nullable: true
pfrRegistrationNumber:
type: "string"
format: "string"
nullable: true
pfrAuthorityName:
type: "string"
format: "string"
nullable: true
pfrRegistrationDate:
type: "string"
format: "date"
nullable: true
insRegistrationNumber:
type: "string"
format: "string"
nullable: true
insAuthorityName:
type: "string"
format: "string"
nullable: true
insRegistrationDate:
type: "string"
format: "date"
nullable: true
description: "Дополнительные реквизиты."
okvedSummary:
required:
- "additional"
- "count"
- "main"
type: "object"
properties:
count:
type: "integer"
format: "int64"
main:
maxItems: 100
type: "array"
items:
required:
- "code"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
description:
type: "string"
format: "string"
nullable: true
description: "ОКВЭД."
additional:
maxItems: 100
type: "array"
items:
required:
- "code"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
description:
type: "string"
format: "string"
nullable: true
description: "ОКВЭД."
description: "ОКВЭДы."
contractSummary:
required:
- "admittedCount"
- "count"
- "notAdmittedCount"
type: "object"
properties:
count:
type: "integer"
format: "int64"
admittedCount:
type: "integer"
format: "int64"
notAdmittedCount:
type: "integer"
format: "int64"
totalValue:
type: "number"
format: "double"
nullable: true
description: "Гос. контракты."
licenseSummary:
required:
- "active"
- "inactive"
- "total"
type: "object"
properties:
total:
type: "integer"
format: "int64"
active:
type: "integer"
format: "int64"
inactive:
type: "integer"
format: "int64"
description: "Количество лицензий."
trafficLightColors:
required:
- "greenCount"
- "redCount"
- "yellowCount"
type: "object"
properties:
redCount:
type: "integer"
format: "int32"
yellowCount:
type: "integer"
format: "int32"
greenCount:
type: "integer"
format: "int32"
description: "Результаты экспресс-проверки."
innerCheckResult:
required:
- "activeProceedings"
- "bankruptcyMessage"
- "defendant"
- "defendantDynamic"
- "disqualifiedPersons"
- "executedProceedings"
- "finance"
- "invalidLegalAddress"
- "isNegative"
- "plaintiff"
- "sameAddressNumber"
- "sameManager"
- "taxDebt"
- "taxReport"
- "thirdOrOtherPerson"
- "unfairSupplier"
type: "object"
properties:
bankruptcyMessage:
required:
- "color"
type: "object"
properties:
value:
type: "object"
properties:
idType:
type: "integer"
format: "int64"
nullable: true
messageType:
type: "string"
format: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\\
d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
decisionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\\
d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
caseNumber:
type: "string"
format: "string"
nullable: true
caseId:
type: "integer"
format: "int64"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
plaintiff:
required:
- "color"
type: "object"
properties:
value:
required:
- "maxDate"
- "minDate"
- "totalCases"
type: "object"
properties:
minDate:
type: "integer"
description: "Наименьший год с судебными делам\
и."
format: "int32"
maxDate:
type: "integer"
description: "Наибольший год с судебными делам\
и."
format: "int32"
totalCases:
type: "integer"
format: "int32"
description: "Статистика по судебным делам."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
thirdOrOtherPerson:
required:
- "color"
type: "object"
properties:
value:
required:
- "maxDate"
- "minDate"
- "totalCases"
type: "object"
properties:
minDate:
type: "integer"
description: "Наименьший год с судебными делам\
и."
format: "int32"
maxDate:
type: "integer"
description: "Наибольший год с судебными делам\
и."
format: "int32"
totalCases:
type: "integer"
format: "int32"
description: "Статистика по судебным делам."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
defendant:
required:
- "color"
type: "object"
properties:
value:
required:
- "maxDate"
- "minDate"
- "totalCases"
type: "object"
properties:
minDate:
type: "integer"
description: "Наименьший год с судебными делам\
и."
format: "int32"
maxDate:
type: "integer"
description: "Наибольший год с судебными делам\
и."
format: "int32"
totalCases:
type: "integer"
format: "int32"
description: "Статистика по судебным делам."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
defendantDynamic:
required:
- "color"
type: "object"
properties:
value:
required:
- "lastYear"
- "percent"
- "prevLastYear"
type: "object"
properties:
lastYear:
type: "integer"
format: "int32"
prevLastYear:
type: "integer"
format: "int32"
percent:
type: "number"
format: "double"
description: "Динамика судебных дел в качестве отв\
етчика."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
executedProceedings:
required:
- "color"
type: "object"
properties:
value:
type: "integer"
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
activeProceedings:
required:
- "color"
type: "object"
properties:
value:
type: "integer"
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
sameManager:
required:
- "color"
type: "object"
properties:
value:
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
sameManager:
type: "object"
properties:
manager:
maxLength: 512
type: "string"
nullable: true
managerCountInCountry:
type: "integer"
format: "int32"
nullable: true
managerInnCount:
type: "integer"
format: "int32"
nullable: true
description: "Массовый руководитель."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
sameAddressNumber:
required:
- "color"
type: "object"
properties:
value:
type: "integer"
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
finance:
required:
- "color"
type: "object"
properties:
value:
type: "object"
properties:
balanceType:
type: "integer"
format: "int64"
nullable: true
periods:
maxItems: 200
type: "array"
description: "Бухгалтерская отчетность."
nullable: true
items:
type: "object"
properties:
periodName:
maxLength: 512
type: "string"
description: "Отчетный период."
nullable: true
dateBegin:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\\
d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Начало периода."
format: "string"
nullable: true
dateEnd:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\\
d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Конец периода."
format: "string"
nullable: true
data:
maxItems: 200
type: "array"
nullable: true
items:
type: "object"
properties:
form:
maxLength: 512
type: "string"
description: "Форма."
nullable: true
section:
maxLength: 512
type: "string"
description: "Раздел."
nullable: true
name:
maxLength: 512
type: "string"
description: "Наименование."
nullable: true
code:
maxLength: 512
type: "string"
description: "Код."
nullable: true
value:
maxLength: 512
type: "string"
description: "Значение."
nullable: true
id:
type: "integer"
description: "Идентификатор списка\
."
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
isNegative:
required:
- "color"
- "value"
type: "object"
properties:
value:
required:
- "negativeListsCount"
type: "object"
properties:
negativeListsCount:
type: "integer"
format: "int32"
description: "Статистика негативных списков."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
unfairSupplier:
required:
- "color"
type: "object"
properties:
value:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
invalidLegalAddress:
required:
- "color"
type: "object"
properties:
value:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
disqualifiedPersons:
required:
- "color"
type: "object"
properties:
value:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
taxReport:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
taxDebt:
required:
- "color"
type: "object"
properties:
value:
required:
- "statDate"
- "sum"
type: "object"
properties:
sum:
type: "number"
format: "double"
statDate:
type: "string"
format: "date"
description: "Налоговая задолженность."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
description: "Результат внутренней проверки компании:\n\n\
* `BankruptcyMessage` — сообщения о банкротстве;\n\n* `Plaintiff`\
\ — судебные дела в качестве истца;\n\n* `ThirdOrOtherPerson`\
\ — судебные дела в качестве третьего лица;\n\n* `Defendant`\
\ — судебные дела в качестве ответчика;\n\n* `DefendantDynamic`\
\ — динамика судебных дел в качестве ответчика;\n\n* `ExecutedProceedings`\
\ — завершенные исполнительные производства;\n\n* `ActiveProceedings`\
\ — активные исполнительные производства;\n\n* `SameManager`\
\ — массовый руководитель;\n\n* `SameAddressNumber` — ма\
ссовый юридический адрес;\n\n* `Finance` — бухгалтерская\
\ отчетность;\n\n* `IsNegative` — негативные списки;\n\n\
* `UnfairSupplier` — реестр недобросовестных поставщиков\
;\n\n* `InvalidLegalAddress` — список компаний, отсутств\
ующих по юридическому адресу;\n\n* `DisqualifiedPersons`\
\ — реестр дисквалифицированных лиц;\n\n* `ReferenceCheckRecommended`\
\ — рекомендация проверки в справочных источниках;\n\n*\
\ `DueDiligenceRecommended` — рекомендация проведения до\
кументальной проверки (Due Diligence);\n\n* `TaxReport`\
\ — налоговая отчетность;\n\n* `TaxDebt` — налоговая зад\
олженность."
checkResult:
required:
- "admittedContractsAsSupplier"
- "authorizedCapitalAmount"
- "confidantChangeDate"
- "founderChangeDate"
- "legalAddressChangeDate"
- "legalForm"
- "licensedOkvedCount"
- "okvedCount"
- "registrationDate"
- "riskLevel"
- "status"
type: "object"
properties:
status:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
registrationDate:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
legalAddressChangeDate:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
founderChangeDate:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
confidantChangeDate:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
authorizedCapitalAmount:
required:
- "color"
type: "object"
properties:
value:
type: "number"
format: "double"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
admittedContractsAsSupplier:
required:
- "color"
- "value"
type: "object"
properties:
value:
required:
- "count"
type: "object"
properties:
count:
type: "integer"
format: "int64"
totalValue:
type: "number"
format: "double"
nullable: true
description: "Статистика по контрактам."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
legalForm:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
okvedCount:
required:
- "color"
- "value"
type: "object"
properties:
value:
type: "integer"
format: "int64"
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
licensedOkvedCount:
required:
- "color"
- "value"
type: "object"
properties:
value:
type: "integer"
format: "int64"
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
riskLevel:
required:
- "color"
type: "object"
properties:
value:
type: "integer"
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
description: "Результат проверки компании:\n\n* `Status` —\
\ статус компании;\n\n* `RegistrationDate` — проверка да\
ты регистрации на превышение трех лет;\n\n* `LegalAddressChangeDate`\
\ — проверка изменения юридического адреса за последний\
\ год;\n\n* `FounderChangeDate` — проверка изменения учр\
едителя за последний год;\n\n* `ConfidantChangeDate` — п\
роверка изменения руководителя за последний год;\n\n* `AuthorizedCapitalAmount`\
\ — проверка превышения уставного капитала минимального\
\ порога;\n\n* `AdmittedContractsAsSupplier` — участие в\
\ государственных закупках;\n\n* `LegalForm` — организац\
ионно-правовая форма организации;\n\n* `OkvedCount` — ко\
личество видов деятельности, превышающих порог;\n\n* `LicensedOkvedCount`\
\ — проверка соответствия лицензии коду ОКВЭД;\n\n* `RiskLevel`\
\ — уровень риска."
relationSummary:
required:
- "relatedByConfidant"
- "relatedByFounder"
- "total"
type: "object"
properties:
total:
type: "integer"
format: "int32"
relatedByFounder:
type: "integer"
format: "int32"
relatedByConfidant:
type: "integer"
format: "int32"
description: "Связанные компании."
relatedCompanies:
maxItems: 4
type: "array"
items:
required:
- "ogrn"
type: "object"
properties:
name:
type: "string"
format: "string"
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
description: "Короткое описание связанной компании."
leaders:
maxItems: 100
type: "array"
items:
required:
- "name"
type: "object"
properties:
actualDate:
type: "string"
format: "date"
nullable: true
name:
type: "string"
format: "string"
position:
type: "string"
format: "string"
nullable: true
description: "Руководитель."
founders:
maxItems: 10000
type: "array"
items:
required:
- "name"
type: "object"
properties:
name:
type: "string"
format: "string"
nominalCostAmount:
type: "number"
format: "double"
nullable: true
sharePercent:
type: "number"
format: "double"
nullable: true
description: "Учредители."
history:
maxItems: 3
type: "array"
items:
required:
- "oldParamValue"
- "paramName"
- "paramText"
- "paramValue"
type: "object"
properties:
paramText:
type: "string"
format: "string"
changeDate:
type: "string"
format: "date"
nullable: true
paramName:
type: "string"
format: "string"
oldParamValue:
type: "string"
format: "string"
paramValue:
type: "string"
format: "string"
description: "Измененные данные."
licenses:
maxItems: 3
type: "array"
items:
required:
- "activity"
- "address"
- "status"
type: "object"
properties:
"no":
type: "string"
format: "string"
nullable: true
authorityName:
type: "string"
format: "string"
nullable: true
date:
type: "string"
format: "date"
nullable: true
startDate:
type: "string"
format: "date"
nullable: true
endDate:
type: "string"
format: "date"
nullable: true
address:
maxItems: 1200
type: "array"
items:
type: "string"
format: "string"
activity:
maxItems: 100
type: "array"
items:
type: "string"
format: "string"
status:
type: "string"
description: "Статус лицензии."
enum:
- "active"
- "inactive"
- "unknown"
description: "Лицензия."
contracts:
maxItems: 3
type: "array"
items:
required:
- "contractId"
- "counterpartyOgrn"
- "role"
type: "object"
properties:
contractId:
pattern: "^(\\d{19})$"
type: "string"
counterpartyOgrn:
pattern: "^\\d{13,15}$"
type: "string"
purchaseObjectTypeName:
type: "string"
format: "string"
nullable: true
stageCode:
type: "string"
description: "Статус контракта:\n\n\n* `execution` —\
\ исполнение;\n\n* `stopped` — аннулировано;\n\n*\
\ `completed` — исполнение завершено;\n\n* `canceled`\
\ — исполнение прекращено;\n\n* `unknown` — неизве\
стный статус."
enum:
- "execution"
- "completed"
- "canceled"
- "stopped"
- "unknown"
role:
type: "string"
description: "Роль в контракте."
enum:
- "supplier"
- "customer"
price:
type: "number"
format: "double"
nullable: true
description: "Гос. контракты компании."
financialStatementsResponse:
type: "object"
properties:
reason:
required:
- "reasonCode"
- "reasonText"
type: "object"
properties:
reasonCode:
type: "string"
description: "Коды для причин отсутствия финансово\
й отчетности."
enum:
- "isEntrepreneur"
- "lessThanYear"
- "noData"
reasonText:
maxLength: 512
type: "string"
description: "Данные о причине отсутствия финансовой о\
тчетности."
financialStatementsData:
required:
- "accountsPayable"
- "accountsReceivable"
- "profit"
- "revenue"
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
revenue:
required:
- "name"
- "values"
type: "object"
properties:
name:
maxLength: 512
type: "string"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
values:
maxItems: 5
type: "array"
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
description: "Данные за отчетный период."
description: "Выручка."
profit:
required:
- "name"
- "values"
type: "object"
properties:
name:
maxLength: 512
type: "string"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
values:
maxItems: 5
type: "array"
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
description: "Данные за отчетный период."
description: "Прибыль."
accountsPayable:
required:
- "name"
- "values"
type: "object"
properties:
name:
maxLength: 512
type: "string"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
values:
maxItems: 5
type: "array"
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
description: "Данные за отчетный период."
description: "Кредиторский долг."
accountsReceivable:
required:
- "name"
- "values"
type: "object"
properties:
name:
maxLength: 512
type: "string"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
values:
maxItems: 5
type: "array"
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
description: "Данные за отчетный период."
description: "Дебиторский долг."
description: "Финансовая отчетность для excerpt."
description: "Обертка для данных по финансовой отчетности\
\ или для причины их отсутствия."
description: "Общая информация о компании."
description: "Выписка по компании."
example:
companyType: "company"
companyExcerpt:
shortName: ""
inn: "000000000000"
ogrn: "1000000000000"
okpo: "0000000000"
isActing: true
normName: "Название, ОАО"
shortNameRus: "ОАО \"Название\""
shortNameEn: "OAO \"Name\""
dateFirstReg: "1999-01-01"
fullNameRus: "ОТКРЫТОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"НАЗВАНИЕ\""
kpp: "000000000"
bik: "000000000"
email: "example@example.ru"
www: "www.example.ru"
registerNumber: ""
okato:
value: ""
code: "00086552000"
regionName: "Москва"
regionCode: 45
status:
isActing: true
date: "2023-04-24+03:00"
text: ""
type: "Действующее"
code: 24
groupId: 1
groupName: "Действующее"
phones:
- code: "342"
number: "0000000"
- code: "384"
number: "0000000"
- code: "385"
number: "0000000"
finance:
balanceType: 1
periods:
- periodName: "2015"
dateBegin: "2015-01-01+03:00"
dateEnd: "2015-12-31+03:00"
data:
- form: "Баланс"
section: "Актив"
name: "Нематериальные активы"
code: "1110"
value: "554779000"
id: 1
- form: "Баланс"
section: "Актив"
name: "Основные средства"
code: "1150"
value: "11502405000"
id: 5
- form: "Баланс"
section: "Актив"
name: "Долгосрочные финансовые вложения"
code: "1170"
value: "13980027000"
id: 12
- periodName: "2016"
dateBegin: "2016-01-01+03:00"
dateEnd: "2016-12-31+03:00"
data:
- form: "Баланс"
section: "Актив"
name: "Нематериальные активы"
code: "1110"
value: "50345000"
id: 1
- form: "Баланс"
section: "Актив"
name: "Основные средства"
code: "1150"
value: "10687759000"
id: 5
- form: "Баланс"
section: "Актив"
name: "Доходные вложения в материальные ценности"
code: "1160"
value: "636050000"
id: 9
- periodName: "2017"
dateBegin: "2017-01-01+03:00"
dateEnd: "2017-12-31+03:00"
data:
- form: "Баланс"
section: "Актив"
name: "Нематериальные активы"
code: "1110"
value: "69825000"
id: 1
- form: "Баланс"
section: "Актив"
name: "Основные средства"
code: "1150"
value: "11072450000"
id: 5
- form: "Баланс"
section: "Актив"
name: "Доходные вложения в материальные ценности"
code: "1160"
value: "566919000"
id: 9
leaders:
- actualDate: "2020-12-01+03:00"
name: "Фамилия Имя Отчество"
position: "генеральный директор"
managementCompany: ""
managementCompanyINN: "000000000000"
structure:
countCoownerFCSM: 1
countCoownerRosstat: 1
countCoownerEGRUL: 1
countBranch: 0
countBranchRosstat: 36
countBranchEGRUL: 139
countAffiliatedCompanyFCSM: 0
countAffiliatedCompanyRosstat: 22
countAffiliatedCompanyEGRUL: 23
nonprofitOrganizationRosstat: 3
proceedings:
active: 65
executed: 1326
charterCapital:
value: "1110616000"
date: "2000-01-01+04:00"
currencyCode: ""
currencyName: ""
companyWithSameInfo:
telephoneCount:
value: 1
phoneCode: "342"
phoneNumber: "2901202"
phoneList: []
addressCount: 51
addressWithoutRoomCount: 60
addressNotAffiliatedCount: 51
addressFTSCount: 26
managerCountInCountry: 1
managerCountInRegion: 1
managerInnCount: 0
companyLiquidatedWithSameInfo:
addressCount: 10
addressWithoutRoomCount: 10
arbitrationCases:
cases:
- year: 2006
plaintiff:
casesNumber: 2
sum: "17369466"
defendant:
casesNumber: 0
sum: "0"
thirdOrOtherPerson:
casesNumber: 0
- year: 2005
plaintiff:
casesNumber: 2
sum: "0"
defendant:
casesNumber: 0
sum: "0"
thirdOrOtherPerson:
casesNumber: 0
- year: 2004
plaintiff:
casesNumber: 2
sum: "0"
defendant:
casesNumber: 0
sum: "0"
thirdOrOtherPerson:
casesNumber: 0
total: 703
considered: 35
appealed: 4
decisionsAndRulings: 13
completed: 651
federalTaxRegistrationPayment:
regDate: "2010-01-25+03:00"
regAuthority: "Инспекция Федеральной налоговой службы"
regAuthorityAddress: "119048, Москва г, Доватора ул"
regAuthorityCode: "7704"
federalTaxRegistrationCurrent:
regDate: "2008-10-12+04:00"
regAuthority: "Межрайонная инспекция Федеральной налоговой слу\
жбы"
regAuthorityAddress: "125373, Москва г, Походный проезд"
regAuthorityCode: "7746"
okved:
- code: "51.10.1"
name: "Перевозка"
isMain: true
isMainEgrul: true
isMainRosstat: true
- code: "18.12"
name: "Прочие виды полиграфической деятельности"
isMain: false
isMainEgrul: false
isMainRosstat: false
- code: "33.16"
name: "Ремонт и техническое обслуживание"
isMain: false
isMainEgrul: false
isMainRosstat: false
stateContracts:
federalLaw94:
- year: 2013
tenders:
admittedNumber: 69
notAdmittedNumber: 0
winnerNumber: 69
contracts:
signedNumber: 69
sum: "91800339"
- year: 2012
tenders:
admittedNumber: 75
notAdmittedNumber: 0
winnerNumber: 75
contracts:
signedNumber: 75
sum: "4172264976"
- year: 2011
tenders:
admittedNumber: 45
notAdmittedNumber: 0
winnerNumber: 39
contracts:
signedNumber: 39
sum: "2956994583"
federalLaw223: []
address:
- postCode: "119002"
address: "г. Москва, ул. Арбат"
streetName: "ул. Арбат"
buildingNumber: "10"
fiasGUID: "b30b63a1-c2be-4efc-9d0c-c9b6d7438e15"
isHouseFiasGUID: false
fiasCode: "770000000000000000000000000"
fiasRegion: "77"
fiasArea: "000"
fiasCity: "000"
fiasPlace: "000"
fiasPlan: "0000"
fiasStreet: "0758"
actualDate: "2018-03-21+03:00"
buildingType: "дом"
businessCenterName: "Бизнес-центр"
fts: []
includeInList:
- isNegative: false
id: 6
listName: "Компании, сдающие отчетность"
- isNegative: false
id: 7
listName: "Предприятия"
- isNegative: false
id: 8
listName: "Компании"
bankruptcyMessage: []
expressExcerpt:
inn: "000000000000"
companyType: "company"
companyWithSameInfo:
sameManager:
manager: "Фамилия Имя Отчество"
managerCountInCountry: 1
managerInnCount: 0
sameAddress:
address: "г. Москва, ул. Арбат"
addressCount: 51
samePhone:
phoneCode: "342"
phoneNumber: "0000000"
phoneCount: 1
negativeLists: []
status:
isActing: true
date: "2023-04-24+03:00"
type: "Действующее"
code: 24
groupId: 1
groupName: "Действующее"
okvedInfo:
code: "50.00.0"
name: "Перевозка"
okvedCount: 21
netIncome:
periodName: "2020"
dateBegin: "2020-01-01+03:00"
dateEnd: "2020-12-31+03:00"
sum: "-96527133000"
taxYears:
minYear: 2015
maxYear: 2020
financeYears:
minYear: 2015
maxYear: 2020
stateContractYears:
minYear: 2006
maxYear: 2013
activeProceedingsCount: 65
bankruptcyMessage:
idType: 7
messageType: "Тип сообщения"
date: "2021-10-26Z"
decisionDate: "2021-10-19Z"
caseNumber: "А56-13391/2020"
caseId: 23040734
frozenAccountDecisions: []
arbitrationCasesInfo:
year: 2018
count: 23
entrepreneurExcerpt:
inn: "000000000000"
ogrnip: "300000000000000"
okpo: "0000000000"
sex: "man"
okato:
value: ""
code: "00000000000"
regionName: "Московская область"
regionCode: 46
okopf:
code: "50102"
name: "Индивидуальные предприниматели"
phoneList: []
status:
isActing: true
date: "2017-07-06+03:00"
text: "Действующее"
code: 24
groupId: 1
groupName: "Действующее"
includeInList:
- isNegative: false
id: 26
listName: "Реестр субъектов"
federalTaxRegistrationPayment:
regAuthority: "Межрайонная ИФНС России №23 по Московской облас\
ти"
regAuthorityAddress: "144000, Московская обл, г Электросталь"
regAuthorityCode: "5081"
federalTaxRegistrationCurrent:
regDate: "2017-07-06+03:00"
regAuthority: "Межрайонная инспекция Федеральной налоговой слу\
жбы"
regAuthorityAddress: "140000, Московская обл, Люберцы г"
regAuthorityCode: "5027"
citizenship:
code: 643
name: "Российская Федерация"
okved:
- code: "63.91"
name: "Деятельность информационных агентств"
isMain: true
registrationInFunds:
pensionFund:
registrationDate: "2017-07-07+03:00"
registerNumber: "060027069206"
regAuthority: "Государственное учреждение"
submittedStatements:
- form: "Р21001"
submissionDate: "2017-07-03+03:00"
availabilityDate: "2017-07-06+03:00"
grn: "000000000000000"
decisionType: "Решение о государственной регистрации"
stateContracts:
federalLaw94:
- year: 2018
tenders:
admittedNumber: 0
notAdmittedNumber: 1
winnerNumber: 0
contracts:
signedNumber: 0
sum: "0"
bankruptcyMessage: []
expressExcerpt:
inn: "000000000000"
companyType: "company"
companyWithSameInfo:
sameManager:
manager: "Фамилия Имя Отчество"
managerCountInCountry: 1
managerInnCount: 0
sameAddress:
address: "г. Москва, ул. Арбат"
addressCount: 51
samePhone:
phoneCode: "342"
phoneNumber: "0000000"
phoneCount: 1
negativeLists: []
status:
isActing: true
date: "2023-04-24+03:00"
type: "Действующее"
code: 24
groupId: 1
groupName: "Действующее"
okvedInfo:
code: "51.10.1"
name: "Перевозка"
okvedCount: 21
netIncome:
periodName: "2020"
dateBegin: "2020-01-01+03:00"
dateEnd: "2020-12-31+03:00"
sum: "-96527133000"
taxYears:
minYear: 2015
maxYear: 2020
financeYears:
minYear: 2015
maxYear: 2020
stateContractYears:
minYear: 2006
maxYear: 2013
activeProceedingsCount: 65
bankruptcyMessage:
idType: 7
messageType: "Тип сообщения"
date: "2021-10-26Z"
decisionDate: "2021-10-19Z"
caseNumber: "А56-13391/2020"
caseId: 23040734
frozenAccountDecisions: []
arbitrationCasesInfo:
year: 2018
count: 23
companyCard:
statusType: "active"
requisites:
inn: "000000000000"
ogrn: "1000000000000"
kpp: "000000000"
shortName: "ПАО \"НАЗВАНИЕ\""
fullName: "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"НАЗВАНИЕ\""
dateReg: "1996-06-21"
terminationDt: "2020-11-20"
status: "Действующая организация"
authorizedCapitalAmount: 3975771140
ogrnAssignDate: "2000-01-01"
legalAddress: "119019, г Москва, ул Арбат"
city: "Москва"
pages:
- page: "okved"
- page: "contract"
- page: "license"
- page: "history"
- page: "trafficLight"
- page: "feedback"
- page: "financialStatements"
excerpt:
requisites:
legalForm: "ПУБЛИЧНЫЕ АКЦИОНЕРНЫЕ ОБЩЕСТВА"
organizationSizeDesc: "Описание"
entityRegistrationDate: "2010-01-25"
regAuthorityAddressTxt: "125373, гор. Москва, Походный Проезд"
regAuthorityName: "Межрайонная Инспекция Федеральной Налоговой\
\ Службы"
pfrRegistrationNumber: "0000000000000"
pfrAuthorityName: "Отделение Фонда Пенсионного и Социального С\
трахования"
pfrRegistrationDate: "2010-06-18"
insRegistrationNumber: "000000000000000"
insAuthorityName: "Отделение Фонда Пенсионного и Социального С\
трахования"
insRegistrationDate: "2000-10-01"
okvedSummary:
count: 22
main:
- code: "51.10.1"
description: "Перевозка."
additional:
- code: "18.12.1"
description: "Прочие виды деятельности."
- code: "33.16.1"
description: "Ремонт и техническое обслуживание."
- code: "41.20.1"
description: "Строительство."
contractSummary:
count: 164
admittedCount: 40
notAdmittedCount: 94
totalValue: 3.2823479357625E10
licenseSummary:
total: 10
active: 10
inactive: 0
trafficLightColors:
redCount: 1
yellowCount: 5
greenCount: 14
innerCheckResult:
bankruptcyMessage:
value:
idType: 7
messageType: "Тип сообщения"
date: "2011-10-26Z"
decisionDate: "2011-10-19Z"
caseNumber: "А56-00000/2010"
caseId: 0
color: "green"
plaintiff:
value:
minDate: 2004
maxDate: 2018
totalCases: 470
color: "yellow"
thirdOrOtherPerson:
value:
minDate: 2007
maxDate: 2018
totalCases: 85
color: "yellow"
defendant:
value:
minDate: 2007
maxDate: 2018
totalCases: 157
color: "yellow"
defendantDynamic:
value:
lastYear: 2019
prevLastYear: 2018
percent: 50
color: "none"
executedProceedings:
value: 1326
color: "yellow"
activeProceedings:
value: 65
color: "red"
sameManager:
value:
inn: "000000000000"
sameManager:
manager: "Фамилия Имя Отчество"
managerCountInCountry: 1
managerInnCount: 1
color: "red"
sameAddressNumber:
value: 51
color: "yellow"
finance:
value:
balanceType: 1
periods:
- periodName: "2015"
dateBegin: "2015-01-01+03:00"
dateEnd: "2015-12-31+03:00"
data: []
- periodName: "2016"
dateBegin: "2016-01-01+03:00"
dateEnd: "2016-12-31+03:00"
data: []
- periodName: "2017"
dateBegin: "2017-01-01+03:00"
dateEnd: "2017-12-31+03:00"
data: []
color: "green"
isNegative:
value:
negativeListsCount: 0
color: "green"
unfairSupplier:
value:
isNegative: true
id: 1
listName: "Название"
color: "green"
invalidLegalAddress:
value:
isNegative: true
id: 1
listName: "Название"
color: "green"
disqualifiedPersons:
value:
isNegative: true
id: 1
listName: "Название"
color: "green"
taxReport:
value: "2023-04-25"
color: "none"
taxDebt:
value:
sum: 10
statDate: "2000-01-01"
color: "green"
checkResult:
status:
value: "Действующая организация"
color: "none"
registrationDate:
value: "1994-06-21"
color: "green"
legalAddressChangeDate:
value: "2019-07-10"
color: "green"
founderChangeDate:
value: "2021-10-25"
color: "green"
confidantChangeDate:
value: "2022-04-18"
color: "green"
authorizedCapitalAmount:
value: 3975771140
color: "green"
admittedContractsAsSupplier:
value:
count: 40
totalValue: 27523079541
color: "green"
legalForm:
value: "Публичные акционерные общества"
color: "green"
okvedCount:
value: 22
color: "none"
licensedOkvedCount:
value: 0
color: "none"
riskLevel:
value: 0
color: "none"
relationSummary:
total: 10
relatedByFounder: 0
relatedByConfidant: 0
relatedCompanies:
- name: "ООО \"Название\""
ogrn: "1000000000000"
inn: "000000000000"
leaders:
- actualDate: "2022-01-01"
name: "Фамилия Имя Отчество"
position: "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР"
founders: []
history:
- paramText: "организации"
changeDate: "2022-09-06"
paramName: "auth_cap"
oldParamValue: "2444535550.00"
paramValue: "3975771140.00"
- paramText: "организации"
changeDate: "2022-06-11"
paramName: "lic_new"
oldParamValue: "Л041-01162-50/00369716 от 9 апреля 2020"
paramValue: "Л041-01162-50/00369716|2020-04-09|2020-04-09"
licenses:
- "no": "14761-АТ"
authorityName: "МИНИСТЕРСТВО"
date: "2020-07-29"
startDate: "2020-07-30"
address: []
activity:
- "РАЗРАБОТКА"
status: "active"
- "no": "Л041-01162-50/00369716"
authorityName: "ФЕДЕРАЛЬНАЯ СЛУЖБА ПО НАДЗОРУ В СФЕРЕ ЗДРАВООХ\
РАНЕНИЯ"
date: "2020-04-09"
startDate: "2020-04-09"
address: []
activity:
- "МЕДИЦИНСКАЯ ДЕЯТЕЛЬНОСТЬ"
status: "active"
- "no": "Л042-01137-77/00283899"
authorityName: "ДЕПАРТАМЕНТ ЗДРАВООХРАНЕНИЯ"
date: "2019-10-03"
startDate: "2019-10-03"
address: []
activity:
- "ФАРМАЦЕВТИЧЕСКАЯ ДЕЯТЕЛЬНОСТЬ"
status: "active"
contracts:
- contractId: "0173200000000000071"
counterpartyOgrn: "1000000000000"
purchaseObjectTypeName: "Услуги"
stageCode: "completed"
role: "supplier"
price: 612000
- contractId: "1490000000000000006"
counterpartyOgrn: "1000000000000"
purchaseObjectTypeName: "Услуги"
stageCode: "execution"
role: "supplier"
price: 664976
- contractId: "1870000000000000002"
counterpartyOgrn: "1000000000000"
purchaseObjectTypeName: "Услуги"
stageCode: "execution"
role: "supplier"
price: 6000000
financialStatementsResponse:
reason:
reasonCode: "lessThanYear"
reasonText: "Компании меньше года"
financialStatementsData:
year: 2021
revenue:
name: "Выручка"
value: 378657216000
valueDiff: 148890851000
values:
- year: 2019
value: 551767420000
- year: 2020
value: 229766365000
valueDiff: -322001055000
- year: 2021
value: 378657216000
valueDiff: 148890851000
profit:
name: "Прибыль"
value: -45639139000
valueDiff: 50887994000
values:
- year: 2019
value: 5286800000
- year: 2020
value: -96527133000
valueDiff: -101813933000
- year: 2021
value: -45639139000
valueDiff: 50887994000
accountsPayable:
name: "Кредиторский долг"
value: 100062394000
valueDiff: -7293171000
values:
- year: 2019
value: 95785513000
- year: 2020
value: 107355565000
valueDiff: 11570052000
- year: 2021
value: 100062394000
valueDiff: -7293171000
accountsReceivable:
name: "Дебиторский долг"
value: 83489186000
valueDiff: 1918241000
values:
- year: 2019
value: 104635508000
- year: 2020
value: 81570945000
valueDiff: -23064563000
- year: 2021
value: 83489186000
valueDiff: 1918241000
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "INVALID"
errorMessage: "Некорректный ОГРН: 1000000000000"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "NO_DATA"
errorMessage: "Данные не найдены: ОГРН 000000000000000"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/counterparty/excerpt/by-inn:
get:
tags:
- "Проверка контрагентов"
summary: "Получить общую выписку для проверки контрагента по ИНН"
description: "Метод для получения выписки по контрагенту — тип компании, вып\
иска по организации, выписка по ИП, общая информация о компании."
operationId: "getApiV1CounterpartyExcerptByInn"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "inn"
in: "query"
description: "Идентификационный номер налогоплательщика."
required: true
style: "form"
explode: true
schema:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "companyCard"
- "companyType"
- "excerpt"
type: "object"
properties:
companyType:
type: "string"
description: "Тип компании."
enum:
- "entrepreneur"
- "company"
companyExcerpt:
required:
- "address"
- "bankruptcyMessage"
- "expressExcerpt"
- "fts"
- "includeInList"
- "leaders"
- "okved"
- "phones"
type: "object"
properties:
shortName:
maxLength: 1000
type: "string"
description: "Краткое наименование компании."
nullable: true
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
description: "ИНН."
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
description: "ОГРН."
nullable: true
okpo:
pattern: "^(\\d{8}|\\d{10})$"
type: "string"
description: "ОКПО."
nullable: true
isActing:
type: "boolean"
description: "Признак действующей компании."
nullable: true
normName:
maxLength: 1000
type: "string"
description: "Нормализованное наименование компании."
nullable: true
shortNameRus:
maxLength: 1000
type: "string"
description: "Краткое наименование компании."
nullable: true
shortNameEn:
maxLength: 1000
type: "string"
description: "Краткое наименование компании на английском\
\ языке."
nullable: true
dateFirstReg:
type: "string"
description: "Дата регистрации."
format: "date"
nullable: true
fullNameRus:
maxLength: 1000
type: "string"
description: "Полное наименование компании на русском."
nullable: true
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "КПП."
nullable: true
bik:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "БИК."
nullable: true
email:
type: "string"
description: "Электронная почта."
format: "email"
nullable: true
www:
maxLength: 512
type: "string"
description: "Веб-сайт."
nullable: true
registerNumber:
maxLength: 512
type: "string"
description: "Регистрационный номер."
nullable: true
okato:
required:
- "value"
type: "object"
properties:
value:
type: "string"
format: "string"
code:
pattern: "^(\\d{2,11})$"
type: "string"
nullable: true
regionName:
maxLength: 512
type: "string"
description: "Название региона."
nullable: true
regionCode:
type: "integer"
description: "Код региона."
format: "int32"
nullable: true
description: "ОКАТО."
status:
required:
- "code"
- "isActing"
type: "object"
properties:
isActing:
type: "boolean"
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
text:
type: "string"
format: "string"
nullable: true
type:
type: "string"
format: "string"
nullable: true
code:
type: "integer"
format: "int32"
groupId:
type: "integer"
format: "int32"
nullable: true
groupName:
type: "string"
format: "string"
nullable: true
description: "Статус."
phones:
maxItems: 200
type: "array"
items:
type: "object"
properties:
code:
pattern: "^\\d{3,5}$"
type: "string"
description: "Зоновый код (код города/оператора)."
nullable: true
number:
pattern: "^\\d{5,7}$"
type: "string"
description: "Местный номер."
nullable: true
description: "Номера телефонов."
finance:
type: "object"
properties:
balanceType:
type: "integer"
format: "int64"
nullable: true
periods:
maxItems: 200
type: "array"
description: "Бухгалтерская отчетность."
nullable: true
items:
type: "object"
properties:
periodName:
maxLength: 512
type: "string"
description: "Отчетный период."
nullable: true
dateBegin:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Начало периода."
format: "string"
nullable: true
dateEnd:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Конец периода."
format: "string"
nullable: true
data:
maxItems: 200
type: "array"
nullable: true
items:
type: "object"
properties:
form:
maxLength: 512
type: "string"
description: "Форма."
nullable: true
section:
maxLength: 512
type: "string"
description: "Раздел."
nullable: true
name:
maxLength: 512
type: "string"
description: "Наименование."
nullable: true
code:
maxLength: 512
type: "string"
description: "Код."
nullable: true
value:
maxLength: 512
type: "string"
description: "Значение."
nullable: true
id:
type: "integer"
description: "Идентификатор списка."
format: "int32"
nullable: true
leaders:
maxItems: 500
type: "array"
description: "Руководители."
items:
type: "object"
properties:
actualDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Дата актуальности."
format: "string"
nullable: true
name:
type: "string"
description: "Наименование."
format: "string"
nullable: true
position:
type: "string"
description: "Должность."
format: "string"
nullable: true
managementCompany:
type: "string"
format: "string"
nullable: true
managementCompanyINN:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
structure:
type: "object"
properties:
countCoownerFCSM:
type: "integer"
description: "Количество совладельцев (данные компании\
/ФСФР)."
format: "int32"
nullable: true
countCoownerRosstat:
type: "integer"
description: "Количество совладельцев (Росстат)."
format: "int32"
nullable: true
countCoownerEGRUL:
type: "integer"
description: "Количество совладельцев (ЕГРЮЛ)."
format: "int32"
nullable: true
countBranch:
type: "integer"
description: "Количество филиалов (данные компании)."
format: "int32"
nullable: true
countBranchRosstat:
type: "integer"
description: "Количество филиалов (Росстат)."
format: "int32"
nullable: true
countBranchEGRUL:
type: "integer"
description: "Количество филиалов (ЕГРЮЛ)."
format: "int32"
nullable: true
countCoownerDKCPFR:
type: "integer"
format: "int32"
nullable: true
countCoownerUkrStat:
type: "integer"
format: "int32"
nullable: true
countAffiliatedCompany:
type: "integer"
format: "int32"
nullable: true
countAffiliatedCompanyFCSM:
type: "integer"
description: "Количество дочерних компаний (данные ком\
пании)."
format: "int32"
nullable: true
countAffiliatedCompanyRosstat:
type: "integer"
description: "Количество дочерних компаний (Росстат)."
format: "int32"
nullable: true
countAffiliatedCompanyEGRUL:
type: "integer"
description: "Количество дочерних компаний (ЕГРЮЛ)."
format: "int32"
nullable: true
nonprofitOrganizationRosstat:
type: "integer"
description: "Количество некоммерческих партнерств (Ро\
сстат)."
format: "int32"
nullable: true
activeBranchesRosstatNumber:
type: "integer"
format: "int32"
nullable: true
activeAffiliatedCompaniesNumber:
type: "integer"
format: "int32"
nullable: true
proceedings:
required:
- "active"
- "executed"
type: "object"
properties:
active:
type: "integer"
description: "Количество непогашенных обязательств."
format: "int32"
executed:
type: "integer"
description: "Количество погашенных обязательств."
format: "int32"
charterCapital:
type: "object"
properties:
value:
maxLength: 512
type: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
currencyCode:
maxLength: 512
type: "string"
nullable: true
currencyName:
maxLength: 512
type: "string"
nullable: true
charterCapitalHistory:
maxItems: 200
type: "array"
description: "История изменения уставного капитала."
nullable: true
items:
type: "object"
properties:
value:
maxLength: 512
type: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
currencyCode:
maxLength: 512
type: "string"
nullable: true
currencyName:
maxLength: 512
type: "string"
nullable: true
companyWithSameInfo:
type: "object"
properties:
telephoneCount:
required:
- "value"
type: "object"
properties:
value:
type: "integer"
format: "int32"
phoneCode:
pattern: "^\\d{3,5}$"
type: "string"
description: "Зоновый код (код города/оператора)."
nullable: true
phoneNumber:
pattern: "^\\d{5,7}$"
type: "string"
description: "Местный номер."
nullable: true
phoneList:
maxItems: 500
type: "array"
nullable: true
items:
required:
- "value"
type: "object"
properties:
value:
type: "integer"
format: "int32"
phoneCode:
pattern: "^\\d{3,5}$"
type: "string"
description: "Зоновый код (код города/оператора\
)."
nullable: true
phoneNumber:
pattern: "^\\d{5,7}$"
type: "string"
description: "Местный номер."
nullable: true
addressCount:
type: "integer"
format: "int32"
nullable: true
addressWithoutRoomCount:
type: "integer"
format: "int32"
nullable: true
addressNotAffiliatedCount:
type: "integer"
format: "int32"
nullable: true
addressFTSCount:
type: "integer"
format: "int32"
nullable: true
managerCountInCountry:
type: "integer"
format: "int32"
nullable: true
managerCountInRegion:
type: "integer"
format: "int32"
nullable: true
managerInnCount:
type: "integer"
format: "int32"
nullable: true
companyLiquidatedWithSameInfo:
type: "object"
properties:
addressCount:
type: "integer"
format: "int32"
nullable: true
addressWithoutRoomCount:
type: "integer"
format: "int32"
nullable: true
arbitrationCases:
type: "object"
properties:
cases:
maxItems: 200
type: "array"
nullable: true
items:
required:
- "defendant"
- "plaintiff"
- "thirdOrOtherPerson"
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
plaintiff:
required:
- "casesNumber"
- "sum"
type: "object"
properties:
casesNumber:
type: "integer"
format: "int32"
sum:
type: "string"
format: "string"
defendant:
required:
- "casesNumber"
- "sum"
type: "object"
properties:
casesNumber:
type: "integer"
format: "int32"
sum:
type: "string"
format: "string"
thirdOrOtherPerson:
required:
- "casesNumber"
type: "object"
properties:
casesNumber:
type: "integer"
format: "int32"
total:
type: "integer"
format: "int32"
nullable: true
considered:
type: "integer"
format: "int32"
nullable: true
appealed:
type: "integer"
format: "int32"
nullable: true
decisionsAndRulings:
type: "integer"
format: "int32"
nullable: true
completed:
type: "integer"
format: "int32"
nullable: true
federalTaxRegistrationPayment:
type: "object"
properties:
regDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
regAuthority:
maxLength: 1000
type: "string"
nullable: true
regAuthorityAddress:
maxLength: 1000
type: "string"
nullable: true
regAuthorityCode:
maxLength: 512
type: "string"
nullable: true
federalTaxRegistrationCurrent:
type: "object"
properties:
regDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
regAuthority:
maxLength: 1000
type: "string"
nullable: true
regAuthorityAddress:
maxLength: 1000
type: "string"
nullable: true
regAuthorityCode:
maxLength: 512
type: "string"
nullable: true
okved:
maxItems: 2500
type: "array"
description: "ОКВЭД."
items:
required:
- "isMain"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
description: "Код."
nullable: true
name:
maxLength: 1000
type: "string"
description: "Наименование."
nullable: true
isMain:
type: "boolean"
description: "Признак основного ОКВЭД."
isMainEgrul:
type: "boolean"
description: "Признак основного ОКВЭД по данным ЕГРЮ\
Л."
nullable: true
isMainRosstat:
type: "boolean"
description: "Признак основного ОКВЭД по данным Росс\
тата."
nullable: true
stateContracts:
type: "object"
properties:
federalLaw94:
maxItems: 200
type: "array"
description: "Данные о госконтрактах за соответствующи\
й год."
nullable: true
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
description: "Значение года."
format: "int32"
tenders:
type: "object"
properties:
admittedNumber:
type: "integer"
description: "Число допусков к тендеру."
format: "int32"
nullable: true
notAdmittedNumber:
type: "integer"
description: "Число недопусков к тендеру."
format: "int32"
nullable: true
winnerNumber:
type: "integer"
description: "Число выигрышей тендеров."
format: "int32"
nullable: true
contracts:
type: "object"
properties:
signedNumber:
type: "integer"
description: "Число подписанных контрактов."
format: "int32"
nullable: true
sum:
type: "string"
description: "Контрактов подписано на сумму\
, рубли."
format: "string"
nullable: true
federalLaw223:
maxItems: 200
type: "array"
description: "Данные о тендерах за соответствующий год\
."
nullable: true
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
description: "Значение года."
format: "int32"
tenders:
type: "object"
properties:
admittedNumber:
type: "integer"
description: "Число допусков к тендеру."
format: "int32"
nullable: true
notAdmittedNumber:
type: "integer"
description: "Число недопусков к тендеру."
format: "int32"
nullable: true
winnerNumber:
type: "integer"
description: "Число выигрышей тендеров."
format: "int32"
nullable: true
contracts:
type: "object"
properties:
signedNumber:
type: "integer"
description: "Число подписанных контрактов."
format: "int32"
nullable: true
sum:
type: "string"
description: "Контрактов подписано на сумму\
, рубли."
format: "string"
nullable: true
address:
maxItems: 200
type: "array"
description: "Местонахождение."
items:
type: "object"
properties:
postCode:
pattern: "^(\\d{6})$"
type: "string"
nullable: true
address:
maxLength: 1000
type: "string"
nullable: true
streetName:
maxLength: 1000
type: "string"
nullable: true
buildingNumber:
maxLength: 512
type: "string"
nullable: true
fiasGUID:
type: "string"
format: "uuid"
nullable: true
isHouseFiasGUID:
type: "boolean"
nullable: true
fiasCode:
maxLength: 512
type: "string"
nullable: true
fiasRegion:
maxLength: 512
type: "string"
nullable: true
fiasArea:
maxLength: 512
type: "string"
nullable: true
fiasCity:
maxLength: 512
type: "string"
nullable: true
fiasPlace:
maxLength: 512
type: "string"
nullable: true
fiasPlan:
maxLength: 512
type: "string"
nullable: true
fiasStreet:
maxLength: 512
type: "string"
nullable: true
actualDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
buildingType:
maxLength: 512
type: "string"
nullable: true
businessCenterName:
maxLength: 512
type: "string"
nullable: true
fts:
maxItems: 200
type: "array"
items:
type: "object"
properties:
endDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Контрактов подписано на сумму, рубли."
format: "string"
nullable: true
income:
type: "string"
format: "string"
nullable: true
expenses:
type: "string"
format: "string"
nullable: true
taxes:
type: "object"
properties:
sum:
type: "string"
format: "string"
nullable: true
tax:
maxItems: 200
type: "array"
nullable: true
items:
type: "object"
properties:
id:
type: "integer"
format: "int32"
nullable: true
name:
type: "string"
format: "string"
nullable: true
sum:
type: "string"
format: "string"
nullable: true
taxArrears:
type: "object"
properties:
tax:
maxItems: 200
type: "array"
nullable: true
items:
required:
- "id"
type: "object"
properties:
id:
type: "integer"
description: "Идентификатор налога/сбора."
format: "int64"
name:
type: "string"
description: "Наименование налога/сбора."
format: "string"
nullable: true
finesSum:
type: "string"
description: "Сумма задолженности по пени."
format: "string"
nullable: true
penaltiesSum:
type: "string"
description: "Сумма задолженности по штраф\
ам."
format: "string"
nullable: true
sum:
type: "string"
format: "string"
nullable: true
taxPenalties:
type: "object"
properties:
sum:
type: "string"
format: "string"
nullable: true
includeInList:
maxItems: 200
type: "array"
items:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
bankruptcyMessage:
maxItems: 3000
type: "array"
items:
type: "object"
properties:
idType:
type: "integer"
format: "int64"
nullable: true
messageType:
type: "string"
format: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
decisionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
caseNumber:
type: "string"
format: "string"
nullable: true
caseId:
type: "integer"
format: "int64"
nullable: true
expressExcerpt:
required:
- "companyType"
- "frozenAccountDecisions"
- "negativeLists"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
description: "ИНН."
nullable: true
companyType:
type: "string"
description: "Тип компании."
enum:
- "entrepreneur"
- "company"
companyWithSameInfo:
required:
- "sameAddress"
- "sameManager"
- "samePhone"
type: "object"
properties:
sameManager:
type: "object"
properties:
manager:
maxLength: 512
type: "string"
nullable: true
managerCountInCountry:
type: "integer"
format: "int32"
nullable: true
managerInnCount:
type: "integer"
format: "int32"
nullable: true
sameAddress:
type: "object"
properties:
address:
maxLength: 1000
type: "string"
nullable: true
addressCount:
type: "integer"
format: "int32"
nullable: true
samePhone:
type: "object"
properties:
phoneCode:
pattern: "^\\d{3,5}$"
type: "string"
description: "Зоновый код (код города/оператор\
а)."
nullable: true
phoneNumber:
pattern: "^\\d{5,7}$"
type: "string"
description: "Местный номер."
nullable: true
phoneCount:
type: "integer"
format: "int32"
nullable: true
negativeLists:
maxItems: 200
type: "array"
description: "Негативные списки, в которых состоит ком\
пания."
items:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
status:
required:
- "code"
- "isActing"
type: "object"
properties:
isActing:
type: "boolean"
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
text:
type: "string"
format: "string"
nullable: true
type:
type: "string"
format: "string"
nullable: true
code:
type: "integer"
format: "int32"
groupId:
type: "integer"
format: "int32"
nullable: true
groupName:
type: "string"
format: "string"
nullable: true
description: "Статус."
okvedInfo:
required:
- "okvedCount"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
nullable: true
name:
type: "string"
format: "string"
nullable: true
okvedCount:
type: "integer"
format: "int32"
netIncome:
required:
- "dateBegin"
- "dateEnd"
- "periodName"
- "sum"
type: "object"
properties:
periodName:
maxLength: 512
type: "string"
dateBegin:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
dateEnd:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
sum:
maxLength: 512
type: "string"
taxYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
financeYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
stateContractYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
activeProceedingsCount:
type: "integer"
description: "Количество активных исполнительных произ\
водств (долгов)."
format: "int32"
nullable: true
bankruptcyMessage:
type: "object"
properties:
idType:
type: "integer"
format: "int64"
nullable: true
messageType:
type: "string"
format: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
decisionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
caseNumber:
type: "string"
format: "string"
nullable: true
caseId:
type: "integer"
format: "int64"
nullable: true
frozenAccountDecisions:
maxItems: 200
type: "array"
description: "Есть решение о приостановлении операций\
\ по счетам."
items:
type: "object"
properties:
sparkId:
required:
- "isEven"
- "isOne"
- "isPowerOfTwo"
- "isZero"
- "sign"
type: "object"
properties:
isPowerOfTwo:
type: "boolean"
readOnly: true
isZero:
type: "boolean"
readOnly: true
isOne:
type: "boolean"
readOnly: true
isEven:
type: "boolean"
readOnly: true
sign:
type: "integer"
format: "int32"
readOnly: true
reason:
type: "object"
properties:
id:
type: "integer"
format: "int32"
nullable: true
name:
maxLength: 1000
type: "string"
nullable: true
taxAuthority:
type: "object"
properties:
code:
maxLength: 512
type: "string"
nullable: true
name:
maxLength: 1000
type: "string"
nullable: true
bank:
type: "object"
properties:
sparkId:
required:
- "isEven"
- "isOne"
- "isPowerOfTwo"
- "isZero"
- "sign"
type: "object"
properties:
isPowerOfTwo:
type: "boolean"
readOnly: true
isZero:
type: "boolean"
readOnly: true
isOne:
type: "boolean"
readOnly: true
isEven:
type: "boolean"
readOnly: true
sign:
type: "integer"
format: "int32"
readOnly: true
bik:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
name:
maxLength: 512
type: "string"
nullable: true
number:
maxLength: 512
type: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
arbitrationCasesInfo:
required:
- "count"
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
count:
type: "integer"
format: "int32"
description: "Выписка по организации."
entrepreneurExcerpt:
required:
- "bankruptcyMessage"
- "expressExcerpt"
- "includeInList"
- "okved"
- "phoneList"
- "submittedStatements"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
ogrnip:
pattern: "^\\d{15}$"
type: "string"
nullable: true
okpo:
pattern: "^(\\d{8}|\\d{10})$"
type: "string"
nullable: true
birthDate:
type: "string"
format: "date"
nullable: true
birthPlace:
type: "string"
format: "string"
nullable: true
fullNameRus:
type: "string"
format: "string"
nullable: true
sex:
type: "string"
enum:
- "man"
- "woman"
- "undefined"
dateReg:
type: "string"
format: "date"
nullable: true
okato:
required:
- "value"
type: "object"
properties:
value:
type: "string"
format: "string"
code:
pattern: "^(\\d{2,11})$"
type: "string"
nullable: true
regionName:
maxLength: 512
type: "string"
description: "Название региона."
nullable: true
regionCode:
type: "integer"
description: "Код региона."
format: "int32"
nullable: true
description: "ОКАТО."
okopf:
type: "object"
properties:
code:
pattern: "^(\\d{5})$"
type: "string"
nullable: true
name:
maxLength: 512
type: "string"
nullable: true
phoneList:
maxItems: 200
type: "array"
items:
type: "object"
properties:
code:
pattern: "^\\d{3,5}$"
type: "string"
description: "Зоновый код (код города/оператора)."
nullable: true
number:
pattern: "^\\d{5,7}$"
type: "string"
description: "Местный номер."
nullable: true
description: "Номера телефонов."
status:
required:
- "code"
- "isActing"
type: "object"
properties:
isActing:
type: "boolean"
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
text:
type: "string"
format: "string"
nullable: true
type:
type: "string"
format: "string"
nullable: true
code:
type: "integer"
format: "int32"
groupId:
type: "integer"
format: "int32"
nullable: true
groupName:
type: "string"
format: "string"
nullable: true
description: "Статус."
includeInList:
maxItems: 200
type: "array"
items:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
federalTaxRegistrationPayment:
type: "object"
properties:
regDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
regAuthority:
maxLength: 1000
type: "string"
nullable: true
regAuthorityAddress:
maxLength: 1000
type: "string"
nullable: true
regAuthorityCode:
maxLength: 512
type: "string"
nullable: true
federalTaxRegistrationCurrent:
type: "object"
properties:
regDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
regAuthority:
maxLength: 1000
type: "string"
nullable: true
regAuthorityAddress:
maxLength: 1000
type: "string"
nullable: true
regAuthorityCode:
maxLength: 512
type: "string"
nullable: true
citizenship:
required:
- "code"
- "name"
type: "object"
properties:
code:
type: "integer"
format: "int32"
name:
type: "string"
format: "string"
okved:
maxItems: 2500
type: "array"
items:
required:
- "isMain"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
description: "Код."
nullable: true
name:
maxLength: 1000
type: "string"
description: "Наименование."
nullable: true
isMain:
type: "boolean"
description: "Признак основного ОКВЭД."
isMainEgrul:
type: "boolean"
description: "Признак основного ОКВЭД по данным ЕГРЮ\
Л."
nullable: true
isMainRosstat:
type: "boolean"
description: "Признак основного ОКВЭД по данным Росс\
тата."
nullable: true
registrationInFunds:
type: "object"
properties:
pensionFund:
required:
- "regAuthority"
- "registerNumber"
- "registrationDate"
type: "object"
properties:
registrationDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
deregistrationDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
registerNumber:
type: "string"
format: "string"
regAuthority:
type: "string"
format: "string"
socialInsuranceFund:
required:
- "regAuthority"
- "registerNumber"
- "registrationDate"
type: "object"
properties:
registrationDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
deregistrationDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
registerNumber:
type: "string"
format: "string"
regAuthority:
type: "string"
format: "string"
compulsoryMedicalInsuranceFund:
required:
- "regAuthority"
- "registerNumber"
- "registrationDate"
type: "object"
properties:
registrationDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
deregistrationDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
registerNumber:
type: "string"
format: "string"
regAuthority:
type: "string"
format: "string"
submittedStatements:
maxItems: 200
type: "array"
items:
type: "object"
properties:
form:
type: "string"
format: "string"
nullable: true
submissionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
availabilityDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
nullable: true
grn:
type: "string"
format: "string"
nullable: true
decisionType:
type: "string"
format: "string"
nullable: true
stateContracts:
type: "object"
properties:
federalLaw94:
maxItems: 200
type: "array"
description: "Данные о госконтрактах за соответствующи\
й год."
nullable: true
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
description: "Значение года."
format: "int32"
tenders:
type: "object"
properties:
admittedNumber:
type: "integer"
description: "Число допусков к тендеру."
format: "int32"
nullable: true
notAdmittedNumber:
type: "integer"
description: "Число недопусков к тендеру."
format: "int32"
nullable: true
winnerNumber:
type: "integer"
description: "Число выигрышей тендеров."
format: "int32"
nullable: true
contracts:
type: "object"
properties:
signedNumber:
type: "integer"
description: "Число подписанных контрактов."
format: "int32"
nullable: true
sum:
type: "string"
description: "Контрактов подписано на сумму\
, рубли."
format: "string"
nullable: true
federalLaw223:
maxItems: 200
type: "array"
description: "Данные о тендерах за соответствующий год\
."
nullable: true
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
description: "Значение года."
format: "int32"
tenders:
type: "object"
properties:
admittedNumber:
type: "integer"
description: "Число допусков к тендеру."
format: "int32"
nullable: true
notAdmittedNumber:
type: "integer"
description: "Число недопусков к тендеру."
format: "int32"
nullable: true
winnerNumber:
type: "integer"
description: "Число выигрышей тендеров."
format: "int32"
nullable: true
contracts:
type: "object"
properties:
signedNumber:
type: "integer"
description: "Число подписанных контрактов."
format: "int32"
nullable: true
sum:
type: "string"
description: "Контрактов подписано на сумму\
, рубли."
format: "string"
nullable: true
arbitrationCases:
type: "object"
properties:
cases:
maxItems: 200
type: "array"
nullable: true
items:
required:
- "defendant"
- "plaintiff"
- "thirdOrOtherPerson"
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
plaintiff:
required:
- "casesNumber"
- "sum"
type: "object"
properties:
casesNumber:
type: "integer"
format: "int32"
sum:
type: "string"
format: "string"
defendant:
required:
- "casesNumber"
- "sum"
type: "object"
properties:
casesNumber:
type: "integer"
format: "int32"
sum:
type: "string"
format: "string"
thirdOrOtherPerson:
required:
- "casesNumber"
type: "object"
properties:
casesNumber:
type: "integer"
format: "int32"
total:
type: "integer"
format: "int32"
nullable: true
considered:
type: "integer"
format: "int32"
nullable: true
appealed:
type: "integer"
format: "int32"
nullable: true
decisionsAndRulings:
type: "integer"
format: "int32"
nullable: true
completed:
type: "integer"
format: "int32"
nullable: true
executionProceedings:
required:
- "active"
- "executed"
type: "object"
properties:
active:
type: "integer"
description: "Количество непогашенных обязательств."
format: "int32"
executed:
type: "integer"
description: "Количество погашенных обязательств."
format: "int32"
bankruptcyMessage:
maxItems: 3000
type: "array"
items:
type: "object"
properties:
idType:
type: "integer"
format: "int64"
nullable: true
messageType:
type: "string"
format: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
decisionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
caseNumber:
type: "string"
format: "string"
nullable: true
caseId:
type: "integer"
format: "int64"
nullable: true
expressExcerpt:
required:
- "companyType"
- "frozenAccountDecisions"
- "negativeLists"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
description: "ИНН."
nullable: true
companyType:
type: "string"
description: "Тип компании."
enum:
- "entrepreneur"
- "company"
companyWithSameInfo:
required:
- "sameAddress"
- "sameManager"
- "samePhone"
type: "object"
properties:
sameManager:
type: "object"
properties:
manager:
maxLength: 512
type: "string"
nullable: true
managerCountInCountry:
type: "integer"
format: "int32"
nullable: true
managerInnCount:
type: "integer"
format: "int32"
nullable: true
sameAddress:
type: "object"
properties:
address:
maxLength: 1000
type: "string"
nullable: true
addressCount:
type: "integer"
format: "int32"
nullable: true
samePhone:
type: "object"
properties:
phoneCode:
pattern: "^\\d{3,5}$"
type: "string"
description: "Зоновый код (код города/оператор\
а)."
nullable: true
phoneNumber:
pattern: "^\\d{5,7}$"
type: "string"
description: "Местный номер."
nullable: true
phoneCount:
type: "integer"
format: "int32"
nullable: true
negativeLists:
maxItems: 200
type: "array"
description: "Негативные списки, в которых состоит ком\
пания."
items:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
status:
required:
- "code"
- "isActing"
type: "object"
properties:
isActing:
type: "boolean"
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
text:
type: "string"
format: "string"
nullable: true
type:
type: "string"
format: "string"
nullable: true
code:
type: "integer"
format: "int32"
groupId:
type: "integer"
format: "int32"
nullable: true
groupName:
type: "string"
format: "string"
nullable: true
description: "Статус."
okvedInfo:
required:
- "okvedCount"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
nullable: true
name:
type: "string"
format: "string"
nullable: true
okvedCount:
type: "integer"
format: "int32"
netIncome:
required:
- "dateBegin"
- "dateEnd"
- "periodName"
- "sum"
type: "object"
properties:
periodName:
maxLength: 512
type: "string"
dateBegin:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
dateEnd:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
sum:
maxLength: 512
type: "string"
taxYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
financeYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
stateContractYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
activeProceedingsCount:
type: "integer"
description: "Количество активных исполнительных произ\
водств (долгов)."
format: "int32"
nullable: true
bankruptcyMessage:
type: "object"
properties:
idType:
type: "integer"
format: "int64"
nullable: true
messageType:
type: "string"
format: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
decisionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
caseNumber:
type: "string"
format: "string"
nullable: true
caseId:
type: "integer"
format: "int64"
nullable: true
frozenAccountDecisions:
maxItems: 200
type: "array"
description: "Есть решение о приостановлении операций\
\ по счетам."
items:
type: "object"
properties:
sparkId:
required:
- "isEven"
- "isOne"
- "isPowerOfTwo"
- "isZero"
- "sign"
type: "object"
properties:
isPowerOfTwo:
type: "boolean"
readOnly: true
isZero:
type: "boolean"
readOnly: true
isOne:
type: "boolean"
readOnly: true
isEven:
type: "boolean"
readOnly: true
sign:
type: "integer"
format: "int32"
readOnly: true
reason:
type: "object"
properties:
id:
type: "integer"
format: "int32"
nullable: true
name:
maxLength: 1000
type: "string"
nullable: true
taxAuthority:
type: "object"
properties:
code:
maxLength: 512
type: "string"
nullable: true
name:
maxLength: 1000
type: "string"
nullable: true
bank:
type: "object"
properties:
sparkId:
required:
- "isEven"
- "isOne"
- "isPowerOfTwo"
- "isZero"
- "sign"
type: "object"
properties:
isPowerOfTwo:
type: "boolean"
readOnly: true
isZero:
type: "boolean"
readOnly: true
isOne:
type: "boolean"
readOnly: true
isEven:
type: "boolean"
readOnly: true
sign:
type: "integer"
format: "int32"
readOnly: true
bik:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
name:
maxLength: 512
type: "string"
nullable: true
number:
maxLength: 512
type: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
arbitrationCasesInfo:
required:
- "count"
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
count:
type: "integer"
format: "int32"
description: "Выписка по ИП."
companyCard:
required:
- "pages"
- "requisites"
- "statusType"
type: "object"
properties:
statusType:
type: "string"
description: "Статус компании."
enum:
- "active"
- "reorganizing"
- "liquidating"
- "liquidated"
- "bankrupting"
- "unknown"
requisites:
required:
- "ogrn"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
shortName:
type: "string"
format: "string"
nullable: true
fullName:
type: "string"
format: "string"
nullable: true
dateReg:
type: "string"
format: "date"
nullable: true
terminationDt:
type: "string"
format: "date"
nullable: true
status:
type: "string"
format: "string"
nullable: true
authorizedCapitalAmount:
type: "number"
format: "double"
nullable: true
ogrnAssignDate:
type: "string"
format: "date"
nullable: true
legalAddress:
type: "string"
format: "string"
nullable: true
city:
type: "string"
format: "string"
nullable: true
description: "Реквизиты."
pages:
maxItems: 20
type: "array"
items:
required:
- "page"
type: "object"
properties:
page:
type: "string"
description: "Код страницы."
enum:
- "okved"
- "contract"
- "license"
- "history"
- "trafficLight"
- "relatedCompanies"
- "feedback"
- "financialStatements"
- "enforcementProceedings"
- "inspections"
description: "Информация о странице."
description: "Карточка компании."
excerpt:
required:
- "checkResult"
- "contractSummary"
- "contracts"
- "financialStatementsResponse"
- "founders"
- "history"
- "leaders"
- "licenseSummary"
- "licenses"
- "okvedSummary"
- "relatedCompanies"
- "relationSummary"
- "requisites"
- "trafficLightColors"
type: "object"
properties:
requisites:
type: "object"
properties:
legalForm:
type: "string"
format: "string"
nullable: true
organizationSizeDesc:
type: "string"
format: "string"
nullable: true
entityRegistrationDate:
type: "string"
format: "date"
nullable: true
regAuthorityAddressTxt:
type: "string"
format: "string"
nullable: true
regAuthorityName:
type: "string"
format: "string"
nullable: true
pfrRegistrationNumber:
type: "string"
format: "string"
nullable: true
pfrAuthorityName:
type: "string"
format: "string"
nullable: true
pfrRegistrationDate:
type: "string"
format: "date"
nullable: true
insRegistrationNumber:
type: "string"
format: "string"
nullable: true
insAuthorityName:
type: "string"
format: "string"
nullable: true
insRegistrationDate:
type: "string"
format: "date"
nullable: true
description: "Дополнительные реквизиты."
okvedSummary:
required:
- "additional"
- "count"
- "main"
type: "object"
properties:
count:
type: "integer"
format: "int64"
main:
maxItems: 100
type: "array"
items:
required:
- "code"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
description:
type: "string"
format: "string"
nullable: true
description: "ОКВЭД."
additional:
maxItems: 100
type: "array"
items:
required:
- "code"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
description:
type: "string"
format: "string"
nullable: true
description: "ОКВЭД."
description: "ОКВЭДы."
contractSummary:
required:
- "admittedCount"
- "count"
- "notAdmittedCount"
type: "object"
properties:
count:
type: "integer"
format: "int64"
admittedCount:
type: "integer"
format: "int64"
notAdmittedCount:
type: "integer"
format: "int64"
totalValue:
type: "number"
format: "double"
nullable: true
description: "Гос. контракты."
licenseSummary:
required:
- "active"
- "inactive"
- "total"
type: "object"
properties:
total:
type: "integer"
format: "int64"
active:
type: "integer"
format: "int64"
inactive:
type: "integer"
format: "int64"
description: "Количество лицензий."
trafficLightColors:
required:
- "greenCount"
- "redCount"
- "yellowCount"
type: "object"
properties:
redCount:
type: "integer"
format: "int32"
yellowCount:
type: "integer"
format: "int32"
greenCount:
type: "integer"
format: "int32"
description: "Результаты экспресс-проверки."
innerCheckResult:
required:
- "activeProceedings"
- "bankruptcyMessage"
- "defendant"
- "defendantDynamic"
- "disqualifiedPersons"
- "executedProceedings"
- "finance"
- "invalidLegalAddress"
- "isNegative"
- "plaintiff"
- "sameAddressNumber"
- "sameManager"
- "taxDebt"
- "taxReport"
- "thirdOrOtherPerson"
- "unfairSupplier"
type: "object"
properties:
bankruptcyMessage:
required:
- "color"
type: "object"
properties:
value:
type: "object"
properties:
idType:
type: "integer"
format: "int64"
nullable: true
messageType:
type: "string"
format: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\\
d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
decisionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\\
d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
caseNumber:
type: "string"
format: "string"
nullable: true
caseId:
type: "integer"
format: "int64"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
plaintiff:
required:
- "color"
type: "object"
properties:
value:
required:
- "maxDate"
- "minDate"
- "totalCases"
type: "object"
properties:
minDate:
type: "integer"
description: "Наименьший год с судебными делам\
и."
format: "int32"
maxDate:
type: "integer"
description: "Наибольший год с судебными делам\
и."
format: "int32"
totalCases:
type: "integer"
format: "int32"
description: "Статистика по судебным делам."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
thirdOrOtherPerson:
required:
- "color"
type: "object"
properties:
value:
required:
- "maxDate"
- "minDate"
- "totalCases"
type: "object"
properties:
minDate:
type: "integer"
description: "Наименьший год с судебными делам\
и."
format: "int32"
maxDate:
type: "integer"
description: "Наибольший год с судебными делам\
и."
format: "int32"
totalCases:
type: "integer"
format: "int32"
description: "Статистика по судебным делам."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
defendant:
required:
- "color"
type: "object"
properties:
value:
required:
- "maxDate"
- "minDate"
- "totalCases"
type: "object"
properties:
minDate:
type: "integer"
description: "Наименьший год с судебными делам\
и."
format: "int32"
maxDate:
type: "integer"
description: "Наибольший год с судебными делам\
и."
format: "int32"
totalCases:
type: "integer"
format: "int32"
description: "Статистика по судебным делам."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
defendantDynamic:
required:
- "color"
type: "object"
properties:
value:
required:
- "lastYear"
- "percent"
- "prevLastYear"
type: "object"
properties:
lastYear:
type: "integer"
format: "int32"
prevLastYear:
type: "integer"
format: "int32"
percent:
type: "number"
format: "double"
description: "Динамика судебных дел в качестве отв\
етчика."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
executedProceedings:
required:
- "color"
type: "object"
properties:
value:
type: "integer"
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
activeProceedings:
required:
- "color"
type: "object"
properties:
value:
type: "integer"
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
sameManager:
required:
- "color"
type: "object"
properties:
value:
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
sameManager:
type: "object"
properties:
manager:
maxLength: 512
type: "string"
nullable: true
managerCountInCountry:
type: "integer"
format: "int32"
nullable: true
managerInnCount:
type: "integer"
format: "int32"
nullable: true
description: "Массовый руководитель."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
sameAddressNumber:
required:
- "color"
type: "object"
properties:
value:
type: "integer"
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
finance:
required:
- "color"
type: "object"
properties:
value:
type: "object"
properties:
balanceType:
type: "integer"
format: "int64"
nullable: true
periods:
maxItems: 200
type: "array"
description: "Бухгалтерская отчетность."
nullable: true
items:
type: "object"
properties:
periodName:
maxLength: 512
type: "string"
description: "Отчетный период."
nullable: true
dateBegin:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\\
d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Начало периода."
format: "string"
nullable: true
dateEnd:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\\
d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Конец периода."
format: "string"
nullable: true
data:
maxItems: 200
type: "array"
nullable: true
items:
type: "object"
properties:
form:
maxLength: 512
type: "string"
description: "Форма."
nullable: true
section:
maxLength: 512
type: "string"
description: "Раздел."
nullable: true
name:
maxLength: 512
type: "string"
description: "Наименование."
nullable: true
code:
maxLength: 512
type: "string"
description: "Код."
nullable: true
value:
maxLength: 512
type: "string"
description: "Значение."
nullable: true
id:
type: "integer"
description: "Идентификатор списка\
."
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
isNegative:
required:
- "color"
- "value"
type: "object"
properties:
value:
required:
- "negativeListsCount"
type: "object"
properties:
negativeListsCount:
type: "integer"
format: "int32"
description: "Статистика негативных списков."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
unfairSupplier:
required:
- "color"
type: "object"
properties:
value:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
invalidLegalAddress:
required:
- "color"
type: "object"
properties:
value:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
disqualifiedPersons:
required:
- "color"
type: "object"
properties:
value:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
taxReport:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
taxDebt:
required:
- "color"
type: "object"
properties:
value:
required:
- "statDate"
- "sum"
type: "object"
properties:
sum:
type: "number"
format: "double"
statDate:
type: "string"
format: "date"
description: "Налоговая задолженность."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
description: "Результат внутренней проверки компании:\n\n\
* `BankruptcyMessage` — сообщения о банкротстве;\n\n* `Plaintiff`\
\ — судебные дела в качестве истца;\n\n* `ThirdOrOtherPerson`\
\ — судебные дела в качестве третьего лица;\n\n* `Defendant`\
\ — судебные дела в качестве ответчика;\n\n* `DefendantDynamic`\
\ — динамика судебных дел в качестве ответчика;\n\n* `ExecutedProceedings`\
\ — завершенные исполнительные производства;\n\n* `ActiveProceedings`\
\ — активные исполнительные производства;\n\n* `SameManager`\
\ — массовый руководитель;\n\n* `SameAddressNumber` — ма\
ссовый юридический адрес;\n\n* `Finance` — бухгалтерская\
\ отчетность;\n\n* `IsNegative` — негативные списки;\n\n\
* `UnfairSupplier` — реестр недобросовестных поставщиков\
;\n\n* `InvalidLegalAddress` — список компаний, отсутств\
ующих по юридическому адресу;\n\n* `DisqualifiedPersons`\
\ — реестр дисквалифицированных лиц;\n\n* `ReferenceCheckRecommended`\
\ — рекомендация проверки в справочных источниках;\n\n*\
\ `DueDiligenceRecommended` — рекомендация проведения до\
кументальной проверки (Due Diligence);\n\n* `TaxReport`\
\ — налоговая отчетность;\n\n* `TaxDebt` — налоговая зад\
олженность."
checkResult:
required:
- "admittedContractsAsSupplier"
- "authorizedCapitalAmount"
- "confidantChangeDate"
- "founderChangeDate"
- "legalAddressChangeDate"
- "legalForm"
- "licensedOkvedCount"
- "okvedCount"
- "registrationDate"
- "riskLevel"
- "status"
type: "object"
properties:
status:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
registrationDate:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
legalAddressChangeDate:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
founderChangeDate:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
confidantChangeDate:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
authorizedCapitalAmount:
required:
- "color"
type: "object"
properties:
value:
type: "number"
format: "double"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
admittedContractsAsSupplier:
required:
- "color"
- "value"
type: "object"
properties:
value:
required:
- "count"
type: "object"
properties:
count:
type: "integer"
format: "int64"
totalValue:
type: "number"
format: "double"
nullable: true
description: "Статистика по контрактам."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
legalForm:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
okvedCount:
required:
- "color"
- "value"
type: "object"
properties:
value:
type: "integer"
format: "int64"
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
licensedOkvedCount:
required:
- "color"
- "value"
type: "object"
properties:
value:
type: "integer"
format: "int64"
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
riskLevel:
required:
- "color"
type: "object"
properties:
value:
type: "integer"
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
description: "Результат проверки компании:\n\n* `Status` —\
\ статус компании;\n\n* `RegistrationDate` — проверка да\
ты регистрации на превышение трех лет;\n\n* `LegalAddressChangeDate`\
\ — проверка изменения юридического адреса за последний\
\ год;\n\n* `FounderChangeDate` — проверка изменения учр\
едителя за последний год;\n\n* `ConfidantChangeDate` — п\
роверка изменения руководителя за последний год;\n\n* `AuthorizedCapitalAmount`\
\ — проверка превышения уставного капитала минимального\
\ порога;\n\n* `AdmittedContractsAsSupplier` — участие в\
\ государственных закупках;\n\n* `LegalForm` — организац\
ионно-правовая форма организации;\n\n* `OkvedCount` — ко\
личество видов деятельности, превышающих порог;\n\n* `LicensedOkvedCount`\
\ — проверка соответствия лицензии коду ОКВЭД;\n\n* `RiskLevel`\
\ — уровень риска."
relationSummary:
required:
- "relatedByConfidant"
- "relatedByFounder"
- "total"
type: "object"
properties:
total:
type: "integer"
format: "int32"
relatedByFounder:
type: "integer"
format: "int32"
relatedByConfidant:
type: "integer"
format: "int32"
description: "Связанные компании."
relatedCompanies:
maxItems: 4
type: "array"
items:
required:
- "ogrn"
type: "object"
properties:
name:
type: "string"
format: "string"
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
description: "Короткое описание связанной компании."
leaders:
maxItems: 100
type: "array"
items:
required:
- "name"
type: "object"
properties:
actualDate:
type: "string"
format: "date"
nullable: true
name:
type: "string"
format: "string"
position:
type: "string"
format: "string"
nullable: true
description: "Руководитель."
founders:
maxItems: 10000
type: "array"
items:
required:
- "name"
type: "object"
properties:
name:
type: "string"
format: "string"
nominalCostAmount:
type: "number"
format: "double"
nullable: true
sharePercent:
type: "number"
format: "double"
nullable: true
description: "Учредители."
history:
maxItems: 3
type: "array"
items:
required:
- "oldParamValue"
- "paramName"
- "paramText"
- "paramValue"
type: "object"
properties:
paramText:
type: "string"
format: "string"
changeDate:
type: "string"
format: "date"
nullable: true
paramName:
type: "string"
format: "string"
oldParamValue:
type: "string"
format: "string"
paramValue:
type: "string"
format: "string"
description: "Измененные данные."
licenses:
maxItems: 3
type: "array"
items:
required:
- "activity"
- "address"
- "status"
type: "object"
properties:
"no":
type: "string"
format: "string"
nullable: true
authorityName:
type: "string"
format: "string"
nullable: true
date:
type: "string"
format: "date"
nullable: true
startDate:
type: "string"
format: "date"
nullable: true
endDate:
type: "string"
format: "date"
nullable: true
address:
maxItems: 1200
type: "array"
items:
type: "string"
format: "string"
activity:
maxItems: 100
type: "array"
items:
type: "string"
format: "string"
status:
type: "string"
description: "Статус лицензии."
enum:
- "active"
- "inactive"
- "unknown"
description: "Лицензия."
contracts:
maxItems: 3
type: "array"
items:
required:
- "contractId"
- "counterpartyOgrn"
- "role"
type: "object"
properties:
contractId:
pattern: "^(\\d{19})$"
type: "string"
counterpartyOgrn:
pattern: "^\\d{13,15}$"
type: "string"
purchaseObjectTypeName:
type: "string"
format: "string"
nullable: true
stageCode:
type: "string"
description: "Статус контракта:\n\n\n* `execution` —\
\ исполнение;\n\n* `stopped` — аннулировано;\n\n*\
\ `completed` — исполнение завершено;\n\n* `canceled`\
\ — исполнение прекращено;\n\n* `unknown` — неизве\
стный статус."
enum:
- "execution"
- "completed"
- "canceled"
- "stopped"
- "unknown"
role:
type: "string"
description: "Роль в контракте."
enum:
- "supplier"
- "customer"
price:
type: "number"
format: "double"
nullable: true
description: "Гос. контракты компании."
financialStatementsResponse:
type: "object"
properties:
reason:
required:
- "reasonCode"
- "reasonText"
type: "object"
properties:
reasonCode:
type: "string"
description: "Коды для причин отсутствия финансово\
й отчетности."
enum:
- "isEntrepreneur"
- "lessThanYear"
- "noData"
reasonText:
maxLength: 512
type: "string"
description: "Данные о причине отсутствия финансовой о\
тчетности."
financialStatementsData:
required:
- "accountsPayable"
- "accountsReceivable"
- "profit"
- "revenue"
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
revenue:
required:
- "name"
- "values"
type: "object"
properties:
name:
maxLength: 512
type: "string"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
values:
maxItems: 5
type: "array"
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
description: "Данные за отчетный период."
description: "Выручка."
profit:
required:
- "name"
- "values"
type: "object"
properties:
name:
maxLength: 512
type: "string"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
values:
maxItems: 5
type: "array"
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
description: "Данные за отчетный период."
description: "Прибыль."
accountsPayable:
required:
- "name"
- "values"
type: "object"
properties:
name:
maxLength: 512
type: "string"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
values:
maxItems: 5
type: "array"
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
description: "Данные за отчетный период."
description: "Кредиторский долг."
accountsReceivable:
required:
- "name"
- "values"
type: "object"
properties:
name:
maxLength: 512
type: "string"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
values:
maxItems: 5
type: "array"
items:
required:
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
value:
type: "integer"
format: "int64"
nullable: true
valueDiff:
type: "integer"
format: "int64"
nullable: true
description: "Данные за отчетный период."
description: "Дебиторский долг."
description: "Финансовая отчетность для excerpt."
description: "Обертка для данных по финансовой отчетности\
\ или для причины их отсутствия."
description: "Общая информация о компании."
description: "Выписка по компании."
example:
companyType: "company"
companyExcerpt:
shortName: ""
inn: "000000000000"
ogrn: "1000000000000"
okpo: "0000000000"
isActing: true
normName: "Название, ОАО"
shortNameRus: "ОАО \"Название\""
shortNameEn: "OAO \"Name\""
dateFirstReg: "1999-01-01"
fullNameRus: "ОТКРЫТОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"НАЗВАНИЕ\""
kpp: "000000000"
bik: "000000000"
email: "example@example.ru"
www: "www.example.ru"
registerNumber: ""
okato:
value: ""
code: "00086552000"
regionName: "Москва"
regionCode: 45
status:
isActing: true
date: "2023-04-24+03:00"
text: ""
type: "Действующее"
code: 24
groupId: 1
groupName: "Действующее"
phones:
- code: "342"
number: "0000000"
- code: "384"
number: "0000000"
- code: "385"
number: "0000000"
finance:
balanceType: 1
periods:
- periodName: "2015"
dateBegin: "2015-01-01+03:00"
dateEnd: "2015-12-31+03:00"
data:
- form: "Баланс"
section: "Актив"
name: "Нематериальные активы"
code: "1110"
value: "554779000"
id: 1
- form: "Баланс"
section: "Актив"
name: "Основные средства"
code: "1150"
value: "11502405000"
id: 5
- form: "Баланс"
section: "Актив"
name: "Долгосрочные финансовые вложения"
code: "1170"
value: "13980027000"
id: 12
- periodName: "2016"
dateBegin: "2016-01-01+03:00"
dateEnd: "2016-12-31+03:00"
data:
- form: "Баланс"
section: "Актив"
name: "Нематериальные активы"
code: "1110"
value: "50345000"
id: 1
- form: "Баланс"
section: "Актив"
name: "Основные средства"
code: "1150"
value: "10687759000"
id: 5
- form: "Баланс"
section: "Актив"
name: "Доходные вложения в материальные ценности"
code: "1160"
value: "636050000"
id: 9
- periodName: "2017"
dateBegin: "2017-01-01+03:00"
dateEnd: "2017-12-31+03:00"
data:
- form: "Баланс"
section: "Актив"
name: "Нематериальные активы"
code: "1110"
value: "69825000"
id: 1
- form: "Баланс"
section: "Актив"
name: "Основные средства"
code: "1150"
value: "11072450000"
id: 5
- form: "Баланс"
section: "Актив"
name: "Доходные вложения в материальные ценности"
code: "1160"
value: "566919000"
id: 9
leaders:
- actualDate: "2020-12-01+03:00"
name: "Фамилия Имя Отчество"
position: "генеральный директор"
managementCompany: ""
managementCompanyINN: "000000000000"
structure:
countCoownerFCSM: 1
countCoownerRosstat: 1
countCoownerEGRUL: 1
countBranch: 0
countBranchRosstat: 36
countBranchEGRUL: 139
countAffiliatedCompanyFCSM: 0
countAffiliatedCompanyRosstat: 22
countAffiliatedCompanyEGRUL: 23
nonprofitOrganizationRosstat: 3
proceedings:
active: 65
executed: 1326
charterCapital:
value: "1110616000"
date: "2000-01-01+04:00"
currencyCode: ""
currencyName: ""
companyWithSameInfo:
telephoneCount:
value: 1
phoneCode: "342"
phoneNumber: "2901202"
phoneList: []
addressCount: 51
addressWithoutRoomCount: 60
addressNotAffiliatedCount: 51
addressFTSCount: 26
managerCountInCountry: 1
managerCountInRegion: 1
managerInnCount: 0
companyLiquidatedWithSameInfo:
addressCount: 10
addressWithoutRoomCount: 10
arbitrationCases:
cases:
- year: 2006
plaintiff:
casesNumber: 2
sum: "17369466"
defendant:
casesNumber: 0
sum: "0"
thirdOrOtherPerson:
casesNumber: 0
- year: 2005
plaintiff:
casesNumber: 2
sum: "0"
defendant:
casesNumber: 0
sum: "0"
thirdOrOtherPerson:
casesNumber: 0
- year: 2004
plaintiff:
casesNumber: 2
sum: "0"
defendant:
casesNumber: 0
sum: "0"
thirdOrOtherPerson:
casesNumber: 0
total: 703
considered: 35
appealed: 4
decisionsAndRulings: 13
completed: 651
federalTaxRegistrationPayment:
regDate: "2010-01-25+03:00"
regAuthority: "Инспекция Федеральной налоговой службы"
regAuthorityAddress: "119048, Москва г, Доватора ул"
regAuthorityCode: "7704"
federalTaxRegistrationCurrent:
regDate: "2008-10-12+04:00"
regAuthority: "Межрайонная инспекция Федеральной налоговой слу\
жбы"
regAuthorityAddress: "125373, Москва г, Походный проезд"
regAuthorityCode: "7746"
okved:
- code: "51.10.1"
name: "Перевозка"
isMain: true
isMainEgrul: true
isMainRosstat: true
- code: "18.12"
name: "Прочие виды полиграфической деятельности"
isMain: false
isMainEgrul: false
isMainRosstat: false
- code: "33.16"
name: "Ремонт и техническое обслуживание"
isMain: false
isMainEgrul: false
isMainRosstat: false
stateContracts:
federalLaw94:
- year: 2013
tenders:
admittedNumber: 69
notAdmittedNumber: 0
winnerNumber: 69
contracts:
signedNumber: 69
sum: "91800339"
- year: 2012
tenders:
admittedNumber: 75
notAdmittedNumber: 0
winnerNumber: 75
contracts:
signedNumber: 75
sum: "4172264976"
- year: 2011
tenders:
admittedNumber: 45
notAdmittedNumber: 0
winnerNumber: 39
contracts:
signedNumber: 39
sum: "2956994583"
federalLaw223: []
address:
- postCode: "119002"
address: "г. Москва, ул. Арбат"
streetName: "ул. Арбат"
buildingNumber: "10"
fiasGUID: "b30b63a1-c2be-4efc-9d0c-c9b6d7438e15"
isHouseFiasGUID: false
fiasCode: "770000000000000000000000000"
fiasRegion: "77"
fiasArea: "000"
fiasCity: "000"
fiasPlace: "000"
fiasPlan: "0000"
fiasStreet: "0758"
actualDate: "2018-03-21+03:00"
buildingType: "дом"
businessCenterName: "Бизнес-центр"
fts: []
includeInList:
- isNegative: false
id: 6
listName: "Компании, сдающие отчетность"
- isNegative: false
id: 7
listName: "Предприятия"
- isNegative: false
id: 8
listName: "Компании"
bankruptcyMessage: []
expressExcerpt:
inn: "000000000000"
companyType: "company"
companyWithSameInfo:
sameManager:
manager: "Фамилия Имя Отчество"
managerCountInCountry: 1
managerInnCount: 0
sameAddress:
address: "г. Москва, ул. Арбат"
addressCount: 51
samePhone:
phoneCode: "342"
phoneNumber: "0000000"
phoneCount: 1
negativeLists: []
status:
isActing: true
date: "2023-04-24+03:00"
type: "Действующее"
code: 24
groupId: 1
groupName: "Действующее"
okvedInfo:
code: "50.00.0"
name: "Перевозка"
okvedCount: 21
netIncome:
periodName: "2020"
dateBegin: "2020-01-01+03:00"
dateEnd: "2020-12-31+03:00"
sum: "-96527133000"
taxYears:
minYear: 2015
maxYear: 2020
financeYears:
minYear: 2015
maxYear: 2020
stateContractYears:
minYear: 2006
maxYear: 2013
activeProceedingsCount: 65
bankruptcyMessage:
idType: 7
messageType: "Тип сообщения"
date: "2021-10-26Z"
decisionDate: "2021-10-19Z"
caseNumber: "А56-13391/2020"
caseId: 23040734
frozenAccountDecisions: []
arbitrationCasesInfo:
year: 2018
count: 23
entrepreneurExcerpt:
inn: "000000000000"
ogrnip: "300000000000000"
okpo: "0000000000"
sex: "man"
okato:
value: ""
code: "00000000000"
regionName: "Московская область"
regionCode: 46
okopf:
code: "50102"
name: "Индивидуальные предприниматели"
phoneList: []
status:
isActing: true
date: "2017-07-06+03:00"
text: "Действующее"
code: 24
groupId: 1
groupName: "Действующее"
includeInList:
- isNegative: false
id: 26
listName: "Реестр субъектов"
federalTaxRegistrationPayment:
regAuthority: "Межрайонная ИФНС России №23 по Московской облас\
ти"
regAuthorityAddress: "144000, Московская обл, г Электросталь"
regAuthorityCode: "5081"
federalTaxRegistrationCurrent:
regDate: "2017-07-06+03:00"
regAuthority: "Межрайонная инспекция Федеральной налоговой слу\
жбы"
regAuthorityAddress: "140000, Московская обл, Люберцы г"
regAuthorityCode: "5027"
citizenship:
code: 643
name: "Российская Федерация"
okved:
- code: "63.91"
name: "Деятельность информационных агентств"
isMain: true
registrationInFunds:
pensionFund:
registrationDate: "2017-07-07+03:00"
registerNumber: "060027069206"
regAuthority: "Государственное учреждение"
submittedStatements:
- form: "Р21001"
submissionDate: "2017-07-03+03:00"
availabilityDate: "2017-07-06+03:00"
grn: "000000000000000"
decisionType: "Решение о государственной регистрации"
stateContracts:
federalLaw94:
- year: 2018
tenders:
admittedNumber: 0
notAdmittedNumber: 1
winnerNumber: 0
contracts:
signedNumber: 0
sum: "0"
bankruptcyMessage: []
expressExcerpt:
inn: "000000000000"
companyType: "company"
companyWithSameInfo:
sameManager:
manager: "Фамилия Имя Отчество"
managerCountInCountry: 1
managerInnCount: 0
sameAddress:
address: "г. Москва, ул. Арбат"
addressCount: 51
samePhone:
phoneCode: "342"
phoneNumber: "0000000"
phoneCount: 1
negativeLists: []
status:
isActing: true
date: "2023-04-24+03:00"
type: "Действующее"
code: 24
groupId: 1
groupName: "Действующее"
okvedInfo:
code: "51.10.1"
name: "Перевозка"
okvedCount: 21
netIncome:
periodName: "2020"
dateBegin: "2020-01-01+03:00"
dateEnd: "2020-12-31+03:00"
sum: "-96527133000"
taxYears:
minYear: 2015
maxYear: 2020
financeYears:
minYear: 2015
maxYear: 2020
stateContractYears:
minYear: 2006
maxYear: 2013
activeProceedingsCount: 65
bankruptcyMessage:
idType: 7
messageType: "Тип сообщения"
date: "2021-10-26Z"
decisionDate: "2021-10-19Z"
caseNumber: "А56-13391/2020"
caseId: 23040734
frozenAccountDecisions: []
arbitrationCasesInfo:
year: 2018
count: 23
companyCard:
statusType: "active"
requisites:
inn: "000000000000"
ogrn: "1000000000000"
kpp: "000000000"
shortName: "ПАО \"НАЗВАНИЕ\""
fullName: "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"НАЗВАНИЕ\""
dateReg: "1996-06-21"
terminationDt: "2020-11-20"
status: "Действующая организация"
authorizedCapitalAmount: 3975771140
ogrnAssignDate: "2000-01-01"
legalAddress: "119019, г Москва, ул Арбат"
city: "Москва"
pages:
- page: "okved"
- page: "contract"
- page: "license"
- page: "history"
- page: "trafficLight"
- page: "feedback"
- page: "financialStatements"
excerpt:
requisites:
legalForm: "ПУБЛИЧНЫЕ АКЦИОНЕРНЫЕ ОБЩЕСТВА"
organizationSizeDesc: "Описание"
entityRegistrationDate: "2010-01-25"
regAuthorityAddressTxt: "125373, гор. Москва, Походный Проезд"
regAuthorityName: "Межрайонная Инспекция Федеральной Налоговой\
\ Службы"
pfrRegistrationNumber: "0000000000000"
pfrAuthorityName: "Отделение Фонда Пенсионного и Социального С\
трахования"
pfrRegistrationDate: "2010-06-18"
insRegistrationNumber: "000000000000000"
insAuthorityName: "Отделение Фонда Пенсионного и Социального С\
трахования"
insRegistrationDate: "2000-10-01"
okvedSummary:
count: 22
main:
- code: "51.10.1"
description: "Перевозка."
additional:
- code: "18.12.1"
description: "Прочие виды деятельности."
- code: "33.16.1"
description: "Ремонт и техническое обслуживание."
- code: "41.20.1"
description: "Строительство."
contractSummary:
count: 164
admittedCount: 40
notAdmittedCount: 94
totalValue: 3.2823479357625E10
licenseSummary:
total: 10
active: 10
inactive: 0
trafficLightColors:
redCount: 1
yellowCount: 5
greenCount: 14
innerCheckResult:
bankruptcyMessage:
value:
idType: 7
messageType: "Тип сообщения"
date: "2011-10-26Z"
decisionDate: "2011-10-19Z"
caseNumber: "А56-00000/2010"
caseId: 0
color: "green"
plaintiff:
value:
minDate: 2004
maxDate: 2018
totalCases: 470
color: "yellow"
thirdOrOtherPerson:
value:
minDate: 2007
maxDate: 2018
totalCases: 85
color: "yellow"
defendant:
value:
minDate: 2007
maxDate: 2018
totalCases: 157
color: "yellow"
defendantDynamic:
value:
lastYear: 2019
prevLastYear: 2018
percent: 50
color: "none"
executedProceedings:
value: 1326
color: "yellow"
activeProceedings:
value: 65
color: "red"
sameManager:
value:
inn: "000000000000"
sameManager:
manager: "Фамилия Имя Отчество"
managerCountInCountry: 1
managerInnCount: 1
color: "red"
sameAddressNumber:
value: 51
color: "yellow"
finance:
value:
balanceType: 1
periods:
- periodName: "2015"
dateBegin: "2015-01-01+03:00"
dateEnd: "2015-12-31+03:00"
data: []
- periodName: "2016"
dateBegin: "2016-01-01+03:00"
dateEnd: "2016-12-31+03:00"
data: []
- periodName: "2017"
dateBegin: "2017-01-01+03:00"
dateEnd: "2017-12-31+03:00"
data: []
color: "green"
isNegative:
value:
negativeListsCount: 0
color: "green"
unfairSupplier:
value:
isNegative: true
id: 1
listName: "Название"
color: "green"
invalidLegalAddress:
value:
isNegative: true
id: 1
listName: "Название"
color: "green"
disqualifiedPersons:
value:
isNegative: true
id: 1
listName: "Название"
color: "green"
taxReport:
value: "2023-04-25"
color: "none"
taxDebt:
value:
sum: 10
statDate: "2000-01-01"
color: "green"
checkResult:
status:
value: "Действующая организация"
color: "none"
registrationDate:
value: "1994-06-21"
color: "green"
legalAddressChangeDate:
value: "2019-07-10"
color: "green"
founderChangeDate:
value: "2021-10-25"
color: "green"
confidantChangeDate:
value: "2022-04-18"
color: "green"
authorizedCapitalAmount:
value: 3975771140
color: "green"
admittedContractsAsSupplier:
value:
count: 40
totalValue: 27523079541
color: "green"
legalForm:
value: "Публичные акционерные общества"
color: "green"
okvedCount:
value: 22
color: "none"
licensedOkvedCount:
value: 0
color: "none"
riskLevel:
value: 0
color: "none"
relationSummary:
total: 10
relatedByFounder: 0
relatedByConfidant: 0
relatedCompanies:
- name: "ООО \"Название\""
ogrn: "1000000000000"
inn: "000000000000"
leaders:
- actualDate: "2022-01-01"
name: "Фамилия Имя Отчество"
position: "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР"
founders: []
history:
- paramText: "организации"
changeDate: "2022-09-06"
paramName: "auth_cap"
oldParamValue: "2444535550.00"
paramValue: "3975771140.00"
- paramText: "организации"
changeDate: "2022-06-11"
paramName: "lic_new"
oldParamValue: "Л041-01162-50/00369716 от 9 апреля 2020"
paramValue: "Л041-01162-50/00369716|2020-04-09|2020-04-09"
licenses:
- "no": "14761-АТ"
authorityName: "МИНИСТЕРСТВО"
date: "2020-07-29"
startDate: "2020-07-30"
address: []
activity:
- "РАЗРАБОТКА"
status: "active"
- "no": "Л041-01162-50/00369716"
authorityName: "ФЕДЕРАЛЬНАЯ СЛУЖБА ПО НАДЗОРУ В СФЕРЕ ЗДРАВООХ\
РАНЕНИЯ"
date: "2020-04-09"
startDate: "2020-04-09"
address: []
activity:
- "МЕДИЦИНСКАЯ ДЕЯТЕЛЬНОСТЬ"
status: "active"
- "no": "Л042-01137-77/00283899"
authorityName: "ДЕПАРТАМЕНТ ЗДРАВООХРАНЕНИЯ"
date: "2019-10-03"
startDate: "2019-10-03"
address: []
activity:
- "ФАРМАЦЕВТИЧЕСКАЯ ДЕЯТЕЛЬНОСТЬ"
status: "active"
contracts:
- contractId: "0173200000000000071"
counterpartyOgrn: "1000000000000"
purchaseObjectTypeName: "Услуги"
stageCode: "completed"
role: "supplier"
price: 612000
- contractId: "1490000000000000006"
counterpartyOgrn: "1000000000000"
purchaseObjectTypeName: "Услуги"
stageCode: "execution"
role: "supplier"
price: 664976
- contractId: "1870000000000000002"
counterpartyOgrn: "1000000000000"
purchaseObjectTypeName: "Услуги"
stageCode: "execution"
role: "supplier"
price: 6000000
financialStatementsResponse:
reason:
reasonCode: "lessThanYear"
reasonText: "Компании меньше года"
financialStatementsData:
year: 2021
revenue:
name: "Выручка"
value: 378657216000
valueDiff: 148890851000
values:
- year: 2019
value: 551767420000
- year: 2020
value: 229766365000
valueDiff: -322001055000
- year: 2021
value: 378657216000
valueDiff: 148890851000
profit:
name: "Прибыль"
value: -45639139000
valueDiff: 50887994000
values:
- year: 2019
value: 5286800000
- year: 2020
value: -96527133000
valueDiff: -101813933000
- year: 2021
value: -45639139000
valueDiff: 50887994000
accountsPayable:
name: "Кредиторский долг"
value: 100062394000
valueDiff: -7293171000
values:
- year: 2019
value: 95785513000
- year: 2020
value: 107355565000
valueDiff: 11570052000
- year: 2021
value: 100062394000
valueDiff: -7293171000
accountsReceivable:
name: "Дебиторский долг"
value: 83489186000
valueDiff: 1918241000
values:
- year: 2019
value: 104635508000
- year: 2020
value: 81570945000
valueDiff: -23064563000
- year: 2021
value: 83489186000
valueDiff: 1918241000
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "INVALID"
errorMessage: "Некорректный ОГРН: 1000000000000"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "NO_DATA"
errorMessage: "Данные не найдены: ОГРН 000000000000000"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/counterparty/express/excerpt:
get:
tags:
- "Проверка контрагентов"
summary: "Получить краткую выписку для проверки контрагента"
description: "Метод для получения краткой выписки по контрагенту."
operationId: "getApiV1CounterpartyExpressExcerpt"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "ogrn"
in: "query"
description: "Основной государственный регистрационный номер."
required: true
style: "form"
explode: true
schema:
pattern: "^\\d{13,15}$"
type: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "companyType"
- "frozenAccountDecisions"
- "negativeLists"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
description: "ИНН."
nullable: true
companyType:
type: "string"
description: "Тип компании."
enum:
- "entrepreneur"
- "company"
companyWithSameInfo:
required:
- "sameAddress"
- "sameManager"
- "samePhone"
type: "object"
properties:
sameManager:
type: "object"
properties:
manager:
maxLength: 512
type: "string"
nullable: true
managerCountInCountry:
type: "integer"
format: "int32"
nullable: true
managerInnCount:
type: "integer"
format: "int32"
nullable: true
sameAddress:
type: "object"
properties:
address:
maxLength: 1000
type: "string"
nullable: true
addressCount:
type: "integer"
format: "int32"
nullable: true
samePhone:
type: "object"
properties:
phoneCode:
pattern: "^\\d{3,5}$"
type: "string"
description: "Зоновый код (код города/оператора)."
nullable: true
phoneNumber:
pattern: "^\\d{5,7}$"
type: "string"
description: "Местный номер."
nullable: true
phoneCount:
type: "integer"
format: "int32"
nullable: true
negativeLists:
maxItems: 200
type: "array"
description: "Негативные списки, в которых состоит компания."
items:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
status:
required:
- "code"
- "isActing"
type: "object"
properties:
isActing:
type: "boolean"
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
text:
type: "string"
format: "string"
nullable: true
type:
type: "string"
format: "string"
nullable: true
code:
type: "integer"
format: "int32"
groupId:
type: "integer"
format: "int32"
nullable: true
groupName:
type: "string"
format: "string"
nullable: true
description: "Статус."
okvedInfo:
required:
- "okvedCount"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
nullable: true
name:
type: "string"
format: "string"
nullable: true
okvedCount:
type: "integer"
format: "int32"
netIncome:
required:
- "dateBegin"
- "dateEnd"
- "periodName"
- "sum"
type: "object"
properties:
periodName:
maxLength: 512
type: "string"
dateBegin:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
dateEnd:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
sum:
maxLength: 512
type: "string"
taxYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
financeYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
stateContractYears:
required:
- "maxYear"
- "minYear"
type: "object"
properties:
minYear:
type: "integer"
format: "int32"
maxYear:
type: "integer"
format: "int32"
activeProceedingsCount:
type: "integer"
description: "Количество активных исполнительных производств (д\
олгов)."
format: "int32"
nullable: true
bankruptcyMessage:
type: "object"
properties:
idType:
type: "integer"
format: "int64"
nullable: true
messageType:
type: "string"
format: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
decisionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
caseNumber:
type: "string"
format: "string"
nullable: true
caseId:
type: "integer"
format: "int64"
nullable: true
frozenAccountDecisions:
maxItems: 200
type: "array"
description: "Есть решение о приостановлении операций по счета\
м."
items:
type: "object"
properties:
sparkId:
required:
- "isEven"
- "isOne"
- "isPowerOfTwo"
- "isZero"
- "sign"
type: "object"
properties:
isPowerOfTwo:
type: "boolean"
readOnly: true
isZero:
type: "boolean"
readOnly: true
isOne:
type: "boolean"
readOnly: true
isEven:
type: "boolean"
readOnly: true
sign:
type: "integer"
format: "int32"
readOnly: true
reason:
type: "object"
properties:
id:
type: "integer"
format: "int32"
nullable: true
name:
maxLength: 1000
type: "string"
nullable: true
taxAuthority:
type: "object"
properties:
code:
maxLength: 512
type: "string"
nullable: true
name:
maxLength: 1000
type: "string"
nullable: true
bank:
type: "object"
properties:
sparkId:
required:
- "isEven"
- "isOne"
- "isPowerOfTwo"
- "isZero"
- "sign"
type: "object"
properties:
isPowerOfTwo:
type: "boolean"
readOnly: true
isZero:
type: "boolean"
readOnly: true
isOne:
type: "boolean"
readOnly: true
isEven:
type: "boolean"
readOnly: true
sign:
type: "integer"
format: "int32"
readOnly: true
bik:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
name:
maxLength: 512
type: "string"
nullable: true
number:
maxLength: 512
type: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
arbitrationCasesInfo:
required:
- "count"
- "year"
type: "object"
properties:
year:
type: "integer"
format: "int32"
count:
type: "integer"
format: "int32"
example:
inn: "000000000000"
companyType: "company"
companyWithSameInfo:
sameManager:
manager: "Фамилия Имя Отчество"
managerCountInCountry: 1
managerInnCount: 0
sameAddress:
address: "г. Москва, ул. Арбат"
addressCount: 51
samePhone:
phoneCode: "342"
phoneNumber: "0000000"
phoneCount: 1
negativeLists: []
status:
isActing: true
date: "2023-04-24+03:00"
type: "Действующее"
code: 24
groupId: 1
groupName: "Действующее"
okvedInfo:
code: "51.10.1"
name: "Перевозка"
okvedCount: 21
netIncome:
periodName: "2020"
dateBegin: "2020-01-01+03:00"
dateEnd: "2020-12-31+03:00"
sum: "-96527133000"
taxYears:
minYear: 2015
maxYear: 2020
financeYears:
minYear: 2015
maxYear: 2020
stateContractYears:
minYear: 2006
maxYear: 2013
activeProceedingsCount: 65
bankruptcyMessage:
idType: 7
messageType: "Тип сообщения"
date: "2021-10-26Z"
decisionDate: "2021-10-19Z"
caseNumber: "А56-13391/2020"
caseId: 23040734
frozenAccountDecisions: []
arbitrationCasesInfo:
year: 2018
count: 23
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "INVALID"
errorMessage: "Некорректный ОГРН: 1000000000000"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "NO_DATA"
errorMessage: "Данные не найдены: ОГРН 000000000000000"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/counterparty/history:
get:
tags:
- "Проверка контрагентов"
summary: "Получить историю изменений"
description: "Метод для получения истории изменений по компании."
operationId: "getApiV1CounterpartyHistory"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "limit"
in: "query"
required: true
style: "form"
explode: true
schema:
maximum: 100
minimum: 1
type: "integer"
format: "int32"
- name: "offset"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "integer"
format: "int32"
- name: "ogrn"
in: "query"
description: "Основной государственный регистрационный номер."
required: true
style: "form"
explode: true
schema:
pattern: "^\\d{13,15}$"
type: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "companyCard"
- "data"
type: "object"
properties:
companyCard:
required:
- "pages"
- "requisites"
- "statusType"
type: "object"
properties:
statusType:
type: "string"
description: "Статус компании."
enum:
- "active"
- "reorganizing"
- "liquidating"
- "liquidated"
- "bankrupting"
- "unknown"
requisites:
required:
- "ogrn"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
shortName:
type: "string"
format: "string"
nullable: true
fullName:
type: "string"
format: "string"
nullable: true
dateReg:
type: "string"
format: "date"
nullable: true
terminationDt:
type: "string"
format: "date"
nullable: true
status:
type: "string"
format: "string"
nullable: true
authorizedCapitalAmount:
type: "number"
format: "double"
nullable: true
ogrnAssignDate:
type: "string"
format: "date"
nullable: true
legalAddress:
type: "string"
format: "string"
nullable: true
city:
type: "string"
format: "string"
nullable: true
description: "Реквизиты."
pages:
maxItems: 20
type: "array"
items:
required:
- "page"
type: "object"
properties:
page:
type: "string"
description: "Код страницы."
enum:
- "okved"
- "contract"
- "license"
- "history"
- "trafficLight"
- "relatedCompanies"
- "feedback"
- "financialStatements"
- "enforcementProceedings"
- "inspections"
description: "Информация о странице."
description: "Карточка компании."
data:
required:
- "items"
- "total"
type: "object"
properties:
total:
type: "integer"
format: "int64"
items:
maxItems: 100
type: "array"
items:
required:
- "oldParamValue"
- "paramName"
- "paramText"
- "paramValue"
type: "object"
properties:
paramText:
type: "string"
format: "string"
changeDate:
type: "string"
format: "date"
nullable: true
paramName:
type: "string"
format: "string"
oldParamValue:
type: "string"
format: "string"
paramValue:
type: "string"
format: "string"
description: "Измененные данные."
example:
companyCard:
statusType: "active"
requisites:
inn: "000000000000"
ogrn: "1000000000000"
kpp: "000000000"
shortName: "ПАО \"НАЗВАНИЕ\""
fullName: "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"НАЗВАНИЕ\""
dateReg: "1996-06-21"
terminationDt: "2020-11-20"
status: "Действующая организация"
authorizedCapitalAmount: 3975771140
ogrnAssignDate: "2000-01-01"
legalAddress: "119019, г Москва, ул Арбат"
city: "Москва"
pages:
- page: "okved"
- page: "contract"
- page: "license"
- page: "history"
- page: "trafficLight"
- page: "feedback"
- page: "financialStatements"
data:
total: 125
items:
- paramText: "организации"
changeDate: "2022-09-06"
paramName: "auth_cap"
oldParamValue: "2444535550.00"
paramValue: "3975771140.00"
- paramText: "организации"
changeDate: "2022-06-11"
paramName: "lic_new"
oldParamValue: "Л041-01162-50/00369716 от 9 апреля 2020"
paramValue: "Л041-01162-50/00369716|2020-04-09|2020-04-09"
- paramText: "организации"
changeDate: "2022-06-10"
paramName: "lic_del"
oldParamValue: "ЛО-50-01-011924 от 9 апреля 2020"
paramValue: "ЛО-50-01-011924|2020-04-09|2020-04-09"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "INVALID"
errorMessage: "Некорректный ОГРН: 1000000000000"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "NO_DATA"
errorMessage: "Данные не найдены: ОГРН 000000000000000"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/counterparty/licenses:
get:
tags:
- "Проверка контрагентов"
summary: "Получить список лицензий контрагента"
description: "Метод возвращает список лицензий контрагента."
operationId: "getApiV1CounterpartyLicenses"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "limit"
in: "query"
required: true
style: "form"
explode: true
schema:
maximum: 100
minimum: 1
type: "integer"
format: "int32"
- name: "offset"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "integer"
format: "int32"
- name: "ogrn"
in: "query"
description: "Основной государственный регистрационный номер."
required: true
style: "form"
explode: true
schema:
pattern: "^\\d{13,15}$"
type: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "companyCard"
- "data"
type: "object"
properties:
companyCard:
required:
- "pages"
- "requisites"
- "statusType"
type: "object"
properties:
statusType:
type: "string"
description: "Статус компании."
enum:
- "active"
- "reorganizing"
- "liquidating"
- "liquidated"
- "bankrupting"
- "unknown"
requisites:
required:
- "ogrn"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
shortName:
type: "string"
format: "string"
nullable: true
fullName:
type: "string"
format: "string"
nullable: true
dateReg:
type: "string"
format: "date"
nullable: true
terminationDt:
type: "string"
format: "date"
nullable: true
status:
type: "string"
format: "string"
nullable: true
authorizedCapitalAmount:
type: "number"
format: "double"
nullable: true
ogrnAssignDate:
type: "string"
format: "date"
nullable: true
legalAddress:
type: "string"
format: "string"
nullable: true
city:
type: "string"
format: "string"
nullable: true
description: "Реквизиты."
pages:
maxItems: 20
type: "array"
items:
required:
- "page"
type: "object"
properties:
page:
type: "string"
description: "Код страницы."
enum:
- "okved"
- "contract"
- "license"
- "history"
- "trafficLight"
- "relatedCompanies"
- "feedback"
- "financialStatements"
- "enforcementProceedings"
- "inspections"
description: "Информация о странице."
description: "Карточка компании."
data:
required:
- "active"
- "items"
- "total"
type: "object"
properties:
total:
type: "integer"
format: "int64"
active:
type: "integer"
format: "int64"
items:
maxItems: 100
type: "array"
items:
required:
- "activity"
- "address"
- "status"
type: "object"
properties:
"no":
type: "string"
format: "string"
nullable: true
authorityName:
type: "string"
format: "string"
nullable: true
date:
type: "string"
format: "date"
nullable: true
startDate:
type: "string"
format: "date"
nullable: true
endDate:
type: "string"
format: "date"
nullable: true
address:
maxItems: 1200
type: "array"
items:
type: "string"
format: "string"
activity:
maxItems: 100
type: "array"
items:
type: "string"
format: "string"
status:
type: "string"
description: "Статус лицензии."
enum:
- "active"
- "inactive"
- "unknown"
description: "Лицензия."
example:
companyCard:
statusType: "active"
requisites:
inn: "000000000000"
ogrn: "1000000000000"
kpp: "000000000"
shortName: "ПАО \"НАЗВАНИЕ\""
fullName: "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"НАЗВАНИЕ\""
dateReg: "1996-06-21"
terminationDt: "2020-11-20"
status: "Действующая организация"
authorizedCapitalAmount: 3975771140
ogrnAssignDate: "2000-01-01"
legalAddress: "119019, г Москва, ул Арбат"
city: "Москва"
pages:
- page: "okved"
- page: "contract"
- page: "license"
- page: "history"
- page: "trafficLight"
- page: "feedback"
- page: "financialStatements"
data:
total: 10
active: 10
items:
- "no": "14761-АТ"
authorityName: "МИНИСТЕРСТВО"
date: "2020-07-29"
startDate: "2020-07-30"
address: []
activity:
- "РАЗРАБОТКА"
status: "active"
- "no": "Л041-01162-50/00369716"
authorityName: "ФЕДЕРАЛЬНАЯ СЛУЖБА ПО НАДЗОРУ В СФЕРЕ ЗДРАВООХ\
РАНЕНИЯ"
date: "2020-04-09"
startDate: "2020-04-09"
address: []
activity:
- "МЕДИЦИНСКАЯ ДЕЯТЕЛЬНОСТЬ"
status: "active"
- "no": "Л042-01137-77/00283899"
authorityName: "ДЕПАРТАМЕНТ ЗДРАВООХРАНЕНИЯ"
date: "2019-10-03"
startDate: "2019-10-03"
address: []
activity:
- "ФАРМАЦЕВТИЧЕСКАЯ ДЕЯТЕЛЬНОСТЬ"
status: "active"
- "no": "АВ ГН-06-501-3715"
authorityName: "ЦЕНТРАЛЬНЫЙ АППАРАТ ФЕДЕРАЛЬНОЙ СЛУЖБЫ"
date: "2019-09-30"
startDate: "2019-09-30"
endDate: "2024-01-14"
address: []
activity:
- "ОБРАЩЕНИЕ"
status: "active"
- "no": "АН 77-000556"
authorityName: "ЦЕНТРАЛЬНОЕ МЕЖРЕГИОНАЛЬНОЕ УПРАВЛЕНИЕ"
date: "2019-07-03"
startDate: "2019-07-03"
address: []
activity:
- "ДЕЯТЕЛЬНОСТЬ ПО ПЕРЕВОЗКАМ"
status: "active"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "INVALID"
errorMessage: "Некорректный ОГРН: 1000000000000"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "NO_DATA"
errorMessage: "Данные не найдены: ОГРН 000000000000000"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/counterparty/okved:
get:
tags:
- "Проверка контрагентов"
summary: "Получить список ОКВЭДов контрагента"
description: "Метод возвращает список ОКВЭДов контрагента.\n\n\nОКВЭД — обще\
российский классификатор видов экономической деятельности, в котором все в\
иды деятельности обозначены числовыми кодами."
operationId: "getApiV1CounterpartyOkved"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "ogrn"
in: "query"
description: "Основной государственный регистрационный номер."
required: true
style: "form"
explode: true
schema:
pattern: "^\\d{13,15}$"
type: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "companyCard"
- "data"
type: "object"
properties:
companyCard:
required:
- "pages"
- "requisites"
- "statusType"
type: "object"
properties:
statusType:
type: "string"
description: "Статус компании."
enum:
- "active"
- "reorganizing"
- "liquidating"
- "liquidated"
- "bankrupting"
- "unknown"
requisites:
required:
- "ogrn"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
shortName:
type: "string"
format: "string"
nullable: true
fullName:
type: "string"
format: "string"
nullable: true
dateReg:
type: "string"
format: "date"
nullable: true
terminationDt:
type: "string"
format: "date"
nullable: true
status:
type: "string"
format: "string"
nullable: true
authorizedCapitalAmount:
type: "number"
format: "double"
nullable: true
ogrnAssignDate:
type: "string"
format: "date"
nullable: true
legalAddress:
type: "string"
format: "string"
nullable: true
city:
type: "string"
format: "string"
nullable: true
description: "Реквизиты."
pages:
maxItems: 20
type: "array"
items:
required:
- "page"
type: "object"
properties:
page:
type: "string"
description: "Код страницы."
enum:
- "okved"
- "contract"
- "license"
- "history"
- "trafficLight"
- "relatedCompanies"
- "feedback"
- "financialStatements"
- "enforcementProceedings"
- "inspections"
description: "Информация о странице."
description: "Карточка компании."
data:
required:
- "additional"
- "main"
type: "object"
properties:
main:
maxItems: 100
type: "array"
items:
required:
- "code"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
description:
type: "string"
format: "string"
nullable: true
description: "ОКВЭД."
additional:
maxItems: 100
type: "array"
items:
required:
- "code"
type: "object"
properties:
code:
pattern: "^\\d{2}((\\.\\d{1,2})?)((\\.\\d{1,2})?)$"
type: "string"
description:
type: "string"
format: "string"
nullable: true
description: "ОКВЭД."
description: "ОКВЭДы компании."
example:
companyCard:
statusType: "active"
requisites:
inn: "000000000000"
ogrn: "1000000000000"
kpp: "000000000"
shortName: "ПАО \"НАЗВАНИЕ\""
fullName: "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"НАЗВАНИЕ\""
dateReg: "1996-06-21"
terminationDt: "2020-11-20"
status: "Действующая организация"
authorizedCapitalAmount: 3975771140
ogrnAssignDate: "2000-01-01"
legalAddress: "119019, г Москва, ул Арбат"
city: "Москва"
pages:
- page: "okved"
- page: "contract"
- page: "license"
- page: "history"
- page: "trafficLight"
- page: "feedback"
- page: "financialStatements"
data:
main:
- code: "51.10.1"
description: "Перевозка."
additional:
- code: "51.10.2"
description: "Прочие."
- code: "51.10.3"
description: "Ремонт."
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "INVALID"
errorMessage: "Некорректный ОГРН: 1000000000000"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "NO_DATA"
errorMessage: "Данные не найдены: ОГРН 000000000000000"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/counterparty/related_companies:
get:
tags:
- "Проверка контрагентов"
summary: "Получить общую информацию о связанных компаниях"
description: "Метод для получения информации по связанным компаниям."
operationId: "getApiV1CounterpartyRelatedCompanies"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "filter"
in: "query"
description: "Фильтр для статусов связанных компаний."
required: false
style: "form"
explode: true
schema:
maxItems: 5
type: "array"
items:
type: "string"
enum:
- "operating"
- "bankruptcy"
- "reorganization"
- "inLiquidationProcess"
- "liquidated"
- name: "ogrn"
in: "query"
description: "Основной государственный регистрационный номер."
required: true
style: "form"
explode: true
schema:
pattern: "^\\d{13,15}$"
type: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "companyCard"
- "data"
type: "object"
properties:
companyCard:
required:
- "pages"
- "requisites"
- "statusType"
type: "object"
properties:
statusType:
type: "string"
description: "Статус компании."
enum:
- "active"
- "reorganizing"
- "liquidating"
- "liquidated"
- "bankrupting"
- "unknown"
requisites:
required:
- "ogrn"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
shortName:
type: "string"
format: "string"
nullable: true
fullName:
type: "string"
format: "string"
nullable: true
dateReg:
type: "string"
format: "date"
nullable: true
terminationDt:
type: "string"
format: "date"
nullable: true
status:
type: "string"
format: "string"
nullable: true
authorizedCapitalAmount:
type: "number"
format: "double"
nullable: true
ogrnAssignDate:
type: "string"
format: "date"
nullable: true
legalAddress:
type: "string"
format: "string"
nullable: true
city:
type: "string"
format: "string"
nullable: true
description: "Реквизиты."
pages:
maxItems: 20
type: "array"
items:
required:
- "page"
type: "object"
properties:
page:
type: "string"
description: "Код страницы."
enum:
- "okved"
- "contract"
- "license"
- "history"
- "trafficLight"
- "relatedCompanies"
- "feedback"
- "financialStatements"
- "enforcementProceedings"
- "inspections"
description: "Информация о странице."
description: "Карточка компании."
data:
required:
- "entrepreneurRelations"
- "managers"
- "relationSummary"
type: "object"
properties:
entrepreneurRelations:
maxItems: 100
type: "array"
items:
required:
- "ogrn"
- "positionType"
- "statusPriority"
type: "object"
properties:
fullName:
maxLength: 1000
type: "string"
nullable: true
shortName:
maxLength: 1000
type: "string"
nullable: true
statusGroup:
maxLength: 512
type: "string"
nullable: true
statusPriority:
type: "integer"
format: "int32"
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
entityRegistrationDate:
type: "string"
format: "date"
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
positionType:
type: "string"
description: "Должность физ. лица в компании."
enum:
- "entrepreneur"
- "founder"
- "confidant"
- "founderAndConfidant"
description: "Описание связанной компании."
managers:
maxItems: 100
type: "array"
items:
required:
- "inn"
- "name"
- "positionType"
- "relatedEnterprises"
- "total"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
name:
maxLength: 1000
type: "string"
total:
type: "integer"
format: "int32"
positionType:
type: "string"
description: "Должность физ. лица в компании."
enum:
- "entrepreneur"
- "founder"
- "confidant"
- "founderAndConfidant"
relatedEnterprises:
maxItems: 100
type: "array"
items:
required:
- "ogrn"
- "positionType"
- "statusPriority"
type: "object"
properties:
fullName:
maxLength: 1000
type: "string"
nullable: true
shortName:
maxLength: 1000
type: "string"
nullable: true
statusGroup:
maxLength: 512
type: "string"
nullable: true
statusPriority:
type: "integer"
format: "int32"
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
entityRegistrationDate:
type: "string"
format: "date"
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
positionType:
type: "string"
description: "Должность физ. лица в компании."
enum:
- "entrepreneur"
- "founder"
- "confidant"
- "founderAndConfidant"
description: "Описание связанной компании."
description: "Менеджер и связанные с ним компании."
relationSummary:
required:
- "relatedByConfidant"
- "relatedByFounder"
- "total"
type: "object"
properties:
total:
type: "integer"
format: "int32"
relatedByFounder:
type: "integer"
format: "int32"
relatedByConfidant:
type: "integer"
format: "int32"
description: "Связанные компании."
description: "Связанные компании."
example:
companyCard:
statusType: "active"
requisites:
inn: "000000000000"
ogrn: "1000000000000"
kpp: "000000000"
shortName: "ПАО \"НАЗВАНИЕ\""
fullName: "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"НАЗВАНИЕ\""
dateReg: "1996-06-21"
terminationDt: "2020-11-20"
status: "Действующая организация"
authorizedCapitalAmount: 3975771140
ogrnAssignDate: "2000-01-01"
legalAddress: "119019, г Москва, ул Арбат"
city: "Москва"
pages:
- page: "okved"
- page: "contract"
- page: "license"
- page: "history"
- page: "trafficLight"
- page: "feedback"
- page: "financialStatements"
data:
entrepreneurRelations: []
managers: []
relationSummary:
total: 11
relatedByFounder: 0
relatedByConfidant: 0
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "INVALID"
errorMessage: "Некорректный ОГРН: 1000000000000"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "NO_DATA"
errorMessage: "Данные не найдены: ОГРН 000000000000000"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/counterparty/related_companies_page:
get:
tags:
- "Проверка контрагентов"
summary: "Получить список связанных компаний"
description: "Метод для получения списка связанных компаний."
operationId: "getApiV1CounterpartyRelatedCompaniesPage"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "filter"
in: "query"
description: "Фильтр для статусов связанных компаний."
required: false
style: "form"
explode: true
schema:
maxItems: 5
type: "array"
items:
type: "string"
enum:
- "operating"
- "bankruptcy"
- "reorganization"
- "inLiquidationProcess"
- "liquidated"
- name: "limit"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "integer"
format: "int32"
- name: "managerInn"
in: "query"
description: "ИНН менеджера связанной компании."
required: false
style: "form"
explode: true
schema:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
- name: "offset"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "integer"
format: "int32"
- name: "ogrn"
in: "query"
description: "Основной государственный регистрационный номер."
required: true
style: "form"
explode: true
schema:
pattern: "^\\d{13,15}$"
type: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "relations"
type: "object"
properties:
relations:
maxItems: 100
type: "array"
items:
required:
- "ogrn"
- "positionType"
- "statusPriority"
type: "object"
properties:
fullName:
maxLength: 1000
type: "string"
nullable: true
shortName:
maxLength: 1000
type: "string"
nullable: true
statusGroup:
maxLength: 512
type: "string"
nullable: true
statusPriority:
type: "integer"
format: "int32"
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
entityRegistrationDate:
type: "string"
format: "date"
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
positionType:
type: "string"
description: "Должность физ. лица в компании."
enum:
- "entrepreneur"
- "founder"
- "confidant"
- "founderAndConfidant"
description: "Описание связанной компании."
description: "Подгружаемые связанные компании."
example:
relations:
- fullName: "Акционерное Общество \"Название\""
shortName: "АО \"Название\""
statusGroup: "Действующая организация"
statusPriority: 1
inn: "000000000000"
kpp: "000000000"
entityRegistrationDate: "1999-03-03"
ogrn: "1000000000000"
positionType: "founder"
- fullName: "Общество с Ограниченной Ответственностью \"Название\""
shortName: "ООО \"Название\""
statusGroup: "Действующая организация"
statusPriority: 1
inn: "000000000000"
kpp: "000000000"
entityRegistrationDate: "2010-01-01"
ogrn: "1000000000000"
positionType: "founder"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "INVALID"
errorMessage: "Некорректный ОГРН: 1000000000000"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "NO_DATA"
errorMessage: "Данные не найдены: ОГРН 000000000000000"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/counterparty/traffic_light:
get:
tags:
- "Проверка контрагентов"
summary: "Получить светофор факторов надежности"
description: "Метод для получения светофора факторов надежности."
operationId: "getApiV1CounterpartyTrafficLight"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "ogrn"
in: "query"
description: "Основной государственный регистрационный номер."
required: true
style: "form"
explode: true
schema:
pattern: "^\\d{13,15}$"
type: "string"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "companyCard"
- "data"
type: "object"
properties:
companyCard:
required:
- "pages"
- "requisites"
- "statusType"
type: "object"
properties:
statusType:
type: "string"
description: "Статус компании."
enum:
- "active"
- "reorganizing"
- "liquidating"
- "liquidated"
- "bankrupting"
- "unknown"
requisites:
required:
- "ogrn"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
ogrn:
pattern: "^\\d{13,15}$"
type: "string"
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
nullable: true
shortName:
type: "string"
format: "string"
nullable: true
fullName:
type: "string"
format: "string"
nullable: true
dateReg:
type: "string"
format: "date"
nullable: true
terminationDt:
type: "string"
format: "date"
nullable: true
status:
type: "string"
format: "string"
nullable: true
authorizedCapitalAmount:
type: "number"
format: "double"
nullable: true
ogrnAssignDate:
type: "string"
format: "date"
nullable: true
legalAddress:
type: "string"
format: "string"
nullable: true
city:
type: "string"
format: "string"
nullable: true
description: "Реквизиты."
pages:
maxItems: 20
type: "array"
items:
required:
- "page"
type: "object"
properties:
page:
type: "string"
description: "Код страницы."
enum:
- "okved"
- "contract"
- "license"
- "history"
- "trafficLight"
- "relatedCompanies"
- "feedback"
- "financialStatements"
- "enforcementProceedings"
- "inspections"
description: "Информация о странице."
description: "Карточка компании."
data:
required:
- "companyType"
- "expressCheckResult"
- "innerCheckResult"
type: "object"
properties:
companyType:
type: "string"
description: "Тип компании."
enum:
- "entrepreneur"
- "company"
expressCheckResult:
required:
- "admittedContractsAsSupplier"
- "authorizedCapitalAmount"
- "confidantChangeDate"
- "founderChangeDate"
- "legalAddressChangeDate"
- "legalForm"
- "licensedOkvedCount"
- "okvedCount"
- "registrationDate"
- "riskLevel"
- "status"
type: "object"
properties:
status:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
registrationDate:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
legalAddressChangeDate:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
founderChangeDate:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
confidantChangeDate:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
authorizedCapitalAmount:
required:
- "color"
type: "object"
properties:
value:
type: "number"
format: "double"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
admittedContractsAsSupplier:
required:
- "color"
- "value"
type: "object"
properties:
value:
required:
- "count"
type: "object"
properties:
count:
type: "integer"
format: "int64"
totalValue:
type: "number"
format: "double"
nullable: true
description: "Статистика по контрактам."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
legalForm:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
okvedCount:
required:
- "color"
- "value"
type: "object"
properties:
value:
type: "integer"
format: "int64"
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
licensedOkvedCount:
required:
- "color"
- "value"
type: "object"
properties:
value:
type: "integer"
format: "int64"
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
riskLevel:
required:
- "color"
type: "object"
properties:
value:
type: "integer"
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
description: "Результат проверки компании:\n\n* `Status` —\
\ статус компании;\n\n* `RegistrationDate` — проверка да\
ты регистрации на превышение трех лет;\n\n* `LegalAddressChangeDate`\
\ — проверка изменения юридического адреса за последний\
\ год;\n\n* `FounderChangeDate` — проверка изменения учр\
едителя за последний год;\n\n* `ConfidantChangeDate` — п\
роверка изменения руководителя за последний год;\n\n* `AuthorizedCapitalAmount`\
\ — проверка превышения уставного капитала минимального\
\ порога;\n\n* `AdmittedContractsAsSupplier` — участие в\
\ государственных закупках;\n\n* `LegalForm` — организац\
ионно-правовая форма организации;\n\n* `OkvedCount` — ко\
личество видов деятельности, превышающих порог;\n\n* `LicensedOkvedCount`\
\ — проверка соответствия лицензии коду ОКВЭД;\n\n* `RiskLevel`\
\ — уровень риска."
innerCheckResult:
required:
- "activeProceedings"
- "bankruptcyMessage"
- "defendant"
- "defendantDynamic"
- "disqualifiedPersons"
- "executedProceedings"
- "finance"
- "invalidLegalAddress"
- "isNegative"
- "plaintiff"
- "sameAddressNumber"
- "sameManager"
- "taxDebt"
- "taxReport"
- "thirdOrOtherPerson"
- "unfairSupplier"
type: "object"
properties:
bankruptcyMessage:
required:
- "color"
type: "object"
properties:
value:
type: "object"
properties:
idType:
type: "integer"
format: "int64"
nullable: true
messageType:
type: "string"
format: "string"
nullable: true
date:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\\
d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
decisionDate:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\d{2}:\\\
d{2})|Z)?)$"
type: "string"
format: "string"
nullable: true
caseNumber:
type: "string"
format: "string"
nullable: true
caseId:
type: "integer"
format: "int64"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
plaintiff:
required:
- "color"
type: "object"
properties:
value:
required:
- "maxDate"
- "minDate"
- "totalCases"
type: "object"
properties:
minDate:
type: "integer"
description: "Наименьший год с судебными делам\
и."
format: "int32"
maxDate:
type: "integer"
description: "Наибольший год с судебными делам\
и."
format: "int32"
totalCases:
type: "integer"
format: "int32"
description: "Статистика по судебным делам."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
thirdOrOtherPerson:
required:
- "color"
type: "object"
properties:
value:
required:
- "maxDate"
- "minDate"
- "totalCases"
type: "object"
properties:
minDate:
type: "integer"
description: "Наименьший год с судебными делам\
и."
format: "int32"
maxDate:
type: "integer"
description: "Наибольший год с судебными делам\
и."
format: "int32"
totalCases:
type: "integer"
format: "int32"
description: "Статистика по судебным делам."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
defendant:
required:
- "color"
type: "object"
properties:
value:
required:
- "maxDate"
- "minDate"
- "totalCases"
type: "object"
properties:
minDate:
type: "integer"
description: "Наименьший год с судебными делам\
и."
format: "int32"
maxDate:
type: "integer"
description: "Наибольший год с судебными делам\
и."
format: "int32"
totalCases:
type: "integer"
format: "int32"
description: "Статистика по судебным делам."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
defendantDynamic:
required:
- "color"
type: "object"
properties:
value:
required:
- "lastYear"
- "percent"
- "prevLastYear"
type: "object"
properties:
lastYear:
type: "integer"
format: "int32"
prevLastYear:
type: "integer"
format: "int32"
percent:
type: "number"
format: "double"
description: "Динамика судебных дел в качестве отв\
етчика."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
executedProceedings:
required:
- "color"
type: "object"
properties:
value:
type: "integer"
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
activeProceedings:
required:
- "color"
type: "object"
properties:
value:
type: "integer"
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
sameManager:
required:
- "color"
type: "object"
properties:
value:
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
nullable: true
sameManager:
type: "object"
properties:
manager:
maxLength: 512
type: "string"
nullable: true
managerCountInCountry:
type: "integer"
format: "int32"
nullable: true
managerInnCount:
type: "integer"
format: "int32"
nullable: true
description: "Массовый руководитель."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
sameAddressNumber:
required:
- "color"
type: "object"
properties:
value:
type: "integer"
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
finance:
required:
- "color"
type: "object"
properties:
value:
type: "object"
properties:
balanceType:
type: "integer"
format: "int64"
nullable: true
periods:
maxItems: 200
type: "array"
description: "Бухгалтерская отчетность."
nullable: true
items:
type: "object"
properties:
periodName:
maxLength: 512
type: "string"
description: "Отчетный период."
nullable: true
dateBegin:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\\
d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Начало периода."
format: "string"
nullable: true
dateEnd:
pattern: "^\\d{4}-\\d{2}-\\d{2}(((\\+\\\
d{2}:\\d{2})|Z)?)$"
type: "string"
description: "Конец периода."
format: "string"
nullable: true
data:
maxItems: 200
type: "array"
nullable: true
items:
type: "object"
properties:
form:
maxLength: 512
type: "string"
description: "Форма."
nullable: true
section:
maxLength: 512
type: "string"
description: "Раздел."
nullable: true
name:
maxLength: 512
type: "string"
description: "Наименование."
nullable: true
code:
maxLength: 512
type: "string"
description: "Код."
nullable: true
value:
maxLength: 512
type: "string"
description: "Значение."
nullable: true
id:
type: "integer"
description: "Идентификатор списка\
."
format: "int32"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
isNegative:
required:
- "color"
- "value"
type: "object"
properties:
value:
required:
- "negativeListsCount"
type: "object"
properties:
negativeListsCount:
type: "integer"
format: "int32"
description: "Статистика негативных списков."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
unfairSupplier:
required:
- "color"
type: "object"
properties:
value:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
invalidLegalAddress:
required:
- "color"
type: "object"
properties:
value:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
disqualifiedPersons:
required:
- "color"
type: "object"
properties:
value:
required:
- "id"
- "isNegative"
type: "object"
properties:
isNegative:
type: "boolean"
id:
type: "integer"
format: "int32"
listName:
type: "string"
format: "string"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
taxReport:
required:
- "color"
type: "object"
properties:
value:
type: "string"
format: "date"
nullable: true
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
taxDebt:
required:
- "color"
type: "object"
properties:
value:
required:
- "statDate"
- "sum"
type: "object"
properties:
sum:
type: "number"
format: "double"
statDate:
type: "string"
format: "date"
description: "Налоговая задолженность."
color:
type: "string"
description: "Цвет поля."
enum:
- "red"
- "yellow"
- "green"
- "none"
description: "Значение с цветом."
description: "Результат внутренней проверки компании:\n\n\
* `BankruptcyMessage` — сообщения о банкротстве;\n\n* `Plaintiff`\
\ — судебные дела в качестве истца;\n\n* `ThirdOrOtherPerson`\
\ — судебные дела в качестве третьего лица;\n\n* `Defendant`\
\ — судебные дела в качестве ответчика;\n\n* `DefendantDynamic`\
\ — динамика судебных дел в качестве ответчика;\n\n* `ExecutedProceedings`\
\ — завершенные исполнительные производства;\n\n* `ActiveProceedings`\
\ — активные исполнительные производства;\n\n* `SameManager`\
\ — массовый руководитель;\n\n* `SameAddressNumber` — ма\
ссовый юридический адрес;\n\n* `Finance` — бухгалтерская\
\ отчетность;\n\n* `IsNegative` — негативные списки;\n\n\
* `UnfairSupplier` — реестр недобросовестных поставщиков\
;\n\n* `InvalidLegalAddress` — список компаний, отсутств\
ующих по юридическому адресу;\n\n* `DisqualifiedPersons`\
\ — реестр дисквалифицированных лиц;\n\n* `ReferenceCheckRecommended`\
\ — рекомендация проверки в справочных источниках;\n\n*\
\ `DueDiligenceRecommended` — рекомендация проведения до\
кументальной проверки (Due Diligence);\n\n* `TaxReport`\
\ — налоговая отчетность;\n\n* `TaxDebt` — налоговая зад\
олженность."
description: "Светофор надежности внутренней проверки."
example:
companyCard:
statusType: "active"
requisites:
inn: "000000000000"
ogrn: "1000000000000"
kpp: "000000000"
shortName: "ПАО \"НАЗВАНИЕ\""
fullName: "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"НАЗВАНИЕ\""
dateReg: "1996-06-21"
terminationDt: "2020-11-20"
status: "Действующая организация"
authorizedCapitalAmount: 3975771140
ogrnAssignDate: "2000-01-01"
legalAddress: "119019, г Москва, ул Арбат"
city: "Москва"
pages:
- page: "okved"
- page: "contract"
- page: "license"
- page: "history"
- page: "trafficLight"
- page: "feedback"
- page: "financialStatements"
data:
companyType: "company"
expressCheckResult:
status:
value: "Действующая организация"
color: "none"
registrationDate:
value: "1994-06-21"
color: "green"
legalAddressChangeDate:
value: "2019-07-10"
color: "green"
founderChangeDate:
value: "2021-10-25"
color: "green"
confidantChangeDate:
value: "2022-04-18"
color: "green"
authorizedCapitalAmount:
value: 3975771140
color: "green"
admittedContractsAsSupplier:
value:
count: 40
totalValue: 27523079541
color: "green"
legalForm:
value: "Публичные акционерные общества"
color: "green"
okvedCount:
value: 22
color: "none"
licensedOkvedCount:
value: 0
color: "none"
riskLevel:
value: 0
color: "none"
innerCheckResult:
bankruptcyMessage:
value:
idType: 7
messageType: "Тип сообщения"
date: "2021-10-26Z"
decisionDate: "2021-10-19Z"
caseNumber: "А56-13391/2020"
caseId: 23040734
color: "green"
plaintiff:
value:
minDate: 2004
maxDate: 2018
totalCases: 470
color: "yellow"
thirdOrOtherPerson:
value:
minDate: 2007
maxDate: 2018
totalCases: 85
color: "yellow"
defendant:
value:
minDate: 2007
maxDate: 2018
totalCases: 157
color: "yellow"
defendantDynamic:
value:
lastYear: 2019
prevLastYear: 2018
percent: 50
color: "none"
executedProceedings:
value: 1326
color: "yellow"
activeProceedings:
value: 65
color: "red"
sameManager:
value:
inn: "000000000000"
sameManager:
manager: "Фамилия Имя Отчество"
managerCountInCountry: 1
managerInnCount: 1
color: "none"
sameAddressNumber:
value: 51
color: "yellow"
finance:
value:
balanceType: 1
periods:
- periodName: "2015"
dateBegin: "2015-01-01+03:00"
dateEnd: "2015-12-31+03:00"
data: []
- periodName: "2016"
dateBegin: "2016-01-01+03:00"
dateEnd: "2016-12-31+03:00"
data: []
- periodName: "2017"
dateBegin: "2017-01-01+03:00"
dateEnd: "2017-12-31+03:00"
data: []
color: "green"
isNegative:
value:
negativeListsCount: 0
color: "green"
unfairSupplier:
value:
isNegative: true
id: 1
listName: "Название"
color: "green"
invalidLegalAddress:
value:
isNegative: true
id: 1
listName: "Название"
color: "green"
disqualifiedPersons:
value:
isNegative: true
id: 1
listName: "Название"
color: "green"
taxReport:
value: "2023-04-25"
color: "none"
taxDebt:
value:
sum: 10
statDate: "2000-01-01"
color: "green"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "INVALID"
errorMessage: "Некорректный ОГРН: 1000000000000"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "1b3c8ae867bc100d"
errorCode: "NO_DATA"
errorMessage: "Данные не найдены: ОГРН 000000000000000"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/credit-products/{brokerId}/applications/full:
post:
tags:
- "Кредитные продукты"
summary: "Создать полную заявку"
description: "Асинхронный метод для создания заявки на кредитный продукт бан\
ка. Запускает процесс принятия решения по продукту.\n\nРешение и статус за\
явки передаются через вызов партнера."
operationId: "postApiV1Credit-productsBrokerIdApplicationsFull"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "brokerId"
in: "path"
description: "Уникальный идентификатор брокера."
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
requestBody:
content:
application/json:
schema:
required:
- "applicationPayload"
- "files"
type: "object"
properties:
process:
type: "object"
properties:
processId:
type: "string"
description: "Идентификатор процесса."
partnerId:
type: "string"
description: "Идентификатор партнера."
description: "Данные по процессу."
partner:
type: "object"
properties:
pointId:
maxLength: 36
type: "string"
description: "Уникальный идентификатор точки оформления заяв\
ки."
personId:
maxLength: 36
type: "string"
description: "Уникальный идентификатор сотрудника."
description: "Данные партнера."
applicationPayload:
required:
- "applicationId"
- "clientInfo"
type: "object"
properties:
applicationId:
maxLength: 36
type: "string"
description: "Уникальный идентификатор заявки."
clientInfo:
required:
- "birthDate"
- "documents"
- "firstName"
- "lastName"
- "mobilePhone"
type: "object"
properties:
firstName:
maxLength: 50
pattern: "^[^\\s]+(\\s+[^\\s]+)*$"
type: "string"
description: "Имя."
example: "Иван"
lastName:
maxLength: 50
pattern: "^[^\\s]+(\\s+[^\\s]+)*$"
type: "string"
description: "Фамилия."
example: "Иванов"
middleName:
maxLength: 50
pattern: "^[^\\s]+(\\s+[^\\s]+)*$"
type: "string"
description: "Отчество."
example: "Иванович"
birthDate:
pattern: "^((19|20)\\d\\d)-(0?[1-9]|1[012])-(0?[1-9]|[12][0-9]|3[01])$"
type: "string"
description: "Дата рождения."
example: "1986-11-01"
emailAddress:
pattern: "^[a-zA-Z0-9_!#$%&'*+/=?`{|}~^.-]+@[a-zA-Z0-9.-]+$"
type: "string"
description: "Адрес электронной почты."
example: "i.ivanov@email.ru"
education:
type: "string"
description: "Образование."
example: "HIGHER"
enum:
- "SECONDARY_SPECIAL"
- "INCOMPLETE_HIGHER"
- "HIGHER"
- "SECOND_HIGHER"
- "ACADEMIC_DEGREE"
maritalStatus:
type: "string"
description: "Семейное положение."
example: "MARRIED_OFFICIAL"
enum:
- "WIDOW"
- "DIVORCED"
- "MARRIED_UNOFFICIAL"
- "MARRIED_OFFICIAL"
- "SINGLE"
- "SEPARATED"
workPhone:
pattern: "^((\\+7)([0-9]){10})$"
type: "string"
description: "Рабочий телефон."
example: "79010101001"
mobilePhone:
pattern: "^((\\+7)([0-9]){10})$"
type: "string"
description: "Мобильный телефон."
example: "79010101001"
documents:
required:
- "passport"
type: "object"
properties:
passport:
required:
- "serialNumber"
type: "object"
properties:
birthPlace:
maxLength: 150
type: "string"
description: "Место рождения."
example: "Г. МОСКВА"
serialNumber:
maxLength: 20
type: "string"
description: "Серия и номер документа."
example: "1234567890"
division:
maxLength: 10
type: "string"
description: "Код организации, выдавшей документ\
."
example: "123-456"
date:
pattern: "^((19|20)\\d\\d)-(0?[1-9]|1[012])-(0?[1-9]|[12][0-9]|3[01])$"
type: "string"
description: "Дата выдачи документа."
example: "2020-09-01"
organisationWhoGiven:
maxLength: 200
type: "string"
description: "Организация, выдавшая документ."
registrationAddress:
required:
- "area"
- "cityName"
- "country"
- "house"
- "region"
type: "object"
properties:
country:
maxLength: 70
type: "string"
description: "Страна."
example: "РОССИЯ"
correspondence:
type: "boolean"
description: "Корреспонденция."
zipCode:
maxLength: 30
type: "string"
description: "Индекс."
example: "150001"
region:
maxLength: 50
type: "string"
description: "Регион, согласно КЛАДР."
example: "ЯРОСЛАВСКАЯ"
regionType:
maxLength: 50
type: "string"
description: "Тип региона."
example: "ОБЛ"
area:
maxLength: 50
type: "string"
description: "Район."
areaType:
maxLength: 50
type: "string"
description: "Тип района."
cityType:
maxLength: 50
type: "string"
description: "Тип населенного пункта, соглас\
но КЛАДР."
example: "Г"
cityName:
maxLength: 50
type: "string"
description: "Название населенного пункта."
example: "ЯРОСЛАВЛЬ"
placeType:
maxLength: 50
type: "string"
description: "Тип подчиненного населенного п\
ункта, согласно КЛАДР."
placeName:
maxLength: 50
type: "string"
description: "Название подчиненного населенн\
ого пункта."
streetType:
maxLength: 50
type: "string"
description: "Тип улицы, согласно КЛАДР."
example: "ул"
street:
maxLength: 200
type: "string"
description: "Название улицы."
example: "ПРАВДЫ"
house:
maxLength: 30
type: "string"
description: "Номер дома."
example: "11"
building:
maxLength: 30
type: "string"
description: "Корпус."
structure:
maxLength: 30
type: "string"
description: "Строение."
flat:
maxLength: 12
type: "string"
description: "Квартира."
example: "10"
description: "Адрес."
residenceAddress:
required:
- "area"
- "cityName"
- "country"
- "house"
- "region"
type: "object"
properties:
country:
maxLength: 70
type: "string"
description: "Страна."
example: "РОССИЯ"
correspondence:
type: "boolean"
description: "Корреспонденция."
zipCode:
maxLength: 30
type: "string"
description: "Индекс."
example: "150001"
region:
maxLength: 50
type: "string"
description: "Регион, согласно КЛАДР."
example: "ЯРОСЛАВСКАЯ"
regionType:
maxLength: 50
type: "string"
description: "Тип региона."
example: "ОБЛ"
area:
maxLength: 50
type: "string"
description: "Район."
areaType:
maxLength: 50
type: "string"
description: "Тип района."
cityType:
maxLength: 50
type: "string"
description: "Тип населенного пункта, соглас\
но КЛАДР."
example: "Г"
cityName:
maxLength: 50
type: "string"
description: "Название населенного пункта."
example: "ЯРОСЛАВЛЬ"
placeType:
maxLength: 50
type: "string"
description: "Тип подчиненного населенного п\
ункта, согласно КЛАДР."
placeName:
maxLength: 50
type: "string"
description: "Название подчиненного населенн\
ого пункта."
streetType:
maxLength: 50
type: "string"
description: "Тип улицы, согласно КЛАДР."
example: "ул"
street:
maxLength: 200
type: "string"
description: "Название улицы."
example: "ПРАВДЫ"
house:
maxLength: 30
type: "string"
description: "Номер дома."
example: "11"
building:
maxLength: 30
type: "string"
description: "Корпус."
structure:
maxLength: 30
type: "string"
description: "Строение."
flat:
maxLength: 12
type: "string"
description: "Квартира."
example: "10"
description: "Адрес."
description: "Паспорт."
description: "Документы."
previousJob:
type: "object"
properties:
organization:
maxLength: 300
type: "string"
description: "Название организации."
example: "АО «ТБанк»"
jobPositionType:
type: "string"
description: "Тип занятости."
example: "EMPLOYEE"
enum:
- "EMPLOYEE"
- "SELF_EMPLOYED"
- "COMMERCIAL_EMPLOYEE"
- "GOVERNMENT_EMPLOYEE"
- "STUDENT"
- "PENSIONER"
- "PENSIONER_WORKING"
- "UNEMPLOYED"
jobTitle:
maxLength: 100
type: "string"
description: "Название должности."
example: "Специалист по работе с клиентами"
startMonth:
maximum: 12
minimum: 1
type: "integer"
description: "Месяц начала работы. Если данных нет,\
\ не передавайте этот параметр."
format: "int32"
example: 3
startYear:
maximum: 3000
minimum: 1900
type: "integer"
description: "Год начала работы."
format: "int32"
example: 2011
averageMonthlyIncome:
minimum: 1
type: "number"
description: "Средний доход в месяц."
example: 30000
workAddress:
required:
- "area"
- "cityName"
- "country"
- "house"
- "region"
type: "object"
properties:
country:
maxLength: 70
type: "string"
description: "Страна."
example: "РОССИЯ"
correspondence:
type: "boolean"
description: "Корреспонденция."
zipCode:
maxLength: 30
type: "string"
description: "Индекс."
example: "150001"
region:
maxLength: 50
type: "string"
description: "Регион, согласно КЛАДР."
example: "ЯРОСЛАВСКАЯ"
regionType:
maxLength: 50
type: "string"
description: "Тип региона."
example: "ОБЛ"
area:
maxLength: 50
type: "string"
description: "Район."
areaType:
maxLength: 50
type: "string"
description: "Тип района."
cityType:
maxLength: 50
type: "string"
description: "Тип населенного пункта, согласно К\
ЛАДР."
example: "Г"
cityName:
maxLength: 50
type: "string"
description: "Название населенного пункта."
example: "ЯРОСЛАВЛЬ"
placeType:
maxLength: 50
type: "string"
description: "Тип подчиненного населенного пункт\
а, согласно КЛАДР."
placeName:
maxLength: 50
type: "string"
description: "Название подчиненного населенного\
\ пункта."
streetType:
maxLength: 50
type: "string"
description: "Тип улицы, согласно КЛАДР."
example: "ул"
street:
maxLength: 200
type: "string"
description: "Название улицы."
example: "ПРАВДЫ"
house:
maxLength: 30
type: "string"
description: "Номер дома."
example: "11"
building:
maxLength: 30
type: "string"
description: "Корпус."
structure:
maxLength: 30
type: "string"
description: "Строение."
flat:
maxLength: 12
type: "string"
description: "Квартира."
example: "10"
description: "Адрес."
description: "Текущее место работы."
contacts:
maximum: 5
minimum: 1
maxItems: 5
type: "array"
items:
required:
- "firstName"
- "lastName"
- "mobilePhone"
- "relation"
properties:
firstName:
maxLength: 50
type: "string"
description: "Имя."
example: "Екатерина"
lastName:
maxLength: 50
type: "string"
description: "Фамилия."
example: "Ивановна"
middleName:
maxLength: 50
type: "string"
description: "Отчество."
example: "Петрова"
relation:
type: "string"
description: "Тип отношений контактного лица с кли\
ентом."
example: "MOTHER"
enum:
- "BROTHER"
- "SISTER"
- "MOTHER"
- "FATHER"
- "DAUGHTER"
- "SON"
- "HUSBAND"
- "WIFE"
- "OTHER_RELATIVE"
- "FRIEND"
- "COLLEAGUE"
mobilePhone:
pattern: "^((\\+7)([0-9]){10})$"
type: "string"
description: "Мобильный телефон."
example: "79010101001"
description: "Информация о клиенте."
description: "Данные по заявке."
files:
maxItems: 5
minItems: 1
type: "array"
description: "Файлы."
items:
required:
- "data"
- "fileType"
- "mimeType"
type: "object"
properties:
data:
type: "string"
description: "Содержимое документа."
format: "base64"
mimeType:
maxLength: 50
type: "string"
description: "MIME-тип."
example: "application/pdf"
fileType:
type: "string"
description: "Тип документа."
example: "BCI_PD"
enum:
- "PASSPORT_2_3P"
- "PASSPORT_REG"
- "PHOTO"
- "BCI_PD"
- "CONSENT_ECP"
- "AGREEMENT"
- "INDIV_CONDITIONS"
description: "Документы"
example:
partner:
pointId: "f2066320-7ac0-11ec-90d6-0242ac120004"
personId: "f2066320-7ac0-11ec-90d6-0242ac120003"
applicationPayload:
applicationId: "applicationId"
clientInfo:
firstName: "Дмитрий"
lastName: "Петров"
middleName: "Валерьевич"
birthDate: "1991-09-23"
emailAddress: "ivanov@gmail.com"
education: "HIGHER"
maritalStatus: "SINGLE"
workPhone: "+79123456789"
mobilePhone: "+79123456789"
documents:
passport:
birthPlace: "Г. МОСКВА"
serialNumber: "1234567890"
division: "123-456"
date: "2020-09-01"
organisationWhoGiven: "Отделом УФМС по всем городам всех обл\
астей необъятной нашей Родины"
registrationAddress:
country: "РОССИЯ"
correspondence: true
zipCode: "150001"
region: "ЯРОСЛАВСКАЯ"
regionType: "ОБЛ"
area: "Москва"
areaType: "Город"
cityType: "Г"
cityName: "ЯРОСЛАВЛЬ"
placeType: "тер. СНТ"
placeName: "ВМЗ N3"
streetType: "ул"
street: "ПРАВДЫ"
house: "11"
building: "1"
structure: "2"
flat: "10"
residenceAddress:
country: "РОССИЯ"
correspondence: true
zipCode: "150001"
region: "ЯРОСЛАВСКАЯ"
regionType: "ОБЛ"
area: "Москва"
areaType: "Город"
cityType: "Г"
cityName: "ЯРОСЛАВЛЬ"
placeType: "тер. СНТ"
placeName: "ВМЗ N3"
streetType: "ул"
street: "ПРАВДЫ"
house: "11"
building: "1"
structure: "2"
flat: "10"
previousJob:
organization: "АО «ТБанк»"
jobPositionType: "STUDENT"
jobTitle: "Специалист по работе с клиентами"
startMonth: 3
startYear: 2011
averageMonthlyIncome: 30000
workAddress:
country: "РОССИЯ"
correspondence: true
zipCode: "150001"
region: "ЯРОСЛАВСКАЯ"
regionType: "ОБЛ"
area: "Москва"
areaType: "Город"
cityType: "Г"
cityName: "ЯРОСЛАВЛЬ"
placeType: "тер. СНТ"
placeName: "ВМЗ N3"
streetType: "ул"
street: "ПРАВДЫ"
house: "11"
building: "1"
structure: "2"
flat: "10"
contacts:
- firstName: "Екатерина"
lastName: "Ивановна"
middleName: "Петрова"
relation: "WIFE"
mobilePhone: "+79010101001"
files:
- data: "iVBORw0KGgoAAAANSUhEUgAAAAwAAAAMCAYAAABWdVznAAABaUlEQVQokZVSTUsCURS9b8bxKy3TrEhxYQtDCKplqwiEoK39hXZtXFW2KRJa9RvaBC2C6A+0rGiTmwJDkqQMs5TMYcT5eJ03RpTYooHz7r3nnsPj3TuMc07/+RziuJ3NhhFWgQhwBpwkr3Mm+GXki0ALOABXYjczmzEU54H5RET2uan9UCO1UDkGV/bGxzLuaIi4blDj4q4ObkHckBmGeGguTmRx8k+OkzcWThsfGvmnosRkRtwiYpwF65eFbWFIKgNuMt812yDe5Az5yRn0kaG2uxwg4XahFYa8WnpJMZdiN4RBRPrOLTtq91VhyAvDjlp8XjI6+rQrNkJiaLx7kJifyPVKg/TyaxHlGhPE15QOpdHBlDQRIHLK9gi5aZH12CBebV6hXMGUyuznHmBcR9g1E2HZ8igkPzVJqrX2wW1A3BEa1rs4mNIIR3rIIytvWg7CrV8C+2E9wG6ywGm/nuOPP2AP8PRrfAILd8GBXj/H8gAAAABJRU5ErkJggg=="
mimeType: "image/png"
fileType: "BCI_PD"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/credit-products/{brokerId}/applications/{applicationId}:
delete:
tags:
- "Кредитные продукты"
summary: "Отменить заявку"
description: "Асинхронный метод для запуска процесса отмены заявки на кредит\
ный продукт.\n\nОтменить заявку можно до окончательной проверки подписанны\
х документов."
operationId: "deleteApiV1Credit-productsBrokerIdApplicationsApplicationid"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "applicationId"
in: "path"
description: "Уникальный идентификатор заявки."
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
- name: "brokerId"
in: "path"
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
description: "Уникальный идентификатор брокера."
requestBody:
content:
application/json:
schema:
type: "object"
properties:
cancelReason:
maxLength: 36
type: "string"
example: "CLIENT_CANCELLATION"
enum:
- "AUTO_CANCELLATION"
- "CLIENT_CANCELLATION"
- "APPLICATION_PREPARATION_PROBLEM"
- "OTHER_REASON"
comment:
maxLength: 100
type: "string"
example: "Клиент попросил отменить заявку"
required: false
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/credit-products/{brokerId}/applications/{applicationId}/activate-product:
post:
tags:
- "Кредитные продукты"
summary: "Активировать карту"
description: "Асинхронный метод для запуска процесса активации карты на кред\
итный продукт."
operationId: "postApiV1Credit-productsBrokerIdApplicationsApplicationidActivate-product"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "applicationId"
in: "path"
description: "Уникальный идентификатор заявки."
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
- name: "brokerId"
in: "path"
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
description: "Уникальный идентификатор брокера."
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/credit-products/{brokerId}/applications/{applicationId}/confirm-offer:
post:
tags:
- "Кредитные продукты"
summary: "Привязать карту к счету"
description: "Асинхронный метод для привязки карты из пула карт, имеющихся у\
\ партнера, к счету клиента. Возможна повторная привязка. "
operationId: "postApiV1Credit-productsBrokerIdApplicationsApplicationidConfirm-offer"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "applicationId"
in: "path"
description: "Уникальный идентификатор заявки."
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
- name: "brokerId"
in: "path"
description: "Уникальный идентификатор брокера."
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
requestBody:
content:
application/json:
schema:
required:
- "card"
- "eventType"
type: "object"
properties:
card:
type: "object"
properties:
ucid:
type: "integer"
description: "UCID карты."
format: "int64"
example: 1145707389
ean:
type: "integer"
description: "EAN карты."
format: "int64"
example: 2989714752437
description: "Данные карты."
eventType:
type: "string"
description: "Тип события."
enum:
- "LINK_CARD"
- "LINK_CARD_UPDATE"
example:
card:
ucid: 1145707389
ean: "2989714752437"
eventType: "LINK_CARD"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/credit-products/{brokerId}/applications/{applicationId}/documents:
get:
tags:
- "Кредитные продукты"
summary: "Сгенерировать документы"
description: "Синхронный метод для генерации документов, которые нужны для о\
формления кредитного продукта.\n\nДопускается повторная генерация документ\
ов. При вызове генерируется весь необходимый комплект документов."
operationId: "getApiV1Credit-productsBrokerIdApplicationsApplicationidDocuments"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "applicationId"
in: "path"
description: "Уникальный идентификатор заявки."
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
- name: "brokerId"
in: "path"
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
description: "Уникальный идентификатор брокера."
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
properties:
base64:
type: "string"
description: "Данные, закодированные в base64
."
format: "base64"
example:
base64: "iVBORw0KGgoAAAANSUhEUgAAAAwAAAAMCAYAAABWdVznAAABaUlEQVQokZVSTUsCURS9b8bxKy3TrEhxYQtDCKplqwiEoK39hXZtXFW2KRJa9RvaBC2C6A+0rGiTmwJDkqQMs5TMYcT5eJ03RpTYooHz7r3nnsPj3TuMc07/+RziuJ3NhhFWgQhwBpwkr3Mm+GXki0ALOABXYjczmzEU54H5RET2uan9UCO1UDkGV/bGxzLuaIi4blDj4q4ObkHckBmGeGguTmRx8k+OkzcWThsfGvmnosRkRtwiYpwF65eFbWFIKgNuMt812yDe5Az5yRn0kaG2uxwg4XahFYa8WnpJMZdiN4RBRPrOLTtq91VhyAvDjlp8XjI6+rQrNkJiaLx7kJifyPVKg/TyaxHlGhPE15QOpdHBlDQRIHLK9gi5aZH12CBebV6hXMGUyuznHmBcR9g1E2HZ8igkPzVJqrX2wW1A3BEa1rs4mNIIR3rIIytvWg7CrV8C+2E9wG6ywGm/nuOPP2AP8PRrfAILd8GBXj/H8gAAAABJRU5ErkJggg=="
"202":
description: "Документ еще не готов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
properties:
message:
pattern: "^Документ пока не готов, попробуйте позже$"
type: "string"
example:
message: "Документ пока не готов, попробуйте позже"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
post:
tags:
- "Кредитные продукты"
summary: "Загрузить документы"
description: "Синхронный метод для загрузки документов, которые нужны для оф\
ормления кредитного продукта."
operationId: "postApiV1Credit-productsBrokerIdApplicationsApplicationidDocuments"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "applicationId"
in: "path"
description: "Уникальный идентификатор заявки."
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
- name: "brokerId"
in: "path"
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
description: "Уникальный идентификатор брокера."
requestBody:
content:
application/json:
schema:
type: "object"
properties:
documents:
maxItems: 5
minItems: 1
type: "array"
description: "Документы."
items:
required:
- "data"
- "fileType"
- "mimeType"
type: "object"
properties:
data:
type: "string"
description: "Данные документа, закодированные в base64
."
format: "base64"
mimeType:
maxLength: 50
type: "string"
description: "MIME-тип."
example: "application/pdf"
fileType:
type: "string"
description: "Тип документа."
example: "BCI_PD"
enum:
- "PASSPORT_2_3P"
- "PASSPORT_REG"
- "PHOTO"
- "BCI_PD"
- "CONSENT_ECP"
- "AGREEMENT"
- "INDIV_CONDITIONS"
documentExemplarId:
maxLength: 50
type: "string"
description: "Идентификатор документа (значение баркода) б\
ез префикса и постфикса."
description: "Документы."
example:
documents:
- data: "iVBORw0KGgoAAAANSUhEUgAAAAwAAAAMCAYAAABWdVznAAABaUlEQVQokZVSTUsCURS9b8bxKy3TrEhxYQtDCKplqwiEoK39hXZtXFW2KRJa9RvaBC2C6A+0rGiTmwJDkqQMs5TMYcT5eJ03RpTYooHz7r3nnsPj3TuMc07/+RziuJ3NhhFWgQhwBpwkr3Mm+GXki0ALOABXYjczmzEU54H5RET2uan9UCO1UDkGV/bGxzLuaIi4blDj4q4ObkHckBmGeGguTmRx8k+OkzcWThsfGvmnosRkRtwiYpwF65eFbWFIKgNuMt812yDe5Az5yRn0kaG2uxwg4XahFYa8WnpJMZdiN4RBRPrOLTtq91VhyAvDjlp8XjI6+rQrNkJiaLx7kJifyPVKg/TyaxHlGhPE15QOpdHBlDQRIHLK9gi5aZH12CBebV6hXMGUyuznHmBcR9g1E2HZ8igkPzVJqrX2wW1A3BEa1rs4mNIIR3rIIytvWg7CrV8C+2E9wG6ywGm/nuOPP2AP8PRrfAILd8GBXj/H8gAAAABJRU5ErkJggg=="
mimeType: "image/png"
fileType: "PHOTO"
documentExemplarId: "KNR3R8XB86S"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
properties:
documents:
maxItems: 20
type: "array"
description: "Документы."
items:
properties:
documentId:
maxLength: 50
type: "string"
description: "Идентификатор документа."
fileType:
type: "string"
description: "Тип документа."
example: "BCI_PD"
enum:
- "PASSPORT_2_3P"
- "PASSPORT_REG"
- "PHOTO"
- "BCI_PD"
- "CONSENT_ECP"
- "AGREEMENT"
- "INDIV_CONDITIONS"
example:
documents:
- documentId: "49614593"
fileType: "PASSPORT_2_3P"
- documentId: "49614594"
fileType: "INDIV_CONDITIONS"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/credit-products/{brokerId}/applications/{applicationId}/documents/check:
post:
tags:
- "Кредитные продукты"
summary: "Проверка документов"
description: "Асинхронный метод для запуска проверки документов после подпис\
ания с клиентом.\n\nПри переподписаниях или исправлениях допускается повто\
рная проверка."
operationId: "postApiV1Credit-productsBrokerIdApplicationsApplicationidDocumentsCheck"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "applicationId"
in: "path"
description: "Уникальный идентификатор заявки."
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
- name: "brokerId"
in: "path"
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
description: "Уникальный идентификатор брокера."
requestBody:
content:
application/json:
schema:
required:
- "eventType"
type: "object"
properties:
eventType:
type: "string"
description: "Тип события."
enum:
- "SIGNING"
- "RESIGNING"
example:
eventType: "SIGNING"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/employees/add/by-requisites:
post:
tags:
- "Зарплатный проект"
summary: "Добавить сотрудника по реквизитам"
description: " Метод для добавления сотрудников по реквизитам.\n\nЗапрос аси\
нхронный. Его результат можно получить через вызов метода Получить результат добавления сотрудника по реквизитам, передав в нем\
\ соответствующий correlationId
.\n\nРекомендуем вызывать мето\
д не чаще одного раза в 10 минут."
operationId: "addEmployeeRecipientsByRequisites"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
content:
application/json:
schema:
required:
- "correlationId"
- "employees"
type: "object"
properties:
correlationId:
type: "string"
description: "Идентификатор, связывающий запрос создания с запро\
сом получения ответа."
format: "uuid"
employees:
maxItems: 2000
type: "array"
description: "Список сотрудников на добавление."
items:
required:
- "bankInfo"
- "firstName"
- "lastName"
- "number"
type: "object"
properties:
number:
type: "integer"
description: "Идентификатор сотрудника на стороне клиента."
firstName:
maxLength: 100
type: "string"
description: "Имя (кириллица)."
lastName:
maxLength: 100
type: "string"
description: "Фамилия (кириллица)."
middleName:
maxLength: 100
type: "string"
description: "Отчество (кириллица)."
birthDate:
type: "string"
description: "Дата рождения."
format: "date"
passportSerial:
maxLength: 50
type: "string"
description: "Серия паспорта."
passportNumber:
maxLength: 50
type: "string"
description: "Номер паспорта."
mobileNumber:
maxLength: 50
type: "string"
description: "Номер мобильного телефона."
email:
maxLength: 100
type: "string"
description: "Электронная почта."
bankInfo:
required:
- "accountNumber"
type: "object"
properties:
bankBic:
maxLength: 50
type: "string"
description: "БИК банка. По умолчанию — Т-Банк."
accountNumber:
maxLength: 50
type: "string"
description: "Номер счета."
description: "Данные о счете."
required: true
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "correlationId"
type: "object"
properties:
correlationId:
type: "string"
description: "Идентификатор, связывающий запрос создания с зап\
росом получения ответа."
format: "uuid"
example:
correlationId: "17de62bb-e448-45b1-a670-d71cf0d60785"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/employees/add/by-requisites/result:
get:
tags:
- "Зарплатный проект"
summary: "Получить результат добавления сотрудника по реквизитам"
description: "\nМетод возвращает результат запроса для метода Добавить сотрудника по реквизитам. Ответ на запрос создания хранится\
\ в течение двух дней."
operationId: "addEmployeeRecipientsByRequisitesResult"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "correlationId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "Идентификатор, связывающий запрос создания с запросом полу\
чения ответа."
format: "uuid"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "employeesResults"
type: "object"
properties:
employeesResults:
maxItems: 2000
type: "array"
description: "Список результатов добавления сотрудников."
items:
required:
- "firstName"
- "lastName"
- "number"
- "status"
type: "object"
properties:
number:
type: "integer"
description: "Номер сотрудника, переданный клиентом при\
\ создании."
employeeId:
type: "integer"
description: "Идентификатор сотрудника. Может не прийти\
, если при создании сотрудника возникли ошибки."
firstName:
maxLength: 100
type: "string"
description: "Имя (кириллица)."
lastName:
maxLength: 100
type: "string"
description: "Фамилия (кириллица)."
middleName:
maxLength: 100
type: "string"
description: "Отчество (кириллица)."
status:
type: "string"
description: "Статус создания:\n* `QUEUED` — самозанятый\
\ стоит в очереди на создание;\n* `CREATED` — самозаня\
тый создан в выплатах;\n* `ERROR` — самозанятый не был\
\ создан в выплатах. Ошибки перечислены в параметре errors
. "
enum:
- "QUEUED"
- "CREATED"
- "ERROR"
errors:
maxItems: 100
type: "array"
description: "Список ошибок."
items:
required:
- "errorDescription"
type: "object"
properties:
fieldName:
maxLength: 400
type: "string"
description: "Название поля, в котором есть ошибка\
."
errorDescription:
maxLength: 400
type: "string"
description: "Описание ошибки."
example:
employeesResults:
- number: 123
firstName: "Иван"
lastName: "Демидов"
middleName: "Иванович"
status: "ERROR"
errors:
- fieldName: "Инн"
errorDescription: "Не указан инн"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/individual/addresses:
get:
tags:
- "T-ID. Информация о пользователе"
- "T-ID. Делегированная идентификация"
summary: "Получить адреса"
description: "Метод для получения адресов физического лица. Пользователь дол\
жен дать согласие на получение информации об адресах."
operationId: "getApiV2IndividualAddresses"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "addressType"
in: "query"
required: false
style: "form"
explode: true
schema:
type: "string"
description: "Тип адреса:\n
scope
у токена дол\
жен быть доступ вида opensme/individual/blacklist/status/get
.\n\
\ "
operationId: "getApiV1IndividualBlacklistStatus"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/ApiBlacklistResponse"
example:
isBlacklisted: false
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/individual/detail-counters:
get:
tags:
- "T-ID. Информация о пользователе"
summary: "Получить значение счетчика услуги клиента"
description: "Метод возвращает текущее значение счетчика услуги партнера для\
\ клиента."
operationId: "getApiV1IndividualDetailCounters"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
responses:
"200":
description: "Информация о счетчике"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "clientInfo"
- "counterInfo"
type: "object"
properties:
clientInfo:
required:
- "grade"
- "isFulfillConditions"
type: "object"
properties:
grade:
type: "string"
description: "Грейд клиента:\n* `NONE` — без грейда;\n* `FIRST`\
\ — первый;\n* `SECOND` — второй;\n* `THIRD` — третий;\n\
* `FOURTH` — четвертый."
enum:
- "NONE"
- "FIRST"
- "SECOND"
- "THIRD"
- "FOURTH"
isFulfillConditions:
type: "boolean"
description: "Признак выполнения клиентом условий бесплатн\
ости тарифа."
description: "Объект данных о состоянии клиента."
counterInfo:
required:
- "count"
- "isInfinity"
- "period"
type: "object"
properties:
count:
type: "number"
description: "Текущее состояние счетчика (количество досту\
пных услуг)."
isInfinity:
type: "boolean"
description: "Признак бесконечного счетчика."
period:
required:
- "repeatability"
- "validFrom"
- "validUntil"
type: "object"
properties:
validFrom:
pattern: "^(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2})$"
type: "string"
description: "Дата начала периода в формате `yyyy-mm-dd'T'HH:mm:ss`."
validUntil:
pattern: "^(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2})$"
type: "string"
description: "Дата окончания периода в формате `yyyy-mm-dd'T'HH:mm:ss`."
repeatability:
type: "string"
description: "Тип периода:\n* `MONTH` — месяц;\n* `YEAR`\
\ — год."
enum:
- "MONTH"
- "YEAR"
description: "Объект данных о состоянии счетчика услуги."
description: "Объект данных о состоянии счетчика услуги."
description: "Результат получения информации о счетчике услуги кли\
ента"
example:
clientInfo:
grade: "NONE"
isFulfillConditions: true
counterInfo:
count: 1
isInfinity: true
period:
validFrom: "2023-01-15T12:00:00"
validUntil: "2023-02-15T12:00:00"
repeatability: "MONTH"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при некорректном запросе:
value:
errorId: "1"
errorMessage: "Запрос не прошел валидацию"
errorCode: "INVALID_DATA"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии премиальной подписки у клиента:
value:
errorId: "422"
errorMessage: "У клиента нет активной премиальной подписки"
errorCode: "NO_BUNDLE"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
post:
tags:
- "T-ID. Информация о пользователе"
summary: "Изменить значение счетчика услуги клиента"
description: "Метод для получения типа операции и значения, которые должны б\
ыть применены к счетчику услуги партнера по клиенту."
operationId: "setApiV1IndividualDetailCounters"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
content:
application/json:
schema:
required:
- "count"
type: "object"
properties:
count:
type: "integer"
description: "Значение операции."
extraFields:
required:
- "description"
type: "object"
properties:
description:
maxLength: 256
type: "string"
description: "Объект дополнительной информации от партнера."
description: "Дополнительные поля."
examples:
Корректный запрос:
value:
count: 1
Корректный запрос c extraFields:
value:
count: 1
extraFields:
description: "test"
required: true
responses:
"200":
description: "Информация о счетчике"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "count"
- "isInfinity"
type: "object"
properties:
count:
type: "integer"
description: "Итоговое значение счетчика услуги."
isInfinity:
type: "boolean"
description: "Признак бесконечного счетчика."
description: "Результат получения информации о счетчике услуги кли\
ента."
examples:
Успешный ответ:
value:
count: 2
isInfinity: true
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при некорректном запросе:
value:
errorId: "1"
errorMessage: "Запрос не прошел валидацию"
errorCode: "INVALID_DATA"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии премиальной подписки у клиента:
value:
errorId: "422"
errorMessage: "У клиента нет активной премиальной подписки"
errorCode: "NO_BUNDLE"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/individual/documents/passport:
get:
tags:
- "T-ID. Информация о пользователе"
- "T-ID. Делегированная идентификация"
summary: "Получить паспортные данные"
description: "Метод для получения паспортных данных пользователя. Пользовате\
ль должен дать согласие на получение информации о паспортных данных."
operationId: "getApiV2Passport"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "idType"
in: "query"
required: false
style: "form"
explode: true
schema:
maxItems: 6
type: "array"
items:
type: "string"
description: "Тип документа:\nscope
у токен\
а должен быть доступ вида opensme/individual/foreignagent/status/get
.\n\
\ "
operationId: "getApiV1IndividualForeignagentStatus"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/ApiForeignAgentResponse"
example:
isForeignAgent: false
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/individual/identification/status:
get:
tags:
- "T-ID. Информация о пользователе"
- "T-ID. Делегированная идентификация"
summary: "Получить информацию об идентификации пользователя"
description: "Метод возвращает информацию о том, идентифицирован ли пользова\
тель.\n\n\nЧтобы использовать метод, нужен доступ — opensme/individual/identification/status/get
\
\ — Информация об идентификации пользователя
.\n "
operationId: "getApiV1IndividualIdentificationStatus"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/IdentificationStatusResponse"
example:
isIdentified: true
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/individual/pdl/status:
get:
tags:
- "T-ID. Информация о пользователе"
- "T-ID. Делегированная идентификация"
summary: "Получить признак публичного должностного лица"
description: "Метод возвращает информацию о том, является ли пользователь пу\
бличным должностным лицом.\nПользователь должен дать согласие на получение\
\ информации о признаке публичного должностного лица.\n\n\nВ поле scope
\
\ у токена должен быть доступ вида opensme/individual/pdl/status/get
.\n\
\ "
operationId: "getApiV1IndividualPdlStatus"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/ApiPDLResponse"
example:
isPublicOfficialPerson: false
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/individual/self-employed/status:
get:
tags:
- "T-ID. Информация о пользователе"
- "T-ID. Делегированная идентификация"
summary: "Получить информацию о статусе самозанятого"
description: "Метод возвращает информацию о том, является ли пользователь са\
мозанятым.\n\n\nЧтобы использовать метод, нужен доступ opensme/individual/self-employed/status/get
\
\ — Информация о статусе самозанятого
.\n "
operationId: "getApiV2IndividualSelf-employedStatus"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
responses:
"200":
description: "Статус самозанятого получен"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "isSelfEmployed"
type: "object"
properties:
isSelfEmployed:
type: "boolean"
description: "Является ли пользователь самозанятым."
example:
isSelfEmployed: true
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/ndfl-3/requests/{taxRequestId}/info/document-data:
get:
tags:
- "Декларации 3-НДФЛ"
summary: "Получить машиночитаемые данные документа"
description: "\nМетод возвращает машиночитаемые данные документа, тип которо\
го передан в параметре `documentType`\nдля заявки с идентификатором `taxRequestId`.\n\
\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/ndfl3-automation/info/document-data-get
\
\ — Декларации 3-НДФЛ — Получение машиночитаемых данных документа
.\n\
\n\nОграничение на использование метода — 10 запросов в секунду."
operationId: "getApiV1Ndfl-3RequestsTaxrequestidInfoDocument-data"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
- name: "documentType"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "Тип документа."
enum:
- "Ndfl2"
- "TaxReport"
- "ForeignIncomeStatement"
- "IisOpen"
- "IisPaymentOrder"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "documentData"
- "documentType"
type: "object"
properties:
documentType:
type: "string"
description: "Тип документа."
enum:
- "Ndfl2"
- "TaxReport"
- "ForeignIncomeStatement"
- "IisOpen"
- "IisPaymentOrder"
documentData:
description: "Машиночитаемые данные документа."
oneOf:
- required:
- "deps"
type: "object"
properties:
clientData:
required:
- "taxPayerStatus"
type: "object"
properties:
taxPayerStatus:
maxLength: 100
type: "string"
description: "Статус налогоплательщика."
description: "Данные клиента."
deps:
maxItems: 10000
type: "array"
items:
required:
- "depInfo"
- "rates"
type: "object"
properties:
depInfo:
required:
- "companyName"
- "inn"
- "kpp"
- "oktmo"
- "phone"
type: "object"
properties:
oktmo:
pattern: "\\d{8}|\\d{11}|0"
type: "string"
description: "Код по ОКТМО."
phone:
maxLength: 50
type: "string"
description: "Телефон."
inn:
pattern: "^(\\d{10})$"
type: "string"
description: "ИНН."
kpp:
pattern: "^(\\d{9})$"
type: "string"
description: "КПП."
companyName:
maxLength: 1000
type: "string"
description: "Наименование."
description: "Филиал (налоговый агент), за который\
\ подаются сведения."
rates:
type: "array"
description: "Деление всех доходов по ставкам в ра\
зрезе филиала."
items:
required:
- "incomes"
- "rate"
- "totalIncomeTax"
properties:
rate:
type: "integer"
description: "Налоговая ставка по доходу."
incomes:
type: "array"
description: "Доходы, разделенные по месяцам\
\ и кодам дохода."
items:
required:
- "incomeCode"
- "incomeSum"
- "month"
type: "object"
properties:
month:
type: "integer"
description: "Месяц."
incomeCode:
type: "string"
description: "Код дохода."
incomeSum:
type: "number"
description: "Сумма дохода."
recs:
type: "array"
description: "Вычеты, в рамках месяца\
\ и кода дохода"
items:
required:
- "recCode"
- "recSum"
type: "object"
properties:
recCode:
type: "string"
description: "Код вычета"
recSum:
type: "number"
description: "Сумма вычета"
standardRecs:
type: "array"
items:
required:
- "recCode"
- "recSum"
type: "object"
properties:
recCode:
maxLength: 100
type: "string"
description: "Код вычета."
recSum:
type: "number"
description: "Сумма вычета."
description: "Стандартные, социальные и им\
ущественные налоговые вычеты."
totalIncomeTax:
required:
- "incomeTotalSum"
- "prepaymentFixedSum"
- "taxBase"
- "taxSumCalc"
- "taxSumNotWithheld"
- "taxSumOverWithheld"
- "taxSumTransfer"
- "taxSumWithheld"
type: "object"
properties:
incomeTotalSum:
type: "number"
description: "Общая сумма дохода."
taxBase:
type: "number"
description: "Налоговая база."
taxSumCalc:
type: "number"
description: "Сумма налога исчисленная."
prepaymentFixedSum:
type: "number"
description: "Сумма фиксированных авансо\
вых платежей."
taxSumWithheld:
type: "number"
description: "Сумма налога удержанная."
taxSumTransfer:
type: "number"
description: "Сумма налога перечисленная\
."
taxSumOverWithheld:
type: "number"
description: "Сумма налога, излишне удер\
жанная налоговым агентом."
taxSumNotWithheld:
type: "number"
description: "Сумма налога, не удержанна\
я агентом."
description: "Общие суммы дохода и налога."
- required:
- "finalCalcs"
type: "object"
properties:
finalCalcs:
type: "array"
items:
required:
- "couponBase"
- "couponBaseExcess"
- "couponDebt"
- "couponExcessDebt"
- "couponExcessTaxRate"
- "couponTax"
- "couponTaxExcess"
- "couponTaxRate"
- "couponTaxWithheld"
- "couponTaxWithheldExcess"
- "dividendBase"
- "dividendDebt"
- "dividendTax"
- "dividendTaxRate"
- "dividendTaxWithheld"
- "exrepoBase"
- "exrepoDebt"
- "exrepoTax"
- "exrepoTaxRate"
- "exrepoTaxWithheld"
- "finresSellNocb"
- "finresSellOcb"
- "pecuniaryLoss"
- "repoBaseNocb"
- "repoBaseOcb"
- "saldoSellNocb"
- "saldoSellOcb"
- "tax"
- "taxDebt"
- "taxRate"
- "taxWithheld"
- "totalBase"
- "totalCalculateTax"
- "totalTaxDebt"
- "totalTaxIn"
- "totalTaxOut"
- "totalWithheldTax"
- "year"
type: "object"
properties:
year:
type: "integer"
finresSellOcb:
type: "number"
repoBaseOcb:
type: "number"
saldoSellOcb:
type: "number"
finresSellNocb:
type: "number"
repoBaseNocb:
type: "number"
saldoSellNocb:
type: "number"
totalBase:
type: "number"
taxRate:
type: "integer"
tax:
type: "number"
taxWithheld:
type: "number"
taxDebt:
type: "number"
pecuniaryLoss:
type: "number"
dividendBase:
type: "number"
dividendTaxRate:
type: "integer"
dividendTax:
type: "number"
dividendTaxWithheld:
type: "number"
dividendDebt:
type: "number"
couponBaseExcess:
type: "number"
couponExcessTaxRate:
type: "integer"
couponTaxExcess:
type: "number"
couponTaxWithheldExcess:
type: "number"
couponExcessDebt:
type: "number"
couponBase:
type: "number"
couponTaxRate:
type: "integer"
couponTax:
type: "number"
couponTaxWithheld:
type: "number"
couponDebt:
type: "number"
exrepoBase:
type: "number"
exrepoTaxRate:
type: "integer"
exrepoTax:
type: "number"
exrepoTaxWithheld:
type: "number"
exrepoDebt:
type: "number"
totalCalculateTax:
type: "number"
totalWithheldTax:
type: "number"
totalTaxOut:
type: "number"
totalTaxIn:
type: "number"
totalTaxDebt:
type: "number"
- required:
- "incomes"
type: "object"
properties:
incomes:
type: "array"
items:
required:
- "currency"
- "isin"
- "issuerCountry"
- "paymentDate"
- "securityName"
- "taxWithheld"
- "totalPaymentBeforeTax"
- "type"
type: "object"
properties:
paymentDate:
type: "string"
format: "date"
type:
type: "integer"
isin:
type: "string"
issuerCountry:
type: "string"
securityName:
type: "string"
description: "Краткое наименование ценной бумаги."
totalPaymentBeforeTax:
type: "number"
taxWithheld:
type: "number"
currency:
type: "string"
- required:
- "agreements"
type: "object"
properties:
agreements:
type: "array"
description: "Список ИИС."
items:
required:
- "accounts"
- "agreementNumber"
- "openedDate"
type: "object"
properties:
openedDate:
type: "string"
description: "Дата открытия."
format: "date"
agreementNumber:
type: "string"
description: "Номер счета."
closedDate:
type: "string"
description: "Дата закрытия."
accounts:
type: "array"
items:
required:
- "accountNumber"
- "currency"
type: "object"
properties:
accountNumber:
type: "string"
currency:
type: "string"
- required:
- "agreementDate"
- "agreementNumber"
- "date"
- "debitDate"
- "receiptDate"
- "recipient"
- "value"
type: "object"
properties:
date:
type: "string"
format: "date"
receiptDate:
type: "string"
format: "date"
debitDate:
type: "string"
format: "date"
value:
type: "number"
recipient:
required:
- "account"
- "bankAccount"
- "bankName"
- "bik"
- "inn"
- "kpp"
- "name"
type: "object"
properties:
name:
type: "string"
inn:
pattern: "^(\\d{10})$"
type: "string"
description: "ИНН."
kpp:
pattern: "^(\\d{9})$"
type: "string"
description: "КПП."
account:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета. ВАЖНО: Для бюд\
жетных платежей с 01.01.2021 в данном поле нужно у\
казывать новые номера казначейских счетов."
bankName:
maxLength: 255
minLength: 1
type: "string"
description: "Наименование банка получателя. \\n\\nС\
\ 1 января 2021 года при заполнении платежей на пе\
речисление налогов в этом поле после названия банк\
а нужно указывать название счета казначейства чере\
з знак //
."
bik:
pattern: "\\d{9}"
type: "string"
description: "БИК банка получателя. \\n\\nС 1 января\
\ 2021 года при перечислении налоговых платежей ну\
жно указывать новые значения БИК банков получателя\
. \\n\\nПодробнее о полях платежного поручения"
bankAccount:
pattern: "\\d{20}"
type: "string"
description: "Корреспондентский счет банка получател\
я. \\n\\nС 1 января 2021 года при уплате налогов у\
казывается номер счета банка получателя, входящий\
\ в состав единого казначейского счета (ЕКС). Рань\
ше это поле заполнялось нулями. "
agreementNumber:
type: "string"
agreementDate:
type: "string"
format: "date"
example:
documentType: "Ndfl2"
documentData:
clientData:
taxPayerStatus: "1"
deps:
- depInfo:
oktmo: "45344000"
phone: "(495)6481000"
inn: "7710140679"
kpp: "771301001"
companyName: "АО «ТБанк»"
rates:
- rate: 13
incomes:
- month: 8
incomeCode: "1530"
incomeSum: 207597.72
recs:
- recCode: "201"
recSum: 2500.8
totalIncomeTax:
incomeTotalSum: 79702.94
taxBase: 3016.06
taxSumCalc: 1494
prepaymentFixedSum: 0
taxSumWithheld: 1494
taxSumTransfer: 1494
taxSumOverWithheld: 0
taxSumNotWithheld: 0
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте п\
озже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/nominal-accounts/deals/{dealId}:
delete:
tags:
- "Управление сделками"
summary: "Удалить сделку"
description: "\nПозволяет удалить сделку, которая находится в статусе `DRAFT`.\n\
\n\nОграничение на использование метода — 10 запросов в секунду.\n\n\nЧтоб\
ы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "deleteApiV1Nominal-accountsDealsDealid"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/deals/{dealId}/is-valid:
get:
tags:
- "Управление сделками"
summary: "Получить статус проверки на возможность проведения платежей по сде\
лке"
description: "\nМетод для проверки возможности совершения платежа в сделке.\
\ Сверяет сумму депонирования с суммой в настройках и проверяет, хватает л\
и указанных средств на виртуальных счетах депонентов."
operationId: "getApiV1Nominal-accountsDealsDealidIs-valid"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "isValid"
type: "object"
properties:
isValid:
type: "boolean"
description: "Флаг возможности проведения платежей по сделке."
reasons:
type: "array"
description: "Описание причин невозможности проведения платеже\
й по сделке."
items:
type: "object"
properties:
code:
type: "string"
description: "Код ошибки."
description:
type: "string"
description: "Описание ошибки."
details:
type: "object"
additionalProperties:
type: "string"
description: "Дополнительная информация об ошибке."
example:
isValid: false
reasons:
- code: "NO_STEPS_IN_DEAL"
description: "Deal contains no steps."
details:
stepId: "306f557f-2b3c-460d-8429-1d61c59836df"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных."
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "retw6789"
errorMessage: "Deaal not found"
errorCode: "NOT_FOUND"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}:
put:
tags:
- "Управление этапами сделок"
summary: "Обновить этап"
description: "\nПозволяет внести изменения в этап сделки. Только для сделок\
\ в статусе `DRAFT`.\n\n\nОграничение на использование метода — 10 запросо\
в в секунду.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "putApiV1Nominal-accountsDealsDealidStepsStepid"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "stepId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/StepRequest"
example:
description: "Описание этапа сделки"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/StepResponse"
example:
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
stepNumber: 1
description: "Описание этапа сделки"
status: "NEW"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
delete:
tags:
- "Управление этапами сделок"
summary: "Удалить этап"
description: "\nПозволяет удалить этап. Только для сделок в статусе `DRAFT`.\n\
\n\nОграничение на использование метода — 10 запросов в секунду.\n\n\nЧтоб\
ы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "deleteApiV1Nominal-accountsDealsDealidStepsStepid"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "stepId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/payments/{paymentId}:
get:
tags:
- "Биллинг"
summary: "Получить платеж по ID платежа"
description: "Метод для получения платежа по ID платежа."
operationId: "getApiV1Nominal-accountsPaymentsPaymentid"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "paymentId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор платежа."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
oneOf:
- required:
- "accountNumber"
- "amount"
- "bankDetails"
- "beneficiaryId"
- "paymentId"
- "purpose"
- "status"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип платежа:\n* `REGULAR` — обычный;\n* `TAX`\
\ — налоговый."
enum:
- "REGULAR"
- "TAX"
paymentId:
type: "string"
description: "Идентификатор платежа."
format: "uuid"
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер номинального счета."
bankDetails:
description: "Банковские реквизиты."
oneOf:
- required:
- "cardId"
- "terminalKey"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип банковских реквизитов:\n* `PAYMENT_DETAILS`\
\ — по реквизитам счета;\n* `CARD` — на карту;\n* `SBP`\
\ — через СБП."
enum:
- "PAYMENT_DETAILS"
- "CARD"
- "SBP"
cardId:
maxLength: 256
minLength: 1
type: "string"
description: "Идентификатор карты в системе банка."
terminalKey:
maxLength: 256
minLength: 1
type: "string"
description: "Ключ терминала."
description: "Банковские реквизиты."
- required:
- "accountNumber"
- "bankName"
- "bik"
- "corrAccountNumber"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип банковских реквизитов:\n* `PAYMENT_DETAILS`\
\ — по реквизитам счета;\n* `CARD` — на карту;\n* `SBP`\
\ — через СБП."
enum:
- "PAYMENT_DETAILS"
- "CARD"
- "SBP"
bik:
pattern: "\\d{9}"
type: "string"
description: "БИК банка получателя. С 01.01.2021 г. пр\
и перечислении налоговых платежей в этом поле нужно\
\ указывать новые значения БИК банков получателя. [П\
одробнее](https://spmag.ru/articles/polya-platezhnogo-porucheniya-v-2021-godu-obrazec)"
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "КПП получателя."
inn:
pattern: "^(\\d{12}|\\d{10}|0{1})$"
type: "string"
description: "ИНН. Укажите 0, чтобы не заполнять."
name:
maxLength: 160
type: "string"
description: "Наименование получателя."
bankName:
maxLength: 255
minLength: 1
type: "string"
description: "Наименование банка получателя. С 01.01.2021\
\ г. при заполнении платежек на перечисление налогов\
\ в этом поле нужно указывать название счета казначе\
йства после названия банка через знак «//»."
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета. С 01.01.2021 г.\
\ для бюджетных платежей в этом поле нужно указывать\
\ новые номера казначейских счетов."
corrAccountNumber:
pattern: "\\d{20}"
type: "string"
description: "Корреспондентский счет банка получателя\
. С 01.01.2021 г. при уплате налогов указывается ном\
ер счета банка получателя, который входит в состав е\
диного казначейского счета (ЕКС). Раньше это поле за\
полнялось нулями."
description: "Банковские реквизиты."
- required:
- "bankId"
- "phoneNumber"
- "terminalKey"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип банковских реквизитов:\n* `PAYMENT_DETAILS`\
\ — по реквизитам счета;\n* `CARD` — на карту;\n* `SBP`\
\ — через СБП."
enum:
- "PAYMENT_DETAILS"
- "CARD"
- "SBP"
phoneNumber:
pattern: "(\\+7)([0-9]){10}"
type: "string"
description: "Номер мобильного телефона."
bankId:
pattern: "\\d{12}"
type: "string"
description: "Идентификатор банка в системе быстрых пл\
атежей."
terminalKey:
maxLength: 256
minLength: 1
type: "string"
description: "Ключ терминала."
description: "Банковские реквизиты."
dealId:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
stepId:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
recipientId:
type: "string"
description: "Идентификатор реципиента."
format: "uuid"
amount:
type: "number"
description: "Сумма платежа."
status:
type: "string"
description: "Статус платежа. \n\n![payment-statuses](https://business.t-static.ru/static/images/opensme/nominal-accounts/payment-statuses.svg)\n\
* `PENDING` — ожидает обработки;\n* `IN_PROGRESS` — в проц\
ессе;\n* `FAILED` — неуспешен;\n* `CANCELLED` — отменен;\n\
* `SUCCEEDED` — успешно завершен."
enum:
- "PENDING"
- "IN_PROGRESS"
- "FAILED"
- "CANCELLED"
- "SUCCEEDED"
errorMessage:
type: "string"
description: "Описание ошибки при неуспешном платеже."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
operationId:
type: "string"
description: "Уникальный ID операции."
format: "uuid"
- required:
- "accountNumber"
- "amount"
- "bankDetails"
- "beneficiaryId"
- "paymentId"
- "purpose"
- "status"
- "tax"
- "type"
- "uin"
type: "object"
properties:
type:
type: "string"
description: "Тип платежа:\n* `REGULAR` — обычный;\n* `TAX`\
\ — налоговый."
enum:
- "REGULAR"
- "TAX"
paymentId:
type: "string"
description: "Идентификатор платежа."
format: "uuid"
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер номинального счета."
bankDetails:
description: "Банковские реквизиты."
oneOf:
- required:
- "cardId"
- "terminalKey"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип банковских реквизитов:\n* `PAYMENT_DETAILS`\
\ — по реквизитам счета;\n* `CARD` — на карту;\n* `SBP`\
\ — через СБП."
enum:
- "PAYMENT_DETAILS"
- "CARD"
- "SBP"
cardId:
maxLength: 256
minLength: 1
type: "string"
description: "Идентификатор карты в системе банка."
terminalKey:
maxLength: 256
minLength: 1
type: "string"
description: "Ключ терминала."
description: "Банковские реквизиты."
- required:
- "accountNumber"
- "bankName"
- "bik"
- "corrAccountNumber"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип банковских реквизитов:\n* `PAYMENT_DETAILS`\
\ — по реквизитам счета;\n* `CARD` — на карту;\n* `SBP`\
\ — через СБП."
enum:
- "PAYMENT_DETAILS"
- "CARD"
- "SBP"
bik:
pattern: "\\d{9}"
type: "string"
description: "БИК банка получателя. С 01.01.2021 г. пр\
и перечислении налоговых платежей в этом поле нужно\
\ указывать новые значения БИК банков получателя. [П\
одробнее](https://spmag.ru/articles/polya-platezhnogo-porucheniya-v-2021-godu-obrazec)"
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "КПП получателя."
inn:
pattern: "^(\\d{12}|\\d{10}|0{1})$"
type: "string"
description: "ИНН. Укажите 0, чтобы не заполнять."
name:
maxLength: 160
type: "string"
description: "Наименование получателя."
bankName:
maxLength: 255
minLength: 1
type: "string"
description: "Наименование банка получателя. С 01.01.2021\
\ г. при заполнении платежек на перечисление налогов\
\ в этом поле нужно указывать название счета казначе\
йства после названия банка через знак «//»."
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета. С 01.01.2021 г.\
\ для бюджетных платежей в этом поле нужно указывать\
\ новые номера казначейских счетов."
corrAccountNumber:
pattern: "\\d{20}"
type: "string"
description: "Корреспондентский счет банка получателя\
. С 01.01.2021 г. при уплате налогов указывается ном\
ер счета банка получателя, который входит в состав е\
диного казначейского счета (ЕКС). Раньше это поле за\
полнялось нулями."
description: "Банковские реквизиты."
- required:
- "bankId"
- "phoneNumber"
- "terminalKey"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип банковских реквизитов:\n* `PAYMENT_DETAILS`\
\ — по реквизитам счета;\n* `CARD` — на карту;\n* `SBP`\
\ — через СБП."
enum:
- "PAYMENT_DETAILS"
- "CARD"
- "SBP"
phoneNumber:
pattern: "(\\+7)([0-9]){10}"
type: "string"
description: "Номер мобильного телефона."
bankId:
pattern: "\\d{12}"
type: "string"
description: "Идентификатор банка в системе быстрых пл\
атежей."
terminalKey:
maxLength: 256
minLength: 1
type: "string"
description: "Ключ терминала."
description: "Банковские реквизиты."
amount:
type: "number"
description: "Сумма платежа."
status:
type: "string"
description: "Статус платежа. \n\n![payment-statuses](https://business.t-static.ru/static/images/opensme/nominal-accounts/payment-statuses.svg)\n\
* `PENDING` — ожидает обработки;\n* `IN_PROGRESS` — в проц\
ессе;\n* `FAILED` — неуспешен;\n* `CANCELLED` — отменен;\n\
* `SUCCEEDED` — успешно завершен."
enum:
- "PENDING"
- "IN_PROGRESS"
- "FAILED"
- "CANCELLED"
- "SUCCEEDED"
errorMessage:
type: "string"
description: "Описание ошибки при неуспешном платеже."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
operationId:
type: "string"
description: "Уникальный ID операции."
format: "uuid"
uin:
pattern: "0|[А-Яа-яA-Za-z0-9]{4}|[А-ЯA-Z0-9]{20}|[А-ЯA-Z0-9]{25}"
type: "string"
description: "Уникальный идентификатор платежа."
tax:
required:
- "docDate"
- "docNumber"
- "evidence"
- "kbk"
- "oktmo"
- "payerStatus"
- "period"
type: "object"
properties:
payerStatus:
pattern: "\\d{2}"
type: "string"
description: "Статус составителя расчетного документа. П\
оле платежки 101.scope
у токена должен быть доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nonacceptance-debits/manage
\
\ — Управление соглашениями о безакцептных списаниях
. "
operationId: "getApiV1Nonacceptance-RuleList"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "agreementId"
in: "query"
description: "ID соглашения, в рамках которого заключены правила."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "uuid"
- name: "limit"
in: "query"
description: "Максимальное количество правил, которое нужно вывести. Значе\
ние по умолчанию — `50`."
required: false
style: "form"
explode: true
schema:
type: "integer"
format: "int32"
default: 50
- name: "offset"
in: "query"
description: "Количество правил, которые нужно пропустить. Значение по умо\
лчанию — `0`."
required: false
style: "form"
explode: true
schema:
type: "integer"
format: "int32"
default: 0
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
properties:
offset:
type: "integer"
description: "Количество правил, которое было пропущено."
format: "int32"
limit:
type: "integer"
description: "Максимальное количество правил, которое могло бы\
ть выведено."
format: "int32"
size:
type: "integer"
description: "Количество правил в ответе."
format: "int32"
total:
type: "integer"
description: "Общее количество правил."
format: "int32"
results:
maxItems: 50
type: "array"
description: "Результат."
nullable: true
items:
required:
- "amount"
- "cronExpr"
- "id"
- "type"
type: "object"
properties:
type:
type: "string"
description: " Тип правила:\n\n* `Recurrent` — рекуррент\
ное правило;\n\n* `Trigger` — триггерное правило."
enum:
- "Recurrent"
- "Trigger"
id:
type: "string"
description: "ID правила."
format: "uuid"
readOnly: true
amount:
type: "number"
description: "Сумма платежа."
format: "decimal"
cronExpr:
maxLength: 200
minLength: 9
type: "string"
description: "CRON-выражение регулярности платежа."
format: "string"
example:
offset: 0
limit: 50
size: 1
total: 1
results:
- id: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
type: "Recurrent"
amount: 1000.55
cronExpr: "0 12 * * *"
"400":
description: "Соглашение не найдено"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "bcadsa12"
errorCode: "NOT_FOUND"
errorMessage: "Resource not found"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
deprecated: true
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
post:
tags:
- "Правила"
summary: "Создать платежное правило"
description: " Метод для создания платежного правила.\n\nЗадать правило можн\
о двумя способами:\n* Регулярное списание по расписанию. Правило может вып\
олняться не чаще одного раза в 24 часа — например, каждый день в 12:00 мск\
.\n* Списание по событию. Когда происходит событие, соответствующее заданн\
ым параметрам, система автоматически генерирует платежное требование, кото\
рое позволит списать средства вам на счет. Например, если вам нужно списыв\
ать роялти с ваших франчайзи, мы можем автоматически списывать определенны\
й процент от всех пополнений по торговому эквайрингу и зачислять вам на сч\
ет.\n\nВ рамках одного правила доступна одна из обязательных категорий поп\
олнения и вариант списания — фиксированная сумма или процент от платежа. К\
атегории:\n* внесение наличных на счет контрагента;\n* торговый эквайринг\
;\n* интернет-эквайринг;\n* входящие переводы от контрагентов — если испол\
ьзуете эту категорию, обязательно указывайте данные компаний-инициаторов п\
латежей.\n\nЕсли денег на счете плательщика не хватает, платеж встает в ка\
ртотеку. Остаток списывается при следующих поступлениях."
operationId: "postApiV1Nonacceptance-CreateRule"
parameters:
- name: "Idempotency-Key"
in: "header"
description: "Ключ идемпотентности. [Подробнее](https://cloud.yandex.ru/docs/api-design-guide/concepts/idempotency)."
required: true
style: "simple"
explode: false
schema:
type: "string"
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
description: "Параметры платежного правила."
content:
application/json:
schema:
oneOf:
- title: "Рекуррентное правило"
required:
- "agreementId"
- "cronExpr"
- "requisites"
- "type"
type: "object"
properties:
type:
type: "string"
description: " Тип правила:\n\n* `Recurrent` — рекуррентное пр\
авило;\n\n* `Trigger` — триггерное правило."
enum:
- "Recurrent"
- "Trigger"
agreementId:
type: "string"
description: "ID соглашения."
format: "uuid"
cronExpr:
maxLength: 200
minLength: 9
type: "string"
description: "CRON-выражение регулярности платежа. Например, \"\
0 12 * * *\" — каждый день в 12:00 мск."
format: "string"
requisites:
required:
- "amount"
- "docType"
- "payerAccount"
- "payerBIC"
- "payerCorAccount"
- "payerINN"
- "payerKPP"
- "payerName"
- "purpose"
- "recipientAccount"
type: "object"
properties:
docType:
type: "string"
description: " Тип платежного документа. `PaymentRequest`\
\ — платежное требование."
enum:
- "PaymentRequest"
amount:
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа."
format: "decimal"
paymentCondition:
type: "string"
description: " Условие платежа:\n\n* `WithAcceptance` — с\
\ акцептом;\n* `WithoutAcceptance` — без акцепта."
enum:
- "WithAcceptance"
- "WithoutAcceptance"
acceptTerm:
maximum: 9
minimum: 5
type: "integer"
description: "Количество дней для акцепта."
format: "int32"
nullable: true
docDispatchDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2})$"
type: "string"
description: " Дата вручения плательщику предусмотренных д\
оговором документов в формате `YYYY-MM-DD`."
nullable: true
payerAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Номер счета плательщика."
payerINN:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН плательщика."
payerKPP:
pattern: "^(\\d{9}|0)$"
type: "string"
description: " КПП плательщика.\n\nЕсли КПП нет, передайте\
\ `0`."
payerName:
maxLength: 160
minLength: 1
type: "string"
description: "Наименование плательщика."
payerBIC:
pattern: "^(\\d{9})$"
type: "string"
description: "БИК плательщика."
payerCorAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Корреспондентский счет плательщика."
recipientAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Счет получателя."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
format: "string"
- title: "Триггерное правило"
required:
- "agreementId"
- "amount"
- "replenishmentFilter"
- "requisites"
- "type"
type: "object"
properties:
type:
type: "string"
description: " Тип правила:\n\n* `Recurrent` — рекуррентное пр\
авило;\n\n* `Trigger` — триггерное правило."
enum:
- "Recurrent"
- "Trigger"
agreementId:
type: "string"
description: "ID соглашения."
format: "uuid"
amount:
type: "object"
properties:
fixed:
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа в виде фиксированного значения\
."
format: "decimal"
nullable: true
percent:
multipleOf: 0.00010
maximum: 1
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа в виде процента от суммы попол\
нения. Значение 0.0001 соответствует 0.01%, а 1.0000 - 100%."
format: "decimal"
nullable: true
description: "Сумма платежа.\n\nВозможно представление в одном\
\ из двух видов: фиксированный или процентный. Заполнять нео\
бходимо только одно из полей: либо `fixed`, либо `percent`."
replenishmentFilter:
required:
- "category"
type: "object"
properties:
payers:
maxItems: 50
type: "array"
description: "Данные компаний-инициаторов пополнений.\n\nП\
ри заполнении данного поля списание будет происходить, т\
олько когда инициатором пополнения является одна из комп\
аний, указанных в поле.\n\nЗаполнение поля обязательно д\
ля правил с `category` = `CounterpartyIncome`. В иных сл\
учаях поле не заполняется."
nullable: true
items:
required:
- "inn"
- "kpp"
type: "object"
properties:
inn:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН."
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "КПП."
description: "Компания-инициатор операции пополнения"
category:
type: "string"
description: "Категория операций пополнения, по которым бу\
дут производиться списания.\n\n`CashIn` - операции внесе\
ния наличных на счет контрагента.\n\n`MerchantAcq` - опе\
рации, проведенные по торговому эквайрингу.\n\n`InternetAcq`\
\ - операции, проведенные по интернет-эквайрингу.\n\n`CounterpartyIncome`\
\ - операции по входящим переводам от контрагентов. "
enum:
- "CashIn"
- "MerchantAcq"
- "InternetAcq"
- "CounterpartyIncome"
description: "Условия, при которых должны проводиться списания\
\ по операциям пополнения.\n\nРаботает по принципу «и»: если\
\ заполнены несколько полей, то списания будут происходить,\
\ только если для каждого этих полей будет выполнено указанн\
ое условие.\n\nНапример, если в `category` указано `CounterpartyIncome`\
\ и в `payers` указана компания с ИНН = 7777777777, списание\
\ будет происходить только при входящем переводе от компании\
\ с ИНН = 7777777777."
requisites:
required:
- "docType"
- "payerAccount"
- "payerBIC"
- "payerCorAccount"
- "payerINN"
- "payerKPP"
- "payerName"
- "purpose"
- "recipientAccount"
type: "object"
properties:
docType:
type: "string"
description: " Тип платежного документа. `PaymentRequest`\
\ — платежное требование."
enum:
- "PaymentRequest"
paymentCondition:
type: "string"
description: " Условие платежа:\n\n* `WithAcceptance` — с\
\ акцептом;\n* `WithoutAcceptance` — без акцепта."
enum:
- "WithAcceptance"
- "WithoutAcceptance"
acceptTerm:
maximum: 9
minimum: 5
type: "integer"
description: "Количество дней для акцепта."
format: "int32"
nullable: true
docDispatchDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2})$"
type: "string"
description: " Дата вручения плательщику предусмотренных д\
оговором документов в формате `YYYY-MM-DD`."
nullable: true
payerAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Номер счета плательщика."
payerINN:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН плательщика."
payerKPP:
pattern: "^(\\d{9}|0)$"
type: "string"
description: " КПП плательщика.\n\nЕсли КПП нет, передайте\
\ `0`."
payerName:
maxLength: 160
minLength: 1
type: "string"
description: "Наименование плательщика."
payerBIC:
pattern: "^(\\d{9})$"
type: "string"
description: "БИК плательщика."
payerCorAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Корреспондентский счет плательщика."
recipientAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Счет получателя."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
format: "string"
examples:
Рекуррентное правило:
value:
type: "Recurrent"
cronExpr: "0 12 * * *"
agreementId: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
requisites:
amount: 1000.55
docType: "PaymentRequest"
payerAccount: "12345678900987654321"
payerINN: "1234567890"
payerKPP: "123456789"
payerBIC: "044525974"
payerCorAccount: "30101810145250000974"
payerName: "ИП Петров Петр Иванович"
recipientAccount: "09876543211234567890"
purpose: "Платеж по соглашению №236383626412/2022-08-05/25.421"
paymentCondition: "WithoutAcceptance"
acceptTerm: 6
Триггерное правило (процентная сумма, внесение наличных):
value:
type: "Trigger"
agreementId: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
amount:
percent: 0.0815
replenishmentFilter:
category: "CashIn"
requisites:
docType: "PaymentRequest"
payerAccount: "12345678900987654321"
payerINN: "1234567890"
payerKPP: "123456789"
payerBIC: "044525974"
payerCorAccount: "30101810145250000974"
payerName: "ИП Петров Петр Иванович"
recipientAccount: "09876543211234567890"
purpose: "Платеж по соглашению №236383626412/2022-08-05/25.421"
paymentCondition: "WithoutAcceptance"
acceptTerm: 6
Триггерное правило (фиксированная сумма, переводы от контрагентов):
value:
type: "Trigger"
agreementId: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
amount:
fixed: 1000.55
replenishmentFilter:
payers:
- inn: "7777777777"
kpp: "987654321"
- inn: "8888888888"
kpp: "0"
category: "CounterpartyIncome"
requisites:
docType: "PaymentRequest"
payerAccount: "12345678900987654321"
payerINN: "1234567890"
payerKPP: "123456789"
payerBIC: "044525974"
payerCorAccount: "30101810145250000974"
payerName: "ИП Петров Петр Иванович"
recipientAccount: "09876543211234567890"
purpose: "Платеж по соглашению №236383626412/2022-08-05/25.421"
paymentCondition: "WithoutAcceptance"
acceptTerm: 6
required: true
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "ruleId"
type: "object"
properties:
ruleId:
type: "string"
description: "ID правила."
format: "uuid"
example:
ruleId: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Соглашение не найдено:
value:
errorId: "bcadsa12"
errorCode: "NOT_FOUND"
errorMessage: "Resource not found"
Некорректно заполнено поле:
value:
errorId: "bcadsa12"
errorCode: "VALIDATION_ERROR"
errorMessage: "acceptTerm: value must be greater than 0"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Соглашение имеет невалидный статус"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "bcadsa12"
errorCode: "INVALID_STATE"
errorMessage: "Invalid state"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/rules/{ruleId}:
get:
tags:
- "Правила"
summary: "Получить детали платежного правила"
description: "Метод для получения детальной информации о платежном правиле п\
о ID."
operationId: "getApiV1Nonacceptance-RuleDetails"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "ruleId"
in: "path"
description: "ID платежного правила."
required: true
style: "simple"
explode: false
schema:
type: "string"
format: "uuid"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
oneOf:
- title: "Рекуррентное правило"
required:
- "agreementId"
- "cronExpr"
- "id"
- "requisites"
- "type"
type: "object"
properties:
type:
type: "string"
description: " Тип правила:\n\n* `Recurrent` — рекуррентное\
\ правило;\n\n* `Trigger` — триггерное правило."
enum:
- "Recurrent"
- "Trigger"
id:
type: "string"
description: "ID правила."
format: "uuid"
agreementId:
type: "string"
description: "ID соглашения."
format: "uuid"
requisites:
required:
- "amount"
- "docType"
- "payerAccount"
- "payerBIC"
- "payerCorAccount"
- "payerINN"
- "payerKPP"
- "payerName"
- "purpose"
- "recipientAccount"
type: "object"
properties:
docType:
type: "string"
description: " Тип платежного документа. `PaymentRequest`\
\ — платежное требование."
enum:
- "PaymentRequest"
amount:
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа."
format: "decimal"
paymentCondition:
type: "string"
description: " Условие платежа:\n\n* `WithAcceptance` —\
\ с акцептом;\n* `WithoutAcceptance` — без акцепта."
enum:
- "WithAcceptance"
- "WithoutAcceptance"
acceptTerm:
maximum: 9
minimum: 5
type: "integer"
description: "Количество дней для акцепта."
format: "int32"
nullable: true
docDispatchDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2})$"
type: "string"
description: " Дата вручения плательщику предусмотренных\
\ договором документов в формате `YYYY-MM-DD`."
nullable: true
payerAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Номер счета плательщика."
payerINN:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН плательщика."
payerKPP:
pattern: "^(\\d{9}|0)$"
type: "string"
description: " КПП плательщика.\n\nЕсли КПП нет, передай\
те `0`."
payerName:
maxLength: 160
minLength: 1
type: "string"
description: "Наименование плательщика."
payerBIC:
pattern: "^(\\d{9})$"
type: "string"
description: "БИК плательщика."
payerCorAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Корреспондентский счет плательщика."
recipientAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Счет получателя."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
format: "string"
cronExpr:
maxLength: 200
minLength: 9
type: "string"
description: "CRON-выражение регулярности платежа. Например\
, «0 12 * * *» — каждый день в 12:00 мск."
format: "string"
- title: "Триггерное правило"
required:
- "agreementId"
- "amount"
- "id"
- "replenishmentFilter"
- "requisites"
- "type"
type: "object"
properties:
type:
type: "string"
description: " Тип правила:\n\n* `Recurrent` — рекуррентное\
\ правило;\n\n* `Trigger` — триггерное правило."
enum:
- "Recurrent"
- "Trigger"
id:
type: "string"
description: "ID правила."
format: "uuid"
agreementId:
type: "string"
description: "ID соглашения."
format: "uuid"
amount:
type: "object"
properties:
fixed:
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа в виде фиксированного значен\
ия."
format: "decimal"
nullable: true
percent:
multipleOf: 0.00010
maximum: 1
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа в виде процента от суммы поп\
олнения. Значение 0.0001 соответствует 0.01%, а 1.0000\
\ - 100%."
format: "decimal"
nullable: true
description: "Сумма платежа.\n\nВозможно представление в одн\
ом из двух видов: фиксированный или процентный. Заполнять\
\ необходимо только одно из полей: либо `fixed`, либо `percent`."
replenishmentFilter:
required:
- "category"
type: "object"
properties:
payers:
maxItems: 50
type: "array"
description: "Данные компаний-инициаторов пополнений.\n\n\
При заполнении данного поля списание будет происходить\
, только когда инициатором пополнения является одна из\
\ компаний, указанных в поле.\n\nЗаполнение поля обяза\
тельно для правил с `category` = `CounterpartyIncome`.\
\ В иных случаях поле не заполняется."
nullable: true
items:
required:
- "inn"
- "kpp"
type: "object"
properties:
inn:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН."
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "КПП."
description: "Компания-инициатор операции пополнения"
category:
type: "string"
description: "Категория операций пополнения, по которым\
\ будут производиться списания.\n\n`CashIn` - операции\
\ внесения наличных на счет контрагента.\n\n`MerchantAcq`\
\ - операции, проведенные по торговому эквайрингу.\n\n\
`InternetAcq` - операции, проведенные по интернет-эква\
йрингу.\n\n`CounterpartyIncome` - операции по входящим\
\ переводам от контрагентов. "
enum:
- "CashIn"
- "MerchantAcq"
- "InternetAcq"
- "CounterpartyIncome"
description: "Условия, при которых должны проводиться списан\
ия по операциям пополнения.\n\nРаботает по принципу «и»: е\
сли заполнены несколько полей, то списания будут происходи\
ть, только если для каждого этих полей будет выполнено ука\
занное условие.\n\nНапример, если в `category` указано `CounterpartyIncome`\
\ и в `payers` указана компания с ИНН = 7777777777, списан\
ие будет происходить только при входящем переводе от компа\
нии с ИНН = 7777777777."
requisites:
required:
- "docType"
- "payerAccount"
- "payerBIC"
- "payerCorAccount"
- "payerINN"
- "payerKPP"
- "payerName"
- "purpose"
- "recipientAccount"
type: "object"
properties:
docType:
type: "string"
description: " Тип платежного документа. `PaymentRequest`\
\ — платежное требование."
enum:
- "PaymentRequest"
paymentCondition:
type: "string"
description: " Условие платежа:\n\n* `WithAcceptance` —\
\ с акцептом;\n* `WithoutAcceptance` — без акцепта."
enum:
- "WithAcceptance"
- "WithoutAcceptance"
acceptTerm:
maximum: 9
minimum: 5
type: "integer"
description: "Количество дней для акцепта."
format: "int32"
nullable: true
docDispatchDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2})$"
type: "string"
description: " Дата вручения плательщику предусмотренных\
\ договором документов в формате `YYYY-MM-DD`."
nullable: true
payerAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Номер счета плательщика."
payerINN:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН плательщика."
payerKPP:
pattern: "^(\\d{9}|0)$"
type: "string"
description: " КПП плательщика.\n\nЕсли КПП нет, передай\
те `0`."
payerName:
maxLength: 160
minLength: 1
type: "string"
description: "Наименование плательщика."
payerBIC:
pattern: "^(\\d{9})$"
type: "string"
description: "БИК плательщика."
payerCorAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Корреспондентский счет плательщика."
recipientAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Счет получателя."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
format: "string"
examples:
Рекуррентное правило:
value:
id: "c31e2fc0-3a2b-4482-9025-6ec36ed857bc"
agreementId: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
type: "Recurrent"
cronExpr: "0 12 * * *"
requisites:
amount: 1000.55
docType: "PaymentRequest"
payerAccount: "12345678900987654321"
payerINN: "1234567890"
payerKPP: "123456789"
payerBIC: "044525974"
payerCorAccount: "30101810145250000974"
payerName: "ИП Петров Петр Иванович"
recipientAccount: "09876543211234567890"
purpose: "Платеж по соглашению №236383626412/2022-08-05/25.421"
paymentCondition: "WithoutAcceptance"
acceptTerm: 6
Триггерное правило:
value:
id: "c31e2fc0-3a2b-4482-9025-6ec36ed857bc"
agreementId: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
type: "Trigger"
amount:
fixed: null
percent: 0.0815
replenishmentFilter:
payers:
- inn: "7777777777"
kpp: "987654321"
- inn: "8888888888"
kpp: "0"
category: "CounterpartyIncome"
requisites:
docType: "PaymentRequest"
payerAccount: "12345678900987654321"
payerINN: "1234567890"
payerKPP: "123456789"
payerBIC: "044525974"
payerCorAccount: "30101810145250000974"
payerName: "ИП Петров Петр Иванович"
recipientAccount: "09876543211234567890"
purpose: "Платеж по соглашению №236383626412/2022-08-05/25.421"
paymentCondition: "WithoutAcceptance"
acceptTerm: 6
"400":
description: "Правило не найдено"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "bcadsa12"
errorCode: "NOT_FOUND"
errorMessage: "Resource not found"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
put:
tags:
- "Правила"
summary: "Изменить платежное правило"
description: " Метод для обновления конфигурации платежного правила.\n\nВажн\
ые детали работы с рекуррентными правилами:\n\nПосле изменения правила сле\
дующее списание выполняется не раньше, чем через 24 часа после последнего\
\ платежа. Например, списание настроено раз в месяц на 14 число в 10:00. С\
ейчас 15 декабря, последнее списание было 14 декабря. Рассмотрим несколько\
\ случаев:\n* Вы хотите изменить расписание на списание раз в месяц 16 чис\
ла. Тогда следующее списание произойдет 16 декабря — между предыдущим спис\
анием 14 числа и новым списанием 16 пройдет больше 24 часов.\n* Вы хотите\
\ изменить расписание на списание раз в месяц 15 числа в 15:00. Тогда след\
ующее списание произойдет 15 декабря в 15:00 — между предыдущим списанием\
\ 14 числа в 10:00 и новым списанием 15 числа в 15:00 пройдет больше 24 ча\
сов.\n* Вы хотите изменить расписание на списание раз в месяц 15-го числа\
\ в 9:00. Тогда следующее списание произойдет 15 января в 9:00 — между пре\
дыдущим списанием 14 декабря в 10:00 и новым списанием 15 декабря в 9:00 п\
ройдет меньше 24 часов, поэтому будет взята следующая по расписанию дата —\
\ 15 января."
operationId: "putApiV1Nonacceptance-UpdateRule"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "ruleId"
in: "path"
description: "ID платежного правила."
required: true
style: "simple"
explode: false
schema:
type: "string"
format: "uuid"
requestBody:
description: "Параметры платежного правила."
content:
application/json:
schema:
oneOf:
- title: "Рекуррентное правило"
required:
- "cronExpr"
- "requisites"
- "type"
type: "object"
properties:
type:
type: "string"
description: " Тип правила:\n\n* `Recurrent` — рекуррентное пр\
авило;\n\n* `Trigger` — триггерное правило."
enum:
- "Recurrent"
- "Trigger"
requisites:
required:
- "amount"
- "docType"
- "payerAccount"
- "payerBIC"
- "payerCorAccount"
- "payerINN"
- "payerKPP"
- "payerName"
- "purpose"
- "recipientAccount"
type: "object"
properties:
docType:
type: "string"
description: " Тип платежного документа. `PaymentRequest`\
\ — платежное требование."
enum:
- "PaymentRequest"
amount:
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа."
format: "decimal"
paymentCondition:
type: "string"
description: " Условие платежа:\n\n* `WithAcceptance` — с\
\ акцептом;\n* `WithoutAcceptance` — без акцепта."
enum:
- "WithAcceptance"
- "WithoutAcceptance"
acceptTerm:
maximum: 9
minimum: 5
type: "integer"
description: "Количество дней для акцепта."
format: "int32"
nullable: true
docDispatchDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2})$"
type: "string"
description: " Дата вручения плательщику предусмотренных д\
оговором документов в формате `YYYY-MM-DD`."
nullable: true
payerAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Номер счета плательщика."
payerINN:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН плательщика."
payerKPP:
pattern: "^(\\d{9}|0)$"
type: "string"
description: " КПП плательщика.\n\nЕсли КПП нет, передайте\
\ `0`."
payerName:
maxLength: 160
minLength: 1
type: "string"
description: "Наименование плательщика."
payerBIC:
pattern: "^(\\d{9})$"
type: "string"
description: "БИК плательщика."
payerCorAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Корреспондентский счет плательщика."
recipientAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Счет получателя."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
format: "string"
cronExpr:
maxLength: 200
minLength: 9
type: "string"
description: "CRON-выражение регулярности платежа. Например, «\
0 12 * * *» — каждый день в 12:00 мск."
format: "string"
- title: "Триггерное правило"
required:
- "amount"
- "replenishmentFilter"
- "requisites"
- "type"
type: "object"
properties:
type:
type: "string"
description: " Тип правила:\n\n* `Recurrent` — рекуррентное пр\
авило;\n\n* `Trigger` — триггерное правило."
enum:
- "Recurrent"
- "Trigger"
amount:
type: "object"
properties:
fixed:
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа в виде фиксированного значения\
."
format: "decimal"
nullable: true
percent:
multipleOf: 0.00010
maximum: 1
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа в виде процента от суммы попол\
нения. Значение 0.0001 соответствует 0.01%, а 1.0000 - 100%."
format: "decimal"
nullable: true
description: "Сумма платежа.\n\nВозможно представление в одном\
\ из двух видов: фиксированный или процентный. Заполнять нео\
бходимо только одно из полей: либо `fixed`, либо `percent`."
replenishmentFilter:
required:
- "category"
type: "object"
properties:
payers:
maxItems: 50
type: "array"
description: "Данные компаний-инициаторов пополнений.\n\nП\
ри заполнении данного поля списание будет происходить, т\
олько когда инициатором пополнения является одна из комп\
аний, указанных в поле.\n\nЗаполнение поля обязательно д\
ля правил с `category` = `CounterpartyIncome`. В иных сл\
учаях поле не заполняется."
nullable: true
items:
required:
- "inn"
- "kpp"
type: "object"
properties:
inn:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН."
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "КПП."
description: "Компания-инициатор операции пополнения"
category:
type: "string"
description: "Категория операций пополнения, по которым бу\
дут производиться списания.\n\n`CashIn` - операции внесе\
ния наличных на счет контрагента.\n\n`MerchantAcq` - опе\
рации, проведенные по торговому эквайрингу.\n\n`InternetAcq`\
\ - операции, проведенные по интернет-эквайрингу.\n\n`CounterpartyIncome`\
\ - операции по входящим переводам от контрагентов. "
enum:
- "CashIn"
- "MerchantAcq"
- "InternetAcq"
- "CounterpartyIncome"
description: "Условия, при которых должны проводиться списания\
\ по операциям пополнения.\n\nРаботает по принципу «и»: если\
\ заполнены несколько полей, то списания будут происходить,\
\ только если для каждого этих полей будет выполнено указанн\
ое условие.\n\nНапример, если в `category` указано `CounterpartyIncome`\
\ и в `payers` указана компания с ИНН = 7777777777, списание\
\ будет происходить только при входящем переводе от компании\
\ с ИНН = 7777777777."
requisites:
required:
- "docType"
- "payerAccount"
- "payerBIC"
- "payerCorAccount"
- "payerINN"
- "payerKPP"
- "payerName"
- "purpose"
- "recipientAccount"
type: "object"
properties:
docType:
type: "string"
description: " Тип платежного документа. `PaymentRequest`\
\ — платежное требование."
enum:
- "PaymentRequest"
paymentCondition:
type: "string"
description: " Условие платежа:\n\n* `WithAcceptance` — с\
\ акцептом;\n* `WithoutAcceptance` — без акцепта."
enum:
- "WithAcceptance"
- "WithoutAcceptance"
acceptTerm:
maximum: 9
minimum: 5
type: "integer"
description: "Количество дней для акцепта."
format: "int32"
nullable: true
docDispatchDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2})$"
type: "string"
description: " Дата вручения плательщику предусмотренных д\
оговором документов в формате `YYYY-MM-DD`."
nullable: true
payerAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Номер счета плательщика."
payerINN:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН плательщика."
payerKPP:
pattern: "^(\\d{9}|0)$"
type: "string"
description: " КПП плательщика.\n\nЕсли КПП нет, передайте\
\ `0`."
payerName:
maxLength: 160
minLength: 1
type: "string"
description: "Наименование плательщика."
payerBIC:
pattern: "^(\\d{9})$"
type: "string"
description: "БИК плательщика."
payerCorAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Корреспондентский счет плательщика."
recipientAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Счет получателя."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
format: "string"
examples:
Рекуррентное правило:
value:
type: "Recurrent"
cronExpr: "0 12 * * *"
requisites:
amount: 1000.55
docType: "PaymentRequest"
payerAccount: "12345678900987654321"
payerINN: "1234567890"
payerKPP: "123456789"
payerBIC: "044525974"
payerCorAccount: "30101810145250000974"
payerName: "ИП Петров Петр Иванович"
recipientAccount: "09876543211234567890"
purpose: "Платеж по соглашению №236383626412/2022-08-05/25.421"
paymentCondition: "WithoutAcceptance"
acceptTerm: 6
Триггерное правило (процентная сумма, внесение наличных):
value:
type: "Trigger"
amount:
percent: 0.0815
replenishmentFilter:
category: "CashIn"
requisites:
docType: "PaymentRequest"
payerAccount: "12345678900987654321"
payerINN: "1234567890"
payerKPP: "123456789"
payerBIC: "044525974"
payerCorAccount: "30101810145250000974"
payerName: "ИП Петров Петр Иванович"
recipientAccount: "09876543211234567890"
purpose: "Платеж по соглашению №236383626412/2022-08-05/25.421"
paymentCondition: "WithoutAcceptance"
acceptTerm: 6
Триггерное правило (фиксированная сумма, переводы от контрагентов):
value:
type: "Trigger"
amount:
fixed: 1000.55
replenishmentFilter:
payers:
- inn: "7777777777"
kpp: "987654321"
- inn: "8888888888"
kpp: "0"
category: "CounterpartyIncome"
requisites:
docType: "PaymentRequest"
payerAccount: "12345678900987654321"
payerINN: "1234567890"
payerKPP: "123456789"
payerBIC: "044525974"
payerCorAccount: "30101810145250000974"
payerName: "ИП Петров Петр Иванович"
recipientAccount: "09876543211234567890"
purpose: "Платеж по соглашению №236383626412/2022-08-05/25.421"
paymentCondition: "WithoutAcceptance"
acceptTerm: 6
required: true
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
oneOf:
- title: "Рекуррентное правило"
required:
- "agreementId"
- "cronExpr"
- "id"
- "requisites"
- "type"
type: "object"
properties:
type:
type: "string"
description: " Тип правила:\n\n* `Recurrent` — рекуррентное\
\ правило;\n\n* `Trigger` — триггерное правило."
enum:
- "Recurrent"
- "Trigger"
id:
type: "string"
description: "ID правила."
format: "uuid"
agreementId:
type: "string"
description: "ID соглашения."
format: "uuid"
requisites:
required:
- "amount"
- "docType"
- "payerAccount"
- "payerBIC"
- "payerCorAccount"
- "payerINN"
- "payerKPP"
- "payerName"
- "purpose"
- "recipientAccount"
type: "object"
properties:
docType:
type: "string"
description: " Тип платежного документа. `PaymentRequest`\
\ — платежное требование."
enum:
- "PaymentRequest"
amount:
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа."
format: "decimal"
paymentCondition:
type: "string"
description: " Условие платежа:\n\n* `WithAcceptance` —\
\ с акцептом;\n* `WithoutAcceptance` — без акцепта."
enum:
- "WithAcceptance"
- "WithoutAcceptance"
acceptTerm:
maximum: 9
minimum: 5
type: "integer"
description: "Количество дней для акцепта."
format: "int32"
nullable: true
docDispatchDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2})$"
type: "string"
description: " Дата вручения плательщику предусмотренных\
\ договором документов в формате `YYYY-MM-DD`."
nullable: true
payerAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Номер счета плательщика."
payerINN:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН плательщика."
payerKPP:
pattern: "^(\\d{9}|0)$"
type: "string"
description: " КПП плательщика.\n\nЕсли КПП нет, передай\
те `0`."
payerName:
maxLength: 160
minLength: 1
type: "string"
description: "Наименование плательщика."
payerBIC:
pattern: "^(\\d{9})$"
type: "string"
description: "БИК плательщика."
payerCorAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Корреспондентский счет плательщика."
recipientAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Счет получателя."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
format: "string"
cronExpr:
maxLength: 200
minLength: 9
type: "string"
description: "CRON-выражение регулярности платежа. Например\
, «0 12 * * *» — каждый день в 12:00 мск."
format: "string"
- title: "Триггерное правило"
required:
- "agreementId"
- "amount"
- "id"
- "replenishmentFilter"
- "requisites"
- "type"
type: "object"
properties:
type:
type: "string"
description: " Тип правила:\n\n* `Recurrent` — рекуррентное\
\ правило;\n\n* `Trigger` — триггерное правило."
enum:
- "Recurrent"
- "Trigger"
id:
type: "string"
description: "ID правила."
format: "uuid"
agreementId:
type: "string"
description: "ID соглашения."
format: "uuid"
amount:
type: "object"
properties:
fixed:
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа в виде фиксированного значен\
ия."
format: "decimal"
nullable: true
percent:
multipleOf: 0.00010
maximum: 1
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа в виде процента от суммы поп\
олнения. Значение 0.0001 соответствует 0.01%, а 1.0000\
\ - 100%."
format: "decimal"
nullable: true
description: "Сумма платежа.\n\nВозможно представление в одн\
ом из двух видов: фиксированный или процентный. Заполнять\
\ необходимо только одно из полей: либо `fixed`, либо `percent`."
replenishmentFilter:
required:
- "category"
type: "object"
properties:
payers:
maxItems: 50
type: "array"
description: "Данные компаний-инициаторов пополнений.\n\n\
При заполнении данного поля списание будет происходить\
, только когда инициатором пополнения является одна из\
\ компаний, указанных в поле.\n\nЗаполнение поля обяза\
тельно для правил с `category` = `CounterpartyIncome`.\
\ В иных случаях поле не заполняется."
nullable: true
items:
required:
- "inn"
- "kpp"
type: "object"
properties:
inn:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН."
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "КПП."
description: "Компания-инициатор операции пополнения"
category:
type: "string"
description: "Категория операций пополнения, по которым\
\ будут производиться списания.\n\n`CashIn` - операции\
\ внесения наличных на счет контрагента.\n\n`MerchantAcq`\
\ - операции, проведенные по торговому эквайрингу.\n\n\
`InternetAcq` - операции, проведенные по интернет-эква\
йрингу.\n\n`CounterpartyIncome` - операции по входящим\
\ переводам от контрагентов. "
enum:
- "CashIn"
- "MerchantAcq"
- "InternetAcq"
- "CounterpartyIncome"
description: "Условия, при которых должны проводиться списан\
ия по операциям пополнения.\n\nРаботает по принципу «и»: е\
сли заполнены несколько полей, то списания будут происходи\
ть, только если для каждого этих полей будет выполнено ука\
занное условие.\n\nНапример, если в `category` указано `CounterpartyIncome`\
\ и в `payers` указана компания с ИНН = 7777777777, списан\
ие будет происходить только при входящем переводе от компа\
нии с ИНН = 7777777777."
requisites:
required:
- "docType"
- "payerAccount"
- "payerBIC"
- "payerCorAccount"
- "payerINN"
- "payerKPP"
- "payerName"
- "purpose"
- "recipientAccount"
type: "object"
properties:
docType:
type: "string"
description: " Тип платежного документа. `PaymentRequest`\
\ — платежное требование."
enum:
- "PaymentRequest"
paymentCondition:
type: "string"
description: " Условие платежа:\n\n* `WithAcceptance` —\
\ с акцептом;\n* `WithoutAcceptance` — без акцепта."
enum:
- "WithAcceptance"
- "WithoutAcceptance"
acceptTerm:
maximum: 9
minimum: 5
type: "integer"
description: "Количество дней для акцепта."
format: "int32"
nullable: true
docDispatchDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2})$"
type: "string"
description: " Дата вручения плательщику предусмотренных\
\ договором документов в формате `YYYY-MM-DD`."
nullable: true
payerAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Номер счета плательщика."
payerINN:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН плательщика."
payerKPP:
pattern: "^(\\d{9}|0)$"
type: "string"
description: " КПП плательщика.\n\nЕсли КПП нет, передай\
те `0`."
payerName:
maxLength: 160
minLength: 1
type: "string"
description: "Наименование плательщика."
payerBIC:
pattern: "^(\\d{9})$"
type: "string"
description: "БИК плательщика."
payerCorAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Корреспондентский счет плательщика."
recipientAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Счет получателя."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
format: "string"
examples:
Рекуррентное правило:
value:
id: "c31e2fc0-3a2b-4482-9025-6ec36ed857bc"
agreementId: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
type: "Recurrent"
cronExpr: "0 12 * * *"
requisites:
amount: 1000.55
docType: "PaymentRequest"
payerAccount: "12345678900987654321"
payerINN: "1234567890"
payerKPP: "123456789"
payerBIC: "044525974"
payerCorAccount: "30101810145250000974"
payerName: "ИП Петров Петр Иванович"
recipientAccount: "09876543211234567890"
purpose: "Платеж по соглашению №236383626412/2022-08-05/25.421"
paymentCondition: "WithoutAcceptance"
acceptTerm: 6
Триггерное правило (процентная сумма, внесение наличных):
value:
id: "c31e2fc0-3a2b-4482-9025-6ec36ed857bc"
agreementId: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
type: "Trigger"
amount:
fixed: null
percent: 0.0815
replenishmentFilter:
payers: null
category: "CashIn"
requisites:
docType: "PaymentRequest"
payerAccount: "12345678900987654321"
payerINN: "1234567890"
payerKPP: "123456789"
payerBIC: "044525974"
payerCorAccount: "30101810145250000974"
payerName: "ИП Петров Петр Иванович"
recipientAccount: "09876543211234567890"
purpose: "Платеж по соглашению №236383626412/2022-08-05/25.421"
paymentCondition: "WithoutAcceptance"
acceptTerm: 6
Триггерное правило (фиксированная сумма, переводы от контрагентов):
value:
id: "c31e2fc0-3a2b-4482-9025-6ec36ed857bc"
agreementId: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
type: "Trigger"
amount:
fixed: 1000.55
percent: null
replenishmentFilter:
payers:
- inn: "7777777777"
kpp: "987654321"
- inn: "8888888888"
kpp: "0"
category: "CounterpartyIncome"
requisites:
docType: "PaymentRequest"
payerAccount: "12345678900987654321"
payerINN: "1234567890"
payerKPP: "123456789"
payerBIC: "044525974"
payerCorAccount: "30101810145250000974"
payerName: "ИП Петров Петр Иванович"
recipientAccount: "09876543211234567890"
purpose: "Платеж по соглашению №236383626412/2022-08-05/25.421"
paymentCondition: "WithoutAcceptance"
acceptTerm: 6
"400":
description: "Правило не найдено"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "bcadsa12"
errorCode: "NOT_FOUND"
errorMessage: "Resource not found"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
delete:
tags:
- "Правила"
summary: "Удалить правило"
description: " Метод для удаления платежного правила по ID.\n\nПри расторжен\
ии соглашения правила также перестают действовать."
operationId: "deleteApiV1Nonacceptance-DeleteRule"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "ruleId"
in: "path"
description: "ID платежного правила."
required: true
style: "simple"
explode: false
schema:
type: "string"
format: "uuid"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
example: {}
"400":
description: "Правило не найдено"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "bcadsa12"
errorCode: "NOT_FOUND"
errorMessage: "Resource not found"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/salary/payment-registry/list:
post:
tags:
- "Зарплатный проект"
summary: "Получить список платежных реестров за временной промежуток"
description: "\nМетод возвращает результат запроса для метода Получить реестры за определенный временной промежуток. Максимальное ч\
исло число реестров в списке — 50."
operationId: "salaryGetPaymentRegistryList"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
content:
application/json:
schema:
type: "object"
properties:
offset:
type: "integer"
description: "Количество реестров, которых мы пропустим при выда\
че с начала списка"
example: 0
statuses:
maxItems: 10
type: "array"
description: "Статусы платежных реестров"
example:
- "EXECUTED"
- "PART_EXEC"
items:
type: "string"
enum:
- "DRAFT"
- "ERROR"
- "SUBMITTED"
- "PROCESSING"
- "ACCEPTED"
- "EXECUTED"
- "PART_EXEC"
- "REJECTED"
- "CANCELLED"
- "DELETED"
periodStart:
type: "string"
description: "Начало периода, в котором был создан платежный рее\
стр"
format: "date"
example: "2024-09-01"
periodEnd:
type: "string"
description: "Конец периода, в котором был создан платежный реес\
тр"
format: "date"
example: "2024-09-07"
required: true
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "paymentOrders"
type: "object"
properties:
paymentOrders:
maxItems: 50
type: "array"
description: "Список платежных реестров"
items:
type: "object"
properties:
number:
type: "integer"
description: "Номер платежа"
example: 1
date:
type: "string"
description: "Дата платежа"
format: "date-time"
example: "2024-09-01T08:50:46.061Z"
count:
type: "integer"
description: "Количество строк в реестре"
example: 5
sum:
type: "number"
description: "Общая сумма по реестру"
format: "double"
example: 5000
status:
type: "string"
description: "Состояние реестра"
example: "EXECUTED"
enum:
- "DRAFT"
- "ERROR"
- "SUBMITTED"
- "PROCESSING"
- "ACCEPTED"
- "EXECUTED"
- "PART_EXEC"
- "REJECTED"
- "CANCELLED"
- "DELETED"
example:
paymentOrders:
- number: 123
date: "2024-09-01T08:50:46.061Z"
count: 5
sum: 5000
status: "EXECUTED"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/self-employed/payment-registry/list:
post:
tags:
- "Выплаты самозанятым"
summary: "Получить список платежных реестров за временной промежуток"
description: " Метод возвращает результат запроса для метода Получить реестры за определенный временной промежуток. Максимальное ч\
исло число реестров в списке — 50."
operationId: "selfEmployedGetPaymentRegistryList"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
content:
application/json:
schema:
type: "object"
properties:
offset:
type: "integer"
description: "Количество реестров, которых мы пропустим при выда\
че с начала списка"
example: 0
statuses:
maxItems: 10
type: "array"
description: "Статусы платежных реестров"
example:
- "EXECUTED"
- "PART_EXEC"
items:
type: "string"
enum:
- "DRAFT"
- "ERROR"
- "SUBMITTED"
- "PROCESSING"
- "ACCEPTED"
- "EXECUTED"
- "PART_EXEC"
- "REJECTED"
- "CANCELLED"
- "DELETED"
periodStart:
type: "string"
description: "Начало периода, в котором был создан платежный рее\
стр"
format: "date"
example: "2024-09-01"
periodEnd:
type: "string"
description: "Конец периода, в котором был создан платежный реес\
тр"
format: "date"
example: "2024-09-07"
required: true
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "paymentOrders"
type: "object"
properties:
paymentOrders:
maxItems: 50
type: "array"
description: "Список платежных реестров"
items:
type: "object"
properties:
number:
type: "integer"
description: "Номер платежа"
example: 1
date:
type: "string"
description: "Дата платежа"
format: "date-time"
example: "2024-09-01T08:50:46.061Z"
count:
type: "integer"
description: "Количество строк в реестре"
example: 5
sum:
type: "number"
description: "Общая сумма по реестру"
format: "double"
example: 5000
status:
type: "string"
description: "Состояние реестра"
example: "EXECUTED"
enum:
- "DRAFT"
- "ERROR"
- "SUBMITTED"
- "PROCESSING"
- "ACCEPTED"
- "EXECUTED"
- "PART_EXEC"
- "REJECTED"
- "CANCELLED"
- "DELETED"
example:
paymentOrders:
- number: 123
date: "2024-09-01T08:50:46.061Z"
count: 5
sum: 5000
status: "EXECUTED"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/self-employed/recipients/add/by-requisites:
post:
tags:
- "Выплаты самозанятым"
summary: "Добавить самозанятого по реквизитам"
description: " Метод для добавления самозанятых по реквизитам.\n\nЗапрос аси\
нхронный. Его результат можно получить через вызов метода Получить результат создания черновиков анкет сотрудников, передав в н\
ем соответствующий correlationId
."
operationId: "addSelfEmployedRecipientsByRequisites"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
content:
application/json:
schema:
required:
- "correlationId"
- "recipients"
type: "object"
properties:
correlationId:
type: "string"
description: "Идентификатор, связывающий запрос создания с запро\
сом получения ответа."
format: "uuid"
recipients:
maxItems: 2000
type: "array"
description: "Список самозанятых на добавление."
items:
required:
- "bankInfo"
- "firstName"
- "lastName"
- "number"
type: "object"
properties:
number:
type: "integer"
description: "Идентификатор самозанятого на стороне клиент\
а."
firstName:
maxLength: 100
type: "string"
description: "Имя (кириллица)."
lastName:
maxLength: 100
type: "string"
description: "Фамилия (кириллица)."
middleName:
maxLength: 100
type: "string"
description: "Отчество (кириллица)."
mobileNumber:
maxLength: 50
type: "string"
description: "Номер мобильного телефона."
inn:
maxLength: 50
type: "string"
description: "ИНН."
bankInfo:
required:
- "accountNumber"
type: "object"
properties:
bankBic:
maxLength: 50
type: "string"
description: "БИК банка. По умолчанию — Т-Банк."
accountNumber:
maxLength: 50
type: "string"
description: "Номер счета."
description: "Данные о счете."
required: true
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "correlationId"
type: "object"
properties:
correlationId:
type: "string"
description: "Идентификатор, связывающий запрос создания с зап\
росом получения ответа."
format: "uuid"
example:
correlationId: "17de62bb-e448-45b1-a670-d71cf0d60785"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/self-employed/recipients/add/by-requisites/result:
get:
tags:
- "Выплаты самозанятым"
summary: "Получить результат добавления самозанятого по реквизитам"
description: "\nМетод возвращает результат запроса для метода Добавить самозанятого по реквизитам. Ответ на запрос создания хранитс\
я в течение двух дней."
operationId: "addSelfEmployedRecipientsByRequisitesResult"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "correlationId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "Идентификатор, связывающий запрос создания с запросом полу\
чения ответа."
format: "uuid"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "recipientResults"
type: "object"
properties:
recipientResults:
maxItems: 2000
type: "array"
description: "Список результатов добавления самозанятых."
items:
required:
- "firstName"
- "lastName"
- "number"
- "status"
type: "object"
properties:
number:
type: "integer"
description: "Номер самозанятого, переданный клиентом пр\
и создании."
recipientId:
type: "integer"
description: "Идентификатор самозанятого. Может не прийт\
и, если при создании самозанятого возникли ошибки."
firstName:
maxLength: 100
type: "string"
description: "Имя (кириллица)."
lastName:
maxLength: 100
type: "string"
description: "Фамилия (кириллица)."
middleName:
maxLength: 100
type: "string"
description: "Отчество (кириллица)."
status:
type: "string"
description: "Статус создания:\n* `QUEUED` — самозанятый\
\ стоит в очереди на создание;\n* `CREATED` — самозаня\
тый создан в выплатах;\n* `ERROR` — самозанятый не был\
\ создан в выплатах. Ошибки перечислены в параметре errors
. "
enum:
- "QUEUED"
- "CREATED"
- "ERROR"
errors:
maxItems: 100
type: "array"
description: "Список ошибок."
items:
type: "object"
properties:
fieldName:
maxLength: 400
type: "string"
description: "Название поля, в котором есть ошибка\
."
errorDescription:
maxLength: 400
type: "string"
description: "Описание ошибки."
example:
recipientResults:
- number: 123
recipientId: 123
firstName: "Иван"
lastName: "Демидов"
middleName: "Иванович"
status: "ERROR"
errors:
- fieldName: "Инн"
errorDescription: "Не указан инн"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/self-employed/taxpayers/payment-documents-requests:
post:
tags:
- "Самозанятые"
summary: "Создать запрос на получение платежных документов по самозанятым"
description: "Метод для создания запроса на получение платежных документов и\
з ФНС."
operationId: "postApiV1Self-employedTaxpayersPaymentDocumentsRequests"
parameters:
- name: "Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности."
format: "uuid"
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
description: "Детали запроса."
content:
application/json:
schema:
required:
- "innList"
type: "object"
properties:
innList:
maxItems: 100
minItems: 1
type: "array"
description: "Список ИНН самозанятых, для которых запрашиваются\
\ платежные документы."
items:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
example:
innList:
- "173527033406"
- "266445718640"
responses:
"201":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "createdAt"
- "paymentDocumentsRequestId"
- "status"
type: "object"
properties:
paymentDocumentsRequestId:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
status:
type: "string"
description: "Статус запроса."
enum:
- "IN_PROGRESS"
- "COMPLETED"
createdAt:
type: "string"
description: "Дата и время создания запроса по UTC. Возвращает\
ся в формате ISO-8601
."
format: "date-time"
results:
maxItems: 100
minItems: 1
type: "array"
description: "Результаты запроса платежных документов."
items:
required:
- "inn"
type: "object"
properties:
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН самозанятого."
fnsErrorCode:
maxLength: 256
type: "string"
description: "Код ошибки ФНС."
documentList:
maxItems: 3
type: "array"
description: "Список платежных документов."
items:
required:
- "address"
- "amount"
- "code101"
- "code106"
- "code107"
- "code110"
- "createdAt"
- "documentIndex"
- "dueDate"
- "fullName"
- "inn"
- "sourceId"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип начисления:\n* TAX
\
\ — налоговое начисление;\n* DEBT
—\
\ задолженность;\n* PENALTY
— пени."
enum:
- "TAX"
- "DEBT"
- "PENALTY"
documentIndex:
type: "string"
description: "Индекс документа (УИН)."
format: "string"
fullName:
type: "string"
description: "ФИО."
format: "string"
address:
type: "string"
description: "Адрес места жительства."
format: "string"
inn:
type: "string"
description: "ИНН налогоплательщика."
format: "string"
amount:
type: "number"
description: "Сумма к оплате."
recipientBankName:
type: "string"
description: "Банк получателя."
format: "string"
recipientBankBik:
type: "string"
description: "БИК банка получателя."
format: "string"
recipientBankAccountNumber:
type: "string"
description: "Номер счета банка получателя."
format: "string"
recipient:
type: "string"
description: "Получатель."
format: "string"
recipientAccountNumber:
type: "string"
description: "Номер счета получателя."
format: "string"
recipientInn:
type: "string"
description: "ИНН получателя."
format: "string"
recipientKpp:
type: "string"
description: "КПП получателя."
format: "string"
kbk:
type: "string"
description: "КБК налогового начисления или КРСБ."
format: "string"
oktmo:
type: "string"
description: "ОКТМО налогового начисления или КРСБ\
."
format: "string"
code101:
type: "string"
description: "Код для поля 101, статус плательщика\
. [Подробнее](https://www.nalog.gov.ru/html/sites/www.rn77.nalog.ru/2022/2kvartal/Slaydi27042022.pdf)."
format: "string"
code106:
type: "string"
description: "Код для поля 106, основание платежа\
. [Подробнее](https://www.nalog.gov.ru/html/sites/www.rn77.nalog.ru/2022/2kvartal/Slaydi27042022.pdf)."
format: "string"
code107:
type: "string"
description: "Код для поля 107, показатель налогов\
ого периода. [Подробнее](https://www.nalog.gov.ru/html/sites/www.rn77.nalog.ru/2022/2kvartal/Slaydi27042022.pdf)."
format: "string"
code110:
type: "string"
description: "Код для поля 110, вид платежа. Запол\
няется фиксированным значением `0`."
format: "string"
dueDate:
type: "string"
description: "Оплатить до.\n\nДля ТП — 28 число ме\
сяца, следующего за отчетным; для ЗД — дата форм\
ирования документа."
format: "string"
createdAt:
type: "string"
description: "Дата и время создания документа по UTC.\
\ Возвращается в формате ISO-8601
."
format: "date-time"
sourceId:
type: "string"
description: "Внутренний идентификатор источника д\
окумента в ПП НПД.\n\nДля TAX
— вну\
тренний идентификатор налогового начисления, для\
\ DEBT
и PENALTY
— вну\
тренний идентификатор КРСБ."
format: "string"
examples:
Пример ответа IN_PROGRESS:
value:
paymentDocumentsRequestId: "e7bd838c-b376-449d-9074-8591bbb2647e"
status: "IN_PROGRESS"
createdAt: "2022-05-20T09:20:19Z"
Пример ответа COMPLETED:
value:
paymentDocumentsRequestId: "e7bd838c-b376-449d-9074-8591bbb2647e"
status: "COMPLETED"
results:
- inn: "173527033406"
fnsErrorCode: "TAXPAYER_NOT_FOUND"
- inn: "266445718640"
documentList:
- type: "DEBT"
documentIndex: "18209997220000044478"
fullName: "Дементьева Жанна Сергеевна"
address: "603093, РОССИЯ, , , г Нижний Новгород, , ул Роди\
онова, 23А, , офис 307"
inn: "266445718640"
amount: 1000
recipientBankName: "Отделение Барнаул г. Барнаул"
recipientBankBik: "040173001"
recipientBankAccountNumber: "66076855480672434823"
recipient: "УФК по Алтайскому краю"
recipientAccountNumber: "03100810350041010001"
recipientInn: "7733535730"
recipientKpp: "773301001"
kbk: "18210506000011000110"
oktmo: "78237857"
code101: "13"
code106: "ЗД"
code107: "27.07.2022"
code110: "0"
dueDate: "2022-07-27"
createdAt: "2022-05-27T12:48:00.651Z"
sourceId: "12292"
createdAt: "2022-07-20T09:20:19Z"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "cde4zxc5"
errorMessage: "One or more validation errors occurred."
errorCode: "VALIDATION_ERROR"
errorDetails:
innList[0]:
inn: "'inn' must be valid INN, i.e. contain 12 characters\
\ each of which is a digit and at least one of which is\
\ not '0'"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/self-employed/taxpayers/payment-documents-requests/{paymentDocumentsRequestId}:
get:
tags:
- "Самозанятые"
summary: "Получить запрос на получение платежных документов по самозанятым"
description: "Метод для получения запроса на получение платежных документов\
\ по самозанятым из ФНС."
operationId: "getApiV1Self-employedTaxpayersPaymentDocumentsRequestsPaymentDocumentsRequestId"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "paymentDocumentsRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "createdAt"
- "paymentDocumentsRequestId"
- "status"
type: "object"
properties:
paymentDocumentsRequestId:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
status:
type: "string"
description: "Статус запроса."
enum:
- "IN_PROGRESS"
- "COMPLETED"
createdAt:
type: "string"
description: "Дата и время создания запроса по UTC. Возвращает\
ся в формате ISO-8601
."
format: "date-time"
results:
maxItems: 100
minItems: 1
type: "array"
description: "Результаты запроса платежных документов."
items:
required:
- "inn"
type: "object"
properties:
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН самозанятого."
fnsErrorCode:
maxLength: 256
type: "string"
description: "Код ошибки ФНС."
documentList:
maxItems: 3
type: "array"
description: "Список платежных документов."
items:
required:
- "address"
- "amount"
- "code101"
- "code106"
- "code107"
- "code110"
- "createdAt"
- "documentIndex"
- "dueDate"
- "fullName"
- "inn"
- "sourceId"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип начисления:\n* TAX
\
\ — налоговое начисление;\n* DEBT
—\
\ задолженность;\n* PENALTY
— пени."
enum:
- "TAX"
- "DEBT"
- "PENALTY"
documentIndex:
type: "string"
description: "Индекс документа (УИН)."
format: "string"
fullName:
type: "string"
description: "ФИО."
format: "string"
address:
type: "string"
description: "Адрес места жительства."
format: "string"
inn:
type: "string"
description: "ИНН налогоплательщика."
format: "string"
amount:
type: "number"
description: "Сумма к оплате."
recipientBankName:
type: "string"
description: "Банк получателя."
format: "string"
recipientBankBik:
type: "string"
description: "БИК банка получателя."
format: "string"
recipientBankAccountNumber:
type: "string"
description: "Номер счета банка получателя."
format: "string"
recipient:
type: "string"
description: "Получатель."
format: "string"
recipientAccountNumber:
type: "string"
description: "Номер счета получателя."
format: "string"
recipientInn:
type: "string"
description: "ИНН получателя."
format: "string"
recipientKpp:
type: "string"
description: "КПП получателя."
format: "string"
kbk:
type: "string"
description: "КБК налогового начисления или КРСБ."
format: "string"
oktmo:
type: "string"
description: "ОКТМО налогового начисления или КРСБ\
."
format: "string"
code101:
type: "string"
description: "Код для поля 101, статус плательщика\
. [Подробнее](https://www.nalog.gov.ru/html/sites/www.rn77.nalog.ru/2022/2kvartal/Slaydi27042022.pdf)."
format: "string"
code106:
type: "string"
description: "Код для поля 106, основание платежа\
. [Подробнее](https://www.nalog.gov.ru/html/sites/www.rn77.nalog.ru/2022/2kvartal/Slaydi27042022.pdf)."
format: "string"
code107:
type: "string"
description: "Код для поля 107, показатель налогов\
ого периода. [Подробнее](https://www.nalog.gov.ru/html/sites/www.rn77.nalog.ru/2022/2kvartal/Slaydi27042022.pdf)."
format: "string"
code110:
type: "string"
description: "Код для поля 110, вид платежа. Запол\
няется фиксированным значением `0`."
format: "string"
dueDate:
type: "string"
description: "Оплатить до.\n\nДля ТП — 28 число ме\
сяца, следующего за отчетным; для ЗД — дата форм\
ирования документа."
format: "string"
createdAt:
type: "string"
description: "Дата и время создания документа по UTC.\
\ Возвращается в формате ISO-8601
."
format: "date-time"
sourceId:
type: "string"
description: "Внутренний идентификатор источника д\
окумента в ПП НПД.\n\nДля TAX
— вну\
тренний идентификатор налогового начисления, для\
\ DEBT
и PENALTY
— вну\
тренний идентификатор КРСБ."
format: "string"
examples:
Пример ответа IN_PROGRESS:
value:
paymentDocumentsRequestId: "e7bd838c-b376-449d-9074-8591bbb2647e"
status: "IN_PROGRESS"
createdAt: "2022-05-20T09:20:19Z"
Пример ответа COMPLETED:
value:
paymentDocumentsRequestId: "e7bd838c-b376-449d-9074-8591bbb2647e"
status: "COMPLETED"
results:
- inn: "173527033406"
fnsErrorCode: "TAXPAYER_NOT_FOUND"
- inn: "266445718640"
documentList:
- type: "DEBT"
documentIndex: "18209997220000044478"
fullName: "Дементьева Жанна Сергеевна"
address: "603093, РОССИЯ, , , г Нижний Новгород, , ул Роди\
онова, 23А, , офис 307"
inn: "266445718640"
amount: 1000
recipientBankName: "Отделение Барнаул г. Барнаул"
recipientBankBik: "040173001"
recipientBankAccountNumber: "66076855480672434823"
recipient: "УФК по Алтайскому краю"
recipientAccountNumber: "03100810350041010001"
recipientInn: "7733535730"
recipientKpp: "773301001"
kbk: "18210506000011000110"
oktmo: "78237857"
code101: "13"
code106: "ЗД"
code107: "27.07.2022"
code110: "0"
dueDate: "2022-07-27"
createdAt: "2022-05-27T12:48:00.651Z"
sourceId: "12292"
createdAt: "2022-07-20T09:20:19Z"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "cde4zxc5"
errorMessage: "One or more validation errors occurred."
errorCode: "VALIDATION_ERROR"
errorDetails:
paymentDocumentsRequestId: "'paymentDocumentsRequestId' must not\
\ be empty"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/self-employed/taxpayers/{inn}/account-balance:
get:
tags:
- "Самозанятые"
summary: "Получить налоговый баланс самозанятого"
description: "\nМетод возвращает текущий налоговый баланс самозанятого.\n\nЗ\
апрос можно отправить только в ночное время — с 22:00 до 06:00 мск. Это св\
язано с ограничениями от ФНС. Если отправить запрос в другое время, вернет\
ся ошибка с кодом `OPERATION_REJECTED`."
operationId: "getApiV1Self-employedTaxpayersInnAccountBalance"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "inn"
in: "path"
required: true
style: "simple"
explode: false
schema:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "inn"
- "requestStatus"
type: "object"
properties:
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН самозанятого."
requestStatus:
type: "string"
description: "Статус запроса."
enum:
- "IN_PROGRESS"
- "SUCCEEDED"
- "FAILED"
bonusAmount:
type: "number"
description: "Сумма бонусного счета."
unpaidAmount:
type: "number"
description: "Общая сумма неоплаченных платежей."
debtAmount:
type: "number"
description: "Сумма задолженности. Включена в общую сумму неоп\
лаченных платежей."
fnsErrorCode:
maxLength: 256
type: "string"
description: "Код ошибки ФНС."
examples:
Пример ответа IN_PROGRESS:
value:
inn: "173527033406"
requestStatus: "IN_PROGRESS"
Пример ответа SUCCEEDED:
value:
inn: "173527033406"
requestStatus: "SUCCEEDED"
bonusAmount: 3000
unpaidAmount: 3405
debtAmount: 0
Пример ответа FAILED:
value:
inn: "173527033406"
requestStatus: "FAILED"
fnsErrorCode: "TAXPAYER_NOT_FOUND"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "cde4zxc5"
errorMessage: "One or more validation errors occurred."
errorCode: "VALIDATION_ERROR"
errorDetails:
inn: "'inn' must be valid INN, i.e. contain 12 characters each of\
\ which is a digit and at least one of which is not '0' and checksum\
\ matches"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/self-employed/taxpayers/{inn}/income-requests:
post:
tags:
- "Самозанятые"
summary: "Создать запрос на получение суммы доходов самозанятого за период"
description: "\nМетод для создания запроса на получение суммы доходов самоза\
нятого из ФНС.\n\nЗапрос можно отправить только в ночное время — с 22:00 д\
о 06:00 мск. Это связано с ограничениями от ФНС. Если отправить запрос в д\
ругое время, вернется ошибка с кодом `OPERATION_REJECTED`."
operationId: "postApiV1Self-employedTaxpayersInnIncomeRequests"
parameters:
- name: "Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности."
format: "uuid"
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "inn"
in: "path"
required: true
style: "simple"
explode: false
schema:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
requestBody:
description: "Детали запроса."
content:
application/json:
schema:
required:
- "month"
- "year"
type: "object"
properties:
year:
type: "integer"
description: "Год, за который запрашивается сумма доходов."
format: "int32"
month:
type: "integer"
description: "Месяц, за который запрашивается сумма доходов."
format: "int32"
example:
year: 2024
month: 5
responses:
"201":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "incomeRequestId"
- "inn"
- "month"
- "status"
- "year"
type: "object"
properties:
incomeRequestId:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН самозанятого."
status:
type: "string"
description: "Статус запроса."
enum:
- "IN_PROGRESS"
- "SUCCEEDED"
- "FAILED"
year:
type: "integer"
description: "Год, за который запрашивается сумма доходов."
format: "int32"
month:
type: "integer"
description: "Месяц, за который запрашивается сумма доходов."
format: "int32"
totalAmount:
type: "number"
description: "Сумма зарегистрированного дохода за период."
cancelledTotalAmount:
type: "number"
description: "Сумма сторнированного дохода за период."
tax:
type: "number"
description: "Рассчитанный налог за период."
fnsErrorCode:
maxLength: 256
type: "string"
description: "Код ошибки ФНС."
examples:
Пример ответа IN_PROGRESS:
value:
incomeRequestId: "a7dd683f-2648-4209-a87f-88dcbc92c811"
inn: "173527033406"
status: "IN_PROGRESS"
year: 2024
month: 5
Пример ответа SUCCEEDED:
value:
incomeRequestId: "a7dd683f-2648-4209-a87f-88dcbc92c811"
inn: "173527033406"
status: "SUCCEEDED"
year: 2024
month: 5
totalAmount: 3000
cancelledTotalAmount: 100
tax: 0
Пример ответа FAILED:
value:
incomeRequestId: "a7dd683f-2648-4209-a87f-88dcbc92c811"
inn: "173527033406"
status: "FAILED"
year: 2024
month: 5
fnsErrorCode: "TAXPAYER_NOT_FOUND"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "cde4zxc5"
errorMessage: "One or more validation errors occurred."
errorCode: "VALIDATION_ERROR"
errorDetails:
inn: "'inn' must be valid INN, i.e. contain 12 characters each\
\ of which is a digit and at least one of which is not '0'"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/self-employed/taxpayers/{inn}/income-requests/{incomeRequestId}:
get:
tags:
- "Самозанятые"
summary: "Получить запрос на получение суммы доходов самозанятого за период"
description: "Метод для получения запроса на получение суммы доходов самозан\
ятого из ФНС."
operationId: "getApiV1Self-employedTaxpayersInnIncomeRequestsIncomeRequestId"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "incomeRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "inn"
in: "path"
required: true
style: "simple"
explode: false
schema:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "incomeRequestId"
- "inn"
- "month"
- "status"
- "year"
type: "object"
properties:
incomeRequestId:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН самозанятого."
status:
type: "string"
description: "Статус запроса."
enum:
- "IN_PROGRESS"
- "SUCCEEDED"
- "FAILED"
year:
type: "integer"
description: "Год, за который запрашивается сумма доходов."
format: "int32"
month:
type: "integer"
description: "Месяц, за который запрашивается сумма доходов."
format: "int32"
totalAmount:
type: "number"
description: "Сумма зарегистрированного дохода за период."
cancelledTotalAmount:
type: "number"
description: "Сумма сторнированного дохода за период."
tax:
type: "number"
description: "Рассчитанный налог за период."
fnsErrorCode:
maxLength: 256
type: "string"
description: "Код ошибки ФНС."
examples:
Пример ответа IN_PROGRESS:
value:
incomeRequestId: "a7dd683f-2648-4209-a87f-88dcbc92c811"
inn: "173527033406"
status: "IN_PROGRESS"
year: 2024
month: 5
Пример ответа SUCCEEDED:
value:
incomeRequestId: "a7dd683f-2648-4209-a87f-88dcbc92c811"
inn: "173527033406"
status: "SUCCEEDED"
year: 2024
month: 5
totalAmount: 3000
cancelledTotalAmount: 100
tax: 0
Пример ответа FAILED:
value:
incomeRequestId: "a7dd683f-2648-4209-a87f-88dcbc92c811"
inn: "173527033406"
status: "FAILED"
year: 2024
month: 5
fnsErrorCode: "TAXPAYER_NOT_FOUND"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "cde4zxc5"
errorMessage: "One or more validation errors occurred."
errorCode: "VALIDATION_ERROR"
errorDetails:
paymentDocumentsRequestId: "'incomeRequestId' must not be empty"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/self-employed/taxpayers/{inn}/receipts-requests:
post:
tags:
- "Самозанятые"
summary: "Создать запрос на получение списка чеков самозанятого"
description: "\nМетод для создания запроса на получение списка чеков самозан\
ятого из ФНС.\n\nЗапрос можно отправить только в ночное время — с 22:00 до\
\ 06:00 мск. Это связано с ограничениями от ФНС. Если отправить запрос в д\
ругое время, вернется ошибка с кодом `OPERATION_REJECTED`."
operationId: "postApiV1Self-employedTaxpayersInnReceiptsRequests"
parameters:
- name: "Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности."
format: "uuid"
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "inn"
in: "path"
required: true
style: "simple"
explode: false
schema:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
requestBody:
description: "Детали запроса."
content:
application/json:
schema:
required:
- "from"
- "to"
type: "object"
properties:
from:
type: "string"
description: "Дата и время начала периода по UTC в формате ISO-8601\
\ yyyy-MM-ddTHH:mm:ss<.fff>\\
, где:\n\
\n* `HH` — часы в 24-часовой нотации. Допускаются значения от\
\ 00 до 23.\n* `.fff` — опциональная часть, которая содержит д\
оли секунд. Допускается не больше трех знаков.\n* `TZDSuffix`\
\ — опциональный суффикс. Допускается значение Z
\
\ или +00:00
."
format: "date-time"
to:
type: "string"
description: "Дата и время начала периода по UTC в формате ISO-8601\
\ yyyy-MM-ddTHH:mm:ss<.fff>\\
, где:\n\
\n* `HH` — часы в 24-часовой нотации. Допускаются значения от\
\ 00 до 23.\n* `.fff` — опциональная часть, которая содержит д\
оли секунд. Допускается не больше трех знаков.\n* `TZDSuffix`\
\ — опциональный суффикс. Допускается значение Z
\
\ или +00:00
."
format: "date-time"
example:
from: "2024-01-01T00:00:00.000Z"
to: "2024-02-01T00:00:00.000Z"
responses:
"201":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "from"
- "inn"
- "receiptsRequestId"
- "status"
- "to"
type: "object"
properties:
receiptsRequestId:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН самозанятого."
status:
type: "string"
description: "Статус запроса."
enum:
- "IN_PROGRESS"
- "SUCCEEDED"
- "FAILED"
from:
type: "string"
description: "Дата и время начала периода по UTC. Возвращается\
\ в формате ISO-8601
."
format: "date-time"
to:
type: "string"
description: "Дата и время конца периода по UTC. Возвращается\
\ в формате ISO-8601
."
format: "date-time"
fnsErrorCode:
maxLength: 256
type: "string"
description: "Код ошибки ФНС."
offset:
type: "integer"
description: "Запрошенное количество чеков для пропуска."
format: "int32"
limit:
type: "integer"
description: "Запрошенное количество чеков для вывода."
format: "int32"
size:
type: "integer"
description: "Количество чеков в ответе."
format: "int32"
total:
type: "integer"
description: "Всего чеков, подходящих под условия запроса."
format: "int32"
results:
maxItems: 50
type: "array"
description: "Список чеков."
nullable: true
items:
required:
- "fnsLink"
- "incomeReceivedAt"
- "incomeStatedAt"
- "incomeType"
- "services"
- "status"
- "totalAmount"
type: "object"
properties:
incomeType:
type: "string"
description: "От кого самозанятый получил доход."
enum:
- "FROM_INDIVIDUAL"
- "FROM_LEGAL_ENTITY"
- "FROM_FOREIGN_AGENCY"
status:
type: "string"
description: "Статус чека."
enum:
- "REGISTERED"
- "CANCELLED"
incomeReceivedAt:
type: "string"
description: "Дата и время получения дохода по UTC. Возв\
ращается в формате ISO-8601
."
format: "date-time"
incomeStatedAt:
type: "string"
description: "Дата и время заявления дохода по UTC. Возв\
ращается в формате ISO-8601
."
format: "date-time"
services:
maxItems: 100
type: "array"
description: "Массив объектов с информацией об оказанных\
\ услугах."
items:
required:
- "name"
- "price"
type: "object"
properties:
name:
maxLength: 256
type: "string"
description: "Название услуги."
price:
type: "number"
description: "Цена."
totalAmount:
type: "number"
description: "Сумма заявленного дохода."
fnsLink:
maxLength: 256
type: "string"
description: "Ссылка на чек в ФНС."
receiptId:
type: "string"
description: "Идентификатор чека."
format: "uuid"
customerInn:
pattern: "^(\\d{10})$"
type: "string"
description: "ИНН компании-заказчика, которой самозаняты\
й оказал услугу."
customerOrganization:
maxLength: 256
type: "string"
description: "Название компании-заказчика, которой самоз\
анятый оказывал услуги."
examples:
Пример ответа IN_PROGRESS:
value:
status: "IN_PROGRESS"
receiptsRequestId: "a7dd683f-2648-4209-a87f-88dcbc92c811"
inn: "173527033406"
from: "2024-01-01T00:00:00Z"
to: "2024-02-01T00:00:00Z"
Пример ответа SUCCEEDED:
value:
status: "SUCCEEDED"
receiptsRequestId: "a7dd683f-2648-4209-a87f-88dcbc92c811"
inn: "173527033406"
from: "2024-01-01T00:00:00Z"
to: "2024-02-01T00:00:00Z"
results:
- incomeType: "FROM_INDIVIDUAL"
receiptId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
status: "REGISTERED"
incomeReceivedAt: "2022-09-15T16:00:00Z"
incomeStatedAt: "2022-09-15T16:10:00Z"
totalAmount: 1500.42
services:
- name: "Оплата самозанятому по договору"
price: 1500.42
fnsLink: "https://lknpd.nalog.ru/api/v1/receipt/504511355012/2017i8xslu/print"
- incomeType: "FROM_LEGAL_ENTITY"
status: "CANCELLED"
incomeReceivedAt: "2022-09-15T16:00:00Z"
incomeStatedAt: "2022-09-15T16:10:00Z"
totalAmount: 1500.42
services:
- name: "Оплата самозанятому по договору"
price: 1500.42
fnsLink: "https://lknpd.nalog.ru/api/v1/receipt/504511355012/2017i8xslu/print"
customerInn: "7710140679"
customerOrganization: "ООО Рога и копыта"
limit: 50
size: 1
total: 1
offset: 0
Пример ответа FAILED:
value:
status: "FAILED"
fnsErrorCode: "TAXPAYER_NOT_FOUND"
receiptsRequestId: "a7dd683f-2648-4209-a87f-88dcbc92c811"
inn: "173527033406"
from: "2024-01-01T00:00:00Z"
to: "2024-02-01T00:00:00Z"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "cde4zxc5"
errorMessage: "One or more validation errors occurred."
errorCode: "VALIDATION_ERROR"
errorDetails:
inn: "'inn' must be valid INN, i.e. contain 12 characters each\
\ of which is a digit and at least one of which is not '0'"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/self-employed/taxpayers/{inn}/receipts-requests/{receiptsRequestId}:
get:
tags:
- "Самозанятые"
summary: "Получить запрос на получение списка чеков самозанятого"
description: "Метод для получения запроса на получение списка чеков самозаня\
того из ФНС."
operationId: "getApiV1Self-employedTaxpayersInnReceiptsRequestsReceiptsRequestId"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "inn"
in: "path"
required: true
style: "simple"
explode: false
schema:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
- name: "receiptsRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "from"
- "inn"
- "receiptsRequestId"
- "status"
- "to"
type: "object"
properties:
receiptsRequestId:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН самозанятого."
status:
type: "string"
description: "Статус запроса."
enum:
- "IN_PROGRESS"
- "SUCCEEDED"
- "FAILED"
from:
type: "string"
description: "Дата и время начала периода по UTC. Возвращается\
\ в формате ISO-8601
."
format: "date-time"
to:
type: "string"
description: "Дата и время конца периода по UTC. Возвращается\
\ в формате ISO-8601
."
format: "date-time"
fnsErrorCode:
maxLength: 256
type: "string"
description: "Код ошибки ФНС."
offset:
type: "integer"
description: "Запрошенное количество чеков для пропуска."
format: "int32"
limit:
type: "integer"
description: "Запрошенное количество чеков для вывода."
format: "int32"
size:
type: "integer"
description: "Количество чеков в ответе."
format: "int32"
total:
type: "integer"
description: "Всего чеков, подходящих под условия запроса."
format: "int32"
results:
maxItems: 50
type: "array"
description: "Список чеков."
nullable: true
items:
required:
- "fnsLink"
- "incomeReceivedAt"
- "incomeStatedAt"
- "incomeType"
- "services"
- "status"
- "totalAmount"
type: "object"
properties:
incomeType:
type: "string"
description: "От кого самозанятый получил доход."
enum:
- "FROM_INDIVIDUAL"
- "FROM_LEGAL_ENTITY"
- "FROM_FOREIGN_AGENCY"
status:
type: "string"
description: "Статус чека."
enum:
- "REGISTERED"
- "CANCELLED"
incomeReceivedAt:
type: "string"
description: "Дата и время получения дохода по UTC. Возв\
ращается в формате ISO-8601
."
format: "date-time"
incomeStatedAt:
type: "string"
description: "Дата и время заявления дохода по UTC. Возв\
ращается в формате ISO-8601
."
format: "date-time"
services:
maxItems: 100
type: "array"
description: "Массив объектов с информацией об оказанных\
\ услугах."
items:
required:
- "name"
- "price"
type: "object"
properties:
name:
maxLength: 256
type: "string"
description: "Название услуги."
price:
type: "number"
description: "Цена."
totalAmount:
type: "number"
description: "Сумма заявленного дохода."
fnsLink:
maxLength: 256
type: "string"
description: "Ссылка на чек в ФНС."
receiptId:
type: "string"
description: "Идентификатор чека."
format: "uuid"
customerInn:
pattern: "^(\\d{10})$"
type: "string"
description: "ИНН компании-заказчика, которой самозаняты\
й оказал услугу."
customerOrganization:
maxLength: 256
type: "string"
description: "Название компании-заказчика, которой самоз\
анятый оказывал услуги."
examples:
Пример ответа IN_PROGRESS:
value:
status: "IN_PROGRESS"
receiptsRequestId: "a7dd683f-2648-4209-a87f-88dcbc92c811"
inn: "173527033406"
from: "2024-01-01T00:00:00Z"
to: "2024-02-01T00:00:00Z"
Пример ответа SUCCEEDED:
value:
status: "SUCCEEDED"
receiptsRequestId: "a7dd683f-2648-4209-a87f-88dcbc92c811"
inn: "173527033406"
from: "2024-01-01T00:00:00Z"
to: "2024-02-01T00:00:00Z"
results:
- incomeType: "FROM_INDIVIDUAL"
receiptId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
status: "REGISTERED"
incomeReceivedAt: "2022-09-15T16:00:00Z"
incomeStatedAt: "2022-09-15T16:10:00Z"
totalAmount: 1500.42
services:
- name: "Оплата самозанятому по договору"
price: 1500.42
fnsLink: "https://lknpd.nalog.ru/api/v1/receipt/504511355012/2017i8xslu/print"
- incomeType: "FROM_LEGAL_ENTITY"
status: "CANCELLED"
incomeReceivedAt: "2022-09-15T16:00:00Z"
incomeStatedAt: "2022-09-15T16:10:00Z"
totalAmount: 1500.42
services:
- name: "Оплата самозанятому по договору"
price: 1500.42
fnsLink: "https://lknpd.nalog.ru/api/v1/receipt/504511355012/2017i8xslu/print"
customerInn: "7710140679"
customerOrganization: "ООО Рога и копыта"
limit: 50
size: 1
total: 1
offset: 0
Пример ответа FAILED:
value:
status: "FAILED"
fnsErrorCode: "TAXPAYER_NOT_FOUND"
receiptsRequestId: "a7dd683f-2648-4209-a87f-88dcbc92c811"
inn: "173527033406"
from: "2024-01-01T00:00:00Z"
to: "2024-02-01T00:00:00Z"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "cde4zxc5"
errorMessage: "One or more validation errors occurred."
errorCode: "VALIDATION_ERROR"
errorDetails:
paymentDocumentsRequestId: "'receiptsRequestId' must not be empty"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/statement:
get:
tags:
- "Счета и выписки"
summary: "Получить выписку по счету"
description: " Метод для получения списка операций по счету за определенный\
\ период по указанным критериям поиска. Данные доступны с июня 2023 года.\n\
\nЧтобы оперативно отслеживать статус оплаты, вы также можете воспользоват\
ься вебхуком Операция по сче\
ту.\n\nПоля с датой и временем в запросе и ответе передаются в формате\
\ ISO 8601 по UTC.\n\nОперации получаются порциями. Максимальный размер по\
рции регулируется параметром limit
. Если в текущем запросе не\
\ удается вернуть все операции, в ответе будет заполнено поле nextCursor
\
\ с указателем на последнюю операцию в ответе. Чтобы получить очередную по\
рцию операций, повторите запрос — в поле cursor
укажите значе\
ние, полученное из nextCursor
.\n\nЧтобы в ответе вернулись ба\
лансы, передайте параметр withBalances
со значением true
.\
\ Они вернутся только для первого запроса — для следующих запросов очередн\
ой порции операций при заполнении поля `cursor` балансы не возвращаются.\n\
\nПодробнее про сценарий Опер\
ации по счету"
operationId: "getApiV1Statement"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "accountNumber"
in: "query"
description: "Номер счета."
required: true
style: "form"
explode: true
schema:
pattern: "^(\\d{20})$"
type: "string"
example: "40702810510000710417"
- name: "categories"
in: "query"
description: "Категории операций. Подробнее о категориях."
required: false
style: "form"
explode: true
schema:
maxItems: 50
type: "array"
items:
maxLength: 50
type: "string"
example: "fee"
example: "fee"
- name: "cursor"
in: "query"
description: "Указатель на последнюю операцию, полученную в предыдущем зап\
росе.\n\n\nМаксимальное количество операций в запросе — 5000, значение п\
о умолчанию — 1000. Если количество операций больше лимита, этот парамет\
р вернется в последней строке ответа — его нужно передать в следующем за\
просе."
required: false
style: "form"
explode: true
schema:
maxLength: 100
type: "string"
- name: "from"
in: "query"
description: "Дата начала периода, включительно."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "date-time"
example: "2022-02-01T21:00:00Z"
- name: "inns"
in: "query"
description: "ИНН контрагентов."
required: false
style: "form"
explode: true
schema:
maxItems: 50
type: "array"
items:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
example: "17499237465"
example: "17499237465"
- name: "limit"
in: "query"
description: "Максимальное количество операций, которое нужно получить за\
\ один вызов метода."
required: false
style: "form"
explode: true
schema:
maximum: 5000
minimum: 1
type: "integer"
format: "int32"
default: 1000
- name: "operationStatus"
in: "query"
description: "Статус операции для фильтрации: все операции, только авториз\
ации или только подтвержденные транзакции."
required: false
style: "form"
explode: true
schema:
type: "string"
enum:
- "All"
- "Authorization"
- "Transaction"
example: "Transaction"
- name: "to"
in: "query"
description: "Дата окончания периода, не включительно."
required: false
style: "form"
explode: true
schema:
type: "string"
format: "date-time"
example: "2022-02-02T21:00:00Z"
- name: "ucid"
in: "query"
description: "UCID карты — ее уникальный идентификатор. Его можно получить\
\ через метод Получить список кар\
т компании."
required: false
style: "form"
explode: true
schema:
type: "integer"
format: "int64"
example: 1234567890
- name: "withBalances"
in: "query"
description: "Если передан `true`, возвращаются балансы."
required: false
style: "form"
explode: true
schema:
type: "boolean"
responses:
"200":
description: "Список операций"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "operations"
type: "object"
properties:
balances:
type: "object"
properties:
balanceBegin:
type: "number"
description: "Баланс на начало периода."
format: "decimal"
balanceEnd:
type: "number"
description: "Баланс на конец периода."
format: "decimal"
credit:
type: "number"
description: "Обороты по кредиту за весь период."
format: "decimal"
nullable: true
debit:
type: "number"
description: "Обороты по дебету за весь период."
format: "decimal"
nullable: true
creditAuthorizations:
type: "number"
description: "Обороты по кредиту для авторизаций за весть\
\ период."
format: "decimal"
nullable: true
debitAuthorizations:
type: "number"
description: "Обороты по дебету для авторизаций за весь пе\
риод."
format: "decimal"
nullable: true
operationsCount:
type: "integer"
description: "Количество операций за весь период."
format: "int32"
balances:
maxItems: 2000
type: "array"
description: "Балансы и обороты по дням."
items:
type: "object"
properties:
date:
type: "string"
description: "Дата, на которую предоставлены балансы\
\ и обороты."
format: "date"
balanceBegin:
type: "number"
description: "Баланс на начало дня."
format: "decimal"
balanceEnd:
type: "number"
description: "Баланс на конец дня."
format: "decimal"
credit:
type: "number"
description: "Обороты по кредиту."
format: "decimal"
nullable: true
debit:
type: "number"
description: "Обороты по дебету."
format: "decimal"
nullable: true
creditAuthorizations:
type: "number"
description: "Обороты по кредиту для авторизаций."
format: "decimal"
nullable: true
debitAuthorizations:
type: "number"
description: "Обороты по дебету для авторизаций."
format: "decimal"
nullable: true
operationsCount:
type: "integer"
description: "Количество операций."
format: "int32"
description: "Балансы и обороты."
operations:
maxItems: 11000
type: "array"
description: "Список операций."
items:
required:
- "operationDate"
- "operationId"
type: "object"
properties:
operationDate:
type: "string"
description: "Дата операции. В зависимости от статуса оп\
ерации равна дате проведения по балансу или дате автор\
изации."
format: "date-time"
operationId:
type: "string"
description: "Уникальный ID операции."
format: "uuid"
operationStatus:
type: "string"
description: "Статус операции: авторизация или подтвержд\
енная транзакция."
nullable: true
enum:
- "Authorization"
- "Transaction"
accountNumber:
maxLength: 500
type: "string"
description: "Номер счета."
nullable: true
bic:
maxLength: 500
type: "string"
description: "БИК."
nullable: true
typeOfOperation:
maxLength: 500
type: "string"
description: "Тип операции: `Сredit` — поступления, `Debit`\
\ — списания."
nullable: true
category:
maxLength: 500
type: "string"
description: "Категория операции. Подробнее о категориях."
nullable: true
trxnPostDate:
type: "string"
description: "Дата транзакции."
format: "date-time"
nullable: true
authorizationDate:
type: "string"
description: "Дата авторизации."
format: "date-time"
nullable: true
drawDate:
type: "string"
description: "Дата списано."
format: "date-time"
nullable: true
chargeDate:
type: "string"
description: "Дата поступило."
format: "date-time"
nullable: true
docDate:
type: "string"
description: "Дата создания документа."
format: "date-time"
nullable: true
documentNumber:
maxLength: 500
type: "string"
description: "Номер платежного документа."
nullable: true
payVo:
maxLength: 500
type: "string"
description: "Вид операции (строка). Подробнее о видах платежа."
nullable: true
vo:
pattern: "^(\\d{2})$"
type: "string"
description: "Вид операции (номер). Подробнее о видах платежа."
nullable: true
priority:
type: "integer"
description: "Очередность платежа."
format: "int32"
nullable: true
operationAmount:
type: "number"
description: "Сумма в валюте операции."
format: "decimal"
nullable: true
operationCurrencyDigitalCode:
maxLength: 500
type: "string"
description: "Числовой код валюты операции."
nullable: true
accountAmount:
type: "number"
description: "Сумма в валюте счета."
format: "decimal"
nullable: true
accountCurrencyDigitalCode:
maxLength: 500
type: "string"
description: "Числовой код валюты счета."
nullable: true
rubleAmount:
type: "number"
description: "Сумма в рублях по курсу ЦБ на дату операци\
и."
format: "decimal"
nullable: true
description:
maxLength: 500
type: "string"
description: "Описание операции."
nullable: true
payPurpose:
maxLength: 500
type: "string"
description: "Назначение платежа."
nullable: true
payer:
type: "object"
properties:
acct:
maxLength: 500
type: "string"
description: "Номер счета плательщика."
nullable: true
inn:
maxLength: 500
type: "string"
description: "ИНН плательщика."
nullable: true
kpp:
maxLength: 500
type: "string"
description: "КПП плательщика."
nullable: true
name:
maxLength: 500
type: "string"
description: "Наименование плательщика."
nullable: true
bicRu:
maxLength: 500
type: "string"
description: "БИК банка плательщика."
nullable: true
bicSwift:
maxLength: 500
type: "string"
description: "SWIFT-код банка плательщика."
nullable: true
bankName:
maxLength: 500
type: "string"
description: "Название банка плательщика."
nullable: true
corAcct:
maxLength: 500
type: "string"
description: "Корреспондентский счет плательщика."
nullable: true
description: "Информация о плательщике."
receiver:
type: "object"
properties:
acct:
maxLength: 500
type: "string"
description: "Номер счета получателя."
nullable: true
inn:
maxLength: 500
type: "string"
description: "ИНН получателя."
nullable: true
kpp:
maxLength: 500
type: "string"
description: "КПП получателя."
nullable: true
name:
maxLength: 500
type: "string"
description: "Наименование получателя."
nullable: true
bicRu:
maxLength: 500
type: "string"
description: "БИК получателя."
nullable: true
bicSwift:
maxLength: 500
type: "string"
description: "SWIFT-код банка получателя."
nullable: true
bankName:
maxLength: 500
type: "string"
description: "Название банка получателя."
nullable: true
corAcct:
maxLength: 500
type: "string"
description: "Корреспондентский счет получателя."
nullable: true
description: "Информация о получателе."
counterParty:
type: "object"
properties:
account:
maxLength: 500
type: "string"
description: "Номер счета контрагента."
nullable: true
inn:
maxLength: 500
type: "string"
description: "ИНН контрагента."
nullable: true
kpp:
maxLength: 500
type: "string"
description: "КПП контрагента."
nullable: true
name:
maxLength: 500
type: "string"
description: "Наименование контрагента."
nullable: true
bankName:
maxLength: 500
type: "string"
description: "Название банка контрагента."
nullable: true
bankBic:
maxLength: 500
type: "string"
description: "БИК банка контрагента."
nullable: true
bankSwiftCode:
maxLength: 500
type: "string"
description: "SWIFT-код банка контрагента."
nullable: true
corrAccount:
maxLength: 500
type: "string"
description: "Корреспондентский счет контрагента."
nullable: true
description: "Информация о контрагенте."
cardNumber:
maxLength: 500
type: "string"
description: "Маскированный номер карты."
nullable: true
ucid:
type: "integer"
description: "UCID карты — ее уникальный идентификатор.\
\ Его можно получить через метод Получить список карт компании."
format: "int64"
nullable: true
mcc:
maxLength: 500
type: "string"
description: "МСС операции."
nullable: true
merch:
type: "object"
properties:
name:
maxLength: 500
type: "string"
description: "Название мерчанта."
nullable: true
address:
maxLength: 500
type: "string"
description: "Адрес мерчанта."
nullable: true
city:
maxLength: 500
type: "string"
description: "Место совершения (город)."
nullable: true
index:
maxLength: 500
type: "string"
description: "Почтовый индекс мерчанта."
nullable: true
country:
maxLength: 500
type: "string"
description: "Место совершения (страна)."
nullable: true
description: "Информация о мерчанте."
rrn:
maxLength: 500
type: "string"
description: "RRN (Reference Retrieval Number) — уникаль\
ный идентификатор банковской транзакции."
nullable: true
acquirerId:
maxLength: 500
type: "string"
description: "ID эквайера."
nullable: true
tax:
type: "object"
properties:
kbk:
maxLength: 500
type: "string"
description: "КБК-код бюджетной классификации."
nullable: true
oktmo:
maxLength: 500
type: "string"
description: "Код ОКТМО."
nullable: true
payerStatus:
maxLength: 500
type: "string"
description: "Статус отправителя."
nullable: true
evidence:
maxLength: 500
type: "string"
description: "Основание налогового платежа."
nullable: true
period:
maxLength: 500
type: "string"
description: "Налоговый период / Код таможенного орг\
ана."
nullable: true
nalType:
maxLength: 500
type: "string"
description: "Тип налогового документа."
nullable: true
docNumber:
maxLength: 500
type: "string"
description: "Номер налогового документа."
nullable: true
docDate:
maxLength: 500
type: "string"
description: "Дата налогового документа."
nullable: true
uin:
maxLength: 500
type: "string"
description: "Код УИН."
nullable: true
thirdPartyInn:
maxLength: 500
type: "string"
description: "ИНН налогоплательщика."
nullable: true
thirdPartyKpp:
maxLength: 500
type: "string"
description: "КПП налогоплательщика."
nullable: true
description: "Информация по налогам."
nextCursor:
maxLength: 100
type: "string"
description: "Указатель последней полученной операции, если ве\
рнулись не все операции из-за ограничения на количество."
description: "Результат получения операций для выписки."
example:
balances:
balanceBegin: 0
balanceEnd: 484.5
credit: 484.5
debit: 0
creditAuthorizations: 0
debitAuthorizations: 0
operationsCount: 1
balances:
- date: "2022-02-02"
balanceBegin: 0
balanceEnd: 484.5
credit: 484.5
debit: 0
creditAuthorizations: 0
debitAuthorizations: 0
operationsCount: 1
operations:
- operationDate: "2022-02-02T20:07:04Z"
operationId: "64be58f9-c7fc-0027-96ba-763ec56a2317"
operationStatus: "Transaction"
accountNumber: "40702810510000710417"
bic: "044525974"
typeOfOperation: "Сredit"
category: "fee"
trxnPostDate: "2021-03-29T18:37:02Z"
authorizationDate: "2021-03-29T15:29:15Z"
drawDate: "2022-02-02T20:07:04Z"
chargeDate: "2022-02-02T20:07:04Z"
docDate: "2022-02-02T20:07:04Z"
documentNumber: "175926"
payVo: "payment-order"
vo: "17"
priority: 5
operationAmount: 484.5
operationCurrencyDigitalCode: "643"
accountAmount: 484.5
accountCurrencyDigitalCode: "643"
rubleAmount: 176.54
description: "Перевод собственных средств на счет. НДС не облага\
ется"
payPurpose: "Оплата услуг по договору 17369058. НДС не облагаетс\
я"
payer:
acct: "40702810510000710417"
name: "ИП Котиков Александр Михайлович"
inn: "17499237465"
kpp: "0"
bicRu: "044525974"
bicSwift: "CHASUS33"
bankName: "АО «ТБанк»"
corAcct: "30102810945250000974"
receiver:
acct: "40702810510000710417"
name: "ИП Котиков Александр Михайлович"
inn: "17499237465"
kpp: "0"
bicRu: "044525974"
bicSwift: "CHASUS33"
bankName: "АО «ТБанк»"
corAcct: "30102810945250000974"
counterParty:
account: "40702810510000710417"
bankBic: "044525974"
bankName: "АО «ТБанк»"
bankSwiftCode: "CHASUS33"
corrAccount: "30002340500001234056"
inn: "366109554501"
kpp: "0"
name: "Межрайонная ИФНС России № 17 по Воронежской области"
cardNumber: "5534*****6400"
ucid: 1053539419
mcc: "0010"
merch:
address: "13 VOLODARSKOGO STR"
city: "MOSCOW"
index: "183038"
country: "RUS"
name: "Tinkoff.cc_trans"
rrn: "8408475"
acquirerId: "17495726"
tax:
kbk: "18210302101081013260"
oktmo: "40519000"
payerStatus: "09"
evidence: "ТП"
period: "ГД.00.2021"
nalType: "0"
docNumber: "0"
docDate: "0"
uin: "0"
thirdPartyInn: "366109554501"
thirdPartyKpp: "0"
nextCursor: "0plHq1GMtZTd39VywSrQ5C1an0tj0Q4Lo91ZPul5i0Y="
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "5fdf22eb91012189"
errorCode: "NO_EXISTING_ACCOUNT"
errorMessage: "Selected account for company not found."
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v2/chargebacks:
get:
tags:
- "Интернет-эквайринг. Диспуты"
summary: "Получить информацию о диспутах компании с ограничениями по количес\
тву"
description: "Метод для получения информации по всем диспутам компании за за\
прашиваемый период с ограничениями по количеству. Включает в себя как новы\
е диспуты, так и старые, по которым были изменения за период."
operationId: "getChargebacksV2"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "beginDate"
in: "query"
description: "Дата начала."
required: false
style: "form"
explode: true
schema:
type: "string"
format: "date"
- name: "endDate"
in: "query"
description: "Дата окончания."
required: false
style: "form"
explode: true
schema:
type: "string"
format: "date"
- name: "limit"
in: "query"
description: "Ограничение количества запрошенных диспутов. Максимальное зн\
ачение — 100."
required: false
style: "form"
explode: true
schema:
type: "integer"
format: "int64"
- name: "offset"
in: "query"
description: "Смещение количества запрошенных диспутов."
required: false
style: "form"
explode: true
schema:
type: "integer"
format: "int64"
responses:
"200":
description: "OK"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "data"
- "pageable"
type: "object"
properties:
message:
maxLength: 300
type: "string"
description: "Результат обработки запроса."
data:
maxItems: 100
type: "array"
items:
required:
- "attachments"
- "cbkAmt"
- "channel"
- "chargebackStage"
- "reasonCode"
- "status"
type: "object"
properties:
channel:
type: "string"
description: "Канал:\n- `ON-US` — карты Т-Банка;\n- `OFF-US`\
\ — карты сторонних банков."
enum:
- "ON-US"
- "OFF-US"
origTrxnDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2})$"
type: "string"
description: "Дата и время оригинальной транзакции в фор\
мате `yyyy-mm-dd'T'HH:mm:ss`."
cardNumber:
maxLength: 100
pattern: "\\*{2,}"
type: "string"
description: "Маскированный номер карты клиента."
merchantName:
maxLength: 100
type: "string"
description: "Название мерчанта."
submerchantId:
type: "integer"
description: "Идентификатор точки."
format: "int64"
trxnAmt:
type: "number"
description: "Сумма транзакции в рублях."
cbkAmt:
type: "number"
description: "Сумма оспаривания."
cbkCur:
maxLength: 100
type: "string"
description: "Валюта оспаривания."
paymentId:
maxLength: 100
type: "string"
description: "Идентификатор платежа (orderId)."
terminalId:
maxLength: 100
type: "string"
description: "Идентификатор терминала."
arn:
maxLength: 100
type: "string"
description: "ARN (Acquirer Reference Number), состоит и\
з 23 цифр."
rrn:
maxLength: 100
type: "string"
description: "Retrieval Reference Number."
reasonCode:
maxLength: 100
type: "string"
description: "Код причины оспаривания."
status:
maxLength: 100
type: "string"
description: "Статус диспута:\n- `Вернули держателю` — д\
испут проиграли и сумма вернулась физическому лицу.\n\
- `Нужен ответ` — Т-Банк требует от вас ответа на дисп\
ут: согласны с претензией или нет, а также документы,\
\ подтверждающие позицию компании в случае несогласия\
\ с диспутом.\n- `В работе` — ответ от компании получе\
н, диспут в обработке на стороне Т-Банка или стороне э\
митента.\n- `Выиграли` — диспут закрыт в пользу компан\
ии.\n- `Решение по Арбитражу` — диспут закрыт по итога\
м рассмотрения в Арбитражном комитете платежной систем\
ы. Решение ПС может быть передано по запросу."
chargebackStage:
maxLength: 100
type: "string"
description: "Стадия диспута."
retentionDate:
type: "string"
description: "Дата удержания средств с ТСП."
format: "date"
moneyTransferDate:
type: "string"
description: "Дата зачисления средств в ТСП."
format: "date"
text:
maxLength: 5000
type: "string"
description: "Текст сообщения."
deadline:
type: "string"
description: "Дата, до которой ожидаем получить ответ."
format: "date"
attachments:
maxItems: 100
type: "array"
description: "Файлы, прикрепленные к диспуту."
items:
maxLength: 100
type: "string"
description: "Ссылка на файл в data.tinkoff."
firstCbkDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2})$"
type: "string"
description: "Дата и время открытия спора в формате `yyyy-mm-dd'T'HH:mm:ss`."
description: "Информация о диспуте."
pageable:
required:
- "limit"
- "offset"
- "total"
type: "object"
properties:
message:
maxLength: 300
type: "string"
description: "Информация о пагинации."
offset:
type: "integer"
description: "Порядковый номер первого чарджбэка в списке."
format: "int32"
limit:
type: "integer"
description: "Порядковый номер последнего чарджбэка в спис\
ке."
format: "int32"
total:
type: "integer"
description: "Общее количество чарджбэков в запросе."
format: "int32"
description: "Описание параметров пагинации."
description: "Общий формат ответа"
example:
message: "OK"
data:
- channel: "ON-US"
origTrxnDate: "2023-01-31T17:25:14"
cardNumber: "553691******6876"
merchantName: "WIldberries"
submerchantId: 123456
trxnAmt: 5000.5
cbkAmt: 4000
cbkCur: "RUB"
paymentId: "klkjhgfdsdtyuio1kjh2g"
terminalId: "1234567"
arn: "12345678909876543212451"
rrn: "987654321234"
reasonCode: "4837"
status: "Нужен ответ"
chargebackStage: "Чарджбэк"
retentionDate: "2023-02-10"
moneyTransferDate: "2023-02-10"
text: "Добрый день! По указанной ниже операции поступила претенз\
ия от держателя карты. Он утверждает, что данную операцию не с\
овершал."
deadline: "2023-02-14"
attachments:
- "d7cf8082-8f8c-47a8-v80a-51aac30ba315/example.png"
- "80b5a5c0-5a48-4bb8-9f71-0ed9bf8d1955/example.pdf"
pageable:
limit: 100
offset: 0
total: 1234
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "cf92ecba-7ac9-4799-856d-eb450ce1875b"
errorMessage: "Мерчант не подключен к интернет-эквайрингу"
errorCode: "INVALID_DATA"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v2/checkout/order:
post:
tags:
- "Корзина. Работа с заказом"
summary: "Создать заказ для клиента-физического лица"
description: " Метод для создания заказа в системе Корзина."
operationId: "postApiV2Orders"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
content:
application/json:
schema:
required:
- "orderId"
- "orderItems"
- "shopId"
- "taxation"
type: "object"
properties:
shopId:
type: "string"
description: "Уникальный идентификатор магазина в системе Корзин\
а от Т-Банка. Выдается продавцу специалистом Т-Банка во время\
\ интеграции."
format: "uuid"
amount:
type: "number"
description: "Устаревшее — используйте `itemsAmount`.\nСумма зак\
аза в копейках с учетом доставки. Обязательное поле, если не у\
казано значение `itemsAmount`."
deprecated: true
itemsAmount:
type: "number"
description: "Сумма заказа в копейках без учета доставки. Наприм\
ер, 3 рубля 12 копеек — 312 копеек. Параметр должен быть равен\
\ сумме всех параметров `amount`, переданных в объекте `orderItems`.\n\
\nМинимальная сумма операции через СБП — 10 рублей."
orderId:
maxLength: 36
type: "string"
description: "Идентификатор заказа в системе магазина."
taxation:
type: "string"
description: "Система налогообложения, по которой работает прода\
вец:\n\n* `osn` — общая.\n* `usn_income` — упрощенная (доходы\
).\n* `usn_income_outcome` — упрощенная (доходы минус расходы\
).\n* `patent` — патентная.\n* `envd` — единый налог на вменен\
ный доход.\n* `esn` — единый сельскохозяйственный налог.\n* `self`\
\ — НПД. В этом случае информация о чеке не отправляется в Инт\
ернет-эквайринг."
enum:
- "osn"
- "usn_income"
- "usn_income_outcome"
- "patent"
- "envd"
- "esn"
- "self"
description:
maxLength: 250
type: "string"
description: "Описание заказа."
customerKey:
maxLength: 128
type: "string"
description: "Идентификатор покупателя в системе магазина."
successPageUrl:
maxLength: 1000
type: "string"
description: "URL для редиректа на страницу магазина после успеш\
ной оплаты покупателем."
format: "url"
isForceRedirect:
type: "boolean"
description: "Флаг для принудительного редиректа на страницу усп\
еха магазина после выполнения оплаты покупателем:\n\n* `true`\
\ — покупатель сразу перенаправляется на страницу успеха магаз\
ина, которая указана в `successPageUrl`;\n* `false` — покупате\
ль перенаправляется на страницу успеха Корзины от Т-Банка."
shoppingCartPageUrl:
maxLength: 1000
type: "string"
description: "URL для редиректа на страницу магазина с товарной\
\ корзиной."
format: "url"
deliveryPayment:
maxItems: 1000
type: "array"
description: "Массив для переопределения способов доставки и опл\
аты заказа. Настройки по умолчанию указываются при выпуске уни\
кального идентификатора магазина."
items:
required:
- "deliveryKind"
type: "object"
properties:
deliveryKind:
type: "string"
description: "Способ доставки, доступный для заказа. Досту\
пны три группы:\n\n1. `disabled` — доставка не поддержив\
ается.\n2. `by_merchant` — доставка средствами продавца\
.\n3. Доставка с помощью сервиса MetaShip:\n\n* `courier`\
\ — доставка курьерской службой;\n* `post_office` — дост\
авка в почтовое отделение;\n* `delivery_point` — доставк\
а в пункт выдачи заказов;\n* `merchant_delivery_point` —\
\ доставка в пункт выдачи заказов продавца.\n\nПри оформ\
лении заказа можно выбирать значения в рамках одной груп\
пы. Например, заказ может быть создан только способом `by_merchant`\
\ или только с типами, которые относятся к третьей групп\
е."
enum:
- "disabled"
- "by_merchant"
- "courier"
- "post_office"
- "delivery_point"
- "merchant_delivery_point"
paymentTypes:
maxItems: 4
type: "array"
description: "Способы оплаты, доступные для покупателя при\
\ использовании способа доставки, который указан в парам\
етре `deliveryKind`:\n\n* `card` — оплата банковской кар\
той;\n* `sbp` — оплата через СБП;\n* `on_delivery` — опл\
ата при получении;\n* `dolyame` — оплата частями через с\
ервис Долями."
items:
type: "string"
description: "Способы оплаты, доступные при использовани\
и указанного способа доставки:\n\n* `card` — платеж с\
\ использованием кредитной или дебетовой карты;\n* `sbp`\
\ — оплата прямым денежным переводом по технологии СБП\
;\n* `on_delivery` — оплата заказа при получении доста\
вки;\n* `dolyame` — оплата заказа с использованием сер\
виса «Долями»."
enum:
- "card"
- "sbp"
- "on_delivery"
- "dolyame"
description: "Элемент матрицы, переопределяющей доступные спос\
обы доставки и оплаты для заказа."
orderItems:
maxItems: 4000
type: "array"
items:
required:
- "amount"
- "name"
- "price"
- "quantity"
- "tax"
type: "object"
properties:
name:
type: "string"
description: "Наименование товара."
quantity:
type: "number"
description: "Количество товара."
amount:
type: "number"
description: "Суммарная стоимость товара в копейках. Рассч\
итывается как `price * quantity`."
price:
type: "number"
description: "Стоимость одного товара в копейках."
description:
maxLength: 250
type: "string"
description: "Описание товара. Отображается в интерфейсе К\
орзины от Т-Банка."
tax:
type: "string"
description: "Cтавка НДС:\n\n* `none` — без НДС;\n* `vat0`\
\ — 0%;\n* `vat10` — 10%;\n* `vat20` — 20%;\n* `vat110`\
\ — 10/110;\n* `vat118` — 18/118, устаревшее;\n* `vat120`\
\ — 20/120."
enum:
- "none"
- "vat0"
- "vat10"
- "vat20"
- "vat110"
- "vat118"
- "vat120"
excise:
type: "number"
description: "Cумма акциза."
paymentMethod:
type: "string"
description: "Способ расчета заказа:\n\n* `full_payment` —\
\ полный расчет;\n* `full_prepayment` — 100% предоплата\
;\n* `prepayment` — предоплата;\n* `advance` — аванс;\n\
* `partial_payment` — частичный расчет и кредит;\n* `credit`\
\ — передача в кредит;\n* `credit_payment` — оплата кред\
ита.\n\nЕсли значение не передано, по умолчанию в онлайн\
-кассу передается способ `full_payment`.\n\nПоле обязате\
льное, если продавец работает с ФФД 1.2. "
enum:
- "full_payment"
- "full_prepayment"
- "prepayment"
- "advance"
- "partial_payment"
- "credit"
- "credit_payment"
paymentObject:
type: "string"
description: "Категория предмета расчета — товара или услу\
ги:\n\n * `commodity` — товар;\n* `excise` — подакцизный\
\ товар;\n* `job` — работа; \n* `service` — услуга;\n* `gambling_bet`\
\ — ставка азартной игры; \n* `gambling_prize` — выигрыш\
\ азартной игры; \n * `lottery` — лотерейный билет; \n*\
\ `gambling_prize` — выигрыш азартной игры; \n* `lottery_prize`\
\ — выигрыш лотереи; \n* `intellectual_activity` — предо\
ставление результатов интеллектуальной деятельности; \n\
* `payment` — платеж; \n* `agent_commission` — агентское\
\ вознаграждение; \n* `contribution` — составной предмет\
\ расчета; \n* `property_rights` — имущественное право;\
\ \n* `unrealization` — внереализационный доход; \n* `tax_reduction`\
\ — иные платежи и взносы; \n* `trade_fee` — торговый сб\
ор; \n* `resort_tax` — курортный сбор; \n* `pledge` — за\
лог; \n* `income_decrease` — расход; \n* `ie_pension_insurance_without_payments`\
\ — взносы на ОПС ИП; \n* `ie_pension_insurance_with_payments`\
\ — взносы на ОПС; \n* `ie_medical_insurance_without_payments`\
\ — взносы на ОМС ИП; \n* `ie_medical_insurance_with_payments`\
\ — взносы на ОМС; \n* `social_insurance` — взносы на ОС\
С; \n* `casino_chips` — платеж казино; \n* `agent_payment`\
\ — выдача ДС; \n* `excisable_goods_without_marking_code`\
\ — АТНМ; \n* `excisable_goods_with_marking_code` — АТМ\
; \n* `goods_without_marking_code` — ТНМ; \n* `goods_with_marking_code`\
\ — ТМ; \n* `another` — иной предмет расчета."
enum:
- "commodity"
- "excise"
- "job"
- "service"
- "gambling_bet"
- "gambling_prize"
- "lottery"
- "lottery_prize"
- "intellectual_activity"
- "payment"
- "agent_commission"
- "contribution"
- "property_rights"
- "unrealization"
- "tax_reduction"
- "trade_fee"
- "resort_tax"
- "pledge"
- "income_decrease"
- "ie_pension_insurance_without_payments"
- "ie_pension_insurance_with_payments"
- "ie_medical_insurance_without_payments"
- "ie_medical_insurance_with_payments"
- "social_insurance"
- "casino_chips"
- "agent_payment"
- "excisable_goods_without_marking_code"
- "excisable_goods_with_marking_code"
- "goods_without_marking_code"
- "goods_with_marking_code"
- "another"
countryCode:
maxLength: 3
type: "string"
description: "Код страны."
declarationNumber:
type: "string"
description: "Номер декларации."
measurementUnit:
type: "string"
description: "Единица измерения товара."
markCode:
type: "object"
properties:
markCodeType:
type: "string"
description: "Тип штрихкода:\n\n* `ean8` — код товара\
\ в формате EAN-8;\n* `ean13` — код товара в формате\
\ EAN-13;\n* `itf14` — код товара в формате ITF-14;\n\
* `gs10` — код товара в формате GS1, нанесенный на т\
овар, не подлежащий маркировке;\n* `gs1m` — код това\
ра в формате GS1, нанесенный на товар, подлежащий ма\
ркировке;\n* `short` — код товара в формате коротког\
о кода маркировки, нанесенный на товар;\n* `fur` — к\
онтрольно-идентификационный знак мехового изделия;\n\
* `egais20` — код товара в формате ЕГАИС-2.0;\n* `egais30`\
\ — код товара в формате ЕГАИС-3.0;\n* `rawcode` — к\
од маркировки, как он был прочитан сканером. "
enum:
- "ean8"
- "ean13"
- "itf14"
- "gs10"
- "gs1m"
- "short"
- "fur"
- "egais20"
- "egais30"
- "rawcode"
value:
type: "string"
description: "Значение."
description: "Код маркировки в машиночитаемой форме. Форми\
руется в соответствии с определенными требованиями и исп\
ользуется для маркировки потребительской упаковки, товар\
ов или товарных ярлыков."
markQuantity:
type: "object"
properties:
numerator:
type: "number"
description: "Числитель дробной части предмета расчета\
. Значение должно быть строго меньше значения реквиз\
ита Знаменатель
."
denominator:
type: "number"
description: "Знаменатель дробной части предмета расче\
та. Значение равно количеству товара в партии (упако\
вке) c общим кодом маркировки товара."
description: "Параметр для обозначения дробного количества\
\ маркированного товара."
article:
maxLength: 250
type: "string"
description: "Артикул товара. Обязательное поле при работе\
\ со службами доставки — способы доставки `courier`, `post_office`,\
\ `delivery_point`, `merchant_delivery_point`."
weight:
maximum: 1000
exclusiveMaximum: true
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Вес одной единицы товара. Общий вес позиции\
\ равен count * weight
в кг. Обязательное п\
оле при работе со службами доставки — способы доставки `courier`,\
\ `post_office`, `delivery_point`, `merchant_delivery_point`."
format: "double"
declaredValue:
type: "integer"
description: "Объявленная ценность в копейках. Обязательно\
е поле при работе со службами доставки — способы доставк\
и `courier`, `post_office`, `delivery_point`, `merchant_delivery_point`."
format: "int32"
externalProductId:
maxLength: 256
type: "string"
description: "Идентификатор товара в системе продавца."
description: "Модель создания товара."
deliveryCondition:
required:
- "tax"
type: "object"
properties:
price:
type: "number"
description: "Цена товара в копейках. Только для способа дос\
тавки `by_merchant`."
tax:
type: "string"
description: "Cтавка НДС:\n\n* `none` — без НДС;\n* `vat0` —\
\ 0%;\n* `vat10` — 10%;\n* `vat20` — 20%;\n* `vat110` — 10/110;\n\
* `vat118` — 18/118, устаревшее;\n* `vat120` — 20/120."
enum:
- "none"
- "vat0"
- "vat10"
- "vat20"
- "vat110"
- "vat118"
- "vat120"
shippingParameters:
required:
- "height"
- "length"
- "weight"
- "width"
type: "object"
properties:
metashipShopId:
type: "string"
description: "ID магазина в системе MetaShip."
format: "uuid"
metashipWarehouseId:
type: "string"
description: "ID склада в системе MetaShip."
format: "uuid"
types:
type: "array"
description: "Устаревшее — используйте `deliveryPayment`\
\ и `deliveryKind`.\n\nТип доставки:\n\n* Courier
\
\ — курьерская доставка;\n* PostOffice
—\
\ почтовое отправление;\n* DeliveryPoint
\
\ — ПВЗ."
deprecated: true
items:
type: "string"
services:
type: "array"
description: "Дополнительные услуги служб доставки."
items:
required:
- "service"
type: "object"
properties:
service:
type: "string"
description: "Дополнительные услуги служб доставки\
: \n\n* `barcode-generation` — генерация штрихко\
да на стороне MetaShip: YandexDelivery и DPD.\n\
* `dress-fitting` — есть примерка: CDEK и DPD.\n\
* `crate` — обрешетка (защитный каркас) груза: DPD.\n\
* `fragile` — хрупкое: Почта России.\n* `sms` —\
\ SMS-информирование: DPD, Почта России и CDEK.\n\
* `shelf-life-days` — срок хранения заказа в ОПС\
. Можно указать количество дней в `value int`."
value:
type: "string"
description: "Срок хранения заказа — количество дн\
ей."
weight:
maximum: 1000
exclusiveMaximum: true
minimum: 0
exclusiveMinimum: true
type: "number"
description: " Вес товара в килограммах."
format: "double"
height:
maximum: 1000
minimum: 1
type: "integer"
description: "Высота товара в сантиметрах."
format: "int32"
width:
maximum: 1000
minimum: 1
type: "integer"
description: "Ширина товара в сантиметрах."
format: "int32"
length:
maximum: 1000
minimum: 1
type: "integer"
description: "Длина товара в сантиметрах."
format: "int32"
declaredValue:
minimum: 0
type: "number"
description: "Объявленная ценность в копейках. Обязатель\
ное поле при работе со службами доставки — способы дос\
тавки `courier`, `post_office`, `delivery_point`, `merchant_delivery_point`."
format: "double"
description: "Параметры доставки."
freeDelivery:
type: "object"
properties:
postOffice:
type: "object"
properties:
deliveryPriceBefore:
type: "number"
description: "Доставка бесплатная, если цена доставк\
и меньше или равна этому числу."
checkoutPriceAfter:
type: "number"
description: "Доставка бесплатная, если сумма корзин\
ы больше или равна этому числу."
description: "Почтовое отделение."
courier:
type: "object"
properties:
deliveryPriceBefore:
type: "number"
description: "Доставка бесплатная, если цена доставк\
и меньше или равна этому числу."
checkoutPriceAfter:
type: "number"
description: "Доставка бесплатная, если сумма корзин\
ы больше или равна этому числу."
description: "Курьер."
deliveryPoint:
type: "object"
properties:
deliveryPriceBefore:
type: "number"
description: "Доставка бесплатная, если цена доставк\
и меньше или равна этому числу."
checkoutPriceAfter:
type: "number"
description: "Доставка бесплатная, если сумма корзин\
ы больше или равна этому числу."
description: "Пункт выдачи заказов."
description: "Параметр устарел, используйте файл настройки д\
оставок. Параметры бесплатной доставки."
deprecated: true
description: "Объект условий доставки."
discountInfo:
type: "object"
properties:
promoCodeId:
maxLength: 256
type: "string"
description: "Идентификатор промокода."
discountAmount:
type: "number"
description: "Суммарная скидка заказа в копейках. Целое поло\
жительное число."
description: "Информация о скидке. Параметр нужен для отображени\
я скидки в интерфейсе Корзины от Т-Банка. Заказ передается с у\
четом всех скидок."
description: "Модель запроса на создание заказа."
example:
shopId: "d666b39e-8bfb-4273-b794-01d5aaf8226e"
orderId: "12345"
taxation: "osn"
itemsAmount: 10000
description: "описание заказа в произвольной форме"
customerKey: "unique-customer-key-123"
successPageUrl: "https://shop.com/success"
shoppingCartPageUrl: "https://merchant.com/cart"
isForceRedirect: false
orderItems:
- name: "Чемодан"
quantity: 1000
amount: 10000
price: 10
description: "Большой чемодан"
tax: "vat20"
paymentObject: "commodity"
paymentMethod: "full_prepayment"
article: "артикул товара"
declaredValue: 100
weight: 3.213
deliveryCondition:
tax: "vat20"
shippingParameters:
services:
- service: "sms"
- service: "dress-fitting"
- service: "shelf-life-days"
value: "10"
weight: 5.213
length: 80
width: 50
height: 100
deliveryPayment:
- deliveryKind: "disabled"
paymentTypes:
- "card"
required: true
responses:
"201":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "checkoutOrderId"
- "orderId"
- "url"
type: "object"
properties:
checkoutOrderId:
type: "string"
description: "Идентификатор заказа в системе Корзина."
format: "uuid"
url:
type: "string"
description: "Ссылка на виджет Корзины с содержимым заказа."
format: "url"
orderId:
maxLength: 36
type: "string"
description: "Идентификатор заказа в системе магазина."
example:
checkoutOrderId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
url: "https://checkout.tbank.ru/dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
orderId: "order#123"
"400":
description: "Ошибка при создании заказа"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "retw6789"
errorMessage: "Не удалось создать заказ"
errorCode: "NOT_CREATED"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "retw6789"
errorMessage: "Некорректные данные для создания заказа"
errorCode: "NOT_CREATED"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/checkout/order/{shopId}/by/{orderId}:
get:
tags:
- "Корзина. Работа с заказом"
summary: "Получить информацию о заказе клиента-физического лица"
description: " Метод для получения информации о заказе: товары, стоимость, о\
писания.\n\n{shopId}
— идентификатор магазина в системе Корзи\
на, {orderId}
— идентификатор заказа в системе магазина. "
operationId: "getApiV2OrdersShopIdOrderId"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "orderId"
in: "path"
required: true
style: "simple"
explode: false
schema:
maxLength: 36
type: "string"
description: "Идентификатор заказа в системе магазина."
format: "string"
- name: "shopId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор магазина в системе Корзина от Т-Б\
анка. Выдается продавцу специалистом Т-Банка во время интеграции."
format: "uuid"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "order"
type: "object"
properties:
order:
required:
- "amount"
- "checkoutOrderId"
- "deliveryPayment"
- "itemsAmount"
- "orderId"
- "orderItems"
- "shopId"
- "taxation"
- "timestamp"
type: "object"
properties:
checkoutOrderId:
type: "string"
description: "Идентификатор заказа в системе Корзина."
format: "uuid"
shopId:
type: "string"
description: "Уникальный идентификатор магазина в системе\
\ Корзина от Т-Банка. Выдается продавцу специалистом Т-Б\
анка во время интеграции."
format: "uuid"
amount:
type: "number"
description: "Устаревшее — используйте `itemsAmount`.\nСум\
ма заказа в копейках с учетом доставки."
deprecated: true
itemsAmount:
type: "number"
description: "Сумма заказа в копейках без учета доставки.\
\ Например, 3 рубля 12 копеек — 312 копеек. Параметр дол\
жен быть равен сумме всех параметров `amount`, переданны\
х в объекте `orderItems`.\n\nМинимальная сумма операции\
\ через СБП — 10 рублей."
paidAmount:
type: "number"
description: "Сумма, которую уже оплатил плательщик."
amountToPay:
type: "number"
description: "Сумма, которую плательщик еще должен оплатит\
ь."
orderId:
maxLength: 36
type: "string"
taxation:
type: "string"
description: "Система налогообложения, по которой работает\
\ продавец:\n\n* `osn` — общая.\n* `usn_income` — упроще\
нная (доходы).\n* `usn_income_outcome` — упрощенная (дох\
оды минус расходы).\n* `patent` — патентная.\n* `envd` —\
\ единый налог на вмененный доход.\n* `esn` — единый сел\
ьскохозяйственный налог.\n* `self` — НПД. В этом случае\
\ информация о чеке не отправляется в Интернет-эквайринг\
."
enum:
- "osn"
- "usn_income"
- "usn_income_outcome"
- "patent"
- "envd"
- "esn"
- "self"
description:
maxLength: 250
type: "string"
description: "Описание заказа в произвольной форме — оно б\
удет отображаться в квитанции, которая присылается покуп\
ателю в письме."
customerKey:
maxLength: 128
type: "string"
description: "Идентификатор покупателя в системе магазина."
timestamp:
type: "string"
description: "Дата и время создания заказа."
format: "date-time"
successPageUrl:
maxLength: 1000
type: "string"
description: "URL для редиректа на страницу магазина после\
\ успешной оплаты покупателем."
format: "url"
isForceRedirect:
type: "boolean"
description: "Флаг для принудительного редиректа на страни\
цу успеха магазина после выполнения оплаты покупателем:\n\
\n* `true` — покупатель сразу перенаправляется на страни\
цу успеха магазина, которая указана в `successPageUrl`;\n\
* `false` — покупатель перенаправляется на страницу успе\
ха Корзины от Т-Банка."
shoppingCartPageUrl:
maxLength: 1000
type: "string"
description: "URL для редиректа на страницу магазина с тов\
арной корзиной."
format: "url"
comment:
maxLength: 1000
type: "string"
description: "Комментарий к заказу."
deliveryPayment:
maxItems: 1000
type: "array"
description: "Массив для переопределения способов доставки\
\ и оплаты заказа. Настройки по умолчанию указываются пр\
и выпуске уникального идентификатора магазина."
items:
required:
- "deliveryKind"
type: "object"
properties:
deliveryKind:
type: "string"
description: "Способ доставки, доступный для заказа\
. Доступны три группы:\n\n1. `disabled` — доставка\
\ не поддерживается.\n2. `by_merchant` — доставка\
\ средствами продавца.\n3. Доставка с помощью серв\
иса MetaShip:\n\n* `courier` — доставка курьерской\
\ службой;\n* `post_office` — доставка в почтовое\
\ отделение;\n* `delivery_point` — доставка в пунк\
т выдачи заказов;\n* `merchant_delivery_point` — д\
оставка в пункт выдачи заказов продавца.\n\nПри оф\
ормлении заказа можно выбирать значения в рамках о\
дной группы. Например, заказ может быть создан тол\
ько способом `by_merchant` или только с типами, ко\
торые относятся к третьей группе."
enum:
- "disabled"
- "by_merchant"
- "courier"
- "post_office"
- "delivery_point"
- "merchant_delivery_point"
paymentTypes:
maxItems: 4
type: "array"
description: "Способы оплаты, доступные для покупате\
ля при использовании способа доставки, который ука\
зан в параметре `deliveryKind`:\n\n* `card` — опла\
та банковской картой;\n* `sbp` — оплата через СБП\
;\n* `on_delivery` — оплата при получении;\n* `dolyame`\
\ — оплата частями через сервис Долями."
items:
type: "string"
description: "Способы оплаты, доступные при исполь\
зовании указанного способа доставки:\n\n* `card`\
\ — платеж с использованием кредитной или дебето\
вой карты;\n* `sbp` — оплата прямым денежным пер\
еводом по технологии СБП;\n* `on_delivery` — опл\
ата заказа при получении доставки;\n* `dolyame`\
\ — оплата заказа с использованием сервиса «Доля\
ми»."
enum:
- "card"
- "sbp"
- "on_delivery"
- "dolyame"
description: "Элемент матрицы, переопределяющей доступны\
е способы доставки и оплаты для заказа."
paymentType:
type: "string"
description: "Использованный при оформлении заказа способ\
\ оплаты:\n* `internet_acquiring` — оплата через интерне\
т-эквайринг; \n* `payment_on_delivery` — оплата заказа п\
ри получении доставки; \n* `dolyame` — оплата заказа c и\
спользованием сервиса «Долями»."
enum:
- "internet_acquiring"
- "payment_on_delivery"
- "dolyame"
statuses:
maxItems: 1000
type: "array"
items:
required:
- "name"
- "timestamp"
type: "object"
properties:
name:
maxLength: 50
type: "string"
description: "Наименование статуса."
timestamp:
type: "string"
description: "Дата и время статуса."
format: "date-time"
description: "Статус заказа."
recipient:
required:
- "email"
- "firstName"
- "lastName"
- "phone"
type: "object"
properties:
firstName:
maxLength: 35
type: "string"
description: "Имя получателя."
lastName:
maxLength: 35
type: "string"
description: "Фамилия получателя."
phone:
pattern: "^\\+?[0-9]{3}[0-9]{3}[0-9]{4,6}$"
type: "string"
description: "Телефон получателя."
email:
maxLength: 254
type: "string"
description: "Почта получателя."
description: "Получатель заказа."
user:
required:
- "id"
type: "object"
properties:
id:
type: "string"
description: "Идентификатор покупателя в системе Корзи\
на."
format: "uuid"
firstName:
maxLength: 35
type: "string"
description: "Имя покупателя."
lastName:
maxLength: 35
type: "string"
description: "Фамилия покупателя."
phone:
maxLength: 16
type: "string"
description: "Номер телефона покупателя."
email:
maxLength: 254
type: "string"
description: "Адрес электронной почты покупателя."
description: "Информация о покупателе."
delivery:
required:
- "address"
type: "object"
properties:
address:
maxLength: 250
type: "string"
description: "Адрес доставки."
flat:
maxLength: 8
type: "string"
description: "Квартира."
flatCode:
maxLength: 12
type: "string"
description: "Код домофона."
floor:
maxLength: 8
type: "string"
description: "Этаж."
entrance:
maxLength: 8
type: "string"
description: "Подъезд."
comment:
maxLength: 1000
type: "string"
description: "Комментарий для курьера."
deliveryId:
maxLength: 100
type: "string"
description: "Код созданной заявки в системе доставки\
. При самовывозе из магазина принимает значение N/A
."
trackingNumber:
maxLength: 100
type: "string"
description: "Трек-номер от службы доставки."
deliveryType:
maxLength: 30
type: "string"
description: "Тип доставки:\n\n* Courier
\
\ — курьерская доставка;\n* PostOffice
\
\ — почтовое отправление;\n* DeliveryPoint
\
\ — ПВЗ, постамат;\n* Самовывоз из магазина
\
\ — самовывоз из магазина."
deliveryService:
maxLength: 30
type: "string"
description: "Код выбранной службы доставки. При самов\
ывозе из магазина принимает значение Самовывоз\
\ из магазина
."
errorMessage:
maxLength: 250
type: "string"
description: "Текстовая ошибка от службы доставки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке в произв\
ольной форме."
deliveryCondition:
required:
- "price"
- "tax"
type: "object"
properties:
price:
type: "number"
description: "Устаревшее — используйте `priceByMerchant`,\
\ `priceByDeliveryService`, `pricePaid` или `priceToPay`.\n\
\nЦена позиции в копейках."
priceByMerchant:
type: "number"
description: "Цена доставки в копейках, установлен\
ная мерчантом."
priceByDeliveryService:
type: "number"
description: "Цена доставки в копейках, полученная\
\ от службы доставки."
pricePaid:
type: "number"
description: "Цена доставки в копейках, которую фа\
ктически оплатил покупатель."
priceToPay:
type: "number"
description: "Цена доставки в копейках, которую по\
купатель еще должен оплатить."
tax:
type: "string"
description: "Cтавка НДС:\n\n* `none` — без НДС;\n\
* `vat0` — 0%;\n* `vat10` — 10%;\n* `vat20` — 20%;\n\
* `vat110` — 10/110;\n* `vat118` — 18/118, устар\
евшее;\n* `vat120` — 20/120."
enum:
- "none"
- "vat0"
- "vat10"
- "vat20"
- "vat110"
- "vat118"
- "vat120"
shippingParameters:
required:
- "height"
- "length"
- "weight"
- "width"
type: "object"
properties:
metashipShopId:
type: "string"
description: "ID магазина в системе MetaShip."
format: "uuid"
metashipWarehouseId:
type: "string"
description: "ID склада в системе MetaShip."
format: "uuid"
types:
type: "array"
description: "Устаревшее — используйте `deliveryPayment`\
\ и `deliveryKind`.\n\nТип доставки:\n\n* Courier
\
\ — курьерская доставка;\n* PostOffice
\
\ — почтовое отправление;\n* DeliveryPoint
\
\ — ПВЗ."
deprecated: true
items:
type: "string"
services:
type: "array"
description: "Дополнительные услуги служб дост\
авки."
items:
required:
- "service"
type: "object"
properties:
service:
type: "string"
description: "Дополнительные услуги служ\
б доставки: \n\n* `barcode-generation`\
\ — генерация штрихкода на стороне MetaShip:\
\ YandexDelivery и DPD.\n* `dress-fitting`\
\ — есть примерка: CDEK и DPD.\n* `crate`\
\ — обрешетка (защитный каркас) груза\
: DPD.\n* `fragile` — хрупкое: Почта Р\
оссии.\n* `sms` — SMS-информирование:\
\ DPD, Почта России и CDEK.\n* `shelf-life-days`\
\ — срок хранения заказа в ОПС. Можно\
\ указать количество дней в `value int`."
value:
type: "string"
description: "Срок хранения заказа — кол\
ичество дней."
weight:
maximum: 1000
exclusiveMaximum: true
minimum: 0
exclusiveMinimum: true
type: "number"
description: " Вес товара в килограммах."
format: "double"
height:
maximum: 1000
minimum: 1
type: "integer"
description: "Высота товара в сантиметрах."
format: "int32"
width:
maximum: 1000
minimum: 1
type: "integer"
description: "Ширина товара в сантиметрах."
format: "int32"
length:
maximum: 1000
minimum: 1
type: "integer"
description: "Длина товара в сантиметрах."
format: "int32"
declaredValue:
minimum: 0
type: "number"
description: "Объявленная ценность в копейках\
. Обязательное поле при работе со службами д\
оставки — способы доставки `courier`, `post_office`,\
\ `delivery_point`, `merchant_delivery_point`."
format: "double"
description: "Параметры доставки."
description: "Объект условий доставки."
description: "Информация о доставке."
discountInfo:
type: "object"
properties:
promoCodeId:
maxLength: 256
type: "string"
description: "Идентификатор промокода."
discountAmount:
type: "number"
description: "Суммарная скидка заказа в копейках. Цело\
е положительное число."
description: "Информация о скидке. Параметр нужен для отоб\
ражения скидки в интерфейсе Корзины от Т-Банка. Заказ пе\
редается с учетом всех скидок."
orderItems:
maxItems: 4000
type: "array"
items:
required:
- "amount"
- "id"
- "name"
- "price"
- "quantity"
- "tax"
type: "object"
properties:
id:
type: "string"
description: "Идентификатор товара в системе Корзина\
."
format: "uuid"
name:
maxLength: 250
type: "string"
description: "Наименование товара."
quantity:
type: "number"
description: "Количество товара."
amount:
type: "number"
description: "Суммарная стоимость товара в копейках\
. Рассчитывается как `price * quantity`."
price:
type: "number"
description: "Стоимость одного товара в копейках."
description:
maxLength: 250
type: "string"
description: "Описание товара. Отображается в интерф\
ейсе Корзины от Т-Банка."
tax:
type: "string"
description: "Cтавка НДС:\n\n* `none` — без НДС;\n*\
\ `vat0` — 0%;\n* `vat10` — 10%;\n* `vat20` — 20%;\n\
* `vat110` — 10/110;\n* `vat118` — 18/118, устарев\
шее;\n* `vat120` — 20/120."
enum:
- "none"
- "vat0"
- "vat10"
- "vat20"
- "vat110"
- "vat118"
- "vat120"
excise:
type: "number"
description: "Cумма акциза."
paymentMethod:
type: "string"
description: "Способ расчета заказа:\n\n* `full_payment`\
\ — полный расчет;\n* `full_prepayment` — 100% пре\
доплата;\n* `prepayment` — предоплата;\n* `advance`\
\ — аванс;\n* `partial_payment` — частичный расчет\
\ и кредит;\n* `credit` — передача в кредит;\n* `credit_payment`\
\ — оплата кредита.\n\nЕсли значение не передано,\
\ по умолчанию в онлайн-кассу передается способ `full_payment`.\n\
\nПоле обязательное, если продавец работает с ФФД\
\ 1.2. "
enum:
- "full_payment"
- "full_prepayment"
- "prepayment"
- "advance"
- "partial_payment"
- "credit"
- "credit_payment"
paymentObject:
type: "string"
description: "Категория предмета расчета — товара ил\
и услуги:\n\n * `commodity` — товар;\n* `excise` —\
\ подакцизный товар;\n* `job` — работа; \n* `service`\
\ — услуга;\n* `gambling_bet` — ставка азартной иг\
ры; \n* `gambling_prize` — выигрыш азартной игры;\
\ \n * `lottery` — лотерейный билет; \n* `gambling_prize`\
\ — выигрыш азартной игры; \n* `lottery_prize` — в\
ыигрыш лотереи; \n* `intellectual_activity` — пред\
оставление результатов интеллектуальной деятельнос\
ти; \n* `payment` — платеж; \n* `agent_commission`\
\ — агентское вознаграждение; \n* `contribution` —\
\ составной предмет расчета; \n* `property_rights`\
\ — имущественное право; \n* `unrealization` — вне\
реализационный доход; \n* `tax_reduction` — иные п\
латежи и взносы; \n* `trade_fee` — торговый сбор;\
\ \n* `resort_tax` — курортный сбор; \n* `pledge`\
\ — залог; \n* `income_decrease` — расход; \n* `ie_pension_insurance_without_payments`\
\ — взносы на ОПС ИП; \n* `ie_pension_insurance_with_payments`\
\ — взносы на ОПС; \n* `ie_medical_insurance_without_payments`\
\ — взносы на ОМС ИП; \n* `ie_medical_insurance_with_payments`\
\ — взносы на ОМС; \n* `social_insurance` — взносы\
\ на ОСС; \n* `casino_chips` — платеж казино; \n*\
\ `agent_payment` — выдача ДС; \n* `excisable_goods_without_marking_code`\
\ — АТНМ; \n* `excisable_goods_with_marking_code`\
\ — АТМ; \n* `goods_without_marking_code` — ТНМ; \n\
* `goods_with_marking_code` — ТМ; \n* `another` —\
\ иной предмет расчета."
enum:
- "commodity"
- "excise"
- "job"
- "service"
- "gambling_bet"
- "gambling_prize"
- "lottery"
- "lottery_prize"
- "intellectual_activity"
- "payment"
- "agent_commission"
- "contribution"
- "property_rights"
- "unrealization"
- "tax_reduction"
- "trade_fee"
- "resort_tax"
- "pledge"
- "income_decrease"
- "ie_pension_insurance_without_payments"
- "ie_pension_insurance_with_payments"
- "ie_medical_insurance_without_payments"
- "ie_medical_insurance_with_payments"
- "social_insurance"
- "casino_chips"
- "agent_payment"
- "excisable_goods_without_marking_code"
- "excisable_goods_with_marking_code"
- "goods_without_marking_code"
- "goods_with_marking_code"
- "another"
countryCode:
maxLength: 3
type: "string"
description: "Код страны."
declarationNumber:
maxLength: 36
type: "string"
description: "Номер декларации."
measurementUnit:
maxLength: 36
type: "string"
description: "Единица измерения товара."
markCode:
type: "object"
properties:
markCodeType:
type: "string"
description: "Тип штрихкода:\n\n* `ean8` — код т\
овара в формате EAN-8;\n* `ean13` — код товара\
\ в формате EAN-13;\n* `itf14` — код товара в\
\ формате ITF-14;\n* `gs10` — код товара в фор\
мате GS1, нанесенный на товар, не подлежащий м\
аркировке;\n* `gs1m` — код товара в формате GS1,\
\ нанесенный на товар, подлежащий маркировке;\n\
* `short` — код товара в формате короткого код\
а маркировки, нанесенный на товар;\n* `fur` —\
\ контрольно-идентификационный знак мехового и\
зделия;\n* `egais20` — код товара в формате ЕГ\
АИС-2.0;\n* `egais30` — код товара в формате Е\
ГАИС-3.0;\n* `rawcode` — код маркировки, как о\
н был прочитан сканером. "
enum:
- "ean8"
- "ean13"
- "itf14"
- "gs10"
- "gs1m"
- "short"
- "fur"
- "egais20"
- "egais30"
- "rawcode"
value:
type: "string"
description: "Значение."
description: "Код маркировки в машиночитаемой форме\
. Формируется в соответствии с определенными требо\
ваниями и используется для маркировки потребительс\
кой упаковки, товаров или товарных ярлыков."
markQuantity:
type: "object"
properties:
numerator:
type: "number"
description: "Числитель дробной части предмета р\
асчета. Значение должно быть строго меньше зна\
чения реквизита Знаменатель
."
denominator:
type: "number"
description: "Знаменатель дробной части предмета\
\ расчета. Значение равно количеству товара в\
\ партии (упаковке) c общим кодом маркировки т\
овара."
description: "Параметр для обозначения дробного коли\
чества маркированного товара."
article:
maxLength: 250
type: "string"
description: "Артикул товара. Обязательное поле при\
\ работе со службами доставки — способы доставки `courier`,\
\ `post_office`, `delivery_point`, `merchant_delivery_point`."
weight:
maximum: 1000
exclusiveMaximum: true
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Вес одной единицы товара. Общий вес по\
зиции равен count * weight
в кг. Обяз\
ательное поле при работе со службами доставки — сп\
особы доставки `courier`, `post_office`, `delivery_point`,\
\ `merchant_delivery_point`."
format: "double"
declaredValue:
type: "number"
description: "Объявленная ценность в копейках. Обяза\
тельное поле при работе со службами доставки — спо\
собы доставки `courier`, `post_office`, `delivery_point`,\
\ `merchant_delivery_point`."
externalProductId:
maxLength: 256
type: "string"
description: "Идентификатор товара в системе продавц\
а."
description: "Товар."
description: "Модель заказа."
example:
order:
checkoutOrderId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
shopId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
user:
id: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
firstName: "Иван"
lastName: "Иванов"
phone: "+79101234567"
email: "i.ivanov@gmail.com"
amount: 100
itemsAmount: 100
paidAmount: 0
amountToPay: 100
orderId: "order#123"
taxation: "osn"
description: "Описание заказа, сделанного через Т-Корзину."
timestamp: "2022-11-08T11:35:04.311317+00:00"
customerKey: "user#123"
successPageUrl: "https://merchant.com/success"
isForceRedirect: false
shoppingCartPageUrl: "https://merchant.com/cart"
comment: "Комментарий к заказу"
statuses:
- name: "NEW_ORDER"
timestamp: "2022-11-09T10:04:04.211317+00:00"
delivery:
deliveryId: "ae5ef21e-39be-4756-8ecf-15cd5c11cc52"
trackingNumber: "1112-63"
deliveryType: "PostOffice"
deliveryService: "RussianPost"
errorMessage: "Сообщение"
errorDetails:
title: "Сообщение"
details: "Подробности ошибки"
status: 400
address: "г Москва, ул Менжинского, д 5"
flat: "166"
entrance: "3"
floor: "5"
flatCode: "166*B"
deliveryCondition:
price: 2000
priceByMerchant: 2000
priceByDeliveryService: 0
pricePaid: 2000
priceToPay: 0
tax: "none"
shippingParameters:
metashipShopId: "89a3058c-a5bf-4f47-9608-2963c7153e80"
metashipWarehouseId: "ae6a9db6-3e5c-41b0-bdf9-848860f2ace5"
types:
- "PostOffice"
- "Courier"
services:
- service: "sms"
- service: "dress-fitting"
- service: "shelf-life-days"
value: "10"
weight: 63
height: 7
width: 26
length: 22
declaredValue: 3300
discountInfo:
promoCodeId: "promoCode#123"
discountAmount: 100000
orderItems:
- id: "58097aa1-9660-47e7-8550-f2167fa80cea"
name: "Ноутбук"
quantity: 1
amount: 1000
price: 1000
description: "Описание товара."
tax: "none"
excise: 332
paymentMethod: "full_payment"
paymentObject: "commodity"
countryCode: "643"
declarationNumber: "123123"
measurementUnit: "kg"
markCode:
markCodeType: "ean8"
value: "value"
markQuantity:
numerator: 1
denominator: 1
article: "Артикул товара."
weight: 0.005
declaredValue: 1000
recipient:
firstName: "Иван"
lastName: "Петров"
email: "rec@mail.ru"
phone: "+79123456789"
deliveryPayment:
- deliveryKind: "disabled"
paymentTypes:
- "card"
paymentType: "internet_acquiring"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "retw6789"
errorMessage: "Указанный заказ не найден"
errorCode: "NOT_FOUND"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}:
get:
tags:
- "Декларации 3-НДФЛ"
summary: "Получить данные о заявке"
description: "Метод возвращает актуальные данные о заявке. Если заявка не бу\
дет найдена, вернется ошибка."
operationId: "getRequest"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "clientFullName"
- "clientId"
- "createdAt"
- "hasUnreadMessages"
- "requestType"
- "status"
type: "object"
properties:
clientId:
type: "string"
description: "Идентификатор клиента."
format: "uuid"
clientFullName:
maxLength: 200
type: "string"
description: "ФИО клиента."
requestType:
type: "string"
description: "Тип заявки: консультация или декларация."
enum:
- "Comment"
- "Declaration"
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
hasUnreadMessages:
type: "boolean"
description: "Флаг наличия непрочитанных сообщений в чате."
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
createdAt:
type: "string"
description: "Дата создания в формате `ISO-8601`."
format: "dateTime"
example:
clientId: "1453dd48-53ea-4aab-a200-597b57daf809"
clientFullName: "Иванов Иван Иванович"
requestType: "Declaration"
status: "New"
hasUnreadMessages: false
casVersion: 1
createdAt: "2023-02-21T07:14:04.622Z"
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/attachments/upload:
post:
tags:
- "Декларации 3-НДФЛ"
summary: "Загрузить произвольный файл"
description: "Метод для загрузки произвольного файла, который можно прикрепи\
ть как вложение к заявке, идентифицируемой `taxRequestId`. После успешной\
\ загрузки вернется идентификатор файла — `attachmentId`."
operationId: "postApiV2Ndfl-3RequestsTaxrequestidAttachmentsUpload"
parameters:
- name: "X-Content-File-Name"
in: "header"
description: "Имя файла."
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Имя файла."
example: "sample.png"
- name: "X-Content-File-Type"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Тип файла."
example: "image/png"
- name: "X-Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности. Подробнее."
format: "uuid"
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор заявки."
format: "uuid"
requestBody:
content:
application/octet-stream:
schema:
type: "string"
format: "binary"
example: "binary data"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "attachmentId"
type: "object"
properties:
attachmentId:
type: "string"
description: "Идентификатор вложения."
format: "uuid"
example:
attachmentId: "54593069-1789-4a7d-b729-37406bd1fc0e"
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/attachments/{attachmentId}:
get:
tags:
- "Декларации 3-НДФЛ"
summary: "Скачать вложение (файл) из чата"
description: "Метод возвращает файл из чата по заявке (`taxRequestId`) по ег\
о идентификатору — `attachmentId`.\n\nЕсли файл не будет найден или будет\
\ недоступен для скачивания (после закрытия запроса), вернется ошибка."
operationId: "getApiV2Ndfl-3RequestsTaxrequestidAttachmentsAttachmentid"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "attachmentId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор вложения."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
Content-Disposition:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Файл для скачивания."
example: "attachment; filename=\"filename.jpg\""
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/octet-stream:
schema:
type: "string"
format: "binary"
example: "binary data"
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/chat:
get:
tags:
- "Декларации 3-НДФЛ"
summary: "Получить список сообщений по декларации 3-НДФЛ"
description: "Метод возвращает список сообщений чата с клиентом по деклараци\
и по идентификатору заявки — `taxRequestId`. Если заявка не будет найдена\
, вернется ошибка."
operationId: "getChat"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
- name: "limit"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "integer"
description: "Желаемое количество элементов."
- name: "offset"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "integer"
description: "Позиция начала списка."
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "meta"
- "values"
type: "object"
properties:
meta:
required:
- "count"
- "offset"
- "total"
type: "object"
properties:
offset:
type: "integer"
description: "Позиция начала списка."
count:
type: "integer"
description: "Количество элементов в ответе."
total:
type: "integer"
description: "Общее количество элементов."
description: "Информация для пагинации."
values:
maxItems: 1000
type: "array"
description: "Сообщения в чате."
items:
required:
- "authorType"
- "createdAt"
- "id"
type: "object"
properties:
id:
type: "string"
description: "Уникальный идентификатор сообщения."
format: "uuid"
authorType:
type: "string"
description: "Тип автора сообщения."
enum:
- "Manager"
- "Client"
text:
maxLength: 1000
type: "string"
description: "Текст сообщения."
attachments:
maxItems: 1000
type: "array"
description: "Документы, приложенные к сообщению."
items:
required:
- "createdAt"
- "id"
- "mime"
- "name"
- "size"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "Уникальный идентификатор вложения."
name:
maxLength: 100
type: "string"
description: "Название файла."
mime:
maxLength: 100
type: "string"
description: "Тип содержимого файла."
size:
type: "integer"
description: "Размер файла в байтах."
createdAt:
type: "string"
description: "Дата загрузки документа в формате `ISO-8601`."
format: "dateTime"
createdAt:
type: "string"
description: "Дата создания сообщения в формате `ISO-8601`."
format: "dateTime"
example:
meta:
offset: 0
count: 10
total: 100
values:
- id: "17cf5b26-a9b4-4531-bd19-186dbfc64a0a"
authorType: "Manager"
text: "Прикладываю справку"
attachments:
- id: "cb4bc60f-101d-4ba2-a4fb-94dcf1208d31"
name: "image.png"
mime: "image/png"
size: 43870
createdAt: "2023-11-22T14:12:37.933204Z"
createdAt: "2023-11-22T14:12:37.933204Z"
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/chat/send:
post:
tags:
- "Декларации 3-НДФЛ"
summary: "Отправить сообщение в чат с клиентом"
description: "Метод отправляет сообщение с возможными вложениями в чат с кли\
ентом. Если заявка не будет найдена, вернется ошибка."
operationId: "sendChat"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
requestBody:
content:
application/json:
schema:
required:
- "message"
type: "object"
properties:
message:
type: "object"
properties:
text:
maxLength: 1000
type: "string"
description: "Текст сообщения."
attachments:
maxItems: 1000
type: "array"
description: "Вложения. Значение не передается, либо передае\
тся список идентификаторов вложений."
items:
type: "string"
description: "Идентификатор вложения."
format: "uuid"
description: "Сообщение."
example:
message:
text: "Прикладываю справку"
attachments:
- "cb4bc60f-101d-4ba2-a4fb-94dcf1208d30"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
example: {}
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/declaration:
get:
tags:
- "Декларации 3-НДФЛ"
summary: "Получить декларацию клиента"
description: "Метод получает декларацию клиента по ее идентификатору — `RequestId`.\
\ Если заявка или вложения к заявке не будут найдены, вернется ошибка."
operationId: "getDeclaration"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "createdAt"
- "incomeSources"
- "ndfl3"
- "primaryForm"
- "taxReturnReasons"
type: "object"
properties:
primaryForm:
maxItems: 1000
type: "object"
additionalProperties:
required:
- "content"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "Идентификатор группы для формы."
content:
required:
- "chosenOptions"
type: "object"
properties:
chosenOptions:
type: "object"
additionalProperties: {}
description: "Опции внутри группы."
description: "Перечень идентификаторов групп для первичной фор\
мы согласно структуре анкеты. Для каждого идентификатора выв\
одится группа для формы (FormGroup)."
ndfl3:
type: "object"
additionalProperties:
required:
- "chosenOptions"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID группы опций из структуры анкеты."
chosenOptions:
type: "object"
additionalProperties:
required:
- "documents"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID опции из структуры анкеты."
documents:
type: "object"
additionalProperties:
maxItems: 1000
type: "array"
items:
required:
- "id"
- "mime"
- "name"
- "size"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "Уникальный идентификатор вло\
жения."
name:
maxLength: 100
type: "string"
description: "Название файла."
mime:
maxLength: 100
type: "string"
description: "Тип содержимого файла."
size:
type: "integer"
description: "Размер файла в байтах."
description: "Перечень идентификаторов документов\
\ согласно структуре анкеты для выбранной опции\
. Для каждого идентификатора выводится список вл\
ожений (Attachment)."
description: "Перечень идентификаторов групп для первичной дек\
ларации согласно структуре анкеты. Для каждого идентификатор\
а выводится группа (Group)."
incomeSources:
type: "object"
additionalProperties:
required:
- "chosenOptions"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID группы опций из структуры анкеты."
chosenOptions:
type: "object"
additionalProperties:
required:
- "documents"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID опции из структуры анкеты."
documents:
type: "object"
additionalProperties:
maxItems: 1000
type: "array"
items:
required:
- "id"
- "mime"
- "name"
- "size"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "Уникальный идентификатор вло\
жения."
name:
maxLength: 100
type: "string"
description: "Название файла."
mime:
maxLength: 100
type: "string"
description: "Тип содержимого файла."
size:
type: "integer"
description: "Размер файла в байтах."
description: "Перечень идентификаторов документов\
\ согласно структуре анкеты для выбранной опции\
. Для каждого идентификатора выводится список вл\
ожений (Attachment)."
description: "Перечень идентификаторов групп доходов согласно\
\ структуре анкеты. Для каждого идентификатора выводится гру\
ппа (Group)."
taxReturnReasons:
type: "object"
additionalProperties:
required:
- "chosenOptions"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID группы опций из структуры анкеты."
chosenOptions:
type: "object"
additionalProperties:
required:
- "documents"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID опции из структуры анкеты."
documents:
type: "object"
additionalProperties:
maxItems: 1000
type: "array"
items:
required:
- "id"
- "mime"
- "name"
- "size"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "Уникальный идентификатор вло\
жения."
name:
maxLength: 100
type: "string"
description: "Название файла."
mime:
maxLength: 100
type: "string"
description: "Тип содержимого файла."
size:
type: "integer"
description: "Размер файла в байтах."
description: "Перечень идентификаторов документов\
\ согласно структуре анкеты для выбранной опции\
. Для каждого идентификатора выводится список вл\
ожений (Attachment)."
description: "Перечень выбранных клиентом идентификаторов груп\
п вычетов согласно структуре анкеты. Для каждого идентификат\
ора выводится группа (Group)."
finalDocuments:
required:
- "exportedFile"
type: "object"
properties:
exportedFile:
required:
- "id"
- "mime"
- "name"
- "size"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "Уникальный идентификатор вложения."
name:
maxLength: 100
type: "string"
description: "Название файла."
mime:
maxLength: 100
type: "string"
description: "Тип содержимого файла."
size:
type: "integer"
description: "Размер файла в байтах."
description: "Финальные документы декларации."
casVersion:
type: "integer"
description: "Версия заявки в формате `ETag`."
createdAt:
type: "string"
description: "Дата создания декларации в формате `ISO-8601`."
format: "dateTime"
example:
primaryForm:
is-resident:
id: "is-resident"
content:
chosenOptions:
"true": true
declaration-type:
id: "declaration-type"
content:
chosenOptions:
primary: true
declaration-year:
id: "declaration-year"
content:
chosenOptions:
declaration-year-2023: true
incomeSources:
foreign-investment-incomes:
id: "foreign-investment-incomes"
chosenOptions:
foreign-broker-account:
id: "foreign-broker-account"
documents:
broker-report-v2:
- id: "e4f145a8-4f1e-4595-8c8d-7f1363064cc3"
name: "image.png"
mime: "image/png"
size: 43870
taxReturnReasons: {}
ndfl3:
target-year-primary-ndfl3:
id: "target-year-primary-ndfl3"
chosenOptions:
uploaded-target-year-ndfl3:
id: "uploaded-target-year-ndfl3"
documents:
uploaded-target-year-ndfl3:
- id: "854d449f-ae43-4586-9758-00fdd823768f"
name: "image.png"
mime: "image/png"
size: 43870
finalDocuments:
exportedFile:
id: "e426ca85-28f4-46da-8b31-f7fa1c77c607"
name: "image.png"
mime: "image/png"
size: 43870
casVersion: 12
createdAt: "2023-11-15T13:16:20.787349Z"
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Некоторые вложения не найдены"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Некоторые вложения не найдены"
errorCode: "ATTACHMENT_NOT_FOUND"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
put:
tags:
- "Декларации 3-НДФЛ"
summary: "Отредактировать заявку на декларацию клиента"
description: "Метод редактирует или обновляет декларацию клиента по ее идент\
ификатору — `RequestId`. Элементы заявки, которые не изменяются, все равно\
\ должны быть в запросе — частично обновить заявку нельзя.\n\nЕсли заявка\
\ или вложения к заявке не будут найдены, вернется ошибка."
operationId: "updateDeclaration"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
requestBody:
content:
application/json:
schema:
required:
- "incomeSources"
- "ndfl3"
- "primaryForm"
- "taxReturnReasons"
type: "object"
properties:
primaryForm:
maxItems: 1000
type: "object"
additionalProperties:
required:
- "content"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "Идентификатор группы для формы."
content:
required:
- "chosenOptions"
type: "object"
properties:
chosenOptions:
type: "object"
additionalProperties: {}
description: "Опции внутри группы."
description: "Перечень идентификаторов групп для первичной формы\
\ согласно структуре анкеты. Для каждого идентификатора выводи\
тся группа для формы (FormGroup)."
ndfl3:
type: "object"
additionalProperties:
required:
- "chosenOptions"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID группы опций из структуры анкеты"
chosenOptions:
type: "object"
additionalProperties:
required:
- "documents"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID опции из структуры анкеты"
documents:
type: "object"
additionalProperties:
maxItems: 1000
type: "array"
items:
type: "string"
description: "Идентификатор вложения."
format: "uuid"
description: "Перечень идентификаторов документов со\
гласно структуре анкеты для выбранной опции. Для к\
аждого идентификатора выводится список вложений (Attachment)"
description: "Перечень идентификаторов групп для первичной декла\
рации согласно структуре анкеты. Для каждого идентификатора вы\
водится группа (Group)."
incomeSources:
type: "object"
additionalProperties:
required:
- "chosenOptions"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID группы опций из структуры анкеты"
chosenOptions:
type: "object"
additionalProperties:
required:
- "documents"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID опции из структуры анкеты"
documents:
type: "object"
additionalProperties:
maxItems: 1000
type: "array"
items:
type: "string"
description: "Идентификатор вложения."
format: "uuid"
description: "Перечень идентификаторов документов со\
гласно структуре анкеты для выбранной опции. Для к\
аждого идентификатора выводится список вложений (Attachment)"
description: "Перечень идентификаторов групп доходов согласно ст\
руктуре анкеты. Для каждого идентификатора выводится группа (Group)."
taxReturnReasons:
type: "object"
additionalProperties:
required:
- "chosenOptions"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID группы опций из структуры анкеты"
chosenOptions:
type: "object"
additionalProperties:
required:
- "documents"
- "id"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID опции из структуры анкеты"
documents:
type: "object"
additionalProperties:
maxItems: 1000
type: "array"
items:
type: "string"
description: "Идентификатор вложения."
format: "uuid"
description: "Перечень идентификаторов документов со\
гласно структуре анкеты для выбранной опции. Для к\
аждого идентификатора выводится список вложений (Attachment)"
description: "Перечень выбранных клиентом идентификаторов групп\
\ вычетов согласно структуре анкеты. Для каждого идентификатор\
а выводится группа (Group)."
finalDocuments:
required:
- "exportedFile"
type: "object"
properties:
exportedFile:
maxLength: 100
type: "string"
description: "Уникальный идентификатор вложения."
description: "Финальные документы декларации."
example:
primaryForm:
is-resident:
id: "is-resident"
content:
chosenOptions:
"true": true
declaration-type:
id: "declaration-type,"
content:
chosenOptions:
primary: true
declaration-year:
id: "declaration-year"
content:
chosenOptions:
declaration-year-2023: true
incomeSources:
foreign-investment-incomes:
id: "foreign-investment-incomes"
chosenOptions:
foreign-broker-account:
id: "foreign-broker-account"
documents:
broker-report-v2:
- "e4f145a8-4f1e-4595-8c8d-7f1363064cc3"
taxReturnReasons: {}
ndfl3: {}
finalDocuments:
exportedFile: "e426ca85-28f4-46da-8b31-f7fa1c77c607"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
type: "object"
properties:
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
casVersion: 12
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Некоторые вложения не найдены"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Некоторые вложения не найдены"
errorCode: "ATTACHMENT_NOT_FOUND"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/declaration/structure:
get:
tags:
- "Декларации 3-НДФЛ"
summary: "Получить структуру анкеты"
description: "Метод для получения структуры анкеты. Если заявка не будет най\
дена, вернется ошибка."
operationId: "getDeclarationStructure"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "incomeSources"
- "ndfl3"
- "primaryForm"
- "taxReturnReasons"
- "variables"
type: "object"
properties:
variables:
type: "object"
additionalProperties:
type: "string"
description: "Перечисление переменных для динамических заголов\
ков."
primaryForm:
maxItems: 1000
type: "array"
description: "Список экранов для первичного опроса."
items:
required:
- "content"
- "id"
- "title"
- "type"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID экранной формы."
title:
maxLength: 200
type: "string"
description: "Заголовок формы."
fallbackTitle:
maxLength: 200
type: "string"
description: "Заголовок формы, если не получится сформир\
овать динамический заголовок."
type:
type: "string"
description: "Тип выбора элементов на форме."
enum:
- "SingleChoice"
- "MultipleChoice"
content:
required:
- "options"
type: "object"
properties:
options:
maxItems: 1000
type: "array"
description: "Список опций для выбора."
items:
required:
- "id"
- "title"
- "type"
- "value"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID опции."
title:
maxLength: 200
type: "string"
description: "Наименование опции."
type:
type: "string"
description: "Тип значения опции."
enum:
- "String"
- "Int"
- "Boolean"
value:
maxLength: 200
type: "string"
description: "Значение опции."
description: "Список экранов для первичного опроса\
."
description: "Содержимое экрана."
incomeSources:
required:
- "groups"
- "title"
type: "object"
properties:
title:
maxLength: 200
type: "string"
description: "Отображаемое название раздела."
fallBackTitle:
maxLength: 200
type: "string"
description: "Название раздела, если не получится сформиро\
вать динамическое название."
groups:
maxItems: 1000
type: "array"
description: "Список групп в разделе."
items:
required:
- "id"
- "isDeleted"
- "options"
- "title"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID группы."
title:
maxLength: 200
type: "string"
description: "Отображаемое название группы."
hint:
maxLength: 1000
type: "string"
description: "Подсказка к заполнению."
isDeleted:
type: "boolean"
description: "Флаг отсутствия группы в последней вер\
сии анкеты."
options:
maxItems: 1000
type: "array"
description: "Набор опций, входящих в группу."
items:
required:
- "documents"
- "id"
- "isDeleted"
- "title"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID опции."
title:
maxLength: 200
type: "string"
description: "Отображаемое название опции."
hint:
maxLength: 1000
type: "string"
description: "Подсказка к заполнению."
isDeleted:
type: "boolean"
description: "Флаг отсутствия опции в последне\
й версии анкеты."
documents:
maxItems: 1000
type: "array"
description: "Список подтверждающих документов\
, которые нужно приложить."
items:
required:
- "isDeleted"
- "shared"
- "title"
- "type"
type: "object"
properties:
type:
maxLength: 100
type: "string"
description: "ID документа."
title:
maxLength: 200
type: "string"
description: "Отображаемое название доку\
мента."
isDeleted:
type: "boolean"
description: "Флаг отсутствия документа\
\ в последней версии анкеты."
hint:
maxLength: 1000
type: "string"
description: "Подсказка к заполнению."
shared:
type: "boolean"
description: "Флаг, находятся ли вложени\
я в локальной (documents) или глобальн\
ой (sharedDocuments) секциях."
description: "Группы источников дохода."
taxReturnReasons:
required:
- "groups"
- "title"
type: "object"
properties:
title:
maxLength: 200
type: "string"
description: "Отображаемое название раздела."
fallBackTitle:
maxLength: 200
type: "string"
description: "Название раздела, если не получится сформиро\
вать динамическое название."
groups:
maxItems: 1000
type: "array"
description: "Список групп в разделе."
items:
required:
- "id"
- "isDeleted"
- "options"
- "title"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID группы."
title:
maxLength: 200
type: "string"
description: "Отображаемое название группы."
hint:
maxLength: 1000
type: "string"
description: "Подсказка к заполнению."
isDeleted:
type: "boolean"
description: "Флаг отсутствия группы в последней вер\
сии анкеты."
options:
maxItems: 1000
type: "array"
description: "Набор опций, входящих в группу."
items:
required:
- "documents"
- "id"
- "isDeleted"
- "title"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID опции."
title:
maxLength: 200
type: "string"
description: "Отображаемое название опции."
hint:
maxLength: 1000
type: "string"
description: "Подсказка к заполнению."
isDeleted:
type: "boolean"
description: "Флаг отсутствия опции в последне\
й версии анкеты."
documents:
maxItems: 1000
type: "array"
description: "Список подтверждающих документов\
, которые нужно приложить."
items:
required:
- "isDeleted"
- "shared"
- "title"
- "type"
type: "object"
properties:
type:
maxLength: 100
type: "string"
description: "ID документа."
title:
maxLength: 200
type: "string"
description: "Отображаемое название доку\
мента."
isDeleted:
type: "boolean"
description: "Флаг отсутствия документа\
\ в последней версии анкеты."
hint:
maxLength: 1000
type: "string"
description: "Подсказка к заполнению."
shared:
type: "boolean"
description: "Флаг, находятся ли вложени\
я в локальной (documents) или глобальн\
ой (sharedDocuments) секциях."
description: "Группы налоговых вычетов."
ndfl3:
required:
- "groups"
type: "object"
properties:
groups:
maxItems: 1000
type: "array"
description: "Список групп в разделе."
items:
required:
- "id"
- "isDeleted"
- "options"
- "title"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID группы."
title:
maxLength: 200
type: "string"
description: "Отображаемое название группы."
hint:
maxLength: 1000
type: "string"
description: "Подсказка к заполнению."
isDeleted:
type: "boolean"
description: "Флаг отсутствия группы в последней вер\
сии анкеты."
options:
maxItems: 1000
type: "array"
description: "Набор опций, входящих в группу."
items:
required:
- "documents"
- "id"
- "isDeleted"
- "title"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID опции."
title:
maxLength: 200
type: "string"
description: "Отображаемое название опции."
hint:
maxLength: 1000
type: "string"
description: "Подсказка к заполнению."
isDeleted:
type: "boolean"
description: "Флаг отсутствия опции в последне\
й версии анкеты."
documents:
maxItems: 1000
type: "array"
description: "Список подтверждающих документов\
, которые нужно приложить."
items:
required:
- "isDeleted"
- "shared"
- "title"
- "type"
type: "object"
properties:
type:
maxLength: 100
type: "string"
description: "ID документа."
title:
maxLength: 200
type: "string"
description: "Отображаемое название доку\
мента."
isDeleted:
type: "boolean"
description: "Флаг отсутствия документа\
\ в последней версии анкеты."
hint:
maxLength: 1000
type: "string"
description: "Подсказка к заполнению."
shared:
type: "boolean"
description: "Флаг, находятся ли вложени\
я в локальной (documents) или глобальн\
ой (sharedDocuments) секциях."
description: "Группы 3-НДФЛ для уточняющей декларации."
example:
variables:
target_year: "declaration-year"
primaryForm:
- id: "declaration-year"
title: "За какой год оформить декларацию?"
type: "SingleChoice"
content:
options:
- id: "declaration-year-2023"
title: "2023"
type: "Int"
value: "2023"
- id: "declaration-year-2022"
title: "2022"
type: "Int"
value: "2022"
- id: "declaration-year-2021"
title: "2021"
type: "Int"
value: "2021"
- id: "declaration-type"
title: "В первый раз подаете декларацию за {{`{{target_year}}`}}\
\ год?"
fallbackTitle: "В первый раз подаете декларацию за тот год?"
type: "SingleChoice"
content:
options:
- id: "primary"
title: "Да, в первый раз"
type: "String"
value: "Primary"
- id: "clarifying"
title: "Нет, нужна уточненная декларация"
type: "String"
value: "Clarifying"
incomeSources:
title: "Какие доходы учесть в декларации?"
groups:
- id: "foreign-investment-incomes"
title: "Доходы по зарубежным инвестициям"
hint: "Дивиденды по иностранным бумагам у российских брокеров\
\ и доходы по счету иностранного брокера"
isDeleted: false
options:
- id: "foreign-broker-account"
title: "Доходы по счету иностранного брокера"
isDeleted: false
documents:
- type: "broker-report-v2"
title: "Брокерский отчет с момента открытия счета по {{`{{target_year}}`}}\
\ год"
isDeleted: false
shared: false
- type: "broker-report-interactive-brokers"
title: "Брокерский отчет с момента открытия счета по {{`{{target_year}}`}}\
\ год в формате Interactive Brokers"
isDeleted: false
shared: false
taxReturnReasons:
title: "Какие вычеты учесть в декларации?"
groups:
- id: "investment"
title: "Инвестиционный налоговый вычет"
hint: "Вычет по ИИС, учет убытков прошлых лет, сальдирование м\
ежду брокерами"
isDeleted: false
options:
- id: "iis-type-a"
title: "Вычет по ИИС (тип А)"
isDeleted: false
documents:
- type: "open-iis-agreement"
title: "Договор об открытии ИИС"
isDeleted: false
shared: false
- type: "in-money-bills"
title: "Платежки о внесении денег на счет за {{`{{target_year}}`}}\
\ год"
isDeleted: false
shared: false
- type: "employer-2-ndfl"
title: "2-НДФЛ от работодателя"
isDeleted: false
shared: false
ndfl3:
groups:
- id: "target-year-primary-ndfl3"
title: "Первичная 3-НДФЛ за {{`{{target_year}}`}} год"
isDeleted: false
options:
- id: "uploaded-target-year-ndfl3"
title: "Загрузите декларацию 3-НДФЛ за {{`{{target_year}}`}}\
\ год"
isDeleted: false
documents:
- type: "uploaded-target-year-ndfl3"
title: "Загрузите декларацию 3-НДФЛ за {{`{{target_year}}`}}\
\ год"
isDeleted: false
shared: false
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/declaration/workflow/acknowledge:
post:
tags:
- "Декларации 3-НДФЛ"
summary: "Отметить заявку выполненной"
description: "Метод переводит заявку типа «Декларация» в статус `Acknowledge`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `Acknowledge`, метод вернет данные\
\ в 200 ответе. Если актуальная версия заявки не совпадает с версией, пере\
данной в HTTP-заголовке, вернется 422 ошибка.\n\nЕсли передан параметр `finalDocuments`,\
\ данное вложение прикладывается к анкете в качестве финального пакета док\
ументов."
operationId: "updateStatusAcknowledge"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
- name: "finalDocuments"
in: "query"
required: false
style: "form"
explode: true
schema:
type: "string"
description: "Уникальный идентификатор вложения."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "Acknowledge"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/declaration/workflow/cancel:
post:
tags:
- "Декларации 3-НДФЛ"
summary: "Отменить заявку"
description: "Метод переводит заявку типа «Декларация» в статус `Cancelled`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `Cancelled`, метод вернет данные в\
\ 200 ответе. Если актуальная версия заявки не совпадает с версией, переда\
нной в HTTP-заголовке, вернется 422 ошибка."
operationId: "updateStatusCancelled"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "Cancelled"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/declaration/workflow/clarification:
post:
tags:
- "Декларации 3-НДФЛ"
summary: "Требуются уточнения по заявке"
description: "Метод переводит заявку типа «Декларация» в статус `Clarification`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `Clarification`, метод вернет данны\
е в 200 ответе. Если актуальная версия заявки не совпадает с версией, пере\
данной в HTTP-заголовке, вернется 422 ошибка."
operationId: "updateStatusClarification"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "Clarification"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/declaration/workflow/decline:
post:
tags:
- "Декларации 3-НДФЛ"
summary: "Отклонить заявку"
description: "Метод переводит заявку типа «Декларация» в статус `Declined`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `Declined`, метод вернет данные в 200\
\ ответе. Если актуальная версия заявки не совпадает с версией, переданной\
\ в HTTP-заголовке, вернется 422 ошибка."
operationId: "updateStatusDeclined"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "Declined"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/declaration/workflow/payment-done:
post:
tags:
- "Декларации 3-НДФЛ"
summary: "Отметить оплату заявки"
description: "Метод переводит заявку типа «Декларация» в статус `PaymentDone`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `PaymentDone`, метод вернет данные\
\ в 200 ответе. Если актуальная версия заявки не совпадает с версией, пере\
данной в HTTP-заголовке, вернется 422 ошибка."
operationId: "updateStatusPaymentDone"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "PaymentDone"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/declaration/workflow/pending-payment:
post:
tags:
- "Декларации 3-НДФЛ"
summary: "Отметить необходимость оплаты заявки"
description: "Метод переводит заявку типа «Декларация» в статус `PendingPayment`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `PendingPayment`, метод вернет данн\
ые в 200 ответе. Если актуальная версия заявки не совпадает с версией, пер\
еданной в HTTP-заголовке, вернется 422 ошибка."
operationId: "updateStatusPendingPayment"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "PendingPayment"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/declaration/workflow/ready:
post:
tags:
- "Декларации 3-НДФЛ"
summary: "Завершить заявку"
description: "Метод переводит заявку типа «Декларация» в статус `Ready`.\n\n\
Если заявка не будет найдена или ее нельзя перевести в этот статус, вернет\
ся ошибка. Если заявка уже в статусе `Ready`, метод вернет данные в 200 от\
вете. Если актуальная версия заявки не совпадает с версией, переданной в HTTP-з\
аголовке, вернется 422 ошибка."
operationId: "updateStatusReady"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "Ready"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/declaration/workflow/resume-work:
post:
tags:
- "Декларации 3-НДФЛ"
summary: "Возобновить работу над заявкой"
description: "Метод переводит заявку типа «Декларация» в статус `PartnerInProgress`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `PartnerInProgress`, метод вернет д\
анные в 200 ответе. Если актуальная версия заявки не совпадает с версией,\
\ переданной в HTTP-заголовке, вернется 422 ошибка."
operationId: "updateStatusPartnerInProgress"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "PartnerInProgress"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/declaration/workflow/start-review:
post:
tags:
- "Декларации 3-НДФЛ"
summary: "Взять заявку в анализ"
description: "Метод переводит заявку типа «Декларация» в статус `Preprocess`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `Preprocess`, метод вернет данные в\
\ 200 ответе. Если актуальная версия заявки не совпадает с версией, переда\
нной в HTTP-заголовке, вернется 422 ошибка."
operationId: "updateStatusStartReview"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "Preprocess"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/declaration/workflow/start-work:
post:
tags:
- "Декларации 3-НДФЛ"
summary: "Взять заявку в работу"
description: "Метод переводит заявку типа «Декларация» в статус `PartnerGeneratingReportData`.\n\
\nЕсли заявка не будет найдена или ее нельзя перевести в этот статус, верн\
ется ошибка. Если заявка уже в статусе `PartnerGeneratingReportData`, мето\
д вернет данные в 200 ответе. Если актуальная версия заявки не совпадает с\
\ версией, переданной в HTTP-заголовке, вернется 422 ошибка."
operationId: "updateStatusPartnerGeneratingReportData"
parameters:
- name: "If-Match"
in: "header"
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Версия заявки в формате `ETag`, которая используется для о\
птимистичных блокировок. Другое название — casVersion."
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус заявки."
enum:
- "Assigned"
- "InProgress"
- "Answered"
- "SeenByClient"
- "NeedsClarification"
- "Closed"
- "SentToPartner"
- "Draft"
- "New"
- "Preprocess"
- "PartnerGeneratingReportData"
- "PartnerInProgress"
- "PendingPassport"
- "PendingPayment"
- "PaymentDone"
- "Ready"
- "PartnerReady"
- "Acknowledge"
- "Cancelled"
- "Declined"
- "Clarification"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
status: "PartnerGeneratingReportData"
casVersion: 2
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Неверные данные заявки"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Переход между статусами невозможен"
errorCode: "ILLEGAL_WORKFLOW_TRANSITION"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/ndfl-3/requests/{taxRequestId}/info/form:
get:
tags:
- "Декларации 3-НДФЛ"
summary: "Получить заполненную клиентом анкету, где указан желаемый состав д\
екларации 3-НДФЛ"
description: "Метод возвращает заполненную анкету клиента по идентификатору\
\ заявки — `taxRequestId`. Если анкета не будет найдена, вернется ошибка."
operationId: "getFormInfo"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Уникальный идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "casVersion"
- "createdAt"
- "incomeSources"
- "isResident"
- "taxReturnReasons"
- "type"
- "year"
type: "object"
properties:
year:
type: "integer"
description: "Год, за который подается декларация."
isResident:
type: "boolean"
description: "Был ли клиент налоговым резидентом в выбранный г\
од."
type:
type: "string"
description: "Тип декларации — первичная или уточняющая."
enum:
- "Primary"
- "Clarifying"
incomeSources:
maxItems: 1000
type: "array"
description: "Группы источников дохода."
items:
required:
- "options"
- "title"
type: "object"
properties:
title:
maxLength: 100
type: "string"
description: "Название группы."
options:
maxItems: 1000
type: "array"
description: "Детализация в рамках группы."
items:
required:
- "documents"
- "title"
type: "object"
properties:
title:
maxLength: 100
type: "string"
description: "Название детализации."
price:
required:
- "currency"
- "isFullPrice"
- "value"
type: "object"
properties:
value:
type: "integer"
description: "Сумма."
currency:
maxLength: 10
type: "string"
description: "Валюта. Например, `RUB`."
hint:
maxLength: 1000
type: "string"
description: "Поясняющий текст."
isFullPrice:
type: "boolean"
description: "Флаг полной цены."
details:
maxItems: 1000
type: "array"
description: "Детализация цен типа «от»."
items:
required:
- "currency"
- "isFullPrice"
- "value"
type: "object"
properties:
value:
type: "integer"
description: "Сумма."
currency:
maxLength: 10
type: "string"
description: "Валюта. Например, `RUB`."
hint:
maxLength: 1000
type: "string"
description: "Поясняющий текст."
isFullPrice:
type: "boolean"
description: "Флаг полной цены."
description: "Цена."
documents:
maxItems: 1000
type: "array"
description: "Документы, приложенные к анкете."
items:
required:
- "fileName"
- "id"
- "mime"
- "size"
- "title"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID документа для его дальнейше\
го получения."
title:
maxLength: 100
type: "string"
description: "Тип документа."
fileName:
maxLength: 100
type: "string"
description: "Название файла."
mime:
maxLength: 100
type: "string"
description: "Формат файла."
size:
type: "integer"
description: "Размер файла в байтах."
taxReturnReasons:
maxItems: 1000
type: "array"
description: "Группы налоговых вычетов, на которые клиент пода\
л заявку."
items:
required:
- "options"
- "title"
type: "object"
properties:
title:
maxLength: 100
type: "string"
description: "Название группы."
options:
maxItems: 1000
type: "array"
description: "Детализация в рамках группы."
items:
required:
- "documents"
- "title"
type: "object"
properties:
title:
maxLength: 100
type: "string"
description: "Название детализации."
price:
required:
- "currency"
- "isFullPrice"
- "value"
type: "object"
properties:
value:
type: "integer"
description: "Сумма."
currency:
maxLength: 10
type: "string"
description: "Валюта. Например, `RUB`."
hint:
maxLength: 1000
type: "string"
description: "Поясняющий текст."
isFullPrice:
type: "boolean"
description: "Флаг полной цены."
details:
maxItems: 1000
type: "array"
description: "Детализация цен типа «от»."
items:
required:
- "currency"
- "isFullPrice"
- "value"
type: "object"
properties:
value:
type: "integer"
description: "Сумма."
currency:
maxLength: 10
type: "string"
description: "Валюта. Например, `RUB`."
hint:
maxLength: 1000
type: "string"
description: "Поясняющий текст."
isFullPrice:
type: "boolean"
description: "Флаг полной цены."
description: "Цена."
documents:
maxItems: 1000
type: "array"
description: "Документы, приложенные к анкете."
items:
required:
- "fileName"
- "id"
- "mime"
- "size"
- "title"
type: "object"
properties:
id:
maxLength: 100
type: "string"
description: "ID документа для его дальнейше\
го получения."
title:
maxLength: 100
type: "string"
description: "Тип документа."
fileName:
maxLength: 100
type: "string"
description: "Название файла."
mime:
maxLength: 100
type: "string"
description: "Формат файла."
size:
type: "integer"
description: "Размер файла в байтах."
totalAmount:
required:
- "currency"
- "isFullPrice"
- "value"
type: "object"
properties:
value:
type: "integer"
description: "Сумма."
currency:
maxLength: 10
type: "string"
description: "Валюта. Например, `RUB`."
isFullPrice:
type: "boolean"
description: "Зависит от наличия опций, содержащих плавающ\
ую цену. То есть те, у которых `isFullPrice = false`."
createdAt:
type: "string"
description: "Дата загрузки документа в формате `ISO-8601`."
format: "dateTime"
casVersion:
type: "integer"
description: "Актуальный номер версии заявки."
format: "int64"
example:
year: 2022
isResident: true
type: "Primary"
incomeSources:
- title: "Доходы за рубежом"
options:
- title: "Сдача недвижимости в аренду"
price:
value: 8500
currency: "RUB"
isFullPrice: false
details:
- value: 8500
currency: "RUB"
hint: "Менее 50 операций"
isFullPrice: false
- value: 15700
currency: "RUB"
hint: "51-200 операций"
isFullPrice: false
- value: 25400
currency: "RUB"
hint: "201-800 операций"
isFullPrice: false
documents:
- id: "4f73de13-4054-448e-b07f-500e09cd6d56"
title: "Договор аренды"
fileName: "filename.pdf"
mime: "application/pdf"
size: 10000
taxReturnReasons:
- title: "Социальный налоговый вычет"
options:
- title: "Лечение"
price:
value: 8500
currency: "RUB"
isFullPrice: false
documents:
- id: "4f73de13-4054-448e-b07f-500e09cd6d56"
title: "Платежки, подтверждающие расходы на лечение"
fileName: "filename.pdf"
mime: "application/pdf"
size: 10000
totalAmount:
value: 1
currency: "RUB"
isFullPrice: false
createdAt: "2005-08-09T18:31:42+03:30"
casVersion: 1
"400":
description: "Заявка не найдена"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
example:
errorId: "868d646e609f5339"
errorMessage: "Заявка не найдена"
errorCode: "REQUEST_NOT_FOUND"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/rules:
get:
tags:
- "Правила"
summary: "Получить список платежных правил"
description: "Метод для получения списка платежных правил."
operationId: "getApiV2Nonacceptance-RuleList"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "agreementId"
in: "query"
description: "ID соглашения, в рамках которого заключены правила."
required: false
style: "form"
explode: true
schema:
type: "string"
format: "uuid"
nullable: true
- name: "limit"
in: "query"
description: "Максимальное количество правил, которое нужно вывести. Значе\
ние по умолчанию — `50`."
required: false
style: "form"
explode: true
schema:
type: "integer"
format: "int32"
nullable: true
default: 50
- name: "offset"
in: "query"
description: "Количество правил, которые нужно пропустить. Значение по умо\
лчанию — `0`."
required: false
style: "form"
explode: true
schema:
type: "integer"
format: "int32"
nullable: true
default: 0
- name: "ruleTypes"
in: "query"
description: "Типы правил, которые должны быть включены в ответ."
required: false
style: "form"
explode: true
schema:
maxItems: 50
type: "array"
nullable: true
items:
type: "string"
description: " Тип правила:\n\n* `Recurrent` — рекуррентное правило;\n\
\n* `Trigger` — триггерное правило."
enum:
- "Recurrent"
- "Trigger"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "object"
properties:
offset:
type: "integer"
description: "Количество правил, которое было пропущено."
format: "int32"
limit:
type: "integer"
description: "Максимальное количество правил, которое могло бы\
ть выведено."
format: "int32"
size:
type: "integer"
description: "Количество правил в ответе."
format: "int32"
total:
type: "integer"
description: "Общее количество правил."
format: "int32"
results:
maxItems: 50
type: "array"
description: "Результат."
items:
oneOf:
- title: "Рекуррентное правило"
required:
- "agreementId"
- "cronExpr"
- "id"
- "requisites"
- "type"
type: "object"
properties:
type:
type: "string"
description: " Тип правила:\n\n* `Recurrent` — рекурре\
нтное правило;\n\n* `Trigger` — триггерное правило."
enum:
- "Recurrent"
- "Trigger"
id:
type: "string"
description: "ID правила."
format: "uuid"
agreementId:
type: "string"
description: "ID соглашения."
format: "uuid"
requisites:
required:
- "amount"
- "docType"
- "payerAccount"
- "payerBIC"
- "payerCorAccount"
- "payerINN"
- "payerKPP"
- "payerName"
- "purpose"
- "recipientAccount"
type: "object"
properties:
docType:
type: "string"
description: " Тип платежного документа. `PaymentRequest`\
\ — платежное требование."
enum:
- "PaymentRequest"
amount:
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа."
format: "decimal"
paymentCondition:
type: "string"
description: " Условие платежа:\n\n* `WithAcceptance`\
\ — с акцептом;\n* `WithoutAcceptance` — без акц\
епта."
enum:
- "WithAcceptance"
- "WithoutAcceptance"
acceptTerm:
maximum: 9
minimum: 5
type: "integer"
description: "Количество дней для акцепта."
format: "int32"
nullable: true
docDispatchDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2})$"
type: "string"
description: " Дата вручения плательщику предусмот\
ренных договором документов в формате `YYYY-MM-DD`."
nullable: true
payerAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Номер счета плательщика."
payerINN:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН плательщика."
payerKPP:
pattern: "^(\\d{9}|0)$"
type: "string"
description: " КПП плательщика.\n\nЕсли КПП нет, п\
ередайте `0`."
payerName:
maxLength: 160
minLength: 1
type: "string"
description: "Наименование плательщика."
payerBIC:
pattern: "^(\\d{9})$"
type: "string"
description: "БИК плательщика."
payerCorAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Корреспондентский счет плательщика."
recipientAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Счет получателя."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
format: "string"
cronExpr:
maxLength: 200
minLength: 9
type: "string"
description: "CRON-выражение регулярности платежа. Нап\
ример, «0 12 * * *» — каждый день в 12:00 мск."
format: "string"
- title: "Триггерное правило"
required:
- "agreementId"
- "amount"
- "id"
- "replenishmentFilter"
- "requisites"
- "type"
type: "object"
properties:
type:
type: "string"
description: " Тип правила:\n\n* `Recurrent` — рекурре\
нтное правило;\n\n* `Trigger` — триггерное правило."
enum:
- "Recurrent"
- "Trigger"
id:
type: "string"
description: "ID правила."
format: "uuid"
agreementId:
type: "string"
description: "ID соглашения."
format: "uuid"
amount:
type: "object"
properties:
fixed:
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа в виде фиксированного\
\ значения."
format: "decimal"
nullable: true
percent:
multipleOf: 0.00010
maximum: 1
minimum: 0
exclusiveMinimum: true
type: "number"
description: "Сумма платежа в виде процента от сум\
мы пополнения. Значение 0.0001 соответствует 0.01%,\
\ а 1.0000 - 100%."
format: "decimal"
nullable: true
description: "Сумма платежа.\n\nВозможно представление\
\ в одном из двух видов: фиксированный или процентны\
й. Заполнять необходимо только одно из полей: либо `fixed`,\
\ либо `percent`."
replenishmentFilter:
required:
- "category"
type: "object"
properties:
payers:
maxItems: 50
type: "array"
description: "Данные компаний-инициаторов пополнен\
ий.\n\nПри заполнении данного поля списание буде\
т происходить, только когда инициатором пополнен\
ия является одна из компаний, указанных в поле.\n\
\nЗаполнение поля обязательно для правил с `category`\
\ = `CounterpartyIncome`. В иных случаях поле не\
\ заполняется."
nullable: true
items:
required:
- "inn"
- "kpp"
type: "object"
properties:
inn:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН."
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "КПП."
description: "Компания-инициатор операции пополн\
ения"
category:
type: "string"
description: "Категория операций пополнения, по ко\
торым будут производиться списания.\n\n`CashIn`\
\ - операции внесения наличных на счет контраген\
та.\n\n`MerchantAcq` - операции, проведенные по\
\ торговому эквайрингу.\n\n`InternetAcq` - опера\
ции, проведенные по интернет-эквайрингу.\n\n`CounterpartyIncome`\
\ - операции по входящим переводам от контрагент\
ов. "
enum:
- "CashIn"
- "MerchantAcq"
- "InternetAcq"
- "CounterpartyIncome"
description: "Условия, при которых должны проводиться\
\ списания по операциям пополнения.\n\nРаботает по п\
ринципу «и»: если заполнены несколько полей, то спис\
ания будут происходить, только если для каждого этих\
\ полей будет выполнено указанное условие.\n\nНаприм\
ер, если в `category` указано `CounterpartyIncome` и\
\ в `payers` указана компания с ИНН = 7777777777, сп\
исание будет происходить только при входящем перевод\
е от компании с ИНН = 7777777777."
requisites:
required:
- "docType"
- "payerAccount"
- "payerBIC"
- "payerCorAccount"
- "payerINN"
- "payerKPP"
- "payerName"
- "purpose"
- "recipientAccount"
type: "object"
properties:
docType:
type: "string"
description: " Тип платежного документа. `PaymentRequest`\
\ — платежное требование."
enum:
- "PaymentRequest"
paymentCondition:
type: "string"
description: " Условие платежа:\n\n* `WithAcceptance`\
\ — с акцептом;\n* `WithoutAcceptance` — без акц\
епта."
enum:
- "WithAcceptance"
- "WithoutAcceptance"
acceptTerm:
maximum: 9
minimum: 5
type: "integer"
description: "Количество дней для акцепта."
format: "int32"
nullable: true
docDispatchDate:
pattern: "^(\\d{4}-\\d{2}-\\d{2})$"
type: "string"
description: " Дата вручения плательщику предусмот\
ренных договором документов в формате `YYYY-MM-DD`."
nullable: true
payerAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Номер счета плательщика."
payerINN:
pattern: "^(\\d{10}|\\d{12})$"
type: "string"
description: "ИНН плательщика."
payerKPP:
pattern: "^(\\d{9}|0)$"
type: "string"
description: " КПП плательщика.\n\nЕсли КПП нет, п\
ередайте `0`."
payerName:
maxLength: 160
minLength: 1
type: "string"
description: "Наименование плательщика."
payerBIC:
pattern: "^(\\d{9})$"
type: "string"
description: "БИК плательщика."
payerCorAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Корреспондентский счет плательщика."
recipientAccount:
pattern: "^(\\d{20})$"
type: "string"
description: "Счет получателя."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
format: "string"
example:
offset: 0
limit: 50
size: 2
total: 2
results:
- id: "c31e2fc0-3a2b-4482-9025-6ec36ed857bc"
agreementId: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
type: "Recurrent"
cronExpr: "0 12 * * *"
requisites:
amount: 1000.55
docType: "PaymentRequest"
payerAccount: "12345678900987654321"
payerINN: "1234567890"
payerKPP: "123456789"
payerBIC: "044525974"
payerCorAccount: "30101810145250000974"
payerName: "ИП Петров Петр Иванович"
recipientAccount: "09876543211234567890"
purpose: "Платеж по соглашению №236383626412/2022-08-05/25.421"
paymentCondition: "WithoutAcceptance"
acceptTerm: 6
- id: "c31e2fc0-3a2b-4482-9025-6ec36ed857bc"
agreementId: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
type: "Trigger"
amount:
fixed: 1000.55
percent: null
replenishmentFilter:
payers:
- inn: "7777777777"
kpp: "987654321"
- inn: "8888888888"
kpp: "0"
category: "CounterpartyIncome"
requisites:
docType: "PaymentRequest"
payerAccount: "12345678900987654321"
payerINN: "1234567890"
payerKPP: "123456789"
payerBIC: "044525974"
payerCorAccount: "30101810145250000974"
payerName: "ИП Петров Петр Иванович"
recipientAccount: "09876543211234567890"
purpose: "Платеж по соглашению №236383626412/2022-08-05/25.421"
paymentCondition: "WithoutAcceptance"
acceptTerm: 6
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Соглашение не найдено:
value:
errorId: "bcadsa12"
errorCode: "NOT_FOUND"
errorMessage: "Resource not found"
Некорректно заполнено поле:
value:
errorId: "bcadsa12"
errorCode: "VALIDATION_ERROR"
errorMessage: "One or more validation errors occurred."
errorDetails:
ruleTypes:
- "The value '' is invalid."
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/self-employed/payment-registry/receipts/result:
get:
tags:
- "Выплаты самозанятым"
summary: "Получить результат запроса на получение чеков"
description: "Метод возвращает результат запроса на получение чеков."
operationId: "selfEmployedReceiptsResultV2"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "correlationId"
in: "query"
required: true
style: "form"
explode: true
schema:
type: "string"
description: "Идентификатор, связывающий запрос создания с запросом полу\
чения ответа."
format: "uuid"
responses:
"200":
description: "Успешный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус запроса на получение чеков"
example: "FINISHED"
enum:
- "FINISHED"
- "IN_PROGRESS"
- "ERROR"
error:
required:
- "errorCode"
- "errorMessage"
type: "object"
properties:
errorCode:
type: "string"
description: "Код ошибки"
format: "string"
errorMessage:
type: "string"
description: "Описание ошибки"
format: "string"
description: "Ошибка получения чеков по реестру"
receipts:
maxItems: 6000
type: "array"
description: "Результат регистрации дохода"
items:
required:
- "number"
- "selfEmployedInfo"
- "status"
type: "object"
properties:
number:
type: "integer"
description: "Идентификатор платежа на стороне клиента"
format: "int32"
example: 1
selfEmployedInfo:
required:
- "firstName"
- "lastName"
type: "object"
properties:
firstName:
type: "string"
description: "Имя (кириллица)"
format: "string"
lastName:
type: "string"
description: "Фамилия (кириллица)"
format: "string"
middleName:
type: "string"
description: "Отчество (кириллица)"
format: "string"
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН самозанятого"
recipientId:
type: "integer"
description: "Идентификатор самозанятого"
format: "int32"
description: "Данные самозанятого"
link:
type: "string"
description: "Ссылка на чек"
format: "url"
sum:
type: "number"
description: "Сумма"
format: "double"
example: 5000
comment:
maxLength: 128
type: "string"
description: "Комментарий"
status:
type: "string"
description: "Результат регистрации дохода"
enum:
- "IN_PROGRESS"
- "SUCCESS"
- "CANCELED"
- "FISCALIZE_FAILED"
- "ERROR"
error:
required:
- "errorCode"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 400
type: "string"
description: "Код ошибки"
errorMessage:
maxLength: 400
type: "string"
description: "Описание ошибки"
description: "Ошибка во время получения чека"
example:
status: "FINISHED"
receipts:
- number: 777
selfEmployedInfo:
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
inn: "173527033406"
recipientId: 123456789
link: "http://link.example"
sum: 12000
comment: "Зарплата Ивану"
status: "SUCCESS"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v2/self-employed/taxpayers/{inn}/status:
get:
tags:
- "Самозанятые"
summary: "Получить статус самозанятого"
description: "Метод возвращает информацию о статусе самозанятого, дате поста\
новки на учет, выданных Т-Банком правах, регионе и виде деятельности."
operationId: "getApiV2Self-employedTaxpayersInnStatus"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "inn"
in: "path"
required: true
style: "simple"
explode: false
schema:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "status"
type: "object"
properties:
status:
type: "string"
description: "Статус самозанятого в Т-Банке."
enum:
- "REGISTERED"
- "NOT_REGISTERED"
info:
required:
- "oktmo"
- "registeredAt"
type: "object"
properties:
registeredAt:
type: "string"
description: "Дата и время последней постановки на учет по\
\ UTC. Возвращается в формате ISO-8601
."
format: "date-time"
activityCodes:
maxItems: 256
type: "array"
description: "Виды деятельности, которые самозанятый указа\
л при регистрации."
items:
type: "string"
oktmo:
maxLength: 8
type: "string"
description: "Регион деятельности самозанятого."
permissions:
maxItems: 9
type: "array"
description: "Список прав, которые самозанятый выдал Т-Бан\
ку."
items:
type: "string"
enum:
- "PAYMENT_INFORMATION"
- "TAXPAYER_UPDATE"
- "CANCEL_ANY_INCOME"
- "CANCEL_INCOME"
- "INCOME_SUMMARY"
- "INCOME_REGISTRATION"
- "INCOME_LIST"
- "PERMISSIONS_MGMT"
- "TAX_PAYMENT"
description: "Объект с информацией о самозанятом."
application:
required:
- "changedAt"
- "status"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип заявки. Заявка создается при инициализац\
ии процесса регистрации клиента, снятии с учета или отвя\
зки."
enum:
- "REGISTRATION"
- "DEREGISTRATION"
- "BINDING"
- "UNBINDING"
- "CHANGE_PERMISSIONS"
status:
type: "string"
description: "Статус заявки."
enum:
- "IN_PROGRESS"
- "DONE"
changedAt:
type: "string"
description: "Дата и время последнего изменения данных по\
\ заявке по UTC. Возвращается в формате ISO-8601
."
format: "date-time"
result:
type: "string"
description: "Результат по заявке со статусом DONE
."
enum:
- "OK"
- "DENIED"
- "ERROR"
reason:
type: "string"
description: "Причина, по которой рассмотрение заявки не з\
авершилось успехом. Для заявок в статусе DONE
."
format: "string"
description: "Объект с информацией о последней заявке на измен\
ение самозанятости в Т-Банке.\n\nНачальный статус — IN_PROGRESS
,\
\ переходит в DONE
при завершении процесса — ка\
к успешном, так и с ошибкой.\n\nЕсли от пользователя требует\
ся выдать права в личном кабинете ФНС, будет иметь type BINDING
\
\ или CHANGE_PERMISSIONS
.\n\nПосле создания нов\
ой заявки предыдущая исчезает. Нельзя завести новую заявку,\
\ если статус текущей — IN_PROGRESS
."
examples:
Пример ответа REGISTERED DONE:
value:
status: "REGISTERED"
info:
registeredAt: "2022-05-12T14:03:40Z"
activityCodes:
- "100"
oktmo: "29000000"
permissions:
- "PAYMENT_INFORMATION"
- "TAXPAYER_UPDATE"
- "CANCEL_ANY_INCOME"
- "CANCEL_INCOME"
- "INCOME_SUMMARY"
- "INCOME_REGISTRATION"
- "INCOME_LIST"
- "PERMISSIONS_MGMT"
- "TAX_PAYMENT"
application:
type: "REGISTRATION"
status: "DONE"
changedAt: "2022-05-20T09:20:19Z"
result: "OK"
Пример ответа NOT_REGISTERED с заявкой:
value:
status: "NOT_REGISTERED"
application:
type: "BINDING"
status: "IN_PROGRESS"
changedAt: "2022-08-16T09:35:33Z"
Пример ответа NOT_REGISTERED без заявки:
value:
status: "NOT_REGISTERED"
Пример ответа NOT_REGISTERED DONE:
value:
status: "NOT_REGISTERED"
application:
status: "DONE"
type: "REGISTRATION"
result: "DENIED"
reason: "DEBTS_FOUND"
changedAt: "2022-08-16T09:35:33Z"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "cde4zxc5"
errorMessage: "One or more validation errors occurred."
errorCode: "VALIDATION_ERROR"
errorDetails:
inn: "'inn' must be valid INN, i.e. contain 10 or 12 characters\
\ each of which is a digit and at least one of which is not\
\ '0' and checksum matches"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v3/card/limits/set_batch:
put:
tags:
- "Бизнес-карты"
summary: "Установить лимиты по указанным картам"
description: "Метод для установки лимитов по указанным картам — период возоб\
новления лимитов, величина лимита."
operationId: "setCardsLimits"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
requestBody:
description: "Запрос на установку лимитов для списка карт"
content:
application/json:
schema:
required:
- "limits"
type: "object"
properties:
limits:
maxItems: 10000
type: "array"
description: "Список карт для установки лимитов."
items:
required:
- "ucid"
type: "object"
properties:
ucid:
type: "integer"
description: "Уникальный идентификатор карты."
spendLimit:
required:
- "limitPeriod"
- "limitValue"
type: "object"
properties:
limitPeriod:
type: "string"
description: "Период возобновления лимита."
enum:
- "DAY"
- "MONTH"
- "IRREGULAR"
limitValue:
type: "integer"
description: "Величина лимита в валюте счета, к которо\
му привязана карта."
description: "Общий расходный лимит."
cashLimit:
required:
- "limitPeriod"
- "limitValue"
type: "object"
properties:
limitPeriod:
type: "string"
description: "Период возобновления лимита."
enum:
- "DAY"
- "MONTH"
- "IRREGULAR"
limitValue:
type: "integer"
description: "Величина лимита в валюте счета, к которо\
му привязана карта."
description: "Лимит на снятие наличных."
description: "Запрос на установку лимитов для одной карты."
description: "Запрос на установку лимитов для списка карт."
example:
limits:
- ucid: 1029374074
spendLimit:
limitValue: 23400
limitPeriod: "MONTH"
cashLimit:
limitValue: 25000
limitPeriod: "DAY"
required: true
responses:
"200":
description: "Результат установки лимитов для карт"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "limits"
type: "object"
properties:
limits:
maxItems: 10000
type: "array"
description: "Результаты установки лимитов."
items:
required:
- "ucid"
type: "object"
properties:
ucid:
type: "integer"
description: "Уникальный идентификатор карты."
spendLimit:
required:
- "isSuccess"
type: "object"
properties:
isSuccess:
type: "boolean"
description: "Успешность установки лимита."
errorMessage:
type: "string"
description: "Сообщение об ошибке, если лимит не уст\
ановлен."
format: "string"
description: "Результат установки лимита."
cashLimit:
required:
- "isSuccess"
type: "object"
properties:
isSuccess:
type: "boolean"
description: "Успешность установки лимита."
errorMessage:
type: "string"
description: "Сообщение об ошибке, если лимит не уст\
ановлен."
format: "string"
description: "Результат установки лимита."
description: "Результат установки лимитов для одной карты."
description: "Список результатов установки лимитов для карт."
example:
limits:
- ucid: 1029374074
spendLimit:
isSuccess: true
cashLimit:
isSuccess: false
errorMessage: "Can't change the limit"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v3/card/virtual/issue/application:
get:
tags:
- "Бизнес-карты"
summary: "Получить список заявок на виртуальные карты"
description: "Метод возвращает список заявок на виртуальные карты."
operationId: "getVirtualApplicationsList"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "limit"
in: "query"
description: "Количество заявок в списке."
required: true
style: "form"
explode: true
schema:
type: "integer"
- name: "offset"
in: "query"
description: "Номер первой заявки в списке."
required: true
style: "form"
explode: true
schema:
type: "integer"
responses:
"200":
description: "Запрошенный список заявок"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
maxItems: 10000
type: "array"
description: "Список заявок."
items:
required:
- "cardIssueApplicationId"
- "status"
type: "object"
properties:
cardIssueApplicationId:
type: "string"
description: "Идентификатор заявки."
format: "uuid"
status:
maxLength: 21
type: "string"
description: "Статус заявки:\n\n* `FAILED_FATAL` — не можем\
\ выпустить карту данному физ. лицу;\n* `FAILED_NON_FATAL`\
\ — проблема с документами и исходными данными. Подайте за\
явку еще раз."
enum:
- "NEW"
- "IDENTIFICATION"
- "ISSUING"
- "CARD_ISSUED"
- "FAILED_FATAL"
- "FAILED_NON_FATAL"
ucid:
maxLength: 10
type: "string"
description: "UCID выпущенной карты."
description: "Данные заявки на виртуальную карту."
examples:
Пустой список заявок:
description: "Пустой список заявок"
value: []
Список заявок:
description: "Непустой список заявок"
value:
- cardIssueApplicationId: "6bcbca1f-b01d-4796-88bb-d4e868c07a68"
status: "NEW"
- cardIssueApplicationId: "3edcdf90-95d4-4466-ab98-75436076d9cb"
status: "CARD_ISSUED"
ucid: "1140102097"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка валидации:
description: "Ошибка валидации"
value:
errorMessage: "Некорректное значение поля запроса"
errorId: "01234567890123456789"
errorCode: "REQUEST_DATA_VALIDATION_ERROR"
errorDetails:
field: "Название невалидного поля"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v3/company/card:
get:
tags:
- "Бизнес-карты"
summary: "Получить список карт компании"
description: "Метод для получения списка карт компании."
operationId: "getApiV3Card"
parameters:
- name: "X-Request-Id"
in: "header"
description: "Уникальный идентификатор для трассировки запроса. Не влияет\
\ на логику исполнения запроса."
required: false
allowEmptyValue: false
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
format: "uuid"
- name: "accountNumber"
in: "query"
description: "Номер расчетного счета, к которому привязана карта."
required: false
style: "form"
explode: true
schema:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
- name: "limit"
in: "query"
description: "Количество карт, которое нужно вывести. Значение по умолчани\
ю — `1000`."
required: false
style: "form"
explode: true
schema:
maximum: 3000
type: "integer"
- name: "offset"
in: "query"
description: "Количество карт, которые необходимо пропустить. Значение по\
\ умолчанию — `0`."
required: false
style: "form"
explode: true
schema:
type: "integer"
responses:
"200":
description: "Запрошенный список карт"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "cards"
- "limit"
- "offset"
type: "object"
properties:
cards:
maxItems: 10000
type: "array"
description: "Список карт."
items:
required:
- "accountNumber"
- "cardBin"
- "cardLastFourDigits"
- "embossedName"
- "isActive"
- "isVirtual"
- "status"
- "ucid"
type: "object"
properties:
ucid:
type: "integer"
description: "Уникальный идентификатор карты."
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета, к которому привяза\
на карта."
cardBin:
pattern: "^(\\d{6})$"
type: "string"
description: "Первые 6 цифр номера карты (BIN карты)."
cardLastFourDigits:
pattern: "^(\\d{4})$"
type: "string"
description: "Последние 4 цифры номера карты."
embossedName:
maxLength: 100
type: "string"
description: "Имя держателя карты."
isActive:
type: "boolean"
description: "Флаг активации карты."
status:
type: "string"
description: "Статус карты."
enum:
- "NORM"
- "CLOSED"
- "BLOCKED"
isVirtual:
type: "boolean"
description: "Флаг виртуальной карты."
description: "Данные карты."
offset:
type: "integer"
description: "Запрошенный оффсет."
limit:
type: "integer"
description: "Запрошенный лимит."
description: "Список карт."
examples:
Список карт:
description: "Список карт"
value:
cards:
- ucid: 2147484647
accountNumber: "12345678901234567890"
cardBin: "404006"
cardLastFourDigits: "2222"
embossedName: "IVAN IVANOV"
isActive: true
status: "NORM"
isVirtual: true
offset: 0
limit: 1000
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при неактивном токене:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Токен недействителен"
errorCode: "UNAUTHORIZED"
Ошибка при неправильно заданной компании:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Компания с такими ИНН/КПП не найдена. Проверьте\
\ реквизиты. Если реквизиты изменились, необходимо перевыпус\
тить токен."
errorCode: "UNAUTHORIZED"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при отсутствии доступов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "У вас неподходящие скопы для данной операции, т\
ребуемые скопы: scope"
errorCode: "FORBIDDEN"
Ошибка при запросе с неизвестного IP:
value:
errorId: "efc04138-7d50-40f9-a367-0e1ca4d7cd49"
errorMessage: "Запрос был отправлен с IP-адреса, который не бы\
л указан при получении токена. Пожалуйста, укажите этот IP-а\
дрес при получении нового токена"
errorCode: "FORBIDDEN"
Ошибка при отсутствии прав на использование продукта:
value:
errorId: "5d1de3e5-82b9-4b1d-b805-a9de95cf83bb"
errorMessage: "Недостаточно прав на совершаемое действие. Свяж\
итесь с вашим менеджером, чтобы подключить данную функционал\
ьность. "
errorCode: "FORBIDDEN"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при недостатке средств:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Ошибка при превышении лимитов запросов:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
maxLength: 50
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
errorDetails:
type: "object"
description: "Дополнительные данные об ошибке."
errorId:
maxLength: 50
type: "string"
description: "Уникальный идентификатор ошибки."
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
examples:
Непредвиденная ошибка:
value:
errorId: "60324c74-e4b9-477d-baae-786956876a28"
errorMessage: "Непредвиденная ошибка. Попробуйте позже"
errorCode: "INTERNAL_ERROR"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
- url: "https://secured-openapi.tbank.ru"
description: "Production"
/api/v1/company/signer/status:
get:
tags:
- "T-Business ID. Информация о компании"
summary: "Получить информацию о статусе подписанта"
description: "Метод возвращает информацию о том, является ли пользователь по\
дписантом.\nПользователь должен дать согласие на доступ к просмотру информ\
ации о статуcе подписанта.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/signer/get
\
\ — Информация о статусе подписанта в компании с ИНН {inn} и КПП {kpp}
.\n\
\ "
operationId: "getApiV1CompanySignerStatus"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/SignerStatusResponse"
example:
isSigner: true
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/individual/documents/driver-licenses:
get:
tags:
- "T-ID. Информация о пользователе"
summary: "Получить водительские удостоверения"
description: "Метод для получения водительских удостоверений физического лиц\
а.\n\n\nЧтобы использовать метод, нужен доступ — opensme/individual/driver-licenses/get
\
\ — Водительские удостоверения
.\n "
operationId: "getApiV1IndividualDocumentsDriver-licenses"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/DriverLicensesResponse"
example:
licenses:
- docNumber: "1122334455"
issueDate: "2020-10-01"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/individual/documents/inn:
get:
tags:
- "T-ID. Информация о пользователе"
summary: "Получить ИНН"
description: "Метод для получения ИНН пользователя.\n\n\nЧтобы использовать\
\ метод, нужен доступ — opensme/individual/inn/get
— ИН\
Н
.\n "
operationId: "getApiV1IndividualDocumentsInn"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InnResponse"
example:
inn: "719351678037"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/individual/documents/snils:
get:
tags:
- "T-ID. Информация о пользователе"
summary: "Получить СНИЛС"
description: "Метод для получения СНИЛС пользователя.\n\n\nЧтобы использоват\
ь метод, нужен доступ — opensme/individual/snils/get
— С\
НИЛС
.\n "
operationId: "getApiV1IndividualDocumentsSnils"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/SnilsResponse"
example:
snils: "95661068844"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/individual/accounts/debit:
get:
tags:
- "T-ID. Информация о пользователе"
summary: "Получить информацию об активных дебетовых счетах клиента"
description: "Метод возвращает информацию об активных дебетовых счетах — пол\
учатель, счет получателя, данные по банку.\n\n\nЧтобы использовать метод,\
\ нужен доступ opensme/individual/accounts/debit/get
— Р\
еквизиты дебетовых счетов
.\n "
operationId: "getApiV1IndividualAccountsDebit"
responses:
"200":
description: "Активные дебетовые счета"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/DebitAccountsResponse"
example:
accounts:
- name: "Иванов Иван Иванович"
accountNumber: "40802123456789012345"
bank:
bik: "044525974"
corAccount: "30101810145250000974"
name: "АО \"ТБанк\""
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/individual/subscription:
get:
tags:
- "T-ID. Информация о пользователе"
summary: "Получить информацию об активной подписке клиента"
description: "Метод возвращает информацию с типом активной подписки.\n\n\nЧт\
обы использовать метод, нужен доступ opensme/individual/subscription/get
\
\ — Информация о подписке для определения статуса и доступа к опреде\
ленным привилегиям
.\n "
operationId: "getApiV1IndividualSubscription"
responses:
"200":
description: "Информация о подписке клиента"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/SubscriptionResponse"
example:
type: "PREMIUM"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/individual/cobrand/{programId}:
get:
tags:
- "T-ID. Информация о пользователе"
summary: "Получить признак кобренда"
description: "Метод возвращает признак наличия карты кобренда.\n\n\nВ поле scopes
\
\ у токена должен быть доступ вида opensme/individual/cobrand/status/get
\
\ — по нему можно посмотреть наличие статуса кобрэнда.\n "
operationId: "getApiV1IndividualCobrandProgramid"
parameters:
- name: "programId"
in: "path"
description: "Уникальный ID программы лояльности партнера."
required: true
style: "simple"
explode: false
schema:
type: "integer"
description: "Идентификатор программы лояльности"
format: "int32"
example: 42
responses:
"200":
description: "Признак кобренда по клиенту"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CobrandResponse"
example:
programStatus: true
accounts:
- cardType: "CREDIT"
loyaltyId: "123"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/salary/employees/create:
post:
tags:
- "Зарплатный проект"
summary: "Создать черновики анкет сотрудников"
description: "Запрос является асинхронной операцией — его результат можно по\
лучить через вызов метода Получить результат создания черновиков анкет сотрудников, передав в н\
ем соответствующий correlationId.\n\n\nЧтобы использовать метод, ну\
жен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/salary/employees/manage
\
\ — Добавление и получение информации о сотрудниках компании с ИНН {inn}\
\ и КПП {kpp}
.\n\n\nОграничение на использование метода — 1 запрос\
\ в секунду.\n "
operationId: "SalaryCreateEmployee"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CreateEmployeesRequest"
examples:
Гражданин РФ:
summary: "Гражданин РФ"
value:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
employees:
- number: 1
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
birthDate: "1967-12-25"
birthPlace: "Санкт-Петербург"
citizenship: "Санкт-Петербург"
email: "example@example.com"
latinFirstName: "Ivan"
latinLastName: "Ivanov"
phones:
- type: "Мобильный"
number: "+72565121024"
addresses:
- type: "Работы"
country: "Россия"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Херсонская"
house: "12"
building: "1"
construction: "1"
apartment: "512"
- type: "Жительства"
country: "Россия"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Таллинская"
house: "4"
building: "8"
construction: "16"
apartment: "20"
- type: "Жительства"
country: "РОССИЯ"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Таллинская"
house: "4"
building: "8"
construction: "16"
apartment: "20"
documents:
- type: "Паспорт"
serial: "1234"
number: "123456"
date: "2015-05-09"
organization: "ФМС"
division: "123-123"
expireDate: "2025-05-09"
jobInfo:
position: "программист"
Иностранный гражданин:
summary: "Иностранный гражданин"
value:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
employees:
- number: 1
firstName: "Шерлок"
lastName: "Холмс"
birthDate: "1934-03-09"
birthPlace: "Эдинбург"
citizenship: "Соединенное Королевство"
email: "example@example.com"
latinFirstName: "Sherlock"
latinLastName: "Holmes"
phones:
- type: "Мобильный"
number: "+72565121024"
addresses:
- type: "Работы"
country: "Россия"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Херсонская"
house: "12"
building: "1"
construction: "1"
apartment: "512"
- type: "Жительства"
country: "Россия"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Таллинская"
house: "4"
building: "8"
construction: "16"
apartment: "20"
- type: "Жительства"
country: "РОССИЯ"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Таллинская"
house: "4"
building: "8"
construction: "16"
apartment: "20"
documents:
- type: "Загр. паспорт иностранного гр."
serial: "1234"
number: "123456"
date: "2015-05-09"
organization: "Migration service of the United Kingdom"
expireDate: "2025-05-09"
- type: "Вид на жительство"
serial: "1234"
number: "123456"
date: "2015-05-09"
organization: "ФМС"
expireDate: "2025-05-09"
jobInfo:
position: "детектив"
Гражданин РФ + Иностранный гражданин:
summary: "Гражданин РФ + Иностранный гражданин"
value:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
employees:
- number: 1
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
birthDate: "1967-12-25"
birthPlace: "Санкт-Петербург"
citizenship: "Санкт-Петербург"
email: "example@example.com"
latinFirstName: "Ivan"
latinLastName: "Ivanov"
phones:
- type: "Мобильный"
number: "+72565121024"
addresses:
- type: "Работы"
country: "Россия"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Херсонская"
house: "12"
building: "1"
construction: "1"
apartment: "512"
- type: "Жительства"
country: "Россия"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Таллинская"
house: "4"
building: "8"
construction: "16"
apartment: "20"
- type: "Жительства"
country: "РОССИЯ"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Таллинская"
house: "4"
building: "8"
construction: "16"
apartment: "20"
documents:
- type: "Паспорт"
serial: "1234"
number: "123456"
date: "2015-05-09"
organization: "ФМС"
division: "123-123"
expireDate: "2025-05-09"
jobInfo:
position: "программист"
- number: 2
firstName: "Шерлок"
lastName: "Холмс"
birthDate: "1934-03-09"
birthPlace: "Эдинбург"
citizenship: "Соединенное Королевство"
email: "example@example.com"
latinFirstName: "Sherlock"
latinLastName: "Holmes"
phones:
- type: "Мобильный"
number: "+72565121024"
addresses:
- type: "Работы"
country: "Россия"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Херсонская"
house: "12"
building: "1"
construction: "1"
apartment: "512"
- type: "Жительства"
country: "Россия"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Таллинская"
house: "4"
building: "8"
construction: "16"
apartment: "20"
- type: "Жительства"
country: "РОССИЯ"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Таллинская"
house: "4"
building: "8"
construction: "16"
apartment: "20"
documents:
- type: "Загр. паспорт иностранного гр."
serial: "1234"
number: "123456"
date: "2015-05-09"
organization: "Migration service of the United Kingdom"
expireDate: "2025-05-09"
- type: "Вид на жительство"
serial: "1234"
number: "123456"
date: "2015-05-09"
organization: "ФМС"
expireDate: "2025-05-09"
jobInfo:
position: "детектив"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CreateEmployeesResponse"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/salary/employees/create/result:
get:
tags:
- "Зарплатный проект"
summary: "Получить результат создания черновиков анкет сотрудников"
description: "Возвращает результат запроса для метода Создание черновиков анкет сотрудников.\nОтвет на запрос создания хран\
ится в течение двух дней.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/salary/employees/manage
\
\ — Добавление и получение информации о сотрудниках компании с ИНН {inn}\
\ и КПП {kpp}
.\n\n\nОграничение на использование метода — 1 запрос\
\ в секунду.\n "
operationId: "SalaryGetEmployeesCreateResult"
parameters:
- name: "correlationId"
in: "query"
description: "Уникальный идентификатор типа UUID, который связывает запрос создания с запросом получения ответа\
. Формируется на стороне клиента.\n\n\nОграничение на использование мето\
да — 1 запрос в секунду.\n "
required: true
style: "form"
explode: true
schema:
type: "string"
format: "uuid"
example: "cf99df08-0829-4614-8da3-0e440fd23fe0"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CreateEmployeeResultResponse"
examples:
Example0:
value:
employeeResults:
- number: 1
employeeId: 2
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
status: "CREATED"
errors: []
Example1:
value:
employeeResults:
- number: 1
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
status: "ERROR"
errors:
- fieldName: "Дата рождения"
errorDescription: "Вам должно быть от 14 до 100 лет"
- fieldName: "Документ"
errorDescription: "Дата должна быть не ранее 01.07.1997"
- fieldName: "Адрес"
errorDescription: "Отсутствует адрес данного типа"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/salary/employees/list:
post:
tags:
- "Зарплатный проект"
summary: "Получить информацию по сотрудникам"
description: "Вызывайте метод не чаще одного раза в 10 минут.\n\n\nЗаявка на\
\ добавление сотрудника создается в статусе DRAFT
. После этог\
о ее нужно отправить в личном кабинете. Отправленный сотрудник перейдет в\
\ статус ACTIVE
.\n\n\nЧтобы использовать метод, нужен доступ\
\ — opensme/inn/[{inn}]/kpp/[{kpp}]/salary/employees/manage
—\
\ Добавление и получение информации о сотрудниках компании с ИНН {inn}\
\ и КПП {kpp}
.\n\n\nОграничение на использование метода — 1 запрос\
\ в секунду.\n "
operationId: "SalaryGetEmployeesList"
requestBody:
description: "Список идентификаторов сотрудников. Ограничение на использов\
ание метода — 1 запрос в секунду."
content:
application/json:
schema:
$ref: "#/components/schemas/EmployeesInfoRequest"
example:
employeeIds:
- 217
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/EmployeeResponse"
example:
employees:
- id: 217
status: "DRAFT"
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
birthDate: "1967-12-25"
phones:
- type: "Мобильный"
number: "+72565121024"
documents:
- type: "Паспорт"
serial: "1234"
number: "123456"
date: "2015-05-09"
organization: "ФМС"
division: "123-123"
expireDate: "2025-05-09"
jobInfo:
position: "программист"
bankInfo:
accountNumber: "40802123456789012345"
agreementNumber: "1234567890"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/salary/payment-registry/create:
post:
tags:
- "Зарплатный проект"
summary: "Создать черновик платежного реестра"
description: "Запрос является асинхронной операцией — его результат можно по\
лучить через метод Получит\
ь результат создания платежного реестра, передав в нем соответствующий\
\ correlationId.\n\nВ реестр можно добавить сотрудников, которые на\
ходятся в статусах `ACTIVE` и `FIRED`.\n\nЧтобы использовать метод, нужен\
\ доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/salary/payment-registry/manage
\
\ — Добавление и получение информации о платежных реестрах компании\
\ с инн {inn} и кпп {kpp}
.\n\nОграничение на использование метода —\
\ 1 запрос в секунду.\n "
operationId: "SalaryCreatePaymentRegistry"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CreatePaymentRegistryRequest"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
companyAccountNumber: "40802123456789012345"
loadDate: "2015-05-09T12:30"
registryCreateType: "FAIL_ERRORS"
payments:
- number: 1
accountNumber: "12345678901234567890"
paymentPurpose: "Зарплата"
employeeInfo:
firstName: "Петр"
lastName: "Петров"
middleName: "Петрович"
sum: 65000
periodStart: "2015-05-09"
periodEnd: "2016-05-09"
revenueTypeCode: "2"
collectionAmount: 50
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CreatePaymentRegistryResponse"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/salary/payment-registry/create/result:
get:
tags:
- "Зарплатный проект"
summary: "Получить результат создания черновика платежного реестра"
description: "Метод возвращает результат запроса для метода Создать платежный реестр.\nРезультат создания хранится в течение двух\
\ дней.\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/salary/payment-registry/manage
\
\ — Добавление и получение информации о платежных реестрах компании\
\ с ИНН {inn} и КПП {kpp}
.\n\nОграничение на использование метода —\
\ 1 запрос в секунду.\n "
operationId: "SalaryGetPaymentRegistryCreateResult"
parameters:
- name: "correlationId"
in: "query"
description: "Идентификатор, связывающий запрос создания с запросом получе\
ния ответа."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "uuid"
example: "cf99df08-0829-4614-8da3-0e440fd23fe0"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CreatePaymentRegistryResultResponse"
examples:
Example0:
value:
paymentRegistryId: 1
status: "CREATED"
paymentErrors: []
Example1:
value:
status: "ERROR"
error:
fieldName: "Ошибка создания платежного реестра"
errorDescription: "Непредвиденная ошибка. Пожалуйста, попроб\
уйте позже."
paymentErrors:
- number: 1
accountNumber: "40802123456789012345"
errors:
- fieldName: "Номер счета"
errorDescription: "Неверный номер счета"
- fieldName: "Номер договора"
errorDescription: "Номер договора не найден"
- fieldName: "Статус сотрудника"
errorDescription: "Не удалось найти среди активных и бывши\
х сотрудников компании"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/salary/payment-registry/{paymentRegistryId}:
get:
tags:
- "Зарплатный проект"
summary: "Получить информацию по платежному реестру"
description: "Метод для получения информации по платежному реестру — статус\
, дата отправки, номер счета компании, с которого будут списаны деньги,\nс\
умма и список платежей, их количество.\nВызывайте не чаще одного раза в 10\
\ минут.\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/salary/payment-registry/manage
\
\ — Добавление и получение информации о платежных реестрах компании\
\ с ИНН {inn} и КПП {kpp}
.\"\n\nОграничение на использование метода\
\ — 1 запрос в секунду.\n "
operationId: "SalaryGetPaymentRegistry"
parameters:
- name: "paymentRegistryId"
in: "path"
description: "Номер платежного реестра."
required: true
style: "simple"
explode: false
schema:
type: "integer"
format: "int32"
example: 5
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/PaymentRegistryResponse"
example:
status: "EXECUTED"
companyAccountNumber: "40816810800000122870"
loadDate: "2015-05-09T12:30"
paymentsCount: 2
totalSum: 1000
payments:
- number: 1
status: "EXECUTED"
employeeInfo:
firstName: "Петр"
lastName: "Петров"
middleName: "Петрович"
employeeId: 123456789
accountNumber: "40802678901234567890"
paymentPurpose: "Зарплата"
sum: 750
periodStart: "2015-05-09"
periodEnd: "2016-05-09"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/salary/payment-registry/submit:
post:
tags:
- "Зарплатный проект"
summary: "Подписать платежный реестр сотрудников"
description: "Запрос является асинхронной операцией — его результат можно по\
лучить через метод Получить результат подписания платежного реестра, передав в нем соотв\
етствующий correlationId.\n\nДанный метод позволяет подписать черно\
вик платежного реестра, чтобы оплатить его позже через метод Оплатить реестр или через личный кабинет.\n\nЧтобы использовать метод\
, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/salary/payment-registry/submit
\
\ — Подписание платежных реестров по сотрудникам компании с ИНН {inn}\
\ и КПП {kpp}
.\n\nОграничение на использование метода — 1 запрос в\
\ секунду.\n "
operationId: "SalaryPaymentRegistrySubmit"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/PaymentRegistrySubmitRequest"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
paymentRegistryId: 12
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/PaymentRegistrySubmitResponse"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/salary/payment-registry/submit/result:
get:
tags:
- "Зарплатный проект"
summary: "Получить результат подписания платежного реестра сотрудников"
description: "Метод возвращает результат запроса для метода Подписать платежный реестр сотрудников.\nРезультат создания хранится\
\ в течение двух дней.\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/salary/payment-registry/submit
\
\ — Подписание платежных реестров по сотрудникам компании с ИНН {inn}\
\ и КПП {kpp}
.\n\nОграничение на использование метода — 1 запрос в\
\ секунду.\n "
operationId: "SalaryPaymentRegistrySubmitResult"
parameters:
- name: "correlationId"
in: "query"
description: "Идентификатор, связывающий запрос создания с запросом получе\
ния ответа."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "uuid"
example: "cf99df08-0829-4614-8da3-0e440fd23fe0"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/PaymentRegistrySubmitResultResponse"
examples:
Example0:
value:
paymentRegistryId: 12
status: "ACCEPTED"
paymentErrors: []
Example1:
value:
paymentRegistryId: 12
status: "ERROR"
error:
errorCode: "INTERNAL_ERROR"
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте\
\ позже."
paymentErrors:
- number: 1
accountNumber: "40802123456789012345"
errors:
- fieldName: "Номер счета"
errorDescription: "Неверный номер счета"
- fieldName: "Номер договора"
errorDescription: "Номер договора не найден"
- fieldName: "Статус сотрудника"
errorDescription: "Не удалось найти среди активных и бывши\
х сотрудников компании"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/self-employed/recipients/create:
post:
tags:
- "Выплаты самозанятым"
summary: "Создать черновики анкет самозанятых"
description: "Метод для создания черновиков анкет самозанятых.\n\n\nЗапрос а\
синхронный. Его результат можно получить через вызов метода Получить результат создания самозанятого с выпуском карты, передав в\
\ нем соответствующий correlationId.\n\n\nЧтобы использовать метод\
, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/recipients/manage
\
\ — Добавление и получение информации о самозанятых компании с ИНН {inn}\
\ и КПП {kpp}
.\n\n\nОграничение на использование метода — 1 запрос\
\ в секунду.\n "
operationId: "SelfEmployedCreateSelfEmployed"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CreateSelfEmployedRequest"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
recipients:
- number: 1
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
birthDate: "1967-12-25"
birthPlace: "Санкт-Петербург"
citizenship: "Санкт-Петербург"
email: "example@example.com"
latinFirstName: "Ivan"
latinLastName: "Ivanov"
phones:
- type: "Мобильный"
number: "+72565121024"
addresses:
- type: "Жительства"
country: "Россия"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Херсонская"
house: "12"
building: "1"
construction: "1"
apartment: "512"
- type: "Регистрации"
country: "Россия"
postalCode: "123123"
state: "Санкт-Петербург"
city: "Санкт-Петербург"
district: "Санкт-Петербург"
settlement: "Санкт-Петербург"
street: "ул. Херсонская"
house: "12"
building: "1"
construction: "1"
apartment: "512"
documents:
- type: "Паспорт"
serial: "2048"
number: "131072"
date: "2015-05-09"
organization: "ФМС"
division: "256-512"
expireDate: "2025-05-09"
registrationInfo:
oktmo: "oktmo"
activityCodes:
- "1"
- "2"
- "3"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CreateSelfEmployedResponse"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/self-employed/recipients/create/result:
get:
tags:
- "Выплаты самозанятым"
summary: "Получить результат создания черновиков анкет самозанятых"
description: "Метод возвращает результат запроса на создание самозанятого.\n\
Ответ на запрос создания хранится в течение двух дней.\n\n\nЧтобы использо\
вать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/recipients/manage
\
\ — Добавление и получение информации о самозанятых компании с ИНН {inn}\
\ и КПП {kpp}
.\n\n\nОграничение на использование метода — 1 запрос\
\ в секунду.\n "
operationId: "SelfEmployedGetSelfEmployedCreateResult"
parameters:
- name: "correlationId"
in: "query"
description: "Идентификатор, связывающий запрос создания с запросом получе\
ния ответа."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "uuid"
example: "cf99df08-0829-4614-8da3-0e440fd23fe0"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CreateSelfEmployedResultResponse"
examples:
Example0:
value:
recipientResults:
- number: 1
recipientId: 2
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
status: "CREATED"
errors: []
Example1:
value:
recipientResults:
- number: 1
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
status: "ERROR"
errors:
- fieldName: "Дата рождения"
errorDescription: "Вам должно быть от 14 до 100 лет"
- fieldName: "Документ"
errorDescription: "Дата должна быть не ранее 01.07.1997"
- fieldName: "Адрес"
errorDescription: "Отсутствует адрес данного типа"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/self-employed/recipients/list:
post:
tags:
- "Выплаты самозанятым"
summary: "Получить информацию по самозанятым"
description: "Метод для получения информации по самозанятым. Вызывайте не ча\
ще одного раза в 10 минут.\n\n\nЗаявка для добавления самозанятого создает\
ся в статусе DRAFT
. После этого ее нужно отправить в личном к\
абинете. Отправленный самозанятый перейдет в статус ACTIVE
.\n\
\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/recipients/manage
\
\ — Добавление и получение информации о самозанятых компании с ИНН {inn}\
\ и КПП {kpp}
.\n\n\nОграничение на использование метода — 1 запрос\
\ в секунду.\n "
operationId: "SelfEmployedList"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedListRequest"
example:
recipientIds:
- 1
- 2
- 3
inn:
- "502805064090"
status:
- "PROCESSING"
- "DRAFT"
- "PROCESSING_ERROR"
- "ACTIVE"
- "ERROR"
- "REJECTED"
- "DELETED"
- "MTNG_SCHD"
- "MTNG_WAIT"
- "MTNG_CANC"
selfEmployedStatus:
- "REGISTRATION_WAIT"
- "NOT_CONFIRM"
- "NOT_ACTIVE"
- "ACTIVE"
creationDate:
from: "2022-12-27T12:02:08Z"
to: "2022-12-29T15:02:00Z"
offset: 0
limit: 20
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedResponse"
example:
recipients:
- id: 1
status: "ACTIVE"
selfEmployedStatus: "ACTIVE"
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
birthDate: "1958-09-05"
phones:
- type: "Мобильный"
number: "+72565121024"
documents:
- type: "Паспорт"
serial: "2048"
number: "131072"
date: "2015-05-09"
organization: "ФМС Семи Королевств"
division: "256-512"
expireDate: "2025-05-09"
registrationInfo:
oktmo: "oktmo"
activityCodes:
- "1"
- "2"
- "3"
bankInfo:
accountNumber: "40817678901234567890"
agreementNumber: "7007131001"
bankBic: "044525187"
inn: "719351678037"
creationDate: "2023-01-05T11:39:04Z"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/self-employed/payment-registry/create:
post:
tags:
- "Выплаты самозанятым"
summary: "Создать черновик платежного реестра"
description: "Метод для создания черновика платежного реестра.\n\n\nЗапрос а\
синхронный. Его результат можно получить через вызов метода Получить результат создания платежного реестра, передав в нем соответ\
ствующий correlationId.\n\n\nВы можете добавлять в реестр самозянят\
ых, которые находятся в статусах ACTIVE
и FIRED
.\n\
\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/payment-registry/manage
\
\ — Добавление и получение информации о платежных реестрах по самоза\
нятым компании с ИНН {inn} и КПП {kpp}
.\n\n\nОграничение на использ\
ование метода — 1 запрос в секунду.\n "
operationId: "SelfEmployedCreatePaymentRegistry"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedCreatePaymentRegistryRequest"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
companyAccountNumber: "40802123456789012345"
registryCreateType: "FAIL_ERRORS"
payments:
- number: 1
accountNumber: "12345678901234567890"
paymentPurpose: "Оплата по договору"
selfEmployedInfo:
firstName: "Петр"
lastName: "Петров"
middleName: "Петрович"
sum: 750
revenueTypeCode: "2"
taxHolding: true
incomeType: "FROM_LEGAL_ENTITY"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedCreatePaymentRegistryResponse"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/self-employed/payment-registry/create/result:
get:
tags:
- "Выплаты самозанятым"
summary: "Получить результат создания черновика платежного реестра"
description: "Возвращает результат запроса для метода Создать черновик платежного реестра.\nРезультат создания хранится в т\
ечение двух дней.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/payment-registry/manage
\
\ — Добавление и получение информации о платежных реестрах по самоза\
нятым компании с ИНН {inn} и КПП {kpp}
.\n\n\nОграничение на использ\
ование метода — 1 запрос в секунду.\n "
operationId: "SelfEmployedGetPaymentRegistryCreateResult"
parameters:
- name: "correlationId"
in: "query"
description: "Идентификатор, связывающий запрос создания с запросом получе\
ния ответа."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "uuid"
example: "cf99df08-0829-4614-8da3-0e440fd23fe0"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedCreatePaymentRegistryResultResponse"
examples:
Example0:
value:
paymentRegistryId: 1
status: "CREATED"
paymentErrors: []
Example1:
value:
status: "ERROR"
error:
fieldName: "Ошибка создания платежного реестра"
errorDescription: "Непредвиденная ошибка. Пожалуйста, попроб\
уйте позже."
paymentErrors:
- number: 1
accountNumber: "40802123456789012345"
errors:
- fieldName: "Номер счета"
errorDescription: "Неверный номер счета"
- fieldName: "Номер договора"
errorDescription: "Номер договора не найден"
- fieldName: "Статус сотрудника"
errorDescription: "Не удалось найти среди активных и бывши\
х сотрудников компании"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/self-employed/payment-registry/{paymentRegistryId}:
get:
tags:
- "Выплаты самозанятым"
summary: "Получить информацию по платежному реестру"
description: "Вызывайте метод не чаще одного раза раз в 10 минут.\n\n\nЧтобы\
\ использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/payment-registry/manage
\
\ — Добавление и получение информации о платежных реестрах по самоза\
нятым компании с ИНН {inn} и КПП {kpp}
.\n\n\nОграничение на использ\
ование метода — 1 запрос в секунду.\n "
operationId: "SelfEmployedGetPaymentRegistry"
parameters:
- name: "paymentRegistryId"
in: "path"
description: "Номер платежного реестра."
required: true
style: "simple"
explode: false
schema:
type: "integer"
format: "int32"
example: 12
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedPaymentRegistry"
example:
status: "EXECUTED"
loadDate: "2015-05-09T12:30"
paymentsCount: 2
totalSum: 1000
payments:
- number: 1
status: "EXECUTED"
selfEmployedInfo:
firstName: "Петр"
lastName: "Петров"
middleName: "Петрович"
accountNumber: "40802678901234567890"
paymentPurpose: "Оплата по договору"
sum: 750
revenueTypeCode: "1"
collectionAmount: 50
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/self-employed/payment-registry/submit:
post:
tags:
- "Выплаты самозанятым"
summary: "Подписать платежный реестр самозанятых"
description: "Метод позволяет подписать черновик платежного реестра, чтобы о\
платить его позже через метод Оплатить реестр или через личный кабинет.\n\n\nЗапрос асинхронный. Ег\
о результат можно получить через вызов метода Получить результат подписания платежного реестра, передав в нем соотв\
етствующий correlationId.\n\n\nЧтобы использовать метод, нужен дост\
уп — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/payment-registry/submit
\
\ — Подписание платежных реестров по самозанятым компании с ИНН {inn}\
\ и КПП {kpp}
.\n\n\nОграничение на использование метода — 1 запрос\
\ в секунду.\n "
operationId: "SelfEmployedPaymentRegistrySubmit"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedPaymentRegistrySubmitRequest"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
paymentRegistryId: 12
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedPaymentRegistrySubmitResponse"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/self-employed/payment-registry/submit/result:
get:
tags:
- "Выплаты самозанятым"
summary: "Получить результат подписания платежного реестра самозанятых"
description: "Возвращает результат запроса для метода Подписать платежный реестр самозанятых.\nРезультат создания хранится\
\ в течение двух дней.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/payment-registry/submit
\
\ — Подписание платежных реестров по самозанятым компании с ИНН {inn}\
\ и КПП {kpp}
.\n\n\nОграничение на использование метода — 1 запрос\
\ в секунду.\n "
operationId: "SelfEmployedGetPaymentRegistrySubmitResult"
parameters:
- name: "correlationId"
in: "query"
description: "Идентификатор, связывающий запрос создания с запросом получе\
ния ответа."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "uuid"
example: "cf99df08-0829-4614-8da3-0e440fd23fe0"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedPaymentRegistryResultSubmitResponse"
examples:
Example0:
value:
paymentRegistryId: 12
status: "ACCEPTED"
paymentErrors: []
Example1:
value:
paymentRegistryId: 12
status: "ERROR"
error:
errorCode: "INTERNAL_ERROR"
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте\
\ позже."
paymentErrors:
- number: 1
accountNumber: "40802123456789012345"
errors:
- fieldName: "Номер счета"
errorDescription: "Неверный номер счета"
- fieldName: "Номер договора"
errorDescription: "Номер договора не найден"
- fieldName: "Статус сотрудника"
errorDescription: "Не удалось найти среди активных и бывши\
х сотрудников компании"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/self-employed/payment-registry/pay:
post:
tags:
- "Выплаты самозанятым"
summary: "Оплатить платежный реестр"
description: "Запрос является асинхронной операцией — его результат можно по\
лучить через вызов метода Получить результат оплаты платежного реестра самозанятых, передав в н\
ем соответствующий correlationId.\n\n\nЧтобы использовать метод, ну\
жен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/payment-registry/pay
\
\ — Оплата подписанных платежных реестров сотрудников или самозаняты\
х
.\n\n\nОграничение на использование метода — 1 запрос в секунду.\n\
\ "
operationId: "SelfEmployedPayPaymentRegistry"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedPayPaymentRegistryRequest"
example:
paymentRegistryId: 1
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedPayPaymentRegistryResponse"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/self-employed/payment-registry/pay/result:
post:
tags:
- "Выплаты самозанятым"
summary: "Получить результат оплаты платежного реестра"
description: "Возвращает результат запроса для метода Оплатить платежный реестр самозанятых.\nРезультат создания хранится в\
\ течение двух дней.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/payment-registry/pay
\
\ — Оплата подписанных платежных реестров сотрудников или самозаняты\
х
.\n\n\nОграничение на использование метода — 1 запрос в секунду.\n\
\ "
operationId: "SelfEmployedPayPaymentRegistryResult"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedPayPaymentRegistryResultRequest"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedPayPaymentRegistryResultResponse"
example:
paymentRegistryId: 56
status: "SENT"
count: 1
paymentResults:
- number: 1
paymentStatus: "SENT"
errors: []
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/self-employed/payment-registry/receipts:
post:
tags:
- "Выплаты самозанятым"
summary: "Получить чеки по платежному реестру самозанятых"
description: "Метод позволяет запрашивать ссылки на чеки, полученные через м\
етод Зарегистрировать доход самозанятого.\n\n\nЗапрос является асинхронной\
\ операцией — его результат можно получить через вызов метода Получить результат запроса на получение чеков, передав в нем соответс\
твующий correlationId.\n\n\nЧтобы использовать метод, нужен доступ\
\ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/payment-registry/fiscalize
\
\ — Регистрация дохода и получение чеков по платежам платежного реес\
тра по самозанятым компании с ИНН {inn} и КПП {kpp}
.\n\n\nОграничен\
ие на использование метода — 1 запрос в секунду.\n "
operationId: "SelfEmployedReceipts"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedReceiptsRequest"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
paymentRegistryId: 777
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedReceiptsResponse"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/self-employed/payment-registry/receipts/result:
get:
tags:
- "Выплаты самозанятым"
summary: "Получить результат запроса на получение чеков"
description: "Метод возвращает результат запроса на получение чеков.\n\n\nЧт\
обы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/payment-registry/fiscalize
\
\ — Регистрация дохода и получение чеков по платежам платежного реес\
тра по самозанятым компании с ИНН {inn} и КПП {kpp}
.\n\n\nОграничен\
ие на использование метода — 1 запрос в секунду.\n "
operationId: "SelfEmployedReceiptsResult"
parameters:
- name: "correlationId"
in: "query"
description: "Идентификатор, связывающий запрос создания с запросом получе\
ния ответа."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "uuid"
example: "cf99df08-0829-4614-8da3-0e440fd23fe0"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/SelfEmployedReceipts"
examples:
Example0:
value:
status: "FINISHED"
receipts:
- number: 777
selfEmployedInfo:
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
recipientId: 123456789
link: "http://link.example"
status: "SUCCESS"
Example1:
value:
status: "ERROR"
error:
errorCode: "INTERNAL_ERROR"
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте\
\ позже."
receipts:
- number: 777
selfEmployedInfo:
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
recipientId: 123456789
status: "ERROR"
error:
errorCode: "INTERNAL_ERROR"
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуй\
те позже."
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/invoice/send:
post:
tags:
- "Выставление счетов"
summary: "Выставить счет"
description: "Метод для выставления счетов — номер, срок оплаты, дата выстав\
ления, информация о плательщике и другое.\nЛоготип и подпись с печатью не\
\ проставляются.\n\n\nПользователь должен дать согласие на доступ к создан\
ию и отправке счетов на оплату контрагенту.\n\n\nЧтобы использовать метод\
, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/invoice/submit
\
\ — Создание, отправка счета на оплату и получение его информации в\
\ компании с ИНН {inn} и КПП {kpp}
.\n\n\nОграничение на использован\
ие метода — 4 запроса в секунду.\n "
operationId: "postApiV1InvoiceSend"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CreateAndSendInvoiceRequest"
example:
invoiceNumber: "12345"
dueDate: "2020-08-22"
invoiceDate: "2020-07-23"
accountNumber: "40802123456789012345"
payer:
name: "ООО Рога и Копыта"
inn: "730990470834"
kpp: "123456789"
items:
- name: "Рога"
price: 10
unit: "Шт"
vat: "None"
amount: 10
- name: "Копыта"
price: 100
unit: "Шт"
vat: "20"
amount: 2
contacts:
- email: "example@mail.com"
contactPhone: "+74996051110"
comment: "Комментарий, например, информанция для контрагента."
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CreateAndSendInvoiceResponse"
example:
pdfUrl: "https://example.com/qwetq"
invoiceId: "d8327c28-4a8e-4084-93ea-a94b7bd144c5"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/payment/ruble-transfer/pay:
post:
tags:
- "Платежи"
summary: "Выполнить платеж"
description: "Метод для выплаты денег с рублевых счетов компании на счета ре\
зидентов юридических и физических лиц в банках РФ.\n\n\nВыплата денег со с\
чета производится асинхронно.\nЧтобы совершать налоговые платежи за себя и\
\ за третьих лиц, передайте значения в блоке tax.\n\n\nРезультат за\
проса на выплату можно получить через метод Получить статуса платежа, передав в нем соответствующий paymentId.\n\
\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/payments/rub-pay
\
\ — Совершение платежей с рублевого расчетного счета компании с ИНН\
\ {inn} и КПП {kpp}
.\n\n\nВсе вызовы метода дедуплицируются:\n\nSelf-с\
ценарий\n\n\nДедупликация происходит по paymentId в контексте в\
ашей компании. Это значит, что paymentId должен быть уникален в рам\
ках всех платежей от лица вашей компании.\nЕсли вызвать метод два и более\
\ раза с одинаковыми paymentId в рамках одной компании, создастся т\
олько один платеж.\n\nПартнерский сценарий\n\n\nДедупликация происх\
одит по paymentId и clientId. Это значит, что связка paymentId\
\ и clientId должна быть уникальна.\nЕсли вызвать метод два и более\
\ раза с одинаковыми paymentId и clientId, создастся только\
\ один платеж.\nclientId выдается при регистрации партнера в Tinkoff\
\ и отправляется на почту.\n\nЛимиты\n\n\nПо умолчанию на выполнени\
е платежей через API установлены следующие лимиты:\nopensme/inn/[{inn}]/kpp/[{kpp}]/payments/payment-registry
\
\ — Оплата подписанных платежных реестров сотрудников или самозаняты\
х
.\n\n\nПримечание для партнеров: в методе учитывается clientId
.\
\ Если ваш clientId
был изменен, вы не сможете получить стату\
с платежа, созданного\nпри использовании старого clientId
.\n\
clientId
выдается при регистрации партнера в Т-Банке и отправ\
ляется на почту.\n\n\nОграничение на использование метода — 20 запросов в\
\ секунду.\n\n\nЧтобы оперативно отслеживать статусы выплат, вы также може\
те воспользоваться вебхуком Статус платежа."
operationId: "PaymentsCoreGetStatus"
parameters:
- name: "paymentId"
in: "path"
description: "Идентификатор платежа."
required: true
style: "simple"
explode: false
schema:
type: "string"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/PaymentStatusResponse"
example:
status: "EXECUTED"
meta:
clientCustomField: "value"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
examples:
Ошибка, если данный id платежа не был найден:
value:
errorMessage: "No payment found for given paymentId"
errorCode: "PAYMENT_NOT_FOUND"
errorId: "58e32e4e818fad990562"
Ошибка при недостаточном балансе:
value:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/payment/card-transfer/pay:
post:
tags:
- "Платежи"
summary: "Выполнить платеж на карту Т-Банка"
description: "Метод для выплаты денег с рублевых счетов компании на карты Т\
-Банка по номеру договора себе и другим физическим лицам.\n\n\nВыплата ден\
ег со счета производится асинхронно.\nРезультат запроса на выплату можно п\
олучить через вызов метода Получить статуса платежа, передав в нем соответствующий paymentId.\n\
\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/payments/cards-pay
\
\ — Совершение платежей физическим лицам с рублевого расчетного счет\
а компании с ИНН {inn} и КПП {kpp} на карту Т-Банка
.\n\n\nОграничен\
ие на использование метода — 10 запросов в секунду."
operationId: "CardPay"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CreateCardPaymentRequest"
examples:
Пример платежа с номером договора:
value:
id: "123456"
from:
accountNumber: "12345678900987654321"
to:
agreementNumber: "7000368800"
purpose: "Оплата по договору №123. НДС не облагается"
documentNumber: 100
amount: 10
executionOrder: 5
dueDate: "2021-06-20T00:00:00Z"
required: true
responses:
"201":
description: "Платеж поставлен в очередь на исполнение"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
examples:
Ошибка при некорректных реквизитах:
value:
errorMessage: "Payment verification failed"
errorCode: "VERIFICATION_FAILED"
errorId: "12c342b26ae6a44fe5b2"
errorDetails:
reason: "Проверьте номер счета получателя — возможно, вы ука\
зали неправильные цифры"
Ошибка, когда платеж с данным id уже совершен:
value:
errorMessage: "Non unique payment"
errorCode: "PAYMENT_ALREADY_COMPLETED"
errorId: "c1bde0417a19088492b5"
Ошибка при неверном р/c отправителя:
value:
errorMessage: "No agreement found for given account"
errorCode: "UNKNOWN_ACCOUNT"
errorId: "d929c551b4770b708a33"
Ошибка при недостаточном балансе:
value:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/payment/payment-registry/pay:
post:
tags:
- "Платежи"
- "Зарплатный проект"
summary: "Оплатить реестр"
description: "Позволяет оплатить подписанный платежный реестр сотрудников ил\
и самозанятых.\n\n\nВ поле purpose передайте назначение платежа. В\
\ конце назначения добавьте фразу «Согласно реестру» и номер.\n\n\nЛимиты\
\ по переводам рассчитываются вместе с лимитами по методу Выполнить платеж.\n\n\nРезультат запроса на выплату можно получить че\
рез вызов метода Получить с\
татуса платежа.\nДля зарплатного проекта — Получить информацию по платежному реестру (зарплатный проект) и Получить информацию по плат\
ежному реестру (выплаты самозанятым).\n\n\nЧтобы использовать метод, н\
ужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/payments/payment-registry
\
\ — Оплата подписанных платежных реестров сотрудников или самозаняты\
х
.\n\n\nОграничение на использование метода — 10 запросов в секунду\
."
operationId: "CreateSalaryRegistryPayment"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CreateRegistryPaymentRequest"
example:
id: "123456"
paymentRegistryId: 123
accountNumber: "40702810110011000777"
purpose: "Зарплата согласно реестру №123 от 30.06.2021"
documentNumber: 100
executionOrder: 5
dueDate: "2020-07-01T00:00+03:00"
meta:
clientCustomField: "value"
required: true
responses:
"201":
description: "Платеж поставлен в очередь на исполнение"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/payment/create:
post:
tags:
- "Платежи"
summary: "Создать черновик платежного поручения"
description: "Метод для создания черновиков платежей. Работает только для ре\
зидентов РФ.\n\n\nРезультат запроса на создание черновика платежного поруч\
ения можно получить через метод Получ\
ить список статусов платежных документов, передав в нем соответствующи\
й documentId.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/payments/draft/create
\
\ — Создание черновиков платежей в компании с ИНН {inn} и КПП {kpp}
.\n\
\n\nОграничение на использование метода — 10 запросов в секунду.\n \
\ "
operationId: "postApiV1PaymentCreate"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CreatePaymentDraftRequest"
examples:
Пример платежа в пользу физического лица:
summary: "Пример платежа в пользу физического лица"
value:
documentNumber: "654321"
date: "2015-09-03T12:30+03:00[Europe/Moscow]"
amount: 500
recipientName: "Петров Петр Петрович"
inn: "987654321987"
kpp: "0"
bankAcnt: "55554444333322221111"
bankBik: "76543277778"
accountNumber: "40702810110011000777"
paymentPurpose: "оплата товара"
executionOrder: 5
taxPayerStatus: "09"
kbk: "33335555666677778888"
oktmo: "33335555"
taxEvidence: "ТП"
taxPeriod: "ГД.00.2019"
uin: "0"
taxDocNumber: "0"
taxDocDate: "0"
revenueTypeCode: "2"
collectionAmountNumber: 987654321
recipientCorrAccountNumber: "22228888333366661111"
Пример платежа в пользу юридического лица:
summary: "Пример платежа в пользу юридического лица"
value:
documentNumber: "654321"
date: "2015-09-03T12:30+03:00[Europe/Moscow]"
amount: 50000
recipientName: "ООО Рога и Копыта"
inn: "987654321987"
kpp: "654321654"
bankAcnt: "99998888777766665555"
bankBik: "76543277778"
accountNumber: "40702810110011000777"
paymentPurpose: "оплата товара"
executionOrder: 5
taxPayerStatus: "09"
kbk: "33335555666677778888"
oktmo: "33335555"
taxEvidence: "ТП"
taxPeriod: "ГД.00.2019"
uin: "0"
taxDocNumber: "0"
taxDocDate: "0"
revenueTypeCode: "2"
collectionAmountNumber: 987654321
recipientCorrAccountNumber: "66668888000066667777"
Пример налогового платежа:
summary: "Пример налогового платежа"
value:
documentNumber: "514462"
date: "2021-12-30T00:00+03:00[Europe/Moscow]"
amount: 1.0
recipientName: "СИБИРСКОЕ ГУ БАНКА РОССИИ//УФК по Новосибирской\
\ области г. Новосибирск"
inn: "7710140679"
kpp: "771301001"
bankAcnt: "03100643000000015100"
bankBik: "015004950"
accountNumber: "40702810110011000777"
paymentPurpose: "Налоги на прибыль"
taxPayerStatus: "01"
kbk: "18210301000011000110"
oktmo: "50701000"
taxEvidence: "ТП"
taxPeriod: "ГД.00.2021"
uin: "12345678912345678900"
taxDocNumber: "1"
taxDocDate: "10.01.2020"
recipientCorrAccountNumber: "40102810445370000043"
Пример налогового платежа за третьих лиц:
summary: "Пример налогового платежа за третьих лиц"
value:
documentNumber: "514462"
date: "2021-12-30T00:00+03:00[Europe/Moscow]"
amount: 1.0
recipientName: "СИБИРСКОЕ ГУ БАНКА РОССИИ//УФК по Новосибирской\
\ области г. Новосибирск"
inn: "7710140679"
kpp: "771301001"
bankAcnt: "03100643000000015100"
bankBik: "015004950"
accountNumber: "40702810110011000777"
paymentPurpose: "Госпошлина за регистрацию прав на недвижимое им\
ущество и сделок с ним"
taxPayerStatus: "13"
kbk: "18210301000011000110"
oktmo: "50701000"
taxEvidence: "0"
taxPeriod: "0"
uin: "12345678912345678900"
taxDocNumber: "1"
taxDocDate: "10.01.2020"
recipientCorrAccountNumber: "40102810445370000043"
thirdParty:
inn: "987654321098"
kpp: "0"
name: "Иванов Иван Иванович"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CreatePaymentDraftResponse"
example:
documentId: "55555000-0000-0000-5555-000011110000"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
examples:
Ошибка при определении банка-получателя:
value:
errorMessage: "Не можем определить банк-получатель. Проверьте\
, что БИК указан верно"
errorCode: "CANT_DETERMINE_BANK_RECEIVER"
errorId: "28cad1786e"
Ошибка при неправильном расчетном счете:
value:
errorMessage: "Не найден расчетный счет с номером 40802000000000000000"
errorCode: "INVALID_ACCOUNT_NUMBER"
errorId: "162eb53ec0"
Ошибка при несоответствии данных формату платежного поручения:
value:
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorId: "c5a6096c3"
Ошибка при неверном р/c отправителя:
value:
errorMessage: "No agreement found for given account"
errorCode: "UNKNOWN_ACCOUNT"
errorId: "d929c551b4770b708a33"
Ошибка при недостаточном балансе:
value:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/bank-statement:
get:
tags:
- "Счета и выписки"
summary: "Получить выписку по счету клиента за определенный период"
description: "Метод для получения выписок по счетам.\n\n\nЧтобы использовать\
\ метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/bank-statements/get
\
\ — Информация об операциях компании с ИНН {inn} и КПП {kpp}
.\n\
\n\nЗапросы выписок с количеством операций более 50 000 сейчас не поддержи\
ваются и будут возвращать ошибку.\n\n\nОграничение на использование метода\
\ — 10 запросов в секунду."
operationId: "getApiV1Bank-statement"
parameters:
- name: "accountNumber"
in: "query"
description: "Расчетный счет организации."
required: true
style: "form"
explode: true
schema:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета. ВАЖНО: Для бюджетных платежей с 01.01.2021\
\ в данном поле нужно указывать новые номера казначейских счетов."
example: 40702810110011000777
- name: "from"
in: "query"
description: "Дата начала периода. Если параметр не передается, дата прира\
внивается значению даты конца — 1 месяц."
required: false
style: "form"
explode: true
schema:
type: "string"
format: "date"
example: "2021-11-03"
- name: "till"
in: "query"
description: "Дата окончания периода. Если параметр не передается, приравн\
ивается текущей дате."
required: false
style: "form"
explode: true
schema:
type: "string"
format: "date"
example: "2021-11-03"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BankStatement"
example:
accountNumber: "99998888777766665555"
saldoIn: 500
income: 500
outcome: 500
saldoOut: 500
operation:
- operationId: "12345_89765"
id: "1234567890123456789"
date: "2015-04-01"
amount: 500
drawDate: "2015-05-01"
payerName: "Иванов Иван Иванович"
payerInn: "987654321987"
payerAccount: "99998888777766665555"
payerCorrAccount: "40244447777333300000"
payerBic: "76543277778"
payerBank: "банк 'Лидеров'"
chargeDate: "2015-09-03"
recipient: "Петров Петр Петрович"
recipientInn: "765432198765"
recipientAccount: "77774444222277772222"
recipientCorrAccount: "40299998888777700000"
recipientBic: "12345678901"
recipientBank: "банк 'Чемпионов'"
paymentType: ""
operationType: "01"
uin: "0"
paymentPurpose: "материальная помощь"
creatorStatus: ""
kbk: "44445555666677778888"
oktmo: "44445555"
taxEvidence: "ТП"
taxPeriod: "ГД.00.2019"
taxDocNumber: "0"
taxDocDate: "0"
taxType: "taxType"
executionOrder: "5"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
deprecated: true
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/bank-accounts:
get:
tags:
- "Счета и выписки"
summary: "Получить счета"
description: "Чтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/bank-accounts/get
\
\ — Информация о счетах компании с ИНН {inn} и КПП {kpp}
. Огр\
аничение на использование метода — 6 запросов в секунду."
operationId: "getApiV1Bank-accounts"
responses:
"200":
description: "Расчетные счета"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "array"
items:
$ref: "#/components/schemas/AccountInfo"
examples:
Расчетные счета:
value:
- accountNumber: "40802678901234567890"
currency: "643"
balance:
otb: 45089
authorized: 0
pendingPayments: 0
pendingRequisitions: 0
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
deprecated: true
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v2/bank-accounts:
get:
tags:
- "Счета и выписки"
summary: "Получить счета"
description: "Чтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/bank-accounts/get
\
\ — Информация о счетах компании с ИНН {inn} и КПП {kpp}
. Огр\
аничение на использование метода — 6 запросов в секунду."
operationId: "getApiV2Bank-accounts"
responses:
"200":
description: "Расчетные счета"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "array"
items:
$ref: "#/components/schemas/AccountInfo1"
examples:
Расчетные счета:
value:
- accountNumber: "40802678901234567890"
name: "Валютный фунтовый счет"
currency: "643"
bankBik: "123456789"
accountType: "Current"
balance:
otb: 45089
authorized: 0
pendingPayments: 0
pendingRequisitions: 0
transitAccount:
accountNumber: "11223344556677889900"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
deprecated: true
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v3/bank-accounts:
get:
tags:
- "Счета и выписки"
summary: "Получить счета v3"
description: "Метод для получения информации по расчетным счетам организаций\
.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/bank-accounts/get
\
\ — Информация о счетах компании с ИНН {inn} и КПП {kpp}
.\n\n\
\nОграничение на использование метода — 6 запросов в секунду."
operationId: "getApiV3Bank-accounts"
responses:
"200":
description: "Расчетные счета"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "array"
items:
$ref: "#/components/schemas/AccountInfo2"
examples:
Расчетные счета:
value:
- accountNumber: "40802678901234567890"
name: "Валютный фунтовый счет"
currency: "643"
bankBik: "123456789"
accountType: "Current"
activationDate: "2010-08-03"
balance:
otb: 45089
authorized: 0
pendingPayments: 0
pendingRequisitions: 0
transitAccount:
accountNumber: "11223344556677889900"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v4/bank-accounts:
get:
tags:
- "Счета и выписки"
summary: "Получить счета v4"
description: "Метод для получения информации по расчетным и инвестиционным с\
четам организаций.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/bank-accounts/get
\
\ — Информация о счетах компании с ИНН {inn} и КПП {kpp}
.\n\n\
\nОграничение на использование метода — 6 запросов в секунду."
operationId: "getApiV4Bank-accounts"
parameters:
- name: "withInvest"
in: "query"
description: "Флаг получения инвестиционных счетов."
required: false
style: "form"
explode: true
schema:
type: "boolean"
responses:
"200":
description: "Расчетные счета"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "array"
items:
$ref: "#/components/schemas/AccountInfo3"
examples:
Расчетные счета:
value:
- accountNumber: "40802678901234567890"
name: "Валютный фунтовый счет"
status: "NORM"
tariffName: "Тарифный план \"Продвинутый\" GBP"
tariffCode: "TFLE1.2GBP"
currency: "643"
createdOn: "2010-08-03"
mainFlag: "Y"
bankBik: "123456789"
accountType: "Current"
activationDate: "2010-08-03"
balance:
balance: 444333
realOtb: 44000
otb: 45089
authorized: 0
pendingPayments: 0
pendingRequisitions: 0
transitAccount:
accountNumber: "11223344556677889900"
- accountNumber: ""
name: "Инвестиционный счет"
status: "NORM"
tariffName: ""
tariffCode: "TRD12.1"
currency: "643"
createdOn: "2023-01-01"
mainFlag: "N"
bankBik: "123456789"
accountType: "Invest"
activationDate: "2023-01-01"
balance:
balance: 50000
realOtb: 0
otb: 0
authorized: 0
pendingPayments: 0
pendingRequisitions: 0
brokerCurrencyBalance:
- currency: "RUB"
currentBalance: 125
currentBalanceForWithdrawal: 115
blockedQuantity: 10
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/account-operations:
get:
tags:
- "Счета и выписки"
summary: "Получить выписку с авторизациями за определенный период"
description: "Необходимо согласие пользователя на доступ к информации об опе\
рациях компании. Чтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/account-operations/get
\
\ — Информация о транзакциях и авторизациях по счетам компании с инн\
\ {inn} и кпп {kpp}
.Запросы с количеством операций более 10 000 буд\
ут возвращать ошибку TOO_MANY_OPERATIONS. Ограничение на использование мет\
ода — 3 запроса в секунду."
operationId: "getApiV1Account-operations"
parameters:
- name: "accountNumber"
in: "query"
description: "Расчетный счет организации."
required: true
style: "form"
explode: true
schema:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета. ВАЖНО: Для бюджетных платежей с 01.01.2021\
\ в данном поле нужно указывать новые номера казначейских счетов."
example: 40702810110011000777
- name: "ucid"
in: "query"
description: "UCID карты. Если не указан, вернутся все операции по счету."
required: false
style: "form"
explode: true
schema:
type: "integer"
format: "int64"
example: 1234567890
- name: "operationStatus"
in: "query"
description: "Статус операции. Если не указан, вернутся как транзакции, та\
к и авторизации."
required: false
style: "form"
explode: true
schema:
$ref: "#/components/schemas/AccountOperationStatus"
example: "transaction"
- name: "from"
in: "query"
description: "Дата начала периода, включительно."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "date-time"
example: "2021-11-03T11:00:00+03:00"
- name: "till"
in: "query"
description: "Дата конца периода, исключительно."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "date-time"
example: "2021-11-03T11:00:00+03:00"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
type: "array"
items:
$ref: "#/components/schemas/AccountOperation"
example:
- accountNumber: "40702810110011000777"
authDateTime: "2021-11-17T12:10+03:00"
trxnDateTime: "2021-11-17T12:11+03:00"
authId: "123456789"
trxnId: "123456789"
authStatus: "succeed"
operationType: "debit"
operationStatus: "transaction"
amount: 100
currency: "RUB"
accountAmount: 100
description: "Нужно совершить платеж"
card:
ucid: "12345678901234567890"
mcc: "1234"
number: "1111********9999"
merch:
id: "123456"
name: "Лучший Банк"
address: "ул. Уличная, д. 666"
city: "MOSCOW"
country: "RUS"
rrn: "123456789012"
acquirerId: "010455"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
deprecated: true
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/special-accounts/arrest-etp:
get:
tags:
- "Специальные счета"
summary: "Получить данные по специальным счетам"
description: "Метод возвращает информацию по блокировкам, картотекам ЭТП (эл\
ектронная торговая площадка) и списаниям за нарушения договора.\n\n\nЧтобы\
\ использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/special-accounts/arrest-etp/get
\
\ — Получение информации по картотекам, блокировкам, картотекам ЭТП\
\ и по списаниям в бюджет
.\n\n\nУ блокировок и картотек нет информа\
ции о дате отмены, ориентируйтесь только на статус — cardIndexStatus
.\n\
\n\nОграничение на использование метода — 4 запроса в секунду."
operationId: "getApiV1Special-accountsArrest-etp"
parameters:
- name: "accountNumber"
in: "query"
description: "Номер счета клиента."
required: true
style: "form"
explode: true
schema:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета. ВАЖНО: Для бюджетных платежей с 01.01.2021\
\ в данном поле нужно указывать новые номера казначейских счетов."
example: 40702810110011000777
- name: "from"
in: "query"
description: "Дата начала периода."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "date"
example: "2020-12-01"
- name: "till"
in: "query"
description: "Дата окончания периода."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "date"
example: "2020-12-31"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/OperationsResponse"
example:
etpFees:
- id: "987654321"
externalId: "ETP-JNT-f8856187-11eb-46a2-ba1a-eb9ad29aade0"
amount: 600
currency: "643"
status: "ACTIVE"
date: "2021-08-11T13:02:53.000000175+03:00[Europe/Moscow]"
payedAmount: 0
paymentPurpose: "Комиссия"
senderInn: "0"
recipient:
inn: "7707308480"
name: "ЗАО Королей и Царей"
account: "40702810110011000777"
bank:
bik: "7706605793"
corAccount: "40702809400050001234"
name: "Тинькофф"
officeName: "ЭТП Королей и царей"
contractBreaches:
- id: "20051823"
externalId: "ETP-JNT-cc1584b7-bd13-4a9f-8c5a-f30908a6cd3d"
amount: 444.33
currency: "643"
status: "PAYED"
date: "2021-08-11T12:56:39.000000020+03:00[Europe/Moscow]"
payedAmount: 444.33
paymentPurpose: "Перевод средств с площадки Королей и царей"
senderInn: "0"
recipient:
inn: "7707308480"
name: "ЗАО Королей и Царей"
account: "40702810110011000777"
bank:
bik: "7706605793"
corAccount: "40702809400050001234"
name: "Тинькофф"
officeName: "ЭТП Королей и царей"
- id: "20051825"
externalId: "ETP-JNT-b3a741f8-5ad6-4dcc-bbf1-b21872eccfda"
amount: 500.0
currency: "643"
status: "ACTIVE"
date: "2021-08-11T12:59:06.000000361+03:00[Europe/Moscow]"
payedAmount: 0
paymentPurpose: "Перевод средств с площадки Королей и царей"
senderInn: "0"
recipient:
inn: "7707308480"
name: "ЗАО Королей и Царей"
account: "40702810110011000777"
bank:
bik: "7706605793"
corAccount: "40702809400050001234"
name: "Тинькофф"
officeName: "ЭТП Королей и царей"
- id: "20051829"
externalId: "ETP-JNT-e9aecade-1c46-42b4-bb59-e3c0b3a3ecda"
amount: 700.0
currency: "643"
status: "CANCELED"
date: "2021-08-11T13:04:06.000000872+03:00[Europe/Moscow]"
payedAmount: 0
paymentPurpose: "Перевод средств с площадки Королей и царей"
senderInn: "0"
recipient:
inn: "7707308480"
name: "ЗАО Королей и Царей"
account: "40702810110011000777"
bank:
bik: "7706605793"
corAccount: "40702809400050001234"
name: "Тинькофф"
officeName: "ЭТП Королей и царей"
arrests:
sum: 3132.99
values:
- id: "20051779"
externalId: "ETP-JNT-a70a104f-7458-4519-ad44-639255b81bef"
amount: 111.0
currency: "643"
status: "ACTIVE"
date: "2021-08-11T11:35:39.000000658+03:00[Europe/Moscow]"
unblockDate: "2021-08-14T10:36:39.000000658+03:00[Europe/Moscow]"
circumstances: "Блокировка денег для обеспечения заявки на тор\
гах"
officeName: "ЭТП Королей и царей"
- id: "20051785"
externalId: "ETP-JNT-fad278df-a131-46bb-b461-da4c8dc15085"
amount: 444.33
currency: "643"
status: "ACTIVE"
date: "2021-08-11T11:38:44.000000658+03:00[Europe/Moscow]"
unblockDate: "2021-08-14T10:35:19.000000354+03:00[Europe/Moscow]"
circumstances: "Блокировка денег для обеспечения заявки на тор\
гах"
officeName: "ЭТП Королей и царей"
- id: "20051783"
externalId: "ETP-JNT-535f7697-1929-4f7c-ba08-cafb2b4005d2"
amount: 333.33
currency: "643"
status: "CANCELED"
date: "2021-08-11T11:37:56.000000783+03:00[Europe/Moscow]"
unblockDate: "2021-08-12T12:43:39.000000658+03:00[Europe/Moscow]"
circumstances: "Блокировка денег для обеспечения заявки на тор\
гах"
officeName: "ЭТП Королей и царей"
- id: "20051786"
externalId: "ETP-JNT-cc1584b7-bd13-4a9f-8c5a-f30908a6cd3d"
amount: 444.33
currency: "643"
status: "CANCELED"
date: "2021-08-11T11:38:50.000000783+03:00[Europe/Moscow]"
unblockDate: "2021-08-12T12:43:39.000000658+03:00[Europe/Moscow]"
circumstances: "Блокировка денег для обеспечения заявки на тор\
гах"
officeName: "ЭТП Королей и царей"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/nominal-accounts/beneficiaries:
get:
tags:
- "Бенефициары и реквизиты"
summary: "Получить список бенефициаров"
description: "\nВозвращает информацию о бенефициарах компании.\n\n\nОграниче\
ние на использование метода — 10 запросов в секунду.\n\n\nЧтобы использова\
ть метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsBeneficiaries"
parameters:
- name: "offset"
in: "query"
description: "Количество бенефициаров, которое нужно пропустить. Значение\
\ по умолчанию — 0
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно пропустить."
format: "int32"
example: 0
- name: "limit"
in: "query"
description: "Количество бенефициаров, которое нужно вывести. Значение по\
\ умолчанию — 50
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно вывести."
format: "int32"
example: 50
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BeneficiaryListResponse"
example:
offset: 0
limit: 50
size: 7
total: 7
results:
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "FL_RESIDENT"
firstName: "Фома"
middleName: "Семенович"
lastName: "Киняев"
isSelfEmployed: true
birthDate: "1969-08-21"
birthPlace: "г. Москва"
citizenship: "RU"
phoneNumber: "+79998887766"
email: "f.kiniaev@tinkoff.ru"
documents:
- type: "PASSPORT"
serial: "5000"
number: "287846"
date: "1998-01-01"
organization: "Отделом УФМС по всем городам всех областей необ\
ъятной нашей Родины"
division: "123-456"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр. 26"
inn: "266445718640"
snils: "72865174431"
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "FL_NONRESIDENT"
firstName: "John"
middleName: "William"
lastName: "Smith"
isSelfEmployed: false
birthDate: "1978-04-03"
birthPlace: "Pietersburg"
citizenship: "US"
phoneNumber: "+12025550190"
email: "john.smith@example.com"
documents:
- type: "FOREIGN_PASSPORT"
number: "123456789"
date: "1992-02-12"
organization: "Issuing organization"
- type: "VISA"
number: "123456789"
date: "1998-01-01"
expireDate: "2023-01-01"
addresses:
- type: "RESIDENCE_ADDRESS"
address: "Pietersburg, Transvaal Province, South Africa"
inn: "906858195320"
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "UL_RESIDENT"
name: "Акционерное общество «Тинькофф Банк»"
phoneNumber: "+78007551110"
email: "business.welcome@tinkoff.ru"
addresses:
- type: "LEGAL_ENTITY_ADDRESS"
address: "127287, г. Москва, ул. Хуторская 2-я, д. 38А, стр. 26"
- type: "POSTAL_ADDRESS"
address: "Москва, 127287, ул. Хуторская 2-я, д. 38А, стр. 26;\
\ а/я 23, г. Москва, 102001"
registrationDate: "2002-11-28"
opf: "АО"
inn: "7710140679"
ogrn: "1027739642281"
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "UL_NONRESIDENT"
name: "TCS Group Holding Plc."
phoneNumber: "+74996051110"
email: "business.welcome@tinkoff.ru"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036a"
- type: "LEGAL_ENTITY_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036"
- type: "OFFICE_OF_FOREIGN_LEGAL_ENTITY_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036"
nza: "12345678912"
registrationDate: "2015-11-13"
registrationNumber: "107963"
opf: "Plc."
inn: "9909215909"
kio: "21590"
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "IP_RESIDENT"
firstName: "Олег"
middleName: "Юрьевич"
lastName: "Анисимов"
birthDate: "1974-01-23"
birthPlace: "г. Москва"
citizenship: "RU"
phoneNumber: "+71378820200"
email: "KDDwKOwWD0@Pijg1"
documents:
- type: "PASSPORT"
serial: "5000"
number: "287846"
date: "1998-01-01"
organization: "Отделом УФМС по всем городам всех областей необ\
ъятной нашей Родины"
division: "123-456"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр. 26"
registrationDate: "2010-01-15"
inn: "306707771448"
ogrn: "310774601501066"
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "IP_NONRESIDENT"
firstName: "Олег"
middleName: "Юрьевич"
lastName: "Анисимов"
birthDate: "1974-01-23"
birthPlace: "г. Москва"
citizenship: "US"
phoneNumber: "+447768027220"
email: "OAAQAYkiXe@uUmPe"
documents:
- type: "FOREIGN_PASSPORT"
number: "123456789"
date: "1992-02-12"
organization: "Issuing organization"
- type: "MIGRATION_CARD"
number: "123456789"
date: "1998-01-01"
expireDate: "2023-01-01"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр. 26"
registrationDate: "2010-01-15"
inn: "173527033406"
ogrn: "310774601501066"
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "LITE_CONTACT"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
post:
tags:
- "Бенефициары и реквизиты"
summary: "Создать бенефициара"
description: "\nМетод создает бенефициара и возвращает его с ID, который нуж\
ен для дальнейшей работы.\n\n\nОграничение на использование метода — 10 за\
просов в секунду.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
.\n\n\nЗаполняемые данные\
\ будут отличаться в зависимости от типа бенефициара — например, физическо\
е лицо-резидент или физическое лицо-нерезидент.\nПримеры данных по каждому\
\ из типов приведены ниже."
operationId: "postApiV1Nominal-accountsBeneficiaries"
parameters:
- name: "Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности. Подробнее."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/BeneficiaryRequest"
examples:
Физическое лицо, резидент:
value:
type: "FL_RESIDENT"
firstName: "Фома"
middleName: "Семенович"
lastName: "Киняев"
isSelfEmployed: true
birthDate: "1969-08-21"
birthPlace: "г. Москва"
citizenship: "RU"
phoneNumber: "+79998887766"
email: "f.kiniaev@tinkoff.ru"
documents:
- type: "PASSPORT"
serial: "5000"
number: "287846"
date: "1998-01-01"
organization: "Отделом УФМС по всем городам всех областей необ\
ъятной нашей Родины"
division: "123-456"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр. 26"
inn: "266445718640"
snils: "72865174431"
Физическое лицо, нерезидент:
value:
type: "FL_NONRESIDENT"
firstName: "John"
middleName: "William"
lastName: "Smith"
isSelfEmployed: false
birthDate: "1978-04-03"
birthPlace: "Pietersburg"
citizenship: "US"
phoneNumber: "+12025550190"
email: "john.smith@example.com"
documents:
- type: "FOREIGN_PASSPORT"
number: "123456789"
date: "1992-02-12"
organization: "Issuing organization"
- type: "VISA"
number: "123456789"
date: "1998-01-01"
expireDate: "2023-01-01"
addresses:
- type: "RESIDENCE_ADDRESS"
address: "Pietersburg, Transvaal Province, South Africa"
inn: "906858195320"
Юридическое лицо, резидент:
value:
type: "UL_RESIDENT"
name: "Акционерное общество «Тинькофф Банк»"
phoneNumber: "+78007551110"
email: "business.welcome@tinkoff.ru"
addresses:
- type: "LEGAL_ENTITY_ADDRESS"
address: "127287, г. Москва, ул. Хуторская 2-я, д. 38А, стр. 26"
- type: "POSTAL_ADDRESS"
address: "Москва, 127287, ул. Хуторская 2-я, д. 38А, стр. 26;\
\ а/я 23, г. Москва, 102001"
registrationDate: "2002-11-28"
opf: "АО"
inn: "7710140679"
ogrn: "1027739642281"
Юридическое лицо, нерезидент:
value:
type: "UL_NONRESIDENT"
name: "TCS Group Holding Plc."
phoneNumber: "+74996051110"
email: "business.welcome@tinkoff.ru"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036a"
- type: "LEGAL_ENTITY_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036"
- type: "OFFICE_OF_FOREIGN_LEGAL_ENTITY_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036"
nza: "12345678912"
registrationDate: "2015-11-13"
registrationNumber: "107963"
opf: "Plc."
inn: "9909215909"
kio: "21590"
ИП, резидент:
value:
type: "IP_RESIDENT"
firstName: "Олег"
middleName: "Юрьевич"
lastName: "Анисимов"
birthDate: "1974-01-23"
birthPlace: "г. Москва"
citizenship: "RU"
phoneNumber: "+71378820200"
email: "KDDwKOwWD0@Pijg1"
documents:
- type: "PASSPORT"
serial: "5000"
number: "287846"
date: "1998-01-01"
organization: "Отделом УФМС по всем городам всех областей необ\
ъятной нашей Родины"
division: "123-456"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр. 26"
registrationDate: "2010-01-15"
inn: "306707771448"
ogrn: "310774601501066"
ИП, нерезидент:
value:
type: "IP_NONRESIDENT"
firstName: "Олег"
middleName: "Юрьевич"
lastName: "Анисимов"
birthDate: "1974-01-23"
birthPlace: "г. Москва"
citizenship: "US"
phoneNumber: "+447768027220"
email: "OAAQAYkiXe@uUmPe"
documents:
- type: "FOREIGN_PASSPORT"
number: "123456789"
date: "1992-02-12"
organization: "Issuing organization"
- type: "MIGRATION_CARD"
number: "123456789"
date: "1998-01-01"
expireDate: "2023-01-01"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр. 26"
registrationDate: "2010-01-15"
inn: "173527033406"
ogrn: "310774601501066"
Легкий контакт:
value:
type: "LITE_CONTACT"
required: true
responses:
"201":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BeneficiaryResponse"
examples:
Физическое лицо, резидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "FL_RESIDENT"
firstName: "Фома"
middleName: "Семенович"
lastName: "Киняев"
isSelfEmployed: true
birthDate: "1969-08-21"
birthPlace: "г. Москва"
citizenship: "RU"
phoneNumber: "+79998887766"
email: "f.kiniaev@tinkoff.ru"
documents:
- type: "PASSPORT"
serial: "5000"
number: "287846"
date: "1998-01-01"
organization: "Отделом УФМС по всем городам всех областей не\
объятной нашей Родины"
division: "123-456"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр\
. 26"
inn: "266445718640"
snils: "72865174431"
Физическое лицо, нерезидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "FL_NONRESIDENT"
firstName: "John"
middleName: "William"
lastName: "Smith"
isSelfEmployed: false
birthDate: "1978-04-03"
birthPlace: "Pietersburg"
citizenship: "US"
phoneNumber: "+12025550190"
email: "john.smith@example.com"
documents:
- type: "FOREIGN_PASSPORT"
number: "123456789"
date: "1992-02-12"
organization: "Issuing organization"
- type: "VISA"
number: "123456789"
date: "1998-01-01"
expireDate: "2023-01-01"
addresses:
- type: "RESIDENCE_ADDRESS"
address: "Pietersburg, Transvaal Province, South Africa"
inn: "906858195320"
Юридическое лицо, резидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "UL_RESIDENT"
name: "Акционерное общество «Тинькофф Банк»"
phoneNumber: "+78007551110"
email: "business.welcome@tinkoff.ru"
addresses:
- type: "LEGAL_ENTITY_ADDRESS"
address: "127287, г. Москва, ул. Хуторская 2-я, д. 38А, стр\
. 26"
- type: "POSTAL_ADDRESS"
address: "Москва, 127287, ул. Хуторская 2-я, д. 38А, стр. 26;\
\ а/я 23, г. Москва, 102001"
registrationDate: "2002-11-28"
opf: "АО"
inn: "7710140679"
ogrn: "1027739642281"
Юридическое лицо, нерезидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "UL_NONRESIDENT"
name: "TCS Group Holding Plc."
phoneNumber: "+74996051110"
email: "business.welcome@tinkoff.ru"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036a"
- type: "LEGAL_ENTITY_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036"
- type: "OFFICE_OF_FOREIGN_LEGAL_ENTITY_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036"
nza: "12345678912"
registrationDate: "2015-11-13"
registrationNumber: "107963"
opf: "Plc."
inn: "9909215909"
kio: "21590"
ИП, резидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "IP_RESIDENT"
firstName: "Олег"
middleName: "Юрьевич"
lastName: "Анисимов"
birthDate: "1974-01-23"
birthPlace: "г. Москва"
citizenship: "RU"
phoneNumber: "+71378820200"
email: "KDDwKOwWD0@Pijg1"
documents:
- type: "PASSPORT"
serial: "5000"
number: "287846"
date: "1998-01-01"
organization: "Отделом УФМС по всем городам всех областей не\
объятной нашей Родины"
division: "123-456"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр\
. 26"
registrationDate: "2010-01-15"
inn: "306707771448"
ogrn: "310774601501066"
ИП, нерезидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "IP_NONRESIDENT"
firstName: "Олег"
middleName: "Юрьевич"
lastName: "Анисимов"
birthDate: "1974-01-23"
birthPlace: "г. Москва"
citizenship: "US"
phoneNumber: "+447768027220"
email: "OAAQAYkiXe@uUmPe"
documents:
- type: "FOREIGN_PASSPORT"
number: "123456789"
date: "1992-02-12"
organization: "Issuing organization"
- type: "MIGRATION_CARD"
number: "123456789"
date: "1998-01-01"
expireDate: "2023-01-01"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр\
. 26"
registrationDate: "2010-01-15"
inn: "173527033406"
ogrn: "310774601501066"
Легкий контакт:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "LITE_CONTACT"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/beneficiaries/{beneficiaryId}:
get:
tags:
- "Бенефициары и реквизиты"
summary: "Получить данные бенефициара"
description: "\nВозвращает информацию о бенефициаре по его ID.\n\n\nОграниче\
ние на использование метода — 10 запросов в секунду.\n\n\nЧтобы использова\
ть метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsBeneficiariesBeneficiaryid"
parameters:
- name: "beneficiaryId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BeneficiaryResponse"
examples:
Физическое лицо, резидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "FL_RESIDENT"
firstName: "Фома"
middleName: "Семенович"
lastName: "Киняев"
isSelfEmployed: true
birthDate: "1969-08-21"
birthPlace: "г. Москва"
citizenship: "RU"
phoneNumber: "+79998887766"
email: "f.kiniaev@tinkoff.ru"
documents:
- type: "PASSPORT"
serial: "5000"
number: "287846"
date: "1998-01-01"
organization: "Отделом УФМС по всем городам всех областей не\
объятной нашей Родины"
division: "123-456"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр\
. 26"
inn: "266445718640"
snils: "72865174431"
Физическое лицо, нерезидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "FL_NONRESIDENT"
firstName: "John"
middleName: "William"
lastName: "Smith"
isSelfEmployed: false
birthDate: "1978-04-03"
birthPlace: "Pietersburg"
citizenship: "US"
phoneNumber: "+12025550190"
email: "john.smith@example.com"
documents:
- type: "FOREIGN_PASSPORT"
number: "123456789"
date: "1992-02-12"
organization: "Issuing organization"
- type: "VISA"
number: "123456789"
date: "1998-01-01"
expireDate: "2023-01-01"
addresses:
- type: "RESIDENCE_ADDRESS"
address: "Pietersburg, Transvaal Province, South Africa"
inn: "906858195320"
Юридическое лицо, резидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "UL_RESIDENT"
name: "Акционерное общество «Тинькофф Банк»"
phoneNumber: "+78007551110"
email: "business.welcome@tinkoff.ru"
addresses:
- type: "LEGAL_ENTITY_ADDRESS"
address: "127287, г. Москва, ул. Хуторская 2-я, д. 38А, стр\
. 26"
- type: "POSTAL_ADDRESS"
address: "Москва, 127287, ул. Хуторская 2-я, д. 38А, стр. 26;\
\ а/я 23, г. Москва, 102001"
registrationDate: "2002-11-28"
opf: "АО"
inn: "7710140679"
ogrn: "1027739642281"
Юридическое лицо, нерезидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "UL_NONRESIDENT"
name: "TCS Group Holding Plc."
phoneNumber: "+74996051110"
email: "business.welcome@tinkoff.ru"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036a"
- type: "LEGAL_ENTITY_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036"
- type: "OFFICE_OF_FOREIGN_LEGAL_ENTITY_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036"
nza: "12345678912"
registrationDate: "2015-11-13"
registrationNumber: "107963"
opf: "Plc."
inn: "9909215909"
kio: "21590"
ИП, резидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "IP_RESIDENT"
firstName: "Олег"
middleName: "Юрьевич"
lastName: "Анисимов"
birthDate: "1974-01-23"
birthPlace: "г. Москва"
citizenship: "RU"
phoneNumber: "+71378820200"
email: "KDDwKOwWD0@Pijg1"
documents:
- type: "PASSPORT"
serial: "5000"
number: "287846"
date: "1998-01-01"
organization: "Отделом УФМС по всем городам всех областей не\
объятной нашей Родины"
division: "123-456"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр\
. 26"
registrationDate: "2010-01-15"
inn: "306707771448"
ogrn: "310774601501066"
ИП, нерезидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "IP_NONRESIDENT"
firstName: "Олег"
middleName: "Юрьевич"
lastName: "Анисимов"
birthDate: "1974-01-23"
birthPlace: "г. Москва"
citizenship: "US"
phoneNumber: "+447768027220"
email: "OAAQAYkiXe@uUmPe"
documents:
- type: "FOREIGN_PASSPORT"
number: "123456789"
date: "1992-02-12"
organization: "Issuing organization"
- type: "MIGRATION_CARD"
number: "123456789"
date: "1998-01-01"
expireDate: "2023-01-01"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр\
. 26"
registrationDate: "2010-01-15"
inn: "173527033406"
ogrn: "310774601501066"
Легкий контакт:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "LITE_CONTACT"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
put:
tags:
- "Бенефициары и реквизиты"
summary: "Изменить данные бенефициара"
description: "\nМетод полностью изменяет данные бенефициара по его ID.\n\n\n\
Ограничение на использование метода — 10 запросов в секунду.\n\n\nЧтобы ис\
пользовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "putApiV1Nominal-accountsBeneficiariesBeneficiaryid"
parameters:
- name: "beneficiaryId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/BeneficiaryRequest"
examples:
Физическое лицо, резидент:
value:
type: "FL_RESIDENT"
firstName: "Фома"
middleName: "Семенович"
lastName: "Киняев"
isSelfEmployed: true
birthDate: "1969-08-21"
birthPlace: "г. Москва"
citizenship: "RU"
phoneNumber: "+79998887766"
email: "f.kiniaev@tinkoff.ru"
documents:
- type: "PASSPORT"
serial: "5000"
number: "287846"
date: "1998-01-01"
organization: "Отделом УФМС по всем городам всех областей необ\
ъятной нашей Родины"
division: "123-456"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр. 26"
inn: "266445718640"
snils: "72865174431"
Физическое лицо, нерезидент:
value:
type: "FL_NONRESIDENT"
firstName: "John"
middleName: "William"
lastName: "Smith"
isSelfEmployed: false
birthDate: "1978-04-03"
birthPlace: "Pietersburg"
citizenship: "US"
phoneNumber: "+12025550190"
email: "john.smith@example.com"
documents:
- type: "FOREIGN_PASSPORT"
number: "123456789"
date: "1992-02-12"
organization: "Issuing organization"
- type: "VISA"
number: "123456789"
date: "1998-01-01"
expireDate: "2023-01-01"
addresses:
- type: "RESIDENCE_ADDRESS"
address: "Pietersburg, Transvaal Province, South Africa"
inn: "906858195320"
Юридическое лицо, резидент:
value:
type: "UL_RESIDENT"
name: "Акционерное общество «Тинькофф Банк»"
phoneNumber: "+78007551110"
email: "business.welcome@tinkoff.ru"
addresses:
- type: "LEGAL_ENTITY_ADDRESS"
address: "127287, г. Москва, ул. Хуторская 2-я, д. 38А, стр. 26"
- type: "POSTAL_ADDRESS"
address: "Москва, 127287, ул. Хуторская 2-я, д. 38А, стр. 26;\
\ а/я 23, г. Москва, 102001"
registrationDate: "2002-11-28"
opf: "АО"
inn: "7710140679"
ogrn: "1027739642281"
Юридическое лицо, нерезидент:
value:
type: "UL_NONRESIDENT"
name: "TCS Group Holding Plc."
phoneNumber: "+74996051110"
email: "business.welcome@tinkoff.ru"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036a"
- type: "LEGAL_ENTITY_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036"
- type: "OFFICE_OF_FOREIGN_LEGAL_ENTITY_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036"
nza: "12345678912"
registrationDate: "2015-11-13"
registrationNumber: "107963"
opf: "Plc."
inn: "9909215909"
kio: "21590"
ИП, резидент:
value:
type: "IP_RESIDENT"
firstName: "Олег"
middleName: "Юрьевич"
lastName: "Анисимов"
birthDate: "1974-01-23"
birthPlace: "г. Москва"
citizenship: "RU"
phoneNumber: "+71378820200"
email: "KDDwKOwWD0@Pijg1"
documents:
- type: "PASSPORT"
serial: "5000"
number: "287846"
date: "1998-01-01"
organization: "Отделом УФМС по всем городам всех областей необ\
ъятной нашей Родины"
division: "123-456"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр. 26"
registrationDate: "2010-01-15"
inn: "306707771448"
ogrn: "310774601501066"
ИП, нерезидент:
value:
type: "IP_NONRESIDENT"
firstName: "Олег"
middleName: "Юрьевич"
lastName: "Анисимов"
birthDate: "1974-01-23"
birthPlace: "г. Москва"
citizenship: "US"
phoneNumber: "+447768027220"
email: "OAAQAYkiXe@uUmPe"
documents:
- type: "FOREIGN_PASSPORT"
number: "123456789"
date: "1992-02-12"
organization: "Issuing organization"
- type: "MIGRATION_CARD"
number: "123456789"
date: "1998-01-01"
expireDate: "2023-01-01"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр. 26"
registrationDate: "2010-01-15"
inn: "173527033406"
ogrn: "310774601501066"
Легкий контакт:
value:
type: "LITE_CONTACT"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BeneficiaryResponse"
examples:
Физическое лицо, резидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "FL_RESIDENT"
firstName: "Фома"
middleName: "Семенович"
lastName: "Киняев"
isSelfEmployed: true
birthDate: "1969-08-21"
birthPlace: "г. Москва"
citizenship: "RU"
phoneNumber: "+79998887766"
email: "f.kiniaev@tinkoff.ru"
documents:
- type: "PASSPORT"
serial: "5000"
number: "287846"
date: "1998-01-01"
organization: "Отделом УФМС по всем городам всех областей не\
объятной нашей Родины"
division: "123-456"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр\
. 26"
inn: "266445718640"
snils: "72865174431"
Физическое лицо, нерезидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "FL_NONRESIDENT"
firstName: "John"
middleName: "William"
lastName: "Smith"
isSelfEmployed: false
birthDate: "1978-04-03"
birthPlace: "Pietersburg"
citizenship: "US"
phoneNumber: "+12025550190"
email: "john.smith@example.com"
documents:
- type: "FOREIGN_PASSPORT"
number: "123456789"
date: "1992-02-12"
organization: "Issuing organization"
- type: "VISA"
number: "123456789"
date: "1998-01-01"
expireDate: "2023-01-01"
addresses:
- type: "RESIDENCE_ADDRESS"
address: "Pietersburg, Transvaal Province, South Africa"
inn: "906858195320"
Юридическое лицо, резидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "UL_RESIDENT"
name: "Акционерное общество «Тинькофф Банк»"
phoneNumber: "+78007551110"
email: "business.welcome@tinkoff.ru"
addresses:
- type: "LEGAL_ENTITY_ADDRESS"
address: "127287, г. Москва, ул. Хуторская 2-я, д. 38А, стр\
. 26"
- type: "POSTAL_ADDRESS"
address: "Москва, 127287, ул. Хуторская 2-я, д. 38А, стр. 26;\
\ а/я 23, г. Москва, 102001"
registrationDate: "2002-11-28"
opf: "АО"
inn: "7710140679"
ogrn: "1027739642281"
Юридическое лицо, нерезидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "UL_NONRESIDENT"
name: "TCS Group Holding Plc."
phoneNumber: "+74996051110"
email: "business.welcome@tinkoff.ru"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036a"
- type: "LEGAL_ENTITY_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036"
- type: "OFFICE_OF_FOREIGN_LEGAL_ENTITY_ADDRESS"
address: "5th floor BERENGARIA 25 Spyrou Araouzou 25 Limassol,\
\ Cyprus, 3036"
nza: "12345678912"
registrationDate: "2015-11-13"
registrationNumber: "107963"
opf: "Plc."
inn: "9909215909"
kio: "21590"
ИП, резидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "IP_RESIDENT"
firstName: "Олег"
middleName: "Юрьевич"
lastName: "Анисимов"
birthDate: "1974-01-23"
birthPlace: "г. Москва"
citizenship: "RU"
phoneNumber: "+71378820200"
email: "KDDwKOwWD0@Pijg1"
documents:
- type: "PASSPORT"
serial: "5000"
number: "287846"
date: "1998-01-01"
organization: "Отделом УФМС по всем городам всех областей не\
объятной нашей Родины"
division: "123-456"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр\
. 26"
registrationDate: "2010-01-15"
inn: "306707771448"
ogrn: "310774601501066"
ИП, нерезидент:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "IP_NONRESIDENT"
firstName: "Олег"
middleName: "Юрьевич"
lastName: "Анисимов"
birthDate: "1974-01-23"
birthPlace: "г. Москва"
citizenship: "US"
phoneNumber: "+447768027220"
email: "OAAQAYkiXe@uUmPe"
documents:
- type: "FOREIGN_PASSPORT"
number: "123456789"
date: "1992-02-12"
organization: "Issuing organization"
- type: "MIGRATION_CARD"
number: "123456789"
date: "1998-01-01"
expireDate: "2023-01-01"
addresses:
- type: "REGISTRATION_ADDRESS"
address: "127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр\
. 26"
registrationDate: "2010-01-15"
inn: "173527033406"
ogrn: "310774601501066"
Легкий контакт:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
type: "LITE_CONTACT"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/beneficiaries/scoring:
get:
tags:
- "Бенефициары и реквизиты"
summary: "Получить результаты проверки бенефициаров в финансовом мониторинге\
\ v1"
description: "\nМетод устарел. Если вы подключаетесь первый раз, используйте\
\ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsBeneficiariesScoring"
parameters:
- name: "beneficiaryId"
in: "query"
description: "\nИдентификатор бенефициара, по которому нужно вернуть резул\
ьтаты проверки.\nЕсли вы не передаете параметр, возвращаются результаты\
\ по всем бенефициарам."
required: false
style: "form"
explode: true
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
example: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
- name: "passed"
in: "query"
description: "Фильтр по результату проверки — прошел/не прошел."
required: false
style: "form"
explode: true
schema:
type: "boolean"
example: true
- name: "offset"
in: "query"
description: "Количество результатов проверки, которое нужно пропустить. З\
начение по умолчанию — 0
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно пропустить."
format: "int32"
example: 0
- name: "limit"
in: "query"
description: "Количество результатов проверки, которое нужно вывести. Знач\
ение по умолчанию — 50
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно вывести."
format: "int32"
example: 50
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BeneficiaryScoringInfoListResponse"
example:
offset: 0
limit: 50
size: 2
total: 2
results:
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
status: "IN_PROGRESS"
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
status: "READY"
result:
isInnValid: true
isPassportValid: false
isInBlacklist: false
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
deprecated: true
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/bank-details:
get:
tags:
- "Бенефициары и реквизиты"
summary: "Получить список банковских реквизитов бенефициара"
description: "\nВозвращает информацию о всех банковских реквизитах бенефициа\
ра.\n\n\nОграничение на использование метода — 10 запросов в секунду.\n\n\n\
Чтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsBeneficiariesBeneficiaryidBank-details"
parameters:
- name: "beneficiaryId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
- name: "offset"
in: "query"
description: "Количество реквизитов, которое необходимо пропустить. Значен\
ие по умолчанию — 0
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно пропустить."
format: "int32"
example: 0
- name: "limit"
in: "query"
description: "Количество реквизитов, которое необходимо вывести. Значение\
\ по умолчанию — 50
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно вывести."
format: "int32"
example: 50
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BankDetailsListResponse"
example:
offset: 0
limit: 50
size: 3
total: 3
results:
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
type: "PAYMENT_DETAILS"
isDefault: false
bik: "044525974"
kpp: "773401001"
inn: "906858195320"
name: "Киняев Фома Семенович"
bankName: "АО \"ТБанк\""
accountNumber: "11223344556677889900"
corrAccountNumber: "30101810145250000974"
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
type: "CARD"
isDefault: false
cardId: "70000000707"
terminalKey: "1573803282696E2C"
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
type: "SBP"
isDefault: false
phoneNumber: "+79001112233"
bankId: "100000000004"
terminalKey: "1573803282696E2C"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
post:
tags:
- "Бенефициары и реквизиты"
summary: "Создать банковские реквизиты для бенефициара"
description: "\nСоздает банковские реквизиты для бенефициара и возвращает их\
\ с ID, который нужен для дальнейшего взаимодействия.\n\n\nОграничение на\
\ использование метода — 10 запросов в секунду.\n\n\nС помощью метода можн\
о создать реквизиты типов `PAYMENT_DETAILS`, `CARD` и `SBP`.\nДобавить рек\
визиты типа `CARD` могут только партнеры с сертификатом PCI DSS.\nЧтобы по\
дключиться к методу, напишите на openapi@tinkoff.ru\
\ перед интеграцией.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "postApiV1Nominal-accountsBeneficiariesBeneficiaryidBank-details"
parameters:
- name: "Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности. Подробнее."
format: "uuid"
- name: "beneficiaryId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/BankDetailsRequest"
examples:
По реквизитам счета.:
value:
type: "PAYMENT_DETAILS"
isDefault: true
bik: "044525974"
kpp: "773401001"
inn: "906858195320"
name: "Киняев Фома Семенович"
bankName: "АО \"ТБанк\""
accountNumber: "11223344556677889900"
corrAccountNumber: "30101810145250000974"
По карте.:
value:
type: "CARD"
isDefault: true
terminalKey: "1573803282696E2C"
cardData: "ZV5eh9/1JXyBouiDDLpM84dgNBXata7LX/lB1vb8macuJ/bhV8qGe9SzYAsAG8WnmP0G1aNdu4FiLjclzgG1Scn2jJLNex5wM4Acr882QVgV00ZxGAmN3A8su1iVyDWV19Sq7l3WsFWZx2HZPbn8XvkcRHTUHeW528+7pbwSHi/1cTgsqyUpuBrBIz4SaYEVc8Rn57M7YxcdbtR/SAlyInWUUaIAEOJSSJwIQ/35cXLdK/7beLVtIuy2NcjIOnW5yOA1qDRcMiAd+wVhrDb8iZQMf/jPm7a4atlcA+x1z/eaf9gaOXqzDMjtRcFC9/fBsJV+QMMlecmaDhW8ZY1vuA=="
Через СБП.:
value:
type: "SBP"
isDefault: true
terminalKey: "1573803282696E2C"
phoneNumber: "+79001112233"
bankId: "100000000004"
required: true
responses:
"201":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BankDetailsResponse"
examples:
По карте.:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
type: "CARD"
isDefault: true
cardId: "70000000707"
terminalKey: "1573803282696E2C"
По реквизитам счета.:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
type: "PAYMENT_DETAILS"
isDefault: true
bik: "044525974"
kpp: "773401001"
inn: "906858195320"
name: "Киняев Фома Семенович"
bankName: "АО \"ТБанк\""
accountNumber: "11223344556677889900"
corrAccountNumber: "30101810145250000974"
Через СБП.:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
type: "SBP"
isDefault: true
phoneNumber: "+79001112233"
bankId: "100000000004"
terminalKey: "1573803282696E2C"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/bank-details/{bankDetailsId}:
get:
tags:
- "Бенефициары и реквизиты"
summary: "Получить данные банковских реквизитов бенефициара"
description: "\nВозвращает информацию о банковских реквизитах бенефициара по\
\ их ID.\n\n\nОграничение на использование метода — 10 запросов в секунду\
.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsBeneficiariesBeneficiaryidBank-detailsBankdetailsid"
parameters:
- name: "beneficiaryId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
- name: "bankDetailsId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор банковских реквизитов."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BankDetailsResponse"
examples:
По карте.:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
type: "CARD"
isDefault: true
cardId: "70000000707"
terminalKey: "1573803282696E2C"
По реквизитам счета.:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
type: "PAYMENT_DETAILS"
isDefault: true
bik: "044525974"
kpp: "773401001"
inn: "906858195320"
name: "Киняев Фома Семенович"
bankName: "АО \"ТБанк\""
accountNumber: "11223344556677889900"
corrAccountNumber: "30101810145250000974"
Через СБП.:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
type: "SBP"
isDefault: true
phoneNumber: "+79001112233"
bankId: "100000000004"
terminalKey: "1573803282696E2C"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
put:
tags:
- "Бенефициары и реквизиты"
summary: "Изменить банковские реквизиты бенефициара"
description: "\nПолностью изменяет банковские реквизиты бенефициара по их ID.\
\ Вы можете изменить реквизиты типа `PAYMENT_DETAILS` и `SBP`.\n\n\nОграни\
чение на использование метода — 10 запросов в секунду.\n\n\nЧтобы использо\
вать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "putApiV1Nominal-accountsBeneficiariesBeneficiaryidBank-detailsBankdetailsid"
parameters:
- name: "beneficiaryId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
- name: "bankDetailsId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор банковских реквизитов."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/BankDetailsRequest"
examples:
По реквизитам счета.:
value:
type: "PAYMENT_DETAILS"
isDefault: true
bik: "044525974"
kpp: "773401001"
inn: "906858195320"
name: "Киняев Фома Семенович"
bankName: "АО \"ТБанк\""
accountNumber: "11223344556677889900"
corrAccountNumber: "30101810145250000974"
Через СБП.:
value:
type: "SBP"
isDefault: true
terminalKey: "1573803282696E2C"
phoneNumber: "+79001112233"
bankId: "100000000004"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BankDetailsResponse"
examples:
По реквизитам счета.:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
type: "PAYMENT_DETAILS"
isDefault: true
bik: "044525974"
kpp: "773401001"
inn: "906858195320"
name: "Киняев Фома Семенович"
bankName: "АО \"ТБанк\""
accountNumber: "11223344556677889900"
corrAccountNumber: "30101810145250000974"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
delete:
tags:
- "Бенефициары и реквизиты"
summary: "Удалить банковские реквизиты бенефициара"
description: "\nУдаляет реквизиты бенефициара по их ID.\n\n\nОграничение на\
\ использование метода — 10 запросов в секунду.\n\n\nЧтобы использовать ме\
тод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "deleteApiV1Nominal-accountsBeneficiariesBeneficiaryidBank-detailsBankdetailsid"
parameters:
- name: "beneficiaryId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
- name: "bankDetailsId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор банковских реквизитов."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/bank-details/{bankDetailsId}/set-default:
post:
tags:
- "Бенефициары и реквизиты"
summary: "Установить банковские реквизиты бенефициара по умолчанию"
description: "\nВыставляет банковские реквизиты бенефициара как реквизиты по\
\ умолчанию.\n\n\nОграничение на использование метода — 10 запросов в секу\
нду.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "postApiV1Nominal-accountsBeneficiariesBeneficiaryidBank-detailsBankdetailsidSet-default"
parameters:
- name: "beneficiaryId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
- name: "bankDetailsId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор банковских реквизитов."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/add-card-requests:
post:
tags:
- "Бенефициары и реквизиты"
summary: "Создать запрос на добавление реквизитов типа CARD для бенефициара"
description: "\nСоздает запрос на добавление реквизитов типа `CARD` для бене\
фициара и возвращает его с ID, который нужен для дальнейшего взаимодействи\
я.\n\n\nОграничение на использование метода — 10 запросов в секунду.\n\n\n\
Чтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "postApiV1Nominal-accountsBeneficiariesBeneficiaryidAdd-card-requests"
parameters:
- name: "Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности. Подробнее."
format: "uuid"
- name: "beneficiaryId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/AddCardRequestRequest"
example:
terminalKey: "1573803282696E2C"
required: true
responses:
"201":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AddCardRequestResponse"
example:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
addCardRequestId: "49e46893-9a7e-409b-8c79-647aecaae555"
terminalKey: "1573803282696E2C"
status: "PENDING"
addCardUrl: "https://securepay.tinkoff.ru/e2c/f36d8e7f-4bc6-4250-9f64-7fe986d3dc62"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/add-card-requests/{addCardRequestId}:
get:
tags:
- "Бенефициары и реквизиты"
summary: "Получить запрос на добавление реквизитов типа CARD для бенефициара"
description: "\nВозвращает состояние запроса на добавление реквизитов типа `CARD`\
\ для бенефициара.\n\n\nОграничение на использование метода — 10 запросов\
\ в секунду.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsBeneficiariesBeneficiaryidAdd-card-requestsAddcardrequestid"
parameters:
- name: "beneficiaryId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
- name: "addCardRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса на добавление карты."
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AddCardRequestResponse"
examples:
карта в процессе добавления.:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
addCardRequestId: "49e46893-9a7e-409b-8c79-647aecaae555"
terminalKey: "1573803282696E2C"
status: "PENDING"
addCardUrl: "https://securepay.tinkoff.ru/e2c/f36d8e7f-4bc6-4250-9f64-7fe986d3dc62"
карта успешно добавлена.:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
addCardRequestId: "49e46893-9a7e-409b-8c79-647aecaae555"
terminalKey: "1573803282696E2C"
status: "READY"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
не удалось добавить карту.:
value:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
addCardRequestId: "49e46893-9a7e-409b-8c79-647aecaae555"
terminalKey: "1573803282696E2C"
status: "FAILED"
errorMessage: "Внутренняя ошибка системы [9999]"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v2/nominal-accounts/beneficiaries/scoring:
get:
tags:
- "Бенефициары и реквизиты"
summary: "Получить результаты проверки бенефициаров в финансовом мониторинге\
\ v2"
description: "\nВозвращает информацию о результатах проверки бенефициаров в\
\ финансовом мониторинге:\n\n * Для ФЛ-резидентов (FL_RESIDENT) — корректн\
ость паспортных данных, действительность паспорта и проверка по черным спи\
скам.\n * Для ИП-резидентов (IP_RESIDENT) — корректность паспортных данных\
, действительность паспорта и проверка в ЕГРЮЛ.\n * Для ИП-нерезидентов (IP_NONRESIDENT)\
\ — проверка в ЕГРЮЛ.\n * Для ЮЛ-резидентов (UL_RESIDENT) — проверка в ЕГР\
ЮЛ.\n\n\nСписок возможных кодов непройденных проверок:\n\n * INVALID_INN
\
\ — не пройдена проверка на корректность паспортных данных бенефициара.\n\
\ * INVALID_PASSPORT
— не пройдена проверка на действительнос\
ть паспорта бенефициара.\n * IN_BLACKLIST
— бенефициар найден\
\ в черных списках.\n * UL_CLOSED
, UL_NOT_FOUND
\
\ — не пройдена проверка бенефициара в ЕГРЮЛ.\n\n\nКритичные проверки\n\
\n * INVALID_INN
\n * INVALID_PASSPORT
\n * UL_CLOSED
\n\
\ * UL_NOT_FOUND
\n\n\nКоды всех непройденных критичных провер\
ок вернутся в массиве errors.\n\n\n⚠️ Если не пройдена хотя бы одна\
\ критичная проверка, итоговый статус будет FAILED
.\n\nВыплат\
а с участием такого бенефициара через метод Завершить этап сделки\nили через метод Выполнить платеж в пользу бенефициара на реальный счет\nне сможет зав\
ершиться успешно, потому что такое лицо не может быть бенефициаром по номи\
нальному счету.\n\n\nНекритичные проверки\n\n * IN_BLACKLIST
\n\
\n\nКоды всех непройденных некритичных проверок вернутся в массиве warnings.\n\
\n\n⚠️ Непрохождение некритичных проверок не влияет на выплаты бенефициара\
м.\n\n\nОграничение на использование метода — 10 запросов в секунду.\n\n\n\
Чтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV2Nominal-accountsBeneficiariesScoring"
parameters:
- name: "beneficiaryId"
in: "query"
description: "\nИдентификатор бенефициара, по которому необходимо вернуть\
\ результаты проверки.\nЕсли вы не передаете параметр, возвращаются резу\
льтаты по всем бенефициарам."
required: false
style: "form"
explode: true
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
example: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
- name: "passed"
in: "query"
description: "Фильтр по результату проверки (прошел/не прошел)."
required: false
style: "form"
explode: true
schema:
type: "boolean"
example: true
- name: "offset"
in: "query"
description: "Количество результатов проверки, которое нужно пропустить. З\
начение по умолчанию — 0
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно пропустить."
format: "int32"
example: 0
- name: "limit"
in: "query"
description: "Количество результатов проверки, которое нужно вывести. Знач\
ение по умолчанию — 50
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно вывести."
format: "int32"
example: 50
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BeneficiaryScoringInfoListResponseV2"
example:
offset: 0
limit: 50
size: 3
total: 3
results:
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
status: "FAILED"
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
status: "SUCCEEDED"
warnings:
- code: "IN_BLACKLIST"
description: "Бенефициар найден в черных списках."
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
status: "FAILED"
warnings:
- code: "IN_BLACKLIST"
description: "Бенефициар найден в черных списках."
errors:
- code: "INVALID_INN"
description: "Данные паспорта физического лица или ИП некоррек\
тны — проверка по ФИО, паспортным данным и дате рождения. По\
пробуйте доуточнить данные.Исключение — случаи, по которым И\
НН нет в принципе. В таком случае обратитесь к сотруднику по\
ддержки, чтобы вам помогли выключить проверку."
- code: "INVALID_PASSPORT"
description: "Паспорт бенефициара найден в базе недействителен\
ых паспортов — например, истек срок действия или утерян."
- code: "UL_CLOSED"
description: "Юридическое лицо или ИП больше не существует (ли\
квидировано). Данный контрагент не может являться бенефициар\
ом по номинальному счету."
- code: "UL_NOT_FOUND"
description: "Юридическое лицо или ИП не найдено в ЕГРЮЛ — вер\
оятнее всего, ошибка в ИНН. Заполните данные еще раз."
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/deals:
get:
tags:
- "Управление сделками"
summary: "Получить список сделок"
description: "\nПозволяет получить список сделок компании.\n\n\nОграничение\
\ на использование метода — 10 запросов в секунду.\n\n\nЧтобы использовать\
\ метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsDeals"
parameters:
- name: "offset"
in: "query"
description: "Количество сделок, которое нужно пропустить. Значение по умо\
лчанию — 0
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно пропустить."
format: "int32"
example: 0
- name: "limit"
in: "query"
description: "Количество сделок, которое нужно вывести. Значение по умолча\
нию — 50
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно вывести."
format: "int32"
example: 50
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/DealListResponse"
example:
offset: 0
limit: 50
size: 1
total: 1
results:
- dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
accountNumber: "40702810110011000777"
status: "DRAFT"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
post:
tags:
- "Управление сделками"
summary: "Создать сделку"
description: "\nПозволяет создать сделку. Вам понадобится номер номинального\
\ счета.\n\n\nОграничение на использование метода — 10 запросов в секунду\
.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "postApiV1Nominal-accountsDeals"
parameters:
- name: "Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности. Подробнее."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/DealRequest"
example:
accountNumber: "40702810110011000777"
required: true
responses:
"201":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/DealResponse"
example:
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
accountNumber: "40702810110011000777"
status: "DRAFT"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/deals/{dealId}/draft:
post:
tags:
- "Управление сделками"
summary: "Перевести сделку в черновик"
description: "\nПозволяет перевести сделку в статус `DRAFT`. В этом статусе\
\ сделку можно редактировать.\n\n\nОграничение на использование метода — 10\
\ запросов в секунду.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "postApiV1Nominal-accountsDealsDealidDraft"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/deals/{dealId}/accept:
post:
tags:
- "Управление сделками"
summary: "Подтвердить параметры сделки"
description: "\nПозволяет перевести сделку в статус `ACCEPTED` — после `DRAFT`.\n\
\n\nОграничение на использование метода — 10 запросов в секунду.\n\n\nЧтоб\
ы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "postApiV1Nominal-accountsDealsDealidAccept"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/deals/{dealId}/cancel:
post:
tags:
- "Управление сделками"
summary: "Отменить сделку"
description: "\nПозволяет перевести сделку в статус `CANCELLED`, чтобы ее от\
менить.\n\n\nОграничение на использование метода — 10 запросов в секунду.\n\
\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "postApiV1Nominal-accountsDealsDealidCancel"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/deals/{dealId}/steps:
get:
tags:
- "Управление этапами сделок"
summary: "Получить список этапов сделки"
description: "\nПозволяет получить список этапов сделки компании.\n\n\nОгран\
ичение на использование метода — 10 запросов в секунду.\n\n\nЧтобы использ\
овать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsDealsDealidSteps"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "offset"
in: "query"
description: "Количество этапов, которое нужно пропустить. Значение по умо\
лчанию — 0
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно пропустить."
format: "int32"
example: 0
- name: "limit"
in: "query"
description: "Количество этапов, которое необходимо вывести. Значение по у\
молчанию — 50
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно вывести."
format: "int32"
example: 50
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/StepListResponse"
example:
offset: 0
limit: 50
size: 1
total: 1
results:
- dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
stepNumber: 1
description: "Описание этапа сделки"
status: "NEW"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
post:
tags:
- "Управление этапами сделок"
summary: "Создать этап сделки"
description: "\nКогда сделка создана, нужно создать этап(-ы) сделки для сове\
ршения финансовых операций.\nЕсли в рамках сделки совершаются только однов\
ременные выплаты, создайте только один этап.\n\n\nОграничение на использов\
ание метода — 10 запросов в секунду.\n\n\nЧтобы использовать метод, нужен\
\ доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "postApiV1Nominal-accountsDealsDealidSteps"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности. Подробнее."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/StepRequest"
example:
description: "Описание этапа сделки"
required: true
responses:
"201":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/StepResponse"
example:
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
stepNumber: 1
description: "Описание этапа сделки"
status: "NEW"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/complete:
post:
tags:
- "Управление этапами сделок"
summary: "Завершить этап сделки"
description: "\nПозволяет завершить этап для совершения выплат конечным полу\
чателям — реципиентам (recipients),\nкогда все условия сделки выполнены.\n\
\n\nОграничение на использование метода — 10 запросов в секунду.\n\n\nЧтоб\
ы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "postApiV1Nominal-accountsDealsDealidStepsStepidComplete"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "stepId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/deponents/{beneficiaryId}:
get:
tags:
- "Депоненты и реципиенты"
summary: "Получить депонента по ID бенефициара"
description: "\nПозволяет получить депонента по ID бенефициара.\n\n\nОгранич\
ение на использование метода — 10 запросов в секунду.\n\n\nЧтобы использов\
ать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsDealsDealidStepsStepidDeponentsBeneficiaryid"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "stepId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
- name: "beneficiaryId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/DeponentResponse"
example:
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
amount: 100
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
put:
tags:
- "Депоненты и реципиенты"
summary: "Создать или обновить депонента на этапе сделки"
description: "\nПозволяет создать или обновить депонента на этапе сделки. То\
лько для сделок в статусе `DRAFT`.\n\n\nОграничение на использование метод\
а — 10 запросов в секунду.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "putApiV1Nominal-accountsDealsDealidStepsStepidDeponentsBeneficiaryid"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "stepId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
- name: "beneficiaryId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/DeponentRequest"
example:
amount: 100
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/DeponentResponse"
example:
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
amount: 100
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
delete:
tags:
- "Депоненты и реципиенты"
summary: "Удалить депонента"
description: "\nПозволяет удалить депонента на этапе сделки. Только для сдел\
ок в статусе `DRAFT`.\n\n\nОграничение на использование метода — 10 запрос\
ов в секунду.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "deleteApiV1Nominal-accountsDealsDealidStepsStepidDeponentsBeneficiaryid"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "stepId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
- name: "beneficiaryId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/deponents:
get:
tags:
- "Депоненты и реципиенты"
summary: "Получить всех депонентов этапа"
description: "\nПозволяет получить всех депонентов этапа сделки.\n\n\nОграни\
чение на использование метода — 10 запросов в секунду.\n\n\nЧтобы использо\
вать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsDealsDealidStepsStepidDeponents"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "stepId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
- name: "offset"
in: "query"
description: "Количество депонентов, которое нужно пропустить. Значение по\
\ умолчанию — 0
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно пропустить."
format: "int32"
example: 0
- name: "limit"
in: "query"
description: "Количество депонентов, которое нужно вывести. Значение по ум\
олчанию — 50
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно вывести."
format: "int32"
example: 50
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/DeponentListResponse"
example:
offset: 0
limit: 50
size: 1
total: 1
results:
- dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
amount: 100
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/recipients/{recipientId}:
get:
tags:
- "Депоненты и реципиенты"
summary: "Получить реципиента по ID реципиента"
description: "\nПозволяет получить получателя денежных средств — реципиента\
\ (recipient) по ID реципиента (recipientId).\n\n\nОграничение на использо\
вание метода — 10 запросов в секунду.\n\n\nЧтобы использовать метод, нужен\
\ доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
.\n\n\nОтдельный recipientId\
\ создается для идентификации каждого реципиента, так как один и тот же\nб\
енефициар может использоваться в рамках одного этапа несколько раз."
operationId: "getApiV1Nominal-accountsDealsDealidStepsStepidRecipientsRecipientid"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "stepId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
- name: "recipientId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор реципиента."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/RecipientResponse"
example:
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
recipientId: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
amount: 90
tax: 5
purpose: "Назначение платежа"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
keepOnVirtualAccount: false
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
put:
tags:
- "Депоненты и реципиенты"
summary: "Изменить реципиента на этапе сделки"
description: "\nПозволяет изменить данные получателя денежных средств — реци\
пиента (recipient) на этапе сделки. Только для сделок в статусе `DRAFT`.\n\
\n\nОграничение на использование метода — 10 запросов в секунду.\n\n\nЧтоб\
ы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
.\n\n\nЕсли вы делаете пер\
евод на реквизиты — укажите `bankDetailsId`. При переводе на виртуальный с\
чет в рамках номинального счета\nукажите `keepOnVirtualAccount = true`."
operationId: "putApiV1Nominal-accountsDealsDealidStepsStepidRecipientsRecipientid"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "stepId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
- name: "recipientId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор реципиента."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/RecipientRequest"
example:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
amount: 90
tax: 5
purpose: "Назначение платежа"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
keepOnVirtualAccount: false
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/RecipientResponse"
example:
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
recipientId: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
amount: 90
tax: 5
purpose: "Назначение платежа"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
keepOnVirtualAccount: false
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
delete:
tags:
- "Депоненты и реципиенты"
summary: "Удалить реципиента"
description: "\nПозволяет удалить получателя денежных средств — реципиента (recipient)\
\ на этапе сделки. Только для сделок в статусе `DRAFT`.\n\n\nОграничение н\
а использование метода — 10 запросов в секунду.\n\n\nЧтобы использовать ме\
тод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "deleteApiV1Nominal-accountsDealsDealidStepsStepidRecipientsRecipientid"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "stepId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
- name: "recipientId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор реципиента."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/recipients:
get:
tags:
- "Депоненты и реципиенты"
summary: "Получить всех реципиентов этапа"
description: "\nПозволяет получить всех получателей денежных средств — рецип\
иентов (recipients) этапа сделки.\n\n\nОграничение на использование метода\
\ — 10 запросов в секунду.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsDealsDealidStepsStepidRecipients"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "stepId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
- name: "offset"
in: "query"
description: "Количество реципиентов, которое нужно пропустить. Значение п\
о умолчанию — 0
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно пропустить."
format: "int32"
example: 0
- name: "limit"
in: "query"
description: "Количество реципиентов, которое нужно вывести. Значение по у\
молчанию — 50
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно вывести."
format: "int32"
example: 50
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/RecipientListResponse"
example:
offset: 0
limit: 50
size: 1
total: 1
results:
- dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
recipientId: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
amount: 90
tax: 5
purpose: "Назначение платежа"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
keepOnVirtualAccount: false
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
post:
tags:
- "Депоненты и реципиенты"
summary: "Создать реципиента на этапе сделки"
description: "\nПозволяет создать получателя денежных средств — реципиента (recipient)\
\ на этапе сделки. Только для сделок в статусе `DRAFT`.\n\n\nОграничение н\
а использование метода — 10 запросов в секунду.\n\n\nЧтобы использовать ме\
тод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
.\n\n\nЕсли вы делаете пер\
евод на реквизиты, укажите `bankDetailsId`. При переводе на виртуальный сч\
ет в рамках номинального счета\nукажите `keepOnVirtualAccount = true`."
operationId: "postApiV1Nominal-accountsDealsDealidStepsStepidRecipients"
parameters:
- name: "Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности. Подробнее."
format: "uuid"
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "stepId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/RecipientRequest"
example:
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
amount: 90
tax: 5
purpose: "Назначение платежа"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
keepOnVirtualAccount: false
required: true
responses:
"201":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/RecipientResponse"
example:
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
recipientId: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
amount: 90
tax: 5
purpose: "Назначение платежа"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
keepOnVirtualAccount: false
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/recipients/{recipientId}/update-bank-details:
post:
tags:
- "Депоненты и реципиенты"
summary: "Обновить банковские реквизиты у реципиента на этапе сделки"
description: "\nПозволяет обновить банковские реквизиты у получателя денежны\
х средств — реципиента (recipient) при неуспешности платежа.\nТолько для с\
делок в статусе `PAYMENT_FAILED`.\n\n\nОграничение на использование метода\
\ — 10 запросов в секунду.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "postApiV1Nominal-accountsDealsDealidStepsStepidRecipientsRecipientidUpdate-bank-details"
parameters:
- name: "dealId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
- name: "stepId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
- name: "recipientId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор реципиента."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/UpdateRecipientBankDetailsRequest"
example:
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/payments:
get:
tags:
- "Биллинг"
summary: "Получить список платежей"
description: "\nПозволяет получить список платежей в рамках одной сделки.\n\n\
\nОграничение на использование метода — 10 запросов в секунду.\n\n\nЧтобы\
\ использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsPayments"
parameters:
- name: "beneficiaryId"
in: "query"
description: "ID бенефициара."
required: false
style: "form"
explode: true
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
example: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
- name: "dealId"
in: "query"
description: "ID сделки."
required: false
style: "form"
explode: true
schema:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
example: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
- name: "accountNumber"
in: "query"
description: "Номер номинального счета."
required: false
style: "form"
explode: true
schema:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер номинального счета."
example: 40702810110011000777
- name: "offset"
in: "query"
description: "Количество платежей, которое нужно пропустить. Значение по у\
молчанию — 0
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно пропустить."
format: "int32"
example: 0
- name: "limit"
in: "query"
description: "Количество платежей, которое нужно вывести. Значение по умол\
чанию — 50
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно вывести."
format: "int32"
example: 50
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/PaymentListResponse"
example:
offset: 0
limit: 50
size: 8
total: 8
results:
- type: "REGULAR"
paymentId: "58097aa1-9660-47e7-8550-f2167fa80cea"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetails:
type: "PAYMENT_DETAILS"
bik: "044525974"
kpp: "773401001"
inn: "906858195320"
name: "Киняев Фома Семенович"
bankName: "АО \"ТБанк\""
accountNumber: "11223344556677889900"
corrAccountNumber: "30101810145250000974"
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
recipientId: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
amount: 100
status: "SUCCEEDED"
purpose: "Назначение платежа"
operationId: "171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"
- type: "REGULAR"
paymentId: "58097aa1-9660-47e7-8550-f2167fa80cea"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetails:
type: "PAYMENT_DETAILS"
bik: "044525974"
kpp: "773401001"
inn: "906858195320"
name: "Киняев Фома Семенович"
bankName: "АО \"ТБанк\""
accountNumber: "11223344556677889900"
corrAccountNumber: "30101810145250000974"
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
recipientId: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
amount: 100
status: "FAILED"
errorMessage: "Проверьте номер счета банка получателя — возможно\
, вы указали неправильные цифры"
purpose: "Назначение платежа"
operationId: "171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"
- type: "REGULAR"
paymentId: "58097aa1-9660-47e7-8550-f2167fa80cea"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetails:
type: "CARD"
cardId: "70000000707"
terminalKey: "1573803282696E2C"
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
recipientId: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
amount: 100
status: "SUCCEEDED"
purpose: "Назначение платежа"
operationId: "171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"
- type: "REGULAR"
paymentId: "58097aa1-9660-47e7-8550-f2167fa80cea"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetails:
type: "CARD"
cardId: "70000000707"
terminalKey: "1573803282696E2C"
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
recipientId: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
amount: 100
status: "FAILED"
errorMessage: "Transaction not permitted to card"
purpose: "Назначение платежа"
operationId: "171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"
- type: "REGULAR"
paymentId: "58097aa1-9660-47e7-8550-f2167fa80cea"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetails:
type: "SBP"
phoneNumber: "+79001112233"
bankId: "100000000004"
terminalKey: "1573803282696E2C"
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
recipientId: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
amount: 100
status: "SUCCEEDED"
purpose: "Назначение платежа"
operationId: "171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"
- type: "REGULAR"
paymentId: "58097aa1-9660-47e7-8550-f2167fa80cea"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetails:
type: "SBP"
phoneNumber: "+79001112233"
bankId: "100000000004"
terminalKey: "1573803282696E2C"
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
recipientId: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
amount: 100
status: "FAILED"
errorMessage: "Specified bank is not SBP member"
purpose: "Назначение платежа"
operationId: "171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"
- type: "TAX"
paymentId: "58097aa1-9660-47e7-8550-f2167fa80cea"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetails:
type: "PAYMENT_DETAILS"
bik: "444555666"
kpp: "111222333"
inn: "1234567890"
name: "Какой-то отдел ФНС"
bankName: "Чемпион"
accountNumber: "11122233344455566677"
corrAccountNumber: "12345678901234567890"
amount: 100
status: "SUCCEEDED"
purpose: "Сумма налога на имущество, Иванов Иван Иванович, по ис\
полнительному листу от 01.08.2021 по делу N 2-2733/2021"
uin: "0"
tax:
payerStatus: "19"
kbk: "18210301000011000110"
oktmo: "50701000"
evidence: "0"
period: "0"
docNumber: "01;0201251245"
docDate: "0"
thirdParty:
inn: "123456789012"
kpp: "0"
operationId: "171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"
- type: "TAX"
paymentId: "58097aa1-9660-47e7-8550-f2167fa80cea"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetails:
type: "PAYMENT_DETAILS"
bik: "444555666"
kpp: "111222333"
inn: "1234567890"
name: "Какой-то отдел ФНС"
bankName: "Чемпион"
accountNumber: "11122233344455566677"
corrAccountNumber: "12345678901234567890"
amount: 100
status: "FAILED"
errorMessage: "Проверьте номер счета банка получателя — возможно\
, вы указали неправильные цифры"
purpose: "Сумма налога на имущество, Иванов Иван Иванович, по ис\
полнительному листу от 01.08.2021 по делу N 2-2733/2021"
uin: "0"
tax:
payerStatus: "19"
kbk: "18210301000011000110"
oktmo: "50701000"
evidence: "0"
period: "0"
docNumber: "01;0201251245"
docDate: "0"
thirdParty:
inn: "123456789012"
kpp: "0"
operationId: "171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
post:
tags:
- "Биллинг"
summary: "Выполнить платеж в пользу бенефициара на реальный счет"
description: "\nПозволяет напрямую вывести средства с виртуального счета бен\
ефициара на реальный счет.\nДля налогового платежа можно указать реквизиты\
\ целиком. Только для типа `PAYMENT_DETAILS`.\n\n\nОграничение на использо\
вание метода — 10 запросов в секунду.\n\n\nЧтобы использовать метод, нужен\
\ доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "postApiV1Nominal-accountsPayments"
parameters:
- name: "Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности. Подробнее."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CreatePaymentRequest1"
examples:
Обычный платеж.:
value:
type: "REGULAR"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetailsId: "49e46893-9a7e-409b-8c79-647aecaae555"
amount: 100
purpose: "Назначение платежа"
Налоговый платеж.:
value:
type: "TAX"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetails:
type: "PAYMENT_DETAILS"
bik: "444555666"
kpp: "111222333"
inn: "1234567890"
name: "Какой-то отдел ФНС"
bankName: "Чемпион"
accountNumber: "11122233344455566677"
corrAccountNumber: "12345678901234567890"
amount: 100
purpose: "Сумма налога на имущество, Иванов Иван Иванович, по ис\
полнительному листу от 01.08.2021 по делу N 2-2733/2021"
uin: "0"
tax:
payerStatus: "19"
kbk: "18210301000011000110"
oktmo: "50701000"
evidence: "0"
period: "0"
docNumber: "01;0201251245"
docDate: "0"
thirdParty:
inn: "123456789012"
kpp: "0"
required: true
responses:
"201":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/PaymentResponse"
examples:
Успешный обычный платеж по реквизитам счета.:
value:
type: "REGULAR"
paymentId: "58097aa1-9660-47e7-8550-f2167fa80cea"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetails:
type: "PAYMENT_DETAILS"
bik: "044525974"
kpp: "773401001"
inn: "906858195320"
name: "Киняев Фома Семенович"
bankName: "АО \"ТБанк\""
accountNumber: "11223344556677889900"
corrAccountNumber: "30101810145250000974"
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
recipientId: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
amount: 100
status: "SUCCEEDED"
purpose: "Назначение платежа"
operationId: "171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"
Неуспешный обычный платеж по реквизитам счета.:
value:
type: "REGULAR"
paymentId: "58097aa1-9660-47e7-8550-f2167fa80cea"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetails:
type: "PAYMENT_DETAILS"
bik: "044525974"
kpp: "773401001"
inn: "906858195320"
name: "Киняев Фома Семенович"
bankName: "АО \"ТБанк\""
accountNumber: "11223344556677889900"
corrAccountNumber: "30101810145250000974"
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
recipientId: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
amount: 100
status: "FAILED"
errorMessage: "Проверьте номер счета банка получателя — возмож\
но, вы указали неправильные цифры"
purpose: "Назначение платежа"
operationId: "171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"
Успешный налоговый платеж.:
value:
type: "TAX"
paymentId: "58097aa1-9660-47e7-8550-f2167fa80cea"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetails:
type: "PAYMENT_DETAILS"
bik: "444555666"
kpp: "111222333"
inn: "1234567890"
name: "Какой-то отдел ФНС"
bankName: "Чемпион"
accountNumber: "11122233344455566677"
corrAccountNumber: "12345678901234567890"
amount: 100
status: "SUCCEEDED"
purpose: "Сумма налога на имущество, Иванов Иван Иванович, по\
\ исполнительному листу от 01.08.2021 по делу N 2-2733/2021"
uin: "0"
tax:
payerStatus: "19"
kbk: "18210301000011000110"
oktmo: "50701000"
evidence: "0"
period: "0"
docNumber: "01;0201251245"
docDate: "0"
thirdParty:
inn: "123456789012"
kpp: "0"
operationId: "171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"
Неуспешный налоговый платеж.:
value:
type: "TAX"
paymentId: "58097aa1-9660-47e7-8550-f2167fa80cea"
beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
bankDetails:
type: "PAYMENT_DETAILS"
bik: "444555666"
kpp: "111222333"
inn: "1234567890"
name: "Какой-то отдел ФНС"
bankName: "Чемпион"
accountNumber: "11122233344455566677"
corrAccountNumber: "12345678901234567890"
amount: 100
status: "FAILED"
errorMessage: "Проверьте номер счета банка получателя — возмож\
но, вы указали неправильные цифры"
purpose: "Сумма налога на имущество, Иванов Иван Иванович, по\
\ исполнительному листу от 01.08.2021 по делу N 2-2733/2021"
uin: "0"
tax:
payerStatus: "19"
kbk: "18210301000011000110"
oktmo: "50701000"
evidence: "0"
period: "0"
docNumber: "01;0201251245"
docDate: "0"
thirdParty:
inn: "123456789012"
kpp: "0"
operationId: "171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/payments/{paymentId}/retry:
post:
tags:
- "Биллинг"
summary: "Повторить неуспешный платеж в рамках сделки"
description: "\nПозволяет повторить неуспешный платеж в рамках сделки по ID\
\ платежа.\n\n\nОграничение на использование метода — 10 запросов в секунд\
у.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "postApiV1Nominal-accountsPaymentsPaymentidRetry"
parameters:
- name: "paymentId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор платежа."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/RetryPaymentResponse"
example:
retryPaymentId: "126ffab2-62e9-11ec-bca6-43f40eceb896"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/incoming-transactions:
get:
tags:
- "Биллинг"
summary: "Получить список неидентифицированных пополнений"
description: "\nПозволяет получить список транзакций пополнения номинального\
\ счета, которые еще не прошли идентификацию.\n\n\nОграничение на использо\
вание метода — 10 запросов в секунду.\n\n\nЧтобы использовать метод, нужен\
\ доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsIncoming-transactions"
parameters:
- name: "accountNumber"
in: "query"
description: "Номер номинального счета."
required: false
style: "form"
explode: true
schema:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер номинального счета."
example: 40702810110011000777
- name: "offset"
in: "query"
description: "Количество неидентифицированных пополнений, которое нужно пр\
опустить. Значение по умолчанию — 0
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно пропустить."
format: "int32"
example: 0
- name: "limit"
in: "query"
description: "Количество неидентифицированных пополнений, которое нужно вы\
вести. Значение по умолчанию — 50
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно вывести."
format: "int32"
example: 50
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/IncomingTransactionListResponse"
example:
offset: 0
limit: 50
size: 1
total: 1
results:
- accountNumber: "40702810110011000777"
operationId: "171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"
amount: 7500
currency: "643"
operationAmount: 100
operationCurrency: "840"
payerBik: "044525974"
payerKpp: "773401001"
payerInn: "906858195320"
payerBankName: "АО \"ТБанк\""
payerBankSwiftCode: "TICSRUMMXXX"
payerAccountNumber: "40802810300002711854"
payerCorrAccountNumber: "30101810145250000974"
payerName: "Киняев Фома Семенович"
paymentPurpose: "Назначение платежа"
documentNumber: "287846"
chargeDate: "2022-01-20T14:10:56Z"
authorizationDate: "2022-01-20T14:10:56Z"
transactionDate: "2022-01-20T14:10:56Z"
drawDate: "2022-01-20T14:10:56Z"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/incoming-transactions/{operationId}/identify:
post:
tags:
- "Биллинг"
summary: "Идентифицировать пополнение"
description: "\nПозволяет идентифицировать одну из операций пополнения.\n\n\n\
Ограничение на использование метода — 10 запросов в секунду.\n\n\nЧтобы ис\
пользовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "postApiV1Nominal-accountsIncoming-transactionsOperationidIdentify"
parameters:
- name: "operationId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "ID операции пополнения."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/IdentifyIncomingTransactionRequest"
example:
amountDistribution:
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
amount: 100
- beneficiaryId: "75c0d3c4-1a5b-11ec-8669-0326f772aecb"
amount: 50
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/virtual-accounts/balances:
get:
tags:
- "Биллинг"
summary: "Получить информацию по остаткам на виртуальных счетах бенефициаров"
description: "\nПозволяет получить список балансов бенефициаров по одному ил\
и нескольким виртуальным счетам\nв рамках номинального счета.\n\n\nОгранич\
ение на использование метода — 10 запросов в секунду.\n\n\nЧтобы использов\
ать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsVirtual-accountsBalances"
parameters:
- name: "accountNumber"
in: "query"
description: "Номер номинального счета."
required: false
style: "form"
explode: true
schema:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер номинального счета."
example: 40702810110011000777
- name: "beneficiaryId"
in: "query"
description: "ID бенефициара."
required: false
style: "form"
explode: true
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
example: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
- name: "offset"
in: "query"
description: "Количество балансов, которое нужно пропустить. Значение по у\
молчанию — 0
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно пропустить."
format: "int32"
example: 0
- name: "limit"
in: "query"
description: "Количество балансов, которое нужно вывести. Значение по умол\
чанию — 50
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно вывести."
format: "int32"
example: 50
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BalanceListResponse"
example:
offset: 0
limit: 50
size: 1
total: 1
results:
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
amount: 7500
amountOnHold: 1000
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/nominal-accounts/virtual-accounts/holds:
get:
tags:
- "Биллинг"
summary: "Получить информацию по холдам на виртуальных счетах бенефициаров"
description: "\nПозволяет получить список холдов на виртуальных счетах бенеф\
ициаров в рамках номинального счета.\n\n\nОграничение на использование мет\
ода — 10 запросов в секунду.\n\n\nЧтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
\
\ — Управление номинальными счетами
."
operationId: "getApiV1Nominal-accountsVirtual-accountsHolds"
parameters:
- name: "accountNumber"
in: "query"
description: "Номер номинального счета."
required: false
style: "form"
explode: true
schema:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер номинального счета."
example: 40702810110011000777
- name: "beneficiaryId"
in: "query"
description: "ID бенефициара."
required: false
style: "form"
explode: true
schema:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
example: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
- name: "offset"
in: "query"
description: "Количество холдов, которое нужно пропустить. Значение по умо\
лчанию — 0
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно пропустить."
format: "int32"
example: 0
- name: "limit"
in: "query"
description: "Количество холдов, которое нужно вывести. Значение по умолча\
нию — 50
."
required: false
style: "form"
explode: true
schema:
type: "integer"
description: "Количество элементов в списке, которое нужно вывести."
format: "int32"
example: 50
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/HoldListResponse"
example:
offset: 0
limit: 50
size: 1
total: 1
results:
- beneficiaryId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
accountNumber: "40702810110011000777"
holdId: "7540c2ca-2373-472a-a099-7756475484a9"
dealId: "dd6c3237-9958-47d9-9ba0-f6faeaa0e788"
stepId: "c87d3297-f4ae-4f88-add9-6722c1fc0b8c"
recipientId: "00021d4e-536f-11ec-ac0b-370ccfeacec2"
paymentId: "58097aa1-9660-47e7-8550-f2167fa80cea"
amount: 100
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/tacq/operations/terminal/{terminalKey}:
get:
tags:
- "Торговый эквайринг"
summary: "Получить операции по терминалу за период"
description: "Метод возвращает список операций и информацию по ним за указан\
ный период. Значение суммы операции возвращается в копейках.\n\n\nЧтобы ис\
пользовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/tacq/operations/get
\
\ — Получение операций по терминалам торгового эквайринга
.\n\n\
\nЗапросы с количеством операций более 1000 или периодом более одного дня\
\ не поддерживаются — вернется ошибка. Задержка получения операций может с\
оставлять до двух часов.\n\n\nОграничение на использование метода — 1 запр\
ос в секунду.\n "
operationId: "getApiV1TacqOperationsTerminalTerminalkey"
parameters:
- name: "terminalKey"
in: "path"
description: "Серийный номер терминала."
required: true
style: "simple"
explode: false
schema:
type: "string"
example: "7L594999"
- name: "from"
in: "query"
description: "Дата начала периода в формате UTC."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "date-time"
example: "2015-12-12T13:10:10Z"
- name: "till"
in: "query"
description: "Дата окончания периода в формате UTC."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "date-time"
example: "2015-12-13T12:10:10Z"
- name: "limit"
in: "query"
description: "Максимальное количество операций."
required: true
style: "form"
explode: true
schema:
maximum: 1000
type: "integer"
format: "int64"
example: 1000
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TacqOperationResponse"
example:
lastTransactionDate: "2020-10-20T13:10:09Z"
operations:
- rrn: "999999999999"
transactionDate: "2020-10-20T13:10:09Z"
amount: 1000
cardNumber: "999999xxxxxx9999"
type: "Debit"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/tacq/terminals:
get:
tags:
- "Торговый эквайринг"
summary: "Получить терминалы по компании"
description: "Метод возвращает информацию по активным терминалам компании —\
\ полностью подготовленным и готовым проводить платежи. Пользователь долже\
н дать согласие на получение списка терминалов компании.\n\n\nЧтобы исполь\
зовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/tacq/terminals/get
\
\ — Получение информации о терминалах компании торгового эквайринга\
.\n\n\nОграничение на использование метода — 1 запрос в секунду."
operationId: "getApiV1TacqTerminals"
parameters:
- name: "page"
in: "query"
description: "Номер возвращаемой страницы с данными по терминалам. Нумерац\
ия с нуля."
required: true
style: "form"
explode: true
schema:
type: "integer"
format: "int64"
example: 1
- name: "size"
in: "query"
description: "Размер страницы (количество терминалов) с данными."
required: true
style: "form"
explode: true
schema:
type: "integer"
format: "int64"
example: 10
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TacqTerminalsResponse"
example:
totalPages: 3
totalElements: 15
first: false
last: true
terminals:
- key: "6K417293"
id: "10056003"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/card/{ucid}/limits:
get:
tags:
- "Бизнес-карты"
summary: "Получить установленные лимиты по карте и доступный карточный остат\
ок"
description: "Метод возвращает информацию о расходном лимите и лимите на сня\
тие наличных.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/card/limit/get
\
\ — Получение информации о лимитах и остатках по картам компании
.\n\
\n\nОграничение на использование метода — 40 запросов в секунду."
operationId: "getApiV1CardUcidLimits"
parameters:
- name: "ucid"
in: "path"
description: "Уникальный идентификатор карты."
required: true
style: "simple"
explode: false
schema:
type: "integer"
format: "int64"
example: 1074372738
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CardLimitsResponse"
example:
ucid: 1074372738
spendLimit:
limitValue: 9001
limitRemain: 7000
limitPeriod: "IRREGULAR"
cashLimit:
limitValue: 5000
limitRemain: 3000
limitPeriod: "DAY"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/card/{ucid}/spend-limit:
post:
tags:
- "Бизнес-карты"
summary: "Установить расходный лимит по карте"
description: "Метод для установки лимита и периода обновления доступного ост\
атка.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/card/limit/set
\
\ — Изменение лимитов по картам компании
.\n\n\nОграничение на\
\ использование метода — 10 запросов в секунду."
operationId: "postApiV1CardUcidSpend-limit"
parameters:
- name: "ucid"
in: "path"
description: "Уникальный идентификатор карты."
required: true
style: "simple"
explode: false
schema:
type: "integer"
format: "int64"
example: 1074372738
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/SetLimitRequest"
example:
limitValue: 9001
limitPeriod: "IRREGULAR"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/card/{ucid}/cash-limit:
post:
tags:
- "Бизнес-карты"
summary: "Установить лимит на снятие наличных по карте"
description: "Метод для установки лимита и периода обновления доступного ост\
атка.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/card/limit/set
\
\ — Изменение лимитов по картам компании
.\n\n\nОграничение на\
\ использование метода — 10 запросов в секунду."
operationId: "postApiV1CardUcidCash-limit"
parameters:
- name: "ucid"
in: "path"
description: "Уникальный идентификатор карты."
required: true
style: "simple"
explode: false
schema:
type: "integer"
format: "int64"
example: 1074372738
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/SetLimitRequest"
example:
limitValue: 5000
limitPeriod: "DAY"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/card/{ucid}/block:
post:
tags:
- "Бизнес-карты"
summary: "Заблокировать бизнес-карту"
description: "Метод позволяет заблокировать любую бизнес-карту компании, нез\
ависимо от ее владельца.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/card/block
\
\ — Блокировка любой карты компании, независимо от ее владельца
.\n\
\n\nОграничение на использование метода — 5 запросов в секунду."
operationId: "postApiV1CardUcidBlock"
parameters:
- name: "ucid"
in: "path"
description: "Уникальный идентификатор карты."
required: true
style: "simple"
explode: false
schema:
type: "integer"
format: "int64"
example: 1074372738
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/BlockCardRequest"
example:
reason: "CLIENTINITIATED"
comment: "Сотрудник покинул компанию"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/card/{ucid}:
get:
tags:
- "Бизнес-карты"
summary: "Получить данные по одной карте компании"
description: "Метод для получения данный по карте компании — имя держателя,\
\ уникальный идентификатор карты, статус карты, BIN карты, номер расчетног\
о счета, к которому привязана карта.\n\n\nПользователь должен дать согласи\
е на получение информации о картах компании.\n\n\nЧтобы использовать метод\
, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/card/get
— П\
олучение информации о картах компании
.\n\n\nОграничение на использо\
вание метода — 10 запросов в секунду."
operationId: "getApiV1CardUcid"
parameters:
- name: "ucid"
in: "path"
description: "Уникальный идентификатор карты."
required: true
style: "simple"
explode: false
schema:
type: "integer"
format: "int64"
example: 1074372738
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CardInfoResponse"
example:
ucid: 1074372738
accountNumber: "40702810110011000777"
cardBin: "553420"
cardLastFourDigits: "2781"
isActive: true
status: "NORM"
embossedName: "IVAN IVANOV"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/card:
get:
tags:
- "Бизнес-карты"
summary: "Получить данные по картам компании"
description: "Метод для получения данных по картам компании. Пользователь до\
лжен дать согласие на получение информации о картах компании.\n\n\nЧтобы и\
спользовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/card/get
\
\ — Получение информации о картах компании
."
operationId: "getApiV1Card"
parameters:
- name: "accountNumber"
in: "query"
description: "Номер расчетного счета, к которому привязана карта."
required: false
style: "form"
explode: true
schema:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета. ВАЖНО: Для бюджетных платежей с 01.01.2021\
\ в данном поле нужно указывать новые номера казначейских счетов."
example: 40702810110011000777
- name: "offset"
in: "query"
description: "Количество карт, которые нужно пропустить. Значение по умолч\
анию — `0`."
required: false
style: "form"
explode: true
schema:
type: "integer"
format: "int32"
example: 0
- name: "limit"
in: "query"
description: "Количество карт, которые нужно вывести. Значение по умолчани\
ю — `1000`."
required: false
style: "form"
explode: true
schema:
type: "integer"
format: "int32"
example: 1000
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CardInfoSeqResponse"
example:
cards:
- ucid: 1074372738
accountNumber: "40702810110011000777"
cardBin: "553420"
cardLastFourDigits: "2781"
isActive: true
status: "NORM"
embossedName: "IVAN IVANOV"
offset: 0
limit: 1
totalNumber: 2
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/card/virtual/{ucid}/requisites:
get:
tags:
- "Бизнес-карты"
summary: "Получить полные немаскированные реквизиты виртуальной карты"
description: "Метод для получения полных немаскированных реквизитов виртуаль\
ной карты — номер, имя держателя, CVC, срок действия карты.\n\n\nПользоват\
ель должен дать согласие на получение полных немаскированных реквизитов ви\
ртуальных карт компании.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/card/virtual/requisites
\
\ — Получение полных немаскированных реквизитов виртуальных карт ком\
пании
.\n\n\nОграничение на использование метода — 10 запросов в сек\
унду."
operationId: "getApiV1CardVirtualUcidRequisites"
parameters:
- name: "ucid"
in: "path"
description: "Уникальный идентификатор карты."
required: true
style: "simple"
explode: false
schema:
type: "integer"
format: "int64"
example: 1074372738
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/VirtualCardRequisitesResponse"
example:
number: "1111222233334444"
embossedName: "IVAN IVANOV"
cvc: "123"
expiryDate:
year: 2022
month: 5
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/card/virtual/reissue:
post:
tags:
- "Бизнес-карты"
summary: "Отправить заявку на перевыпуск виртуальной карты"
description: "Метод для отправки заявки на перевыпуск виртуальной карты. Пол\
ьзователь должен дать согласие на перевыпуск виртуальных карт компании.\n\n\
\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/card/virtual/reissue
\
\ — Перевыпуск виртуальных карт компании
.\n\n\nОграничение на\
\ использование метода — 10 запросов в секунду."
operationId: "postApiV1CardVirtualReissue"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/ReissueVirtualCardRequest"
example:
ucid: 1074372738
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/ReissueVirtualCardResponse"
example:
correlationId: "24166fc5-ae8a-412a-8eb0-2e86d3c8dc73"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/card/virtual/reissue/result:
get:
tags:
- "Бизнес-карты"
summary: "Получить статус заявки на перевыпуск виртуальной карты"
description: "Метод возвращает статус заявки на перевыпуск виртуальной карты\
. Пользователь должен дать согласие на перевыпуск виртуальных карт компани\
и.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/card/virtual/reissue
\
\ — Перевыпуск виртуальных карт компании
.\n "
operationId: "getApiV1CardVirtualReissueResult"
parameters:
- name: "correlationId"
in: "query"
description: "Идентификатор заявки на перевыпуск виртуальной карты."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "uuid"
example: "24166fc5-ae8a-412a-8eb0-2e86d3c8dc73"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/ReissueVirtualCardResultResponse"
examples:
Заявка находится в работе:
value:
status: "IN_PROGRESS"
Заявка была исполнена, карта перевыпущена:
value:
status: "READY"
info:
oldUcid: 1074372738
newUcid: 1095637483
cardBin: "553420"
cardLastFourDigits: "2781"
Произошла ошибка при обработке заявки:
value:
status: "ERROR"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/card/virtual/issue/application:
post:
tags:
- "Бизнес-карты"
summary: "Создать заявку на выпуск виртуальной бизнес-карты с удаленной иден\
тификацией сотрудника"
description: "Метод создает заявку на выпуск виртуальной бизнес-карты на сот\
рудника и в случае успеха отдает ее ID,\nс помощью которого можно проверят\
ь статус заявки. Чтобы использовать метод,\nподготовьте данные для удаленн\
ой идентификации сотрудника через вызов соответствующих методов.\n\n\nПоль\
зователь должен дать согласие на выпуск виртуальных бизнес-карт на сотрудн\
иков компании.\n\n\nВ поле `scope` у токена должен присутствовать доступ в\
ида `opensme/inn/[{inn}]/kpp/[{kpp}]/card/virtual/issue/for-employee`, где\
\ {inn} — ИНН клиента, а {kpp} — КПП клиента.\n\n\nОграничение на использо\
вание метода — 10 запросов в секунду."
operationId: "postApiV1CardVirtualIssueApplication"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CreateApplicationRequest"
example:
employeeIdentificationApplicationId: "1713e109-31e4-4eed-b804-2c0cb8ef6ef3"
accountNumber: "40702810110011000777"
cardNetwork: "MASTERCARD"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CreateApplicationResponse"
example:
cardIssueApplicationId: "4e954a4f-19dc-4bd5-9a84-aef64e9d71ce"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/card/virtual/issue/application/{cardIssueApplicationId}:
get:
tags:
- "Бизнес-карты"
summary: "Получить статус заявки на выпуск виртуальной бизнес-карты с удален\
ной идентификацией сотрудника"
description: "Метод возвращает статус заявки на выпуск виртуальной бизнес-ка\
рты на сотрудника.\n\n\nЕсли карта уже выпущена, кроме статуса в ответе во\
звращается UCID выпущенной карты.\nЕсли выпуск карты неуспешен, кроме стат\
уса в ответе возвращается причина неудачного выпуска.\n\n\nПользователь до\
лжен дать согласие на выпуск виртуальных бизнес-карт на сотрудников компан\
ии.\n\n\nВ поле `scope` у токена должен быть доступ вида `opensme/inn/[{inn}]/kpp/[{kpp}]/card/virtual/issue/for-employee`,\n\
где {inn} — ИНН клиента, а {kpp} — КПП клиента.\n\n\nОграничение на исполь\
зование метода — 10 запросов в секунду.\""
operationId: "getApiV1CardVirtualIssueApplicationCardissueapplicationid"
parameters:
- name: "cardIssueApplicationId"
in: "path"
description: "Идентификатор заявки на выпуск бизнес-карты."
required: true
style: "simple"
explode: false
schema:
type: "string"
format: "uuid"
example: "6bcbca1f-b01d-4796-88bb-d4e868c07a68"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CardIssueApplicationStatusResponse"
example:
cardIssueApplicationId: "6bcbca1f-b01d-4796-88bb-d4e868c07a68"
status: "IDENTIFICATION"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/employee-remote-identification/application:
post:
tags:
- "Удаленная идентификация сотрудников"
summary: "Создать черновик заявки на удаленную идентификацию сотрудника"
description: "Метод создает черновик заявки на удаленную идентификацию сотру\
дника.\n\n\nЧерновик действителен 30 минут — за это время вы прикрепляете\
\ к нему документы и отправляете в работу.\n\n\nПользователь должен дать с\
огласие на удаленную идентификацию сотрудников.\nВ поле scope у токена дол\
жен быть доступ вида `opensme/inn/[{inn}]/kpp/[{kpp}]/employee-remote-identification`,\
\ где {inn} — ИНН клиента, а {kpp} — КПП клиента.\n\n\nОграничение на испо\
льзование метода — 10 запросов в секунду."
operationId: "postApiV1Employee-remote-identificationApplication"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CreateDraftRequest"
example:
lastName: "Петров"
firstName: "Иван"
secondName: "Сергеевич"
birthDate: "1980-04-15"
placeOfBirth: "г. Москва РСФСР СССР"
phoneNumber: "+79991234567"
passport:
series: "1234"
number: "567890"
issuerName: "ОВД Чистые Пруды"
issuerCode: "000-123"
issueDate: "2000-04-25"
registrationAddress:
zipCode: "312098"
country: "РОССИЯ"
region: "г МОСКВА"
city: "Москва"
settlement: "ЦАО"
street: "Большая Садовая ул"
house: "12"
apartment: "50"
actualAddress:
zipCode: "125212"
country: "РОССИЯ"
region: "г МОСКВА"
city: "Москва"
settlement: "СЗАО"
street: "Головинское шоссе"
house: "5"
building: "1"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CreateDraftResponse"
example:
applicationId: "1713e109-31e4-4eed-b804-2c0cb8ef6ef3"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/employee-remote-identification/application/{applicationId}/{documentType}:
post:
tags:
- "Удаленная идентификация сотрудников"
summary: "Добавить скан или фото документа к заявке на удаленную идентификац\
ию сотрудника"
description: "Метод прикрепляет скан или фото документа к заявке на удаленну\
ю идентификацию сотрудника. Последовательными вызовами этого метода\nприкр\
епляются изображения всех нужных страниц паспорта через `documentType=PASSPORT`,\n\
а также фото с паспортом в руках через `documentType=SELFIE_WITH_PASSPORT`,\
\ чтобы заявку можно было запустить в работу.\n\n\nЕсли подается заявка на\
\ ранее идентифицированного сотрудника, повторно прикреплять фото документ\
ов к заявке не нужно.\n\n\nПользователь должен дать согласие на удаленную\
\ идентификацию сотрудников.\nВ поле `scope` у токена должен быть доступ в\
ида `opensme/inn/[{inn}]/kpp/[{kpp}]/employee-remote-identification`, где\
\ {inn} — ИНН клиента, а {kpp} — КПП клиента.\n\n\nОграничение на использо\
вание метода — 1 запрос в секунду."
operationId: "postApiV1Employee-remote-identificationApplicationApplicationidDocumenttype"
parameters:
- name: "applicationId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "ID заявки на удаленную идентификацию сотрудника."
format: "uuid"
- name: "documentType"
in: "path"
description: "Тип фото для загрузки."
required: true
style: "simple"
explode: false
schema:
$ref: "#/components/schemas/DocumentType2"
example: "SELFIE_WITH_PASSPORT"
- name: "Content-Length"
in: "header"
description: "Размер загружаемого скана или фото документа в байтах."
required: true
style: "simple"
explode: false
schema:
maximum: 5242880
minimum: 1
type: "integer"
format: "int64"
requestBody:
description: "Скан или фото документа в формате `JPEG`, `PNG` или `PDF`."
content:
application/octet-stream:
schema:
type: "string"
format: "binary"
required: true
responses:
"200":
description: "Скан или фото документа добавлено к заявке."
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/delivery/tasks:
post:
tags:
- "Партнерская доставка"
summary: "Создать задание на доставку"
description: "\nМетод создает задание и возвращает его ID в ответе для дальн\
ейшего взаимодействия.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/delivery/tasks/create
\
\ — Создание задания на доставку
.\n\n\nОграничение на использ\
ование метода — 10 запросов в секунду"
operationId: "DeliveryCreateTask"
parameters:
- name: "Idempotency-Key"
in: "header"
required: false
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности. Подробнее."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CreateTaskRequest"
example:
template: "PartnerDelivery"
commentForAgent: "Проверить паспорт"
parentTaskId: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
meta:
dealNumber: "456793"
contacts:
- id: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
role: "Риэлтор"
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
birthDate: "1990-05-05"
phones:
- type: "MOBILE"
number: "+79546523687"
documents:
- type: "PASSPORT"
number: "123467"
series: "3456"
divisionName: "УВД Раменского района"
issueDate: "1990-05-05"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CreateTaskResponse"
example:
id: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/delivery/tasks/{id}/cancel:
post:
tags:
- "Партнерская доставка"
summary: "Отменить задание на доставку"
description: "Метод для отмены задания. После отмены дальнейшая работа по за\
данию не производится.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/delivery/tasks/create
\
\ — Создание задания на доставку
."
operationId: "DeliveryCancelTask"
parameters:
- name: "id"
in: "path"
description: "Идентификатор задания."
required: true
style: "simple"
explode: false
schema:
type: "string"
example: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CancelTaskRequest"
example:
reason: "Отказ клиента"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/delivery/tasks/{id}:
get:
tags:
- "Партнерская доставка"
summary: "Получить информацию по заданию на доставку"
description: "\nМетод возвращает информацию о текущем состоянии задания.\nЧт\
обы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/delivery/tasks/create
\
\ — Создание задания на доставку
.\n"
operationId: "DeliveryGetTask"
parameters:
- name: "id"
in: "path"
description: "Идентификатор задания."
required: true
style: "simple"
explode: false
schema:
type: "string"
example: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/DeliveryTask"
example:
id: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
status: "NEW"
template: "partner_delivery"
meetResult: "Успешная встреча"
resolution: "Документы подписаны"
subResolution: "Подписан договор аренды"
parentTaskId: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
meta:
dealNumber: "456793"
attachments:
- id: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
type: "Договор аренды"
meta:
cadastreNumber: "77:997987687"
noticeNumber: "123-456789"
photos:
- id: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
type: "Паспорт"
subType: "Страница регистрации"
sheetNumber: 1
review:
status: "DISCARDED"
decisionSource: "service"
decisionReason:
- "stranger"
- "from-screen"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
put:
tags:
- "Партнерская доставка"
summary: "Обновить задание на доставку"
description: "\nМетод позволяет обновить уже созданное задание по его ID. Ес\
ли вызов успешный, в ответе возвращается ошибка или пустой объект.\n\n\nЧт\
обы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/delivery/tasks/update
\
\ — Обновление задания на доставку
.\n"
operationId: "DeliveryUpdateTask"
parameters:
- name: "id"
in: "path"
description: "Идентификатор задания."
required: true
style: "simple"
explode: false
schema:
type: "string"
example: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/UpdateTaskRequest"
example:
template: "PartnerDelivery"
commentForAgent: "Проверить паспорт"
parentTaskId: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
meta:
dealNumber: "456793"
contacts:
- id: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
role: "Риэлтор"
firstName: "Иван"
lastName: "Иванов"
middleName: "Иванович"
birthDate: "1990-05-05"
phones:
- type: "MOBILE"
number: "+79546523687"
documents:
- type: "PASSPORT"
number: "123467"
series: "3456"
divisionName: "УВД Раменского района"
issueDate: "1990-05-05"
photos:
- id: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
review:
status: "ACCEPTED"
- id: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
review:
status: "DISCARDED"
decisionReason:
- "все очень плохо"
- "могло бы быть и лучше"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/delivery/meetings/intervals:
post:
tags:
- "Партнерская доставка"
summary: "Получить доступные временные интервалы для назначения встречи"
description: "Метод позволяет получить доступные временные интервалы для наз\
начения встреч. Временной интервал — промежуток времени, в который может б\
ыть проведена встреча.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/delivery/tasks/create
\
\ — Создание задания на доставку
."
operationId: "DeliveryGetIntervals"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/GetIntervalsRequest"
example:
taskIds:
- "39df83a3-edc7-4c83-ba53-9eaae38c225f"
address:
fullAddress: "г. Москва, 3-я улица Строителей, д.25, кв.12"
zipCode: "1234"
country: "Россия"
region: "Москва"
area: "Москва"
city: "Москва"
street: "3-я улица Строителей"
house: "12"
building: "3"
flat: "12"
construction: "2"
settlement: ""
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/GetIntervalsResponse"
example:
appointmentId: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
timeOffset: "+03:00"
intervals:
- startInterval: "2021-10-19T10:00"
endInterval: "2021-10-19T12:00"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/delivery/meetings:
post:
tags:
- "Партнерская доставка"
summary: "Назначить встречу"
description: "Метод позволяет подтвердить временной интервал из списка, полу\
ченного через метод получения интервалов, и назначить на него встречу для\
\ заданий.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/delivery/tasks/create
\
\ — Создание задания на доставку
."
operationId: "DeliveryCreateMeeting"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CreateMeetingRequest"
example:
appointmentId: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
intervalStartTime: "2020-11-23T10:00"
intervalEndTime: "2020-11-23T10:00"
commentForAgent: "Test comment"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CreateMeetingResponse"
example:
meetingId: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/delivery/documents:
post:
tags:
- "Партнерская доставка"
summary: "Загрузить документ к заданию"
description: "Метод позволяет загрузить документ и его метаданные и привязат\
ь документ к заданию.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/delivery/documents/create
\
\ — Загрузка документа в задание на доставку
.\n\n\nОграничени\
е на использование метода — 10 запросов в секунду."
operationId: "postApiV1DeliveryDocuments"
requestBody:
content:
multipart/form-data:
schema:
required:
- "content"
- "taskId"
- "type"
type: "object"
properties:
taskId:
type: "string"
description: "ID задания, с которым нужно связать документ."
type:
type: "string"
description: "Тип документа."
content:
type: "string"
description: "Состав документа, который нужно загрузить и связат\
ь с заданием."
format: "binary"
prevDocId:
type: "string"
description: "ID предыдущего документа. Нужен, чтобы обновить уж\
е загруженный документ."
description:
type: "string"
description: "Описание документа. Содержит дополнительную информ\
ацию, которая нужна для взаимодействия с ним."
meta:
type: "object"
additionalProperties:
type: "string"
description: "Дополнительные метаданные в формате JSON."
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/UploadTaskFileResponse"
example:
id: "39df83a3-edc7-4c83-ba53-9eaae38c225f"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/delivery/documents/{id}:
get:
tags:
- "Партнерская доставка"
summary: "Выгрузить документ по ID"
description: "Метод позволяет выгрузить документ по его ID.\n\n\nЧтобы испол\
ьзовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/delivery/documents/create
\
\ — Загрузка документа в задание на доставку
."
operationId: "getApiV1DeliveryDocumentsId"
parameters:
- name: "id"
in: "path"
description: "Идентификатор документа."
required: true
style: "simple"
explode: false
schema:
type: "string"
example: "f123"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/octet-stream:
schema:
type: "string"
format: "binary"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/safe-deal/beneficiaries:
post:
tags:
- "Безопасная сделка"
summary: "Проверить бенефициаров"
description: "Метод для проверки бенефициаров на действительность персональн\
ых.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/safe-deal/beneficiaries/post
\
\ — Запуск проверки бенефициаров на действительность персональных да\
нных и получение результатов этой проверки
.\n\n\nОграничение исполь\
зования метода — 4 запроса в секунду."
operationId: "postApiV1Safe-dealBeneficiaries"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CheckBeneficiariesRequest"
examples:
Сценарий 1. Серия и номер "1111111111" — передача ПД с некорректными ИИН и паспортом:
value:
firstName: "Иван"
middleName: "Иванович"
lastName: "Иванов"
phone: "+79996661313"
email: "ololo@kek.com"
passport:
birthDate: "2021-05-24"
birthPlace: "Г. МОСКВА"
citizenship: "РФ"
serialNumber: "1111111111"
unitName: "УМВД РОССИИ ПО Г. МОСКВЕ"
issueDate: "2021-05-24"
unitCode: "123-456"
address: "г. Урюпинск, ул. Ленина, 2"
Сценарий 2. Серия и номер "2222222222" — передача ПД с корректным ИИН и некорректным паспортом:
value:
firstName: "Иван"
middleName: "Иванович"
lastName: "Иванов"
phone: "+79996661313"
email: "ololo@kek.com"
passport:
birthDate: "2021-05-24"
birthPlace: "Г. МОСКВА"
citizenship: "РФ"
serialNumber: "2222222222"
unitName: "УМВД РОССИИ ПО Г. МОСКВЕ"
issueDate: "2021-05-24"
unitCode: "123-456"
address: "г. Урюпинск, ул. Ленина, 2"
Сценарий 3. Серия и номер "3333333333" — передача ПД с некорректным ИИН и корректным паспортом:
value:
firstName: "Иван"
middleName: "Иванович"
lastName: "Иванов"
phone: "+79996661313"
email: "ololo@kek.com"
passport:
birthDate: "2021-05-24"
birthPlace: "Г. МОСКВА"
citizenship: "РФ"
serialNumber: "3333333333"
unitName: "УМВД РОССИИ ПО Г. МОСКВЕ"
issueDate: "2021-05-24"
unitCode: "123-456"
address: "г. Урюпинск, ул. Ленина, 2"
Сценарий 4. Другие серия и номер — передача ПД с корректными ИИН и паспортом:
value:
firstName: "Иван"
middleName: "Иванович"
lastName: "Иванов"
phone: "+79996661313"
email: "ololo@kek.com"
passport:
birthDate: "2021-05-24"
birthPlace: "Г. МОСКВА"
citizenship: "РФ"
serialNumber: "1234567890"
unitName: "УМВД РОССИИ ПО Г. МОСКВЕ"
issueDate: "2021-05-24"
unitCode: "123-456"
address: "г. Урюпинск, ул. Ленина, 2"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CheckBeneficiariesResponse"
example:
correlationId: "cf99df08-0829-4614-8da3-0e440fd23fe0"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/safe-deal/beneficiaries/result:
get:
tags:
- "Безопасная сделка"
summary: "Получить статус проверки бенефициара"
description: "Метод для получения статуса проверки бенефициара на действител\
ьность персональных данных.\n\n\nЧтобы использовать метод, нужен доступ —\
\ opensme/inn/[{inn}]/kpp/[{kpp}]/safe-deal/beneficiaries/post
\
\ — Запуск проверки бенефициаров на действительность персональных да\
нных и получение результатов этой проверки
."
operationId: "getApiV1Safe-dealBeneficiariesResult"
parameters:
- name: "correlationId"
in: "query"
description: "Идентификатор, связывающий запрос создания с запросом получе\
ния ответа."
required: true
style: "form"
explode: true
schema:
type: "string"
format: "uuid"
example: "cf99df08-0829-4614-8da3-0e440fd23fe0"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/GetBeneficiariesResultResponse"
examples:
Проверка в процессе:
value:
status: "IN_PROGRESS"
Проверка завершена. ИНН и паспорт некорректные:
value:
status: "READY"
result:
isInnCorrect: false
isPassportCorrect: false
Проверка завершена. ИНН корректный, паспорт некорректный:
value:
status: "READY"
result:
isInnCorrect: true
isPassportCorrect: false
Проверка завершена. ИНН некорректный, паспорт корректный:
value:
status: "READY"
result:
isInnCorrect: false
isPassportCorrect: true
Проверка завершена. ИНН и паспорт корректные:
value:
status: "READY"
result:
isInnCorrect: true
isPassportCorrect: true
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://business.tbank.ru/openapi"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox"
description: "Sandbox"
/api/v1/self-employed/taxpayers/{inn}/bind:
post:
tags:
- "Самозанятые"
summary: "Отправить запрос на подключение самозанятого к Т-Банку"
description: "\nМетод для отправки запроса самозанятому на подключение к Т-Б\
анку.\n\n\n⚠️ Вызовы метода платные. Чтобы ознакомиться с тарифами, напиши\
те на smz_fns_team@tbank.ru.\n\
\n\nСамозанятый получит уведомление в сервисе «Мой налог».\nЕсли он его пр\
имет, Т-Банк сможет проверять его статус, формировать чеки и выполнять дру\
гие операции от его имени в налоговой.\n\n\nУспешный ответ на вызов метода\
\ не гарантирует, что подключение самозанятого завершится успешно.\nВызов\
\ метода инициирует процесс подключения, который может завершиться с ошибк\
ой — например, из-за недоступности сервисов ФНС. \nВ таком случае метод Получи\
ть статус самозанятого возвращает `INTERNAL_ERROR`\nв поле reason\
\ объекта application, и попытку подключения самозанятого нужно пов\
торить.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/taxpayers/bind
\
\ — Привязка самозанятых к Т-Банку
.\n\n\nОграничение на испол\
ьзование метода — 1 запрос в секунду."
operationId: "postApiV1Self-employedTaxpayersInnBind"
parameters:
- name: "inn"
in: "path"
required: true
style: "simple"
explode: false
schema:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН"
- name: "Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности. Подробнее."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/BindTaxpayerRequest"
example:
firstName: "Фома"
lastName: "Киняев"
middleName: "Семенович"
phoneNumber: "+79998887766"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/self-employed/taxpayers/{inn}/receipts:
post:
tags:
- "Самозанятые"
summary: "Зарегистрировать доход самозанятого"
description: "\nМетод для регистрации дохода самозанятого в налоговой, если\
\ он подключен к Т-Банку.\n\n\n⚠️ Вызовы метода платные. Чтобы ознакомитьс\
я с тарифами, напишите на smz_fns_team@tbank.ru.\n\
\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/taxpayers/create-receipt
\
\ — Зарегистрировать доход самозанятого
.\n\n\nОграничение на\
\ использование метода — 1 запрос в секунду."
operationId: "postApiV1Self-employedTaxpayersInnReceipts"
parameters:
- name: "inn"
in: "path"
required: true
style: "simple"
explode: false
schema:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН"
- name: "Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности. Подробнее."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CreateReceiptRequest"
examples:
Доход от физического лица.:
value:
incomeType: "FROM_INDIVIDUAL"
services:
- name: "Оплата самозанятому по договору"
price: 1500.42
Доход от компании.:
value:
incomeType: "FROM_LEGAL_ENTITY"
incomeReceivedAt: "2022-09-01T11:09:22.858Z"
services:
- name: "Оплата самозанятому по договору"
price: 1500.42
customerInn: "7710140679"
customerOrganization: "ООО Рога и копыта"
Доход от иностранной компании.:
value:
incomeType: "FROM_FOREIGN_AGENCY"
services:
- name: "Оплата самозанятому по договору"
price: 1500.42
customerOrganization: "Иностранная компания"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/ReceiptResponse"
example:
receiptId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
incomeType: "FROM_INDIVIDUAL"
incomeReceivedAt: "2022-05-12T14:03:40Z"
incomeStatedAt: "2022-05-12T14:03:40Z"
status: "REGISTERED"
totalAmount: 1500.42
services:
- name: "Оплата самозанятому по договору"
price: 1500.42
operations:
- status: "IN_PROGRESS"
type: "REGISTRATION"
createdAt: "2022-05-12T14:03:40Z"
- status: "SUCCESS"
type: "REGISTRATION"
createdAt: "2022-05-12T14:23:40Z"
fnsLink: "https://lknpd.nalog.ru/api/v1/receipt/504511355012/2017i8xslu/print"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/self-employed/taxpayers/{inn}/status:
get:
tags:
- "Самозанятые"
summary: "Получить статус самозанятого"
description: "\nМетод возвращает информацию о статусе самозанятого, дате пос\
тановки на учет, выданных Т-Банком правах, регионе и виде деятельности.\n\n\
\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/taxpayers/status
\
\ — Получение статуса привязки самозанятых к Т-Банку
.\n\n\nОг\
раничение на использование метода — 10 запросов в секунду."
operationId: "getApiV1Self-employedTaxpayersInnStatus"
parameters:
- name: "inn"
in: "path"
required: true
style: "simple"
explode: false
schema:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/GetTaxpayerStatusResponse"
examples:
Пример ответа Registered Done.:
value:
status: "Registered"
info:
registeredAt: "2022-05-12T14:03:40Z"
activityCodes:
- "100"
oktmo: "29000000"
permissions:
- "PAYMENT_INFORMATION"
- "TAXPAYER_UPDATE"
- "CANCEL_ANY_INCOME"
- "CANCEL_INCOME"
- "INCOME_SUMMARY"
- "INCOME_REGISTRATION"
- "INCOME_LIST"
- "PERMISSIONS_MGMT"
- "TAX_PAYMENT"
application:
status: "DONE"
changedAt: "2022-05-20T09:20:19Z"
result: "REGISTERED"
Пример ответа NotRegistered с заявкой.:
value:
status: "NotRegistered"
application:
status: "IN_PROGRESS"
subStatus: "PERMISSION_REQUESTED"
changedAt: "2022-08-16T09:35:33Z"
Пример ответа NotRegistered без заявки.:
value:
status: "NotRegistered"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
deprecated: true
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/self-employed/taxpayers/{inn}/receipts/{receiptId}/cancel:
post:
tags:
- "Самозанятые"
summary: "Аннулировать доход самозанятого"
description: "\nМетод для аннулирования дохода самозанятого в налоговой, есл\
и он подключен к Т-Банку.\n\n\n⚠️ Вызовы метода платные. Чтобы ознакомитьс\
я с тарифами, напишите на smz_fns_team@tbank.ru.\n\
\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/taxpayers/cancel-receipt
\
\ — Аннулировать доход самозанятого
.\n\n\nОграничение на испо\
льзование метода — 1 запрос в секунду."
operationId: "postApiV1Self-employedTaxpayersInnReceiptsReceiptidCancel"
parameters:
- name: "inn"
in: "path"
required: true
style: "simple"
explode: false
schema:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН"
- name: "receiptId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор чека."
format: "uuid"
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/CancelReceiptRequest"
example:
reason: "MISTAKE"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/CancelReceiptResponse"
example:
receiptId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
operation:
status: "IN_PROGRESS"
type: "CANCELLATION"
createdAt: "2022-09-20T11:09:22.858Z"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/self-employed/taxpayers/{inn}/receipts/{receiptId}:
get:
tags:
- "Самозанятые"
summary: "Получить информацию о чеке"
description: "Метод возвращает информацию по конкретному чеку."
operationId: "getApiV1Self-employedTaxpayersInnReceiptsReceiptid"
parameters:
- name: "inn"
in: "path"
required: true
style: "simple"
explode: false
schema:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН"
- name: "receiptId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор чека."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/ReceiptResponse"
example:
receiptId: "61f656e0-0a86-4ec2-bd43-232499f7ad66"
incomeType: "FROM_INDIVIDUAL"
incomeReceivedAt: "2022-05-12T14:03:40Z"
incomeStatedAt: "2022-05-12T14:03:40Z"
status: "REGISTERED"
totalAmount: 1500.42
services:
- name: "Оплата самозанятому по договору"
price: 1500.42
operations:
- status: "IN_PROGRESS"
type: "REGISTRATION"
createdAt: "2022-05-12T14:03:40Z"
- status: "SUCCESS"
type: "REGISTRATION"
createdAt: "2022-05-12T14:23:40Z"
fnsLink: "https://lknpd.nalog.ru/api/v1/receipt/504511355012/2017i8xslu/print"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/ndfl-3/requests/{taxRequestId}/info/personal:
get:
tags:
- "Декларации 3-НДФЛ"
summary: "Получить персональные данные клиента, для которого требуется форми\
рование декларации"
description: "\nМетод возвращает персональные данные клиента по идентификато\
ру заявки — `taxRequestId`.\nПолучить данные по одному идентификатору заяв\
ки можно только один раз: следующие вызовы будут завершаться 422 ошибкой.\n\
\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/ndfl3-automation/info/personal
\
\ — Декларации 3-НДФЛ — Получение персональных данных клиента
.\n\
\n\nОграничение на использование метода — 10 запросов в секунду."
operationId: "getApiV1Ndfl-3RequestsTaxrequestidInfoPersonal"
parameters:
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/PersonalDataResponse"
example:
birthDate: "1986-10-13"
birthPlace: "г. Москва"
inn: "123456789012"
lastName: "Фамилия"
middleName: "Отчество, если есть"
firstName: "Имя"
address: "Адрес регистрации"
bic: "044525974"
accountNumber: "12345678901234567890"
passport:
serialNumber: "8006123123"
unitName: "Октябрьским РУВД г. Екатеринбург"
unitCode: "321-890"
issueDate: "2000-04-07"
citizenship: "RU"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/ndfl-3/requests/{taxRequestId}/tax-form/upload:
post:
tags:
- "Декларации 3-НДФЛ"
summary: "Загрузить файл с готовой декларацией"
description: "\nМетод загружает готовую декларацию клиента по идентификатору\
\ заявки — `taxRequestId`.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/ndfl3-automation/tax-form/upload
\
\ — Декларации 3-НДФЛ — Загрузить файл с готовой декларацией
.\n\
\n\nОграничение на использование метода — 1 запрос в секунду."
operationId: "postApiV1Ndfl-3RequestsTaxrequestidTax-formUpload"
parameters:
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор заявки."
format: "uuid"
- name: "X-Idempotency-Key"
in: "header"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Ключ идемпотентности. Подробнее."
format: "uuid"
requestBody:
content:
multipart/form-data:
schema:
required:
- "file"
type: "object"
properties:
description:
type: "string"
file:
type: "string"
format: "binary"
required: true
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/Empty"
example: {}
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/ndfl-3/requests/{taxRequestId}/info/form:
get:
tags:
- "Декларации 3-НДФЛ"
summary: "Получить заполненную клиентом анкету с составом декларации 3-НДФЛ"
description: "\nМетод возвращает заполненную анкету клиента по идентификатор\
у заявки — `taxRequestId`.\nЕсли анкета не будет найдена, вернется ошибка\
.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/ndfl3-automation/info/form
\
\ — Декларации 3-НДФЛ — Получить заполненную клиентом анкету
.\n\
\n\nОграничение на использование метода — 10 запросов в секунду."
operationId: "getApiV1Ndfl-3RequestsTaxrequestidInfoForm"
parameters:
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор заявки."
format: "uuid"
responses:
"200":
description: ""
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/FormDataResponse"
example:
year: 2022
isResident: true
type: "Primary"
incomeSources:
- title: "Доходы за рубежом"
options:
- title: "Сдача недвижимости в аренду"
documents:
- id: "4f73de13-4054-448e-b07f-500e09cd6d56"
title: "Document"
fileName: "filename.pdf"
mime: "application/pdf"
size: 10000
taxReturnReasons:
- title: "Социальный налоговый вычет"
options:
- title: "Лечение"
documents:
- id: "4f73de13-4054-448e-b07f-500e09cd6d56"
title: "Document"
fileName: "filename.pdf"
mime: "application/pdf"
size: 10000
casVersion: 1
createdAt: "2005-08-09T18:31:42+03:30"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
/api/v1/ndfl-3/requests/{taxRequestId}/info/form/attachments/{attachmentId}:
get:
tags:
- "Декларации 3-НДФЛ"
summary: "Получить вложение из заполненной анкеты клиента"
description: "\nМетод возвращает файл из анкеты клиента по идентификатору за\
явки — `taxRequestId` и идентификатору файла — `attachmentId`.\nЕсли файл\
\ не будет найден или будет недоступен для скачивания после закрытия запро\
са, вернется ошибка.\n\n\nЧтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/ndfl3-automation/info/form/attachments
\
\ — Декларации 3-НДФЛ — Получить вложение из заполненной анкеты клие\
нта
.\n\n\nОграничение на использование метода — 10 запросов в секун\
ду."
operationId: "getApiV1Ndfl-3RequestsTaxrequestidInfoFormAttachmentsAttachmentid"
parameters:
- name: "taxRequestId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор заявки."
format: "uuid"
- name: "attachmentId"
in: "path"
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор вложения."
format: "uuid"
responses:
"200":
description: ""
headers:
Content-Disposition:
required: true
style: "simple"
explode: false
schema:
type: "string"
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/octet-stream:
schema:
type: "string"
format: "binary"
"400":
description: "Некорректный запрос"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InvalidRequestResponse"
examples:
Ошибка при неправильно заполненном ИНН:
value:
errorId: "retw6789"
errorMessage: "Некорректно заполнен ИНН"
errorCode: "VALIDATION_ERROR"
Ошибка при неправильно переданном значении поля fieldName:
value:
errorId: "cde4zxc5"
errorMessage: "Ваш запрос невалиден"
errorCode: "INVALID_DATA"
errorDetails:
fieldName: "expected fieldName to be one of (1, 2, 3, 4, 5),\
\ but got \"0\""
Ошибка при неправильно переданной дате платежа:
value:
errorId: "cde4zxc5"
errorMessage: "Данные не соответствуют формату платежного пору\
чения"
errorCode: "INVALID_DATA"
errorDetails:
Дата платежа: "Дата исполнения платежа не может быть в прошл\
ом"
"401":
description: "Ошибка аутентификации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthenticationFailedResponse"
example:
errorMessage: "Не хватает учетных данных"
errorCode: "UNAUTHORIZED"
errorId: "asdq3412"
"403":
description: "Ошибка авторизации"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/AuthorizationFailedResponse"
example:
errorMessage: "Неправильный Tls сертификат"
errorCode: "FORBIDDEN"
errorId: "rtbe4567"
"422":
description: "Ошибка при обработке данных"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/BusinessErrorResponse"
example:
errorMessage: "На балансе недостаточно средств"
errorCode: "INSUFFICIENT_FUNDS"
errorId: "bcde3412"
"429":
description: "Слишком много запросов"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/TooManyRequestsErrorResponse"
example:
errorMessage: "Слишком много запросов. Попробуйте позже"
errorCode: "TOO_MANY_REQUESTS"
errorId: "acdf000"
"500":
description: "Ошибка сервера"
headers:
X-Request-Id:
required: true
style: "simple"
explode: false
schema:
type: "string"
description: "Идентификатор запроса."
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerErrorResponse"
example:
errorMessage: "Непредвиденная ошибка. Пожалуйста, попробуйте позже"
errorCode: "INTERNAL_ERROR"
errorId: "asdq3412"
security:
- httpAuth: []
servers:
- url: "https://secured-openapi.tbank.ru"
description: "Production"
- url: "https://business.tbank.ru/openapi/sandbox/secured"
description: "Sandbox"
components:
schemas:
PaymentRegistrySubmitResultResponse:
required:
- "paymentRegistryId"
- "status"
type: "object"
properties:
paymentRegistryId:
type: "integer"
description: "Идентификатор платежного реестра."
format: "int32"
status:
$ref: "#/components/schemas/SubmissionStatus"
error:
required:
- "errorCode"
- "errorMessage"
type: "object"
properties:
errorCode:
type: "string"
description: "Код ошибки."
errorMessage:
type: "string"
description: "Описание ошибки."
description: "Общая ошибка, произошедшая при создании реестра."
paymentErrors:
type: "array"
description: "Платежи внутри реестра, содержащие ошибки."
items:
$ref: "#/components/schemas/EmployedSubmitPaymentError"
BeneficiaryIpResidentRequest:
required:
- "addresses"
- "birthDate"
- "citizenship"
- "documents"
- "firstName"
- "inn"
- "lastName"
- "registrationDate"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип бенефициара:\n* `FL_RESIDENT` — физическое лицо, резид\
ент.\n* `FL_NONRESIDENT` — физическое лицо, нерезидент.\n* `UL_RESIDENT`\
\ — юридическое лицо, резидент.\n* `UL_NONRESIDENT` — юридическое лицо\
, нерезидент.\n* `IP_RESIDENT` — ИП, резидент.\n* `IP_NONRESIDENT` — И\
П, нерезидент.\n* `LITE_CONTACT` — легкий контакт."
enum:
- "FL_RESIDENT"
- "FL_NONRESIDENT"
- "UL_RESIDENT"
- "UL_NONRESIDENT"
- "IP_RESIDENT"
- "IP_NONRESIDENT"
- "LITE_CONTACT"
firstName:
type: "string"
description: "Имя."
middleName:
type: "string"
description: "Отчество."
lastName:
type: "string"
description: "Фамилия."
birthDate:
type: "string"
description: "Дата рождения."
format: "date"
birthPlace:
type: "string"
description: "Место рождения."
citizenship:
pattern: "^([A-Z]{2})$"
type: "string"
description: "Гражданство. Код страны в формате `ISO 3166-1 alpha-2`."
phoneNumber:
pattern: "^((\\+[0-9])([0-9]){6,14})$"
type: "string"
description: "Номер телефона. phoneNumber или email обязателен к заполне\
нию."
email:
type: "string"
description: "Электронная почта. phoneNumber или email обязателен к запо\
лнению."
documents:
minItems: 1
type: "array"
description: "Документы. Для ИП резидента обязателен тип PASSPORT."
items:
$ref: "#/components/schemas/Document2"
addresses:
minItems: 1
type: "array"
description: "Адреса."
items:
$ref: "#/components/schemas/Address"
registrationDate:
type: "string"
description: "Дата регистрации."
format: "date"
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
ogrn:
pattern: "^(\\d{15})$"
type: "string"
description: "Основной государственный регистрационный номер."
StepListResponse:
required:
- "limit"
- "offset"
- "size"
- "total"
type: "object"
properties:
offset:
type: "integer"
description: "Запрошенное количество этапов сделки для пропуска."
format: "int32"
limit:
type: "integer"
description: "Запрошенное количество этапов сделки для вывода."
format: "int32"
size:
type: "integer"
description: "Количество этапов сделки в ответе."
format: "int32"
total:
type: "integer"
description: "Всего этапов сделки, подходящих под условия запроса."
format: "int32"
results:
type: "array"
description: "Список этапов сделки."
items:
$ref: "#/components/schemas/StepResponse"
ApplicationSubStatus:
type: "string"
description: "Субстатус, присутствует только у заявок, где status = IN_PROGRESS."
enum:
- "PERMISSION_REQUESTED"
Balance:
required:
- "authorized"
- "otb"
- "pendingPayments"
- "pendingRequisitions"
type: "object"
properties:
otb:
type: "number"
description: "Доступный остаток — деньги на счете + сумма доступного ове\
рдрафта, если он подключен."
authorized:
type: "number"
description: "Сумма авторизаций — захолдированные на счете средства."
pendingPayments:
type: "number"
description: "Сумма платежей в картотеке клиента — собственные платежи."
pendingRequisitions:
type: "number"
description: "Сумма платежей в картотеке банка — требования к клиенту."
description: "Баланс счета."
BeneficiariesResult:
required:
- "isInnCorrect"
- "isPassportCorrect"
type: "object"
properties:
isInnCorrect:
type: "boolean"
description: "Наличие ИНН по полученным персональным данным."
isPassportCorrect:
type: "boolean"
description: "Действительность персональнных данных."
description: "Результат проверки бенефициара. Возвращается в ответе, если ст\
атус — READY
."
ReceiptService:
required:
- "name"
- "price"
type: "object"
properties:
name:
type: "string"
description: "Название услуги."
price:
type: "number"
description: "Цена."
BeneficiaryScoringInfoListResponse:
required:
- "limit"
- "offset"
- "size"
- "total"
type: "object"
properties:
offset:
type: "integer"
description: "Запрошенное количество результатов проверки для пропуска."
format: "int32"
limit:
type: "integer"
description: "Запрошенное количество результатов проверки для вывода."
format: "int32"
size:
type: "integer"
description: "Количество результатов проверки в ответе."
format: "int32"
total:
type: "integer"
description: "Всего результатов проверки, подходящих под условия запроса\
."
format: "int32"
results:
type: "array"
description: "Список результатов проверки."
items:
$ref: "#/components/schemas/BeneficiaryScoringInfo"
PhoneType1:
type: "string"
description: "Тип телефона."
enum:
- "Мобильный"
- "По месту жительства"
- "Рабочий"
BeneficiaryLiteContactRequest:
required:
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип бенефициара:\n* `FL_RESIDENT` — физическое лицо, резид\
ент.\n* `FL_NONRESIDENT` — физическое лицо, нерезидент.\n* `UL_RESIDENT`\
\ — юридическое лицо, резидент.\n* `UL_NONRESIDENT` — юридическое лицо\
, нерезидент.\n* `IP_RESIDENT` — ИП, резидент.\n* `IP_NONRESIDENT` — И\
П, нерезидент.\n* `LITE_CONTACT` — легкий контакт."
enum:
- "FL_RESIDENT"
- "FL_NONRESIDENT"
- "UL_RESIDENT"
- "UL_NONRESIDENT"
- "IP_RESIDENT"
- "IP_NONRESIDENT"
- "LITE_CONTACT"
description: "Не требующий идентификации контакт."
Passport1:
required:
- "issueDate"
- "issuerCode"
- "issuerName"
- "number"
- "series"
type: "object"
properties:
series:
pattern: "^\\d{4}$"
type: "string"
description: "Серия."
number:
pattern: "^\\d{6}$"
type: "string"
description: "Номер."
issuerName:
type: "string"
description: "Кем выдан."
issuerCode:
type: "string"
description: "Код подразделения."
issueDate:
type: "string"
description: "Дата выдачи в формате `yyyy-MM-dd`."
format: "date"
description: "Данные паспорта."
CardPayerRequisites:
required:
- "accountNumber"
type: "object"
properties:
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета для списания."
description: "Реквизиты плательщика."
SubmitPaymentError:
required:
- "number"
type: "object"
properties:
number:
type: "integer"
description: "Идентификатор платежа, переданный клиентом при создании."
format: "int32"
accountNumber:
type: "string"
description: "Номер счета сотрудника."
errors:
type: "array"
description: "Ошибки валидации."
items:
$ref: "#/components/schemas/FieldValidationError"
SelfEmployedCreationDate:
type: "object"
properties:
from:
type: "string"
description: "Дата начала периода."
format: "date-time"
to:
type: "string"
description: "Дата окончания периода."
format: "date-time"
description: "Период даты добавления."
Passport:
required:
- "date"
- "division"
- "number"
- "serial"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип документа."
enum:
- "PASSPORT"
- "FOREIGN_PASSPORT"
- "FOREIGN_PASSPORT_OF_FOREIGN_CITIZENS"
- "OFFICIAL_PASSPORT"
- "DIPLOMATIC_PASSPORT"
- "MIGRATION_CARD"
- "TEMPORARY_RESIDENCE_PERMIT"
- "VISA"
- "RESIDENCE_PERMIT"
- "CONTRACT"
- "CONTRACT_GPD"
- "PATENT"
serial:
type: "string"
description: "Серия документа."
number:
type: "string"
description: "Номер документа."
date:
type: "string"
description: "Дата выдачи."
format: "date"
organization:
type: "string"
description: "Кем выдан."
division:
pattern: "^(\\d{3}-\\d{3})$"
type: "string"
description: "Код подразделения."
Photo:
required:
- "id"
type: "object"
properties:
id:
type: "string"
type:
type: "string"
description: "Тип фото."
subType:
type: "string"
description: "Подтип фото."
sheetNumber:
type: "integer"
description: "Номер страницы."
format: "int32"
review:
type: "object"
additionalProperties:
type: "string"
description: "Результат проверки фото в формате `JSON`."
CreatePhone:
required:
- "number"
- "type"
type: "object"
properties:
type:
$ref: "#/components/schemas/PhoneType"
number:
type: "string"
description: "Номер телефона."
CreateEmployeesResponse:
required:
- "correlationId"
type: "object"
properties:
correlationId:
type: "string"
description: "Идентификатор, связывающий запрос создания с запросом полу\
чения ответа."
format: "uuid"
SubscriptionResponse:
required:
- "type"
type: "object"
properties:
type:
$ref: "#/components/schemas/BundleCode"
GetBeneficiariesResultResponse:
oneOf:
- $ref: "#/components/schemas/InProgress1"
- $ref: "#/components/schemas/Ready1"
Terminal:
required:
- "id"
- "key"
type: "object"
properties:
key:
type: "string"
description: "Серийный номер терминала."
id:
type: "string"
description: "Идентификатор терминала."
DriverLicensesResponse:
type: "object"
properties:
licenses:
type: "array"
description: "Водительские удостоверения физического лица."
items:
$ref: "#/components/schemas/DriverLicenseResponse"
Address2:
required:
- "fullAddress"
type: "object"
properties:
fullAddress:
type: "string"
description: "Полный адрес."
zipCode:
type: "string"
description: "Почтовый индекс."
country:
type: "string"
description: "Страна."
region:
type: "string"
description: "Регион."
area:
type: "string"
description: "Район."
city:
type: "string"
description: "Город."
street:
type: "string"
description: "Улица."
house:
type: "string"
description: "Дом."
building:
type: "string"
description: "Корпус."
flat:
type: "string"
description: "Квартира."
construction:
type: "string"
description: "Строение."
settlement:
type: "string"
description: "Поселение."
description: "Адрес, по которому нужно получить доступные интервалы для назн\
ачения встречи."
OfficialPassport:
required:
- "date"
- "number"
- "organization"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип документа."
enum:
- "PASSPORT"
- "FOREIGN_PASSPORT"
- "FOREIGN_PASSPORT_OF_FOREIGN_CITIZENS"
- "OFFICIAL_PASSPORT"
- "DIPLOMATIC_PASSPORT"
- "MIGRATION_CARD"
- "TEMPORARY_RESIDENCE_PERMIT"
- "VISA"
- "RESIDENCE_PERMIT"
- "CONTRACT"
- "CONTRACT_GPD"
- "PATENT"
number:
type: "string"
description: "Номер документа."
date:
type: "string"
description: "Дата выдачи."
format: "date"
organization:
type: "string"
description: "Кем выдан."
SelfEmployedPayPaymentRegistryResponse:
required:
- "correlationId"
type: "object"
properties:
correlationId:
type: "string"
description: "Идентификатор, связывающий запрос создания с запросом полу\
чения ответа."
format: "uuid"
PaymentError:
required:
- "number"
type: "object"
properties:
number:
type: "integer"
description: "Идентификатор платежа, переданный клиентом при создании."
format: "int32"
accountNumber:
type: "string"
description: "Номер счета сотрудника."
errors:
type: "array"
description: "Ошибки валидации."
items:
required:
- "errorDescription"
- "fieldName"
type: "object"
properties:
fieldName:
type: "string"
description: "Название поля, в котором возникла ошибка, на русском\
\ языке."
errorDescription:
type: "string"
description: "Описание ошибки."
RkcBankDetails:
required:
- "accountNumber"
- "bankName"
- "bik"
- "corrAccountNumber"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип банковских реквизитов:\n* `PAYMENT_DETAILS` — По рекви\
зитам счета.\n* `CARD` — На карту.\n* `SBP` — Через СБП."
enum:
- "PAYMENT_DETAILS"
- "CARD"
- "SBP"
bik:
pattern: "\\d{9}"
type: "string"
description: "БИК банка получателя.\n\n\nС 1 января 2021 года при перечи\
слении налоговых платежей указываются новые значения БИК банков получа\
теля.\n\n\nПодробнее о полях платежного поручения "
kpp:
pattern: "^(\\d{9})$"
type: "string"
description: "КПП получателя"
inn:
pattern: "^(\\d{12}|\\d{10}|0{1})$"
type: "string"
description: "ИНН. Укажите 0, чтобы не заполнять."
name:
maxLength: 160
type: "string"
description: "Наименование получателя."
bankName:
maxLength: 255
minLength: 1
type: "string"
description: "Наименование банка получателя.\n\n\nС 1 января 2021 года п\
ри заполнении платежей на перечисление налогов после названия банка ук\
азывается название счета казначейства через знак //
. "
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета. ВАЖНО: Для бюджетных платежей с 01.01.2021\
\ в данном поле нужно указывать новые номера казначейских счетов."
corrAccountNumber:
pattern: "\\d{20}"
type: "string"
description: "Корреспондентский счет банка получателя.\n\n\nС 1 января 2021\
\ года при уплате налогов указывается номер счета банка получателя, вх\
одящий в состав единого казначейского счета (ЕКС). Раньше это поле зап\
олнялось нулями. "
UpdateTaskRequest:
required:
- "template"
type: "object"
properties:
template:
type: "string"
description: "Шаблон, определяющий бизнес-логику задания."
commentForAgent:
type: "string"
description: "Комментарий к заданию для представителя."
parentTaskId:
type: "string"
description: "Идентификатор родительского задания."
meta:
type: "object"
additionalProperties:
type: "string"
description: "Дополнительные метаданные в формате JSON."
contacts:
type: "array"
description: "Группа объектов с информацией о данных каждого участника з\
адания, подлежащего удостоверению на встрече."
items:
$ref: "#/components/schemas/Contact"
photos:
type: "array"
description: "Группа объектов с информацией о фото, относящихся к задани\
ю."
items:
$ref: "#/components/schemas/Photo"
SelfEmployedPaymentRegistrySubmitRequest:
required:
- "correlationId"
- "paymentRegistryId"
type: "object"
properties:
correlationId:
type: "string"
description: "Идентификатор, связывающий запрос создания с запросом полу\
чения ответа."
format: "uuid"
paymentRegistryId:
type: "integer"
description: "Идентификатор платежного реестра."
format: "int32"
Patent:
required:
- "date"
- "expireDate"
- "number"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип документа."
enum:
- "PASSPORT"
- "FOREIGN_PASSPORT"
- "FOREIGN_PASSPORT_OF_FOREIGN_CITIZENS"
- "OFFICIAL_PASSPORT"
- "DIPLOMATIC_PASSPORT"
- "MIGRATION_CARD"
- "TEMPORARY_RESIDENCE_PERMIT"
- "VISA"
- "RESIDENCE_PERMIT"
- "CONTRACT"
- "CONTRACT_GPD"
- "PATENT"
number:
type: "string"
description: "Номер документа."
date:
type: "string"
description: "Дата выдачи."
format: "date"
expireDate:
type: "string"
description: "Дата истечения."
format: "date"
CancelReceiptResponse:
required:
- "operation"
- "receiptId"
type: "object"
properties:
receiptId:
type: "string"
description: "Идентификатор чека."
format: "uuid"
operation:
$ref: "#/components/schemas/ReceiptOperation"
TemporaryResidencePermit:
required:
- "date"
- "expireDate"
- "number"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип документа."
enum:
- "PASSPORT"
- "FOREIGN_PASSPORT"
- "FOREIGN_PASSPORT_OF_FOREIGN_CITIZENS"
- "OFFICIAL_PASSPORT"
- "DIPLOMATIC_PASSPORT"
- "MIGRATION_CARD"
- "TEMPORARY_RESIDENCE_PERMIT"
- "VISA"
- "RESIDENCE_PERMIT"
- "CONTRACT"
- "CONTRACT_GPD"
- "PATENT"
number:
type: "string"
description: "Номер документа."
date:
type: "string"
description: "Дата выдачи."
format: "date"
expireDate:
type: "string"
description: "Дата истечения."
format: "date"
TooManyRequestsErrorResponse:
required:
- "errorCode"
- "errorId"
- "errorMessage"
type: "object"
properties:
errorId:
type: "string"
errorMessage:
maxLength: 400
type: "string"
description: "Текст ошибки."
errorCode:
maxLength: 50
type: "string"
description: "Код ошибки."
PositionInfo:
required:
- "currency"
- "currentBalance"
- "currentBalanceForWithdrawal"
type: "object"
properties:
currency:
type: "string"
description: "Код валюты."
currentBalance:
type: "number"
description: "Общий баланс по валюте."
currentBalanceForWithdrawal:
type: "number"
description: "Сумма денежных средств, доступных для вывода."
blockedQuantity:
type: "number"
description: "Количество заблокированной валюты."
BeneficiaryIpResidentResponse:
required:
- "beneficiaryId"
- "birthDate"
- "firstName"
- "lastName"
- "registrationDate"
- "type"
type: "object"
properties:
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
type:
type: "string"
description: "Тип бенефициара:\n* `FL_RESIDENT` — физическое лицо, резид\
ент.\n* `FL_NONRESIDENT` — физическое лицо, нерезидент.\n* `UL_RESIDENT`\
\ — юридическое лицо, резидент.\n* `UL_NONRESIDENT` — юридическое лицо\
, нерезидент.\n* `IP_RESIDENT` — ИП, резидент.\n* `IP_NONRESIDENT` — И\
П, нерезидент.\n* `LITE_CONTACT` — легкий контакт."
enum:
- "FL_RESIDENT"
- "FL_NONRESIDENT"
- "UL_RESIDENT"
- "UL_NONRESIDENT"
- "IP_RESIDENT"
- "IP_NONRESIDENT"
- "LITE_CONTACT"
firstName:
type: "string"
description: "Имя."
middleName:
type: "string"
description: "Отчество."
lastName:
type: "string"
description: "Фамилия."
birthDate:
type: "string"
description: "Дата рождения."
format: "date"
birthPlace:
type: "string"
description: "Место рождения."
citizenship:
pattern: "^([A-Z]{2})$"
type: "string"
description: "Гражданство. Код страны в формате `ISO 3166-1 alpha-2`."
phoneNumber:
pattern: "^((\\+[0-9])([0-9]){6,14})$"
type: "string"
description: "Номер телефона."
email:
type: "string"
description: "Электронная почта."
documents:
type: "array"
description: "Документы."
items:
$ref: "#/components/schemas/Document2"
addresses:
type: "array"
description: "Адреса."
items:
$ref: "#/components/schemas/Address"
registrationDate:
type: "string"
description: "Дата регистрации."
format: "date"
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
ogrn:
pattern: "^(\\d{15})$"
type: "string"
description: "Основной государственный регистрационный номер."
IN_PROGRESS:
required:
- "beneficiaryId"
- "status"
type: "object"
properties:
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
status:
type: "string"
description: "Статус проверки в финансовом мониторинге."
enum:
- "IN_PROGRESS"
- "SUCCEEDED"
- "FAILED"
TransitAccount:
required:
- "accountNumber"
type: "object"
properties:
accountNumber:
type: "string"
description: "Номер транзитного банковского счета."
description: "Информация о транзитном счете. Актуально для валютных счетов."
DeponentRequest:
required:
- "amount"
type: "object"
properties:
amount:
type: "number"
description: "Сумма депонента."
GetIntervalsResponse:
required:
- "appointmentId"
- "timeOffset"
type: "object"
properties:
appointmentId:
type: "string"
description: "Идентификатор назначения встречи."
timeOffset:
type: "string"
description: "Временная зона адреса, для которого выбирается временной и\
нтервал в формате `ISO 8601`. Например, +03:00."
intervals:
type: "array"
description: "Cписок объектов, содержащих информацию о начале и окончани\
и временного интервала."
items:
$ref: "#/components/schemas/Interval"
BeneficiaryFlNonresidentRequest:
required:
- "addresses"
- "birthDate"
- "citizenship"
- "documents"
- "firstName"
- "isSelfEmployed"
- "lastName"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип бенефициара:\n* `FL_RESIDENT` — физическое лицо, резид\
ент.\n* `FL_NONRESIDENT` — физическое лицо, нерезидент.\n* `UL_RESIDENT`\
\ — юридическое лицо, резидент.\n* `UL_NONRESIDENT` — юридическое лицо\
, нерезидент.\n* `IP_RESIDENT` — ИП, резидент.\n* `IP_NONRESIDENT` — И\
П, нерезидент.\n* `LITE_CONTACT` — легкий контакт."
enum:
- "FL_RESIDENT"
- "FL_NONRESIDENT"
- "UL_RESIDENT"
- "UL_NONRESIDENT"
- "IP_RESIDENT"
- "IP_NONRESIDENT"
- "LITE_CONTACT"
firstName:
type: "string"
description: "Имя."
middleName:
type: "string"
description: "Отчество."
lastName:
type: "string"
description: "Фамилия."
isSelfEmployed:
type: "boolean"
description: "Самозанятый."
birthDate:
type: "string"
description: "Дата рождения."
format: "date"
birthPlace:
type: "string"
description: "Место рождения."
citizenship:
pattern: "^([A-Z]{2})$"
type: "string"
description: "Гражданство. Код страны в формате `ISO 3166-1 alpha-2`."
phoneNumber:
pattern: "^((\\+[0-9])([0-9]){6,14})$"
type: "string"
description: "Номер телефона. phoneNumber или email обязателен к заполне\
нию."
email:
type: "string"
description: "Электронная почта. phoneNumber или email обязателен к запо\
лнению."
documents:
minItems: 1
type: "array"
description: "Документы. Обязательно — минимум 2.\n\n\nВ большинстве слу\
чаев основной документ нерезидента РФ — `FOREIGN_PASSPORT`. Второй док\
умент — любой из документов, подтверждающих право на пребывание в РФ.\
\ Подробнее о документах.\n\n\nДля нерезидентов с гражданством BY д\
остаточно одного документа с типом `FOREIGN_PASSPORT`."
items:
$ref: "#/components/schemas/Document2"
addresses:
minItems: 1
type: "array"
description: "Адреса."
items:
$ref: "#/components/schemas/Address"
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
DocumentType1:
type: "string"
description: "Тип документа."
enum:
- "Паспорт"
- "Иностранный паспорт"
- "Загр. паспорт иностранного гр."
- "Служебный/официальный паспорт"
- "Дипломатический паспорт"
- "Миграционная карта"
- "Разр. на временное проживание"
- "Виза"
- "Вид на жительство"
IncomingTransactionListItem:
required:
- "accountNumber"
- "amount"
- "operationId"
type: "object"
properties:
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер счета."
operationId:
type: "string"
description: "ID операции пополнения."
format: "uuid"
amount:
type: "number"
description: "Сумма пополнения в валюте счета."
currency:
pattern: "^\\d{3}$"
type: "string"
description: "Валюта пополнения в валюте счета."
operationAmount:
type: "number"
description: "Сумма пополнения в валюте пополнения."
operationCurrency:
pattern: "^\\d{3}$"
type: "string"
description: "Валюта пополнения в валюте пополнения."
payerBik:
pattern: "\\d{9}"
type: "string"
description: "БИК плательщика."
payerKpp:
pattern: "^(\\d{9})$"
type: "string"
description: "КПП плательщика."
payerInn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
description: "ИНН плательщика."
payerBankName:
maxLength: 255
minLength: 1
type: "string"
description: "Наименования банка плательщика."
payerBankSwiftCode:
type: "string"
description: "SWIFT-код банка плательщика."
payerAccountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер счета плательщика."
payerCorrAccountNumber:
pattern: "\\d{20}"
type: "string"
description: "Корр. счет плательщика."
payerName:
maxLength: 160
type: "string"
description: "Имя плательщика."
paymentPurpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
documentNumber:
type: "string"
description: "Номер платежного поручения."
chargeDate:
type: "string"
description: "Дата и время пополнения."
format: "date-time"
authorizationDate:
type: "string"
description: "Дата авторизации."
format: "date-time"
transactionDate:
type: "string"
description: "Дата транзакции."
format: "date-time"
drawDate:
type: "string"
description: "Дата списания."
format: "date-time"
BankStatement:
required:
- "accountNumber"
- "income"
- "outcome"
- "saldoIn"
- "saldoOut"
type: "object"
properties:
accountNumber:
type: "string"
description: "Расчетный счет организации."
saldoIn:
type: "number"
description: "Баланс на начало периода."
income:
type: "number"
description: "Обороты входящих платежей."
outcome:
type: "number"
description: "Обороты исходящих платежей."
saldoOut:
type: "number"
description: "Баланс на конец периода."
operation:
type: "array"
description: "Список операций по счету."
items:
$ref: "#/components/schemas/BankStatementOperation"
PaymentStatus:
type: "string"
description: "Статус платежа:\nIN_PROGRESS
— в процес\
се исполнения;EXECUTED
— исполнен;FAILED
\
\ — не исполнен;CANCELLED
— отменен.ERROR
— ошибка\
\ создания анкеты самозанятого.DRAFT
— анкета самоза\
нятого готова к отправке.PROCESSING_ERROR
— ошибка о\
тправки анкеты. Обратитесь к персональному менеджеру для уточнения причины\
.PROCESSING
— обрабатываем анкету самозанятого.REJECTED
\
\ — отказ в открытии счета. Конечный статус добавления.MTNG_WAIT
\
\ — самозанятый ожидает назначения встречи для доставки карты. MTNG_SCHD
\
\ — встреча для доставки карты самозанятому назначена.MTNG_CANC
\
\ — встреча для доставки карты самозанятому отменена.ACTIVE
\
\ — самозанятый добавлен. Конечный статус добавления.DELETED
\
\ — самозанятый удален.E.164
."
email:
type: "string"
description: "Электронная почта."
passport:
$ref: "#/components/schemas/BeneficiariesPassport"
CreatePhoneType:
type: "string"
description: "Тип телефона."
enum:
- "Мобильный"
- "По месту жительства"
- "Рабочий"
Address:
required:
- "address"
- "type"
type: "object"
properties:
type:
type: "string"
description: "\nТип адреса.\nДля типов `FL_RESIDENT`, `FL_NONRESIDENT`,\
\ `IP_RESIDENT`, `IP_NONRESIDENT` обязателен один из адресов:\n\n * `REGISTRATION_ADDRESS`\
\ — адрес регистрации по месту жительства;\n * `RESIDENCE_ADDRESS` — а\
дрес регистрации по месту пребывания.\n\nДля типов `UL_RESIDENT`, `UL_NONRESIDENT`\
\ обязательно передавать `LEGAL_ENTITY_ADDRESS` — адрес юридического л\
ица.\n"
enum:
- "POSTAL_ADDRESS"
- "REGISTRATION_ADDRESS"
- "RESIDENCE_ADDRESS"
- "LEGAL_ENTITY_ADDRESS"
- "OFFICE_OF_FOREIGN_LEGAL_ENTITY_ADDRESS"
address:
maxLength: 256
type: "string"
description: "Адрес."
description: "Адрес бенефициара."
CreateSelfEmployedResultResponse:
type: "object"
properties:
recipientResults:
type: "array"
description: "Список результатов создания самозанятых."
items:
$ref: "#/components/schemas/CreateSelfEmployed"
BeneficiaryFlResidentRequest:
required:
- "addresses"
- "birthDate"
- "citizenship"
- "documents"
- "firstName"
- "isSelfEmployed"
- "lastName"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип бенефициара:\n* `FL_RESIDENT` — физическое лицо, резид\
ент.\n* `FL_NONRESIDENT` — физическое лицо, нерезидент.\n* `UL_RESIDENT`\
\ — юридическое лицо, резидент.\n* `UL_NONRESIDENT` — юридическое лицо\
, нерезидент.\n* `IP_RESIDENT` — ИП, резидент.\n* `IP_NONRESIDENT` — И\
П, нерезидент.\n* `LITE_CONTACT` — легкий контакт."
enum:
- "FL_RESIDENT"
- "FL_NONRESIDENT"
- "UL_RESIDENT"
- "UL_NONRESIDENT"
- "IP_RESIDENT"
- "IP_NONRESIDENT"
- "LITE_CONTACT"
firstName:
type: "string"
description: "Имя."
middleName:
type: "string"
description: "Отчество."
lastName:
type: "string"
description: "Фамилия."
isSelfEmployed:
type: "boolean"
description: "Самозанятый."
birthDate:
type: "string"
description: "Дата рождения."
format: "date"
birthPlace:
type: "string"
description: "Место рождения."
citizenship:
pattern: "^([A-Z]{2})$"
type: "string"
description: "Гражданство. Код страны в формате `ISO 3166-1 alpha-2`."
phoneNumber:
pattern: "^((\\+[0-9])([0-9]){6,14})$"
type: "string"
description: "Номер телефона. Номер телефона или электронная почта обяза\
тельны к заполнению."
email:
type: "string"
description: "Электронная почта. Номер телефона или электронная почта об\
язательны к заполнению."
documents:
minItems: 1
type: "array"
description: "Документы. Обязательный тип для физического лица-резидента\
\ — `PASSPORT`."
items:
$ref: "#/components/schemas/Document2"
addresses:
minItems: 1
type: "array"
description: "Адреса"
items:
$ref: "#/components/schemas/Address"
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН"
snils:
pattern: "^(\\d{11})$"
type: "string"
description: "СНИЛС"
ApiBlacklistResponse:
required:
- "isBlacklisted"
type: "object"
properties:
isBlacklisted:
type: "boolean"
description: "Находится ли пользователь в черных списках."
SelfEmployedReceiptsResponse:
required:
- "correlationId"
type: "object"
properties:
correlationId:
type: "string"
description: "Идентификатор, связывающий запрос создания с запросом полу\
чения ответа."
format: "uuid"
SelfEmployedPaymentRegistry:
required:
- "paymentsCount"
- "status"
- "totalSum"
type: "object"
properties:
status:
$ref: "#/components/schemas/PaymentRegistryStatus1"
loadDate:
type: "string"
description: "Дата исполнения реестра."
paymentsCount:
type: "integer"
description: "Количество платежей в реестре."
format: "int32"
totalSum:
type: "number"
description: "Общая сумма платежей в реестре."
payments:
type: "array"
description: "Список платежей внутри реестра."
items:
$ref: "#/components/schemas/SelfEmployedPaymentInfo"
CreateAddress1:
required:
- "postalCode"
- "state"
- "type"
type: "object"
properties:
type:
$ref: "#/components/schemas/CreateAddressType"
country:
type: "string"
description: "Страна."
postalCode:
type: "string"
description: "Индекс."
state:
type: "string"
description: "Регион."
city:
type: "string"
description: "Город."
district:
type: "string"
description: "Район."
settlement:
type: "string"
description: "Населенный пункт."
street:
type: "string"
description: "Улица."
house:
type: "string"
description: "Дом."
building:
type: "string"
description: "Здание."
construction:
type: "string"
description: "Корпус."
apartment:
type: "string"
description: "Квартира."
Contract:
required:
- "date"
- "number"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип документа."
enum:
- "PASSPORT"
- "FOREIGN_PASSPORT"
- "FOREIGN_PASSPORT_OF_FOREIGN_CITIZENS"
- "OFFICIAL_PASSPORT"
- "DIPLOMATIC_PASSPORT"
- "MIGRATION_CARD"
- "TEMPORARY_RESIDENCE_PERMIT"
- "VISA"
- "RESIDENCE_PERMIT"
- "CONTRACT"
- "CONTRACT_GPD"
- "PATENT"
number:
type: "string"
description: "Номер документа."
date:
type: "string"
description: "Дата выдачи."
format: "date"
expireDate:
type: "string"
description: "Дата истечения."
format: "date"
BeneficiaryUlNonresidentRequest:
required:
- "addresses"
- "name"
- "registrationDate"
- "registrationNumber"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип бенефициара:\n* `FL_RESIDENT` — физическое лицо, резид\
ент.\n* `FL_NONRESIDENT` — физическое лицо, нерезидент.\n* `UL_RESIDENT`\
\ — юридическое лицо, резидент.\n* `UL_NONRESIDENT` — юридическое лицо\
, нерезидент.\n* `IP_RESIDENT` — ИП, резидент.\n* `IP_NONRESIDENT` — И\
П, нерезидент.\n* `LITE_CONTACT` — легкий контакт."
enum:
- "FL_RESIDENT"
- "FL_NONRESIDENT"
- "UL_RESIDENT"
- "UL_NONRESIDENT"
- "IP_RESIDENT"
- "IP_NONRESIDENT"
- "LITE_CONTACT"
name:
type: "string"
description: "Наименование организации."
phoneNumber:
pattern: "^((\\+[0-9])([0-9]){6,14})$"
type: "string"
description: "Номер телефона. phoneNumber или email обязателен к заполне\
нию."
email:
type: "string"
description: "Электронная почта. phoneNumber или email обязателен к запо\
лнению."
addresses:
minItems: 1
type: "array"
description: "Адреса."
items:
$ref: "#/components/schemas/Address"
nza:
type: "string"
description: "Номер записи об аккредитации."
registrationDate:
type: "string"
description: "Дата регистрации."
format: "date"
registrationNumber:
type: "string"
description: "Номер регистрации."
opf:
type: "string"
description: "Организационно-правовая форма."
inn:
pattern: "^(\\d{10})$"
type: "string"
description: "ИНН."
kio:
type: "string"
description: "Код иностранной организации. Обязателен, если ИНН не задан\
."
ApplicationStatus:
type: "string"
description: "Статус заявки."
enum:
- "IN_PROGRESS"
- "DONE"
ReissueVirtualCardRequest:
required:
- "ucid"
type: "object"
properties:
ucid:
type: "integer"
description: "Уникальный идентификатор карты."
format: "int64"
ReadyAddCardRequestResponse:
required:
- "addCardRequestId"
- "bankDetailsId"
- "beneficiaryId"
- "status"
- "terminalKey"
type: "object"
properties:
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
addCardRequestId:
type: "string"
description: "Идентификатор запроса на добавление карты."
terminalKey:
maxLength: 256
minLength: 1
type: "string"
description: "Ключ терминала."
status:
type: "string"
description: "Статус запроса на добавление карты:\n* `PENDING` — карта в\
\ процессе добавления.\n* `READY` — карта успешно добавлена.\n* `FAILED`\
\ — не удалось добавить карту."
enum:
- "PENDING"
- "READY"
- "FAILED"
bankDetailsId:
type: "string"
description: "Идентификатор банковских реквизитов."
format: "uuid"
DiplomaticPassport:
required:
- "date"
- "number"
- "organization"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип документа."
enum:
- "PASSPORT"
- "FOREIGN_PASSPORT"
- "FOREIGN_PASSPORT_OF_FOREIGN_CITIZENS"
- "OFFICIAL_PASSPORT"
- "DIPLOMATIC_PASSPORT"
- "MIGRATION_CARD"
- "TEMPORARY_RESIDENCE_PERMIT"
- "VISA"
- "RESIDENCE_PERMIT"
- "CONTRACT"
- "CONTRACT_GPD"
- "PATENT"
number:
type: "string"
description: "Номер документа."
date:
type: "string"
description: "Дата выдачи."
format: "date"
organization:
type: "string"
description: "Кем выдан."
SbpBankDetails:
required:
- "bankId"
- "phoneNumber"
- "terminalKey"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип банковских реквизитов:\n* `PAYMENT_DETAILS` — По рекви\
зитам счета.\n* `CARD` — На карту.\n* `SBP` — Через СБП."
enum:
- "PAYMENT_DETAILS"
- "CARD"
- "SBP"
phoneNumber:
pattern: "^((\\+7)([0-9]){10})$"
type: "string"
description: "Номер мобильного телефона."
bankId:
pattern: "^\\d{12}$"
type: "string"
description: "Идентификатор банка в системе быстрых платежей."
terminalKey:
maxLength: 256
minLength: 1
type: "string"
description: "Ключ терминала."
CreateDocument:
required:
- "date"
- "organization"
- "serial"
- "type"
type: "object"
properties:
type:
$ref: "#/components/schemas/DocumentType"
serial:
type: "string"
description: "Серия."
number:
type: "string"
description: "Номер документа."
date:
type: "string"
description: "Дата."
format: "date"
organization:
type: "string"
description: "Кем выдан."
division:
type: "string"
description: "Код подразделения."
expireDate:
type: "string"
description: "Дата истечения."
format: "date"
AccountOperationType:
type: "string"
description: "Тип операции"
enum:
- "debit"
- "credit"
DealRequest:
required:
- "accountNumber"
type: "object"
properties:
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер номинального счета."
BeneficiaryScoringInfoListResponseV2:
required:
- "limit"
- "offset"
- "size"
- "total"
type: "object"
properties:
offset:
type: "integer"
description: "Запрошенное количество результатов проверки для пропуска."
format: "int32"
limit:
type: "integer"
description: "Запрошенное количество результатов проверки для вывода."
format: "int32"
size:
type: "integer"
description: "Количество результатов проверки в ответе."
format: "int32"
total:
type: "integer"
description: "Всего результатов проверки, подходящих под условия запроса\
."
format: "int32"
results:
type: "array"
description: "Список результатов проверки."
items:
$ref: "#/components/schemas/BeneficiaryScoringInfoV2"
EmployeeResponse:
type: "object"
properties:
employees:
type: "array"
description: "Список сотрудников."
items:
$ref: "#/components/schemas/Employee"
SubmissionStatus1:
type: "string"
description: "Статус подписания платежного реестра."
enum:
- "ACCEPTED"
- "ERROR"
- "IN_PROGRESS"
SUCCEEDED:
required:
- "beneficiaryId"
- "status"
type: "object"
properties:
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
status:
type: "string"
description: "Статус проверки в финансовом мониторинге."
enum:
- "IN_PROGRESS"
- "SUCCEEDED"
- "FAILED"
warnings:
type: "array"
items:
$ref: "#/components/schemas/BeneficiaryScoringError"
Document1:
required:
- "type"
type: "object"
properties:
type:
$ref: "#/components/schemas/DocumentType1"
serial:
type: "string"
description: "Серия."
number:
type: "string"
description: "Номер документа."
date:
type: "string"
description: "Дата."
format: "date"
organization:
type: "string"
description: "Кем выдан."
division:
type: "string"
description: "Код подразделения."
expireDate:
type: "string"
description: "Дата истечения."
format: "date"
CreationEmployedStatus:
type: "string"
description: "Статус создания:QUEUED
— сотрудник\
\ стоит в очереди на создание.CREATED
— сотрудник с\
оздан в зарплатном проекте.ERROR
— сотрудник не был\
\ создан в зарплатном проекте. Ошибки перечислены в параметре errors.0
. Во всех остальных сл\
учаях передавайте фактический ИНН получателя."
kpp:
pattern: "^(\\d{9}|0)$"
type: "string"
description: "КПП получателя. Если у получателя платежа нет КПП, наприме\
р, это физ. лицо или ИП, передайте 0
."
bankAcnt:
type: "string"
description: "Номер счета получателя."
bankBik:
type: "string"
description: "БИК банка."
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета для списания."
paymentPurpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
executionOrder:
maximum: 5
minimum: 1
type: "integer"
description: "Очередность платежа."
format: "int32"
deprecated: true
taxPayerStatus:
type: "string"
description: "Статус составителя расчетного документа. Поле платежки 101.\
\ Если платеж не бюджетный, передайте 0
."
kbk:
type: "string"
description: "Код бюджетной классификации. Поле платежки 104. Если плате\
ж не бюджетный или КБК отсутствует, передайте 0
."
oktmo:
type: "string"
description: "Код ОКТМО территории, на которой мобилизуются денежные сре\
дства от уплаты налога, сбора и иного платежа. Если платеж не бюджетны\
й, передайте 0
."
taxEvidence:
type: "string"
description: "Основание налогового платежа. Поле платежки 106. Если плат\
еж не бюджетный или основание неизвестно, передайте 0
."
taxPeriod:
type: "string"
description: "Налоговый период. Поле платежки 107. Формат — ДД.ММ.ГГГГ,\
\ первые два символа могут быть буквами. Если платеж не бюджетный или\
\ период отсутствует, передайте 0
."
uin:
type: "string"
description: "Уникальный идентификатор платежа. Если платеж не бюджетный\
, передайте 0
."
taxDocNumber:
type: "string"
description: "Номер налогового документа. Поле платежки 108. Если платеж\
\ не бюджетный или задолженность оплачивается в добровольном порядке,\
\ передайте 0
."
taxDocDate:
type: "string"
description: "Дата налогового документа. Поле платежки 109. Формат — ДД\
.ММ.ГГГГ. Если платеж не бюджетный или дата отсутствует, передайте 0
."
revenueTypeCode:
type: "string"
description: "Код вида выплаты. Обязательное поле для платежей в пользу\
\ физ. лиц. Подробнее."
enum:
- "1"
- "2"
- "3"
- "4"
- "5"
collectionAmountNumber:
type: "number"
description: "Удержанная сумма из заработной платы и иных доходов работн\
ика в рублях. Подробнее\
."
recipientCorrAccountNumber:
type: "string"
description: "Корреспондентский счет банка получателя. Для налогового пл\
атежа обязательно указывается номер счета банка получателя средств — н\
омер банковского счета, который входит в состав единого казначейского\
\ счета (ЕКС)."
thirdParty:
$ref: "#/components/schemas/ThirdPartyInfo"
ReceiptOperationStatus:
type: "string"
description: "Статус операции."
enum:
- "IN_PROGRESS"
- "SUCCESS"
- "FAILED"
CreateSelfEmployedData:
required:
- "birthDate"
- "birthPlace"
- "citizenship"
- "firstName"
- "lastName"
- "number"
type: "object"
properties:
number:
type: "integer"
description: "Идентификатор самозанятого на стороне клиента."
format: "int32"
firstName:
type: "string"
description: "Имя (кириллица)."
lastName:
type: "string"
description: "Фамилия (кириллица)."
middleName:
type: "string"
description: "Отчество (кириллица)."
birthDate:
type: "string"
description: "Дата рождения."
format: "date"
birthPlace:
type: "string"
description: "Место рождения."
citizenship:
type: "string"
description: "Гражданство."
email:
type: "string"
description: "Электронная почта."
latinFirstName:
type: "string"
description: "Имя (латиница)."
latinLastName:
type: "string"
description: "Фамилия (латиница)."
phones:
type: "array"
description: "Мобильный телефон."
items:
$ref: "#/components/schemas/CreatePhone1"
addresses:
type: "array"
description: "Адреса места жительства и регистрации."
items:
$ref: "#/components/schemas/CreateAddress1"
documents:
type: "array"
description: "Для граждан РФ укажите данные паспорта.\n\n\nДля иностранн\
ых граждан укажите:\nZ
\
\ или +00:00
."
format: "date-time"
services:
type: "array"
description: "Список услуг."
items:
$ref: "#/components/schemas/ReceiptService"
customerOrganization:
type: "string"
description: "Название организации, которой самозанятый оказывал услуги."
CreateApplicationResponse:
required:
- "cardIssueApplicationId"
type: "object"
properties:
cardIssueApplicationId:
type: "string"
description: "ID заявки на выпуск виртуальной карты на сотрудника."
format: "uuid"
HoldListResponse:
required:
- "limit"
- "offset"
- "size"
- "total"
type: "object"
properties:
offset:
type: "integer"
description: "Запрошенное количество холдов для пропуска."
format: "int32"
limit:
type: "integer"
description: "Запрошенное количество холдов для вывода."
format: "int32"
size:
type: "integer"
description: "Количество холдов в ответе."
format: "int32"
total:
type: "integer"
description: "Всего холдов, подходящих под условия запроса."
format: "int32"
results:
type: "array"
description: "Список холдов."
items:
$ref: "#/components/schemas/HoldListItem"
EmployeesInfoRequest:
type: "object"
properties:
employeeIds:
type: "array"
description: "Идентификаторы сотрудников."
items:
type: "integer"
format: "int32"
CreatePaymentRegistryResultResponse:
required:
- "status"
type: "object"
properties:
paymentRegistryId:
type: "integer"
description: "Идентификатор платежного реестра"
format: "int32"
status:
$ref: "#/components/schemas/CreationRegistryStatus"
error:
required:
- "errorDescription"
- "fieldName"
type: "object"
properties:
fieldName:
type: "string"
description: "Название поля, в котором возникла ошибка, на русском я\
зыке."
errorDescription:
type: "string"
description: "Описание ошибки."
description: "Общая ошибка, произошедшая при создании реестра."
paymentErrors:
type: "array"
description: "Платежи внутри реестра, содержащие ошибки."
items:
$ref: "#/components/schemas/PaymentError"
CardIssueApplicationStatusResponse:
required:
- "cardIssueApplicationId"
- "status"
type: "object"
properties:
cardIssueApplicationId:
type: "string"
description: "Идентификатор заявки на выпуск бизнес-карты."
format: "uuid"
status:
$ref: "#/components/schemas/CardIssueApplicationStatus"
failedReason:
type: "string"
description: "Описание причины неуспешной обработки. Возвращается только\
\ для статусов `FAILED_NON_FATAL` и `FAILED_FATAL`."
ucid:
type: "integer"
description: "Идентификатор карты. Возвращается только для статуса `CARD_ISSUED`."
format: "int64"
DocumentResponse:
required:
- "fileName"
- "id"
- "mime"
- "size"
- "title"
type: "object"
properties:
id:
type: "string"
description: "ID документа."
format: "uuid"
title:
type: "string"
description: "Тип документа."
fileName:
type: "string"
description: "Название файла."
mime:
type: "string"
description: "Формат файла."
size:
type: "integer"
description: "Размер файла."
format: "int64"
Email:
type: "object"
properties:
email:
type: "string"
description: "Электронная почта."
ApiPDLResponse:
required:
- "isPublicOfficialPerson"
type: "object"
properties:
isPublicOfficialPerson:
type: "boolean"
description: "Является ли пользователь публичным должностным лицом."
BeneficiaryIpNonresidentResponse:
required:
- "beneficiaryId"
- "birthDate"
- "citizenship"
- "firstName"
- "lastName"
- "registrationDate"
- "type"
type: "object"
properties:
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
type:
type: "string"
description: "Тип бенефициара:\n* `FL_RESIDENT` — физическое лицо, резид\
ент.\n* `FL_NONRESIDENT` — физическое лицо, нерезидент.\n* `UL_RESIDENT`\
\ — юридическое лицо, резидент.\n* `UL_NONRESIDENT` — юридическое лицо\
, нерезидент.\n* `IP_RESIDENT` — ИП, резидент.\n* `IP_NONRESIDENT` — И\
П, нерезидент.\n* `LITE_CONTACT` — легкий контакт."
enum:
- "FL_RESIDENT"
- "FL_NONRESIDENT"
- "UL_RESIDENT"
- "UL_NONRESIDENT"
- "IP_RESIDENT"
- "IP_NONRESIDENT"
- "LITE_CONTACT"
firstName:
type: "string"
description: "Имя."
middleName:
type: "string"
description: "Отчество."
lastName:
type: "string"
description: "Фамилия."
birthDate:
type: "string"
description: "Дата рождения."
format: "date"
birthPlace:
type: "string"
description: "Место рождения."
citizenship:
pattern: "^([A-Z]{2})$"
type: "string"
description: "Гражданство. Код страны в формате `ISO 3166-1 alpha-2`."
phoneNumber:
pattern: "^((\\+[0-9])([0-9]){6,14})$"
type: "string"
description: "Номер телефона."
email:
type: "string"
description: "Электронная почта."
documents:
type: "array"
description: "Документы."
items:
$ref: "#/components/schemas/Document2"
addresses:
type: "array"
description: "Адреса."
items:
$ref: "#/components/schemas/Address"
registrationDate:
type: "string"
description: "Дата регистрации."
format: "date"
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
ogrn:
pattern: "^(\\d{15})$"
type: "string"
description: "Основной государственный регистрационный номер."
CreateSelfEmployed:
required:
- "firstName"
- "lastName"
- "number"
- "status"
type: "object"
properties:
number:
type: "integer"
description: "Номер самозанятого, переданный клиентом при создании."
format: "int32"
recipientId:
type: "integer"
description: "Идентификатор самозанятого. Может не прийти, если при созд\
ании самозанятого возникли ошибки."
format: "int32"
firstName:
type: "string"
description: "Имя."
lastName:
type: "string"
description: "Фамилия."
middleName:
type: "string"
description: "Отчество."
status:
$ref: "#/components/schemas/CreationSelfEmployedStatus"
errors:
type: "array"
description: "Список ошибок."
items:
$ref: "#/components/schemas/FieldValidationError"
EmployedSubmitPaymentError:
required:
- "number"
type: "object"
properties:
number:
type: "integer"
description: "Идентификатор платежа, переданный клиентом при создании."
format: "int32"
accountNumber:
type: "string"
description: "Номер счета сотрудника."
errors:
type: "array"
description: "Ошибки валидации."
items:
required:
- "errorDescription"
- "fieldName"
type: "object"
properties:
fieldName:
type: "string"
description: "Название поля, в котором возникла ошибка, на русском\
\ языке."
errorDescription:
type: "string"
description: "Описание ошибки."
SelfEmployedCreatePaymentRegistryRequest:
required:
- "correlationId"
type: "object"
properties:
correlationId:
type: "string"
description: "Идентификатор, связывающий запрос создания с запросом полу\
чения ответа."
format: "uuid"
companyAccountNumber:
type: "string"
description: "\nНомер счета компании, с которого будут списаны деньги дл\
я оплаты реестра — при наличии РКО в Т-Банке.true
— Т-Банк переведет 6% от сум\
мы платежа на налоговую копилку для последующей оплаты налогов;false
— самозанятый получит полную сумму и налог удер\
жан не будет.false
."
incomeType:
$ref: "#/components/schemas/SelfEmployedIncomeType"
SetLimitRequest:
required:
- "limitPeriod"
- "limitValue"
type: "object"
properties:
limitValue:
maximum: 1000000000000
exclusiveMaximum: true
minimum: 0
type: "number"
description: "Величина лимита в валюте счета, к которому привязана карта\
. До двух дробных знаков."
limitPeriod:
$ref: "#/components/schemas/InputLimitPeriod"
BankInfo:
required:
- "bik"
- "corAccount"
- "name"
type: "object"
properties:
bik:
pattern: "\\d{9}"
type: "string"
description: "БИК."
corAccount:
pattern: "\\d{20}"
type: "string"
description: "Корреспондентский счет."
name:
maxLength: 255
minLength: 1
type: "string"
description: "Наименование банка."
description: "Информация о банке."
CreatePaymentRegistryResponse:
required:
- "correlationId"
type: "object"
properties:
correlationId:
type: "string"
description: "Идентификатор, связывающий запрос создания с запросом полу\
чения ответа."
format: "uuid"
PayStatus:
type: "string"
description: "Статус платежа."
enum:
- "IN_PROGRESS"
- "EXECUTED"
- "ERROR"
- "SENT"
SelfEmployedPaymentInfo:
required:
- "selfEmployedInfo"
- "status"
- "sum"
type: "object"
properties:
number:
type: "integer"
description: "Идентификатор платежа на стороне клиента. Не возвращается\
, если платежный реестр был создан через личный кабинет."
format: "int32"
status:
$ref: "#/components/schemas/PaymentInfoRegistryStatus1"
selfEmployedInfo:
required:
- "firstName"
- "lastName"
type: "object"
properties:
firstName:
type: "string"
description: "Имя (кириллица)."
lastName:
type: "string"
description: "Фамилия (кириллица)."
middleName:
type: "string"
description: "Отчество (кириллица)."
description: "Данные самозанятого."
accountNumber:
type: "string"
description: "Номер счета самозанятого."
paymentPurpose:
type: "string"
description: "Назначение платежа."
sum:
type: "number"
description: "Сумма платежа."
revenueTypeCode:
type: "string"
description: "Код вида дохода."
enum:
- "1"
- "2"
- "3"
- "4"
- "5"
collectionAmount:
type: "number"
description: "Удержанная сумма."
CreateMeetingResponse:
required:
- "meetingId"
type: "object"
properties:
meetingId:
type: "string"
description: "Идентификатор назначенной встречи"
CardInfoSeqResponse:
required:
- "limit"
- "offset"
- "totalNumber"
type: "object"
properties:
cards:
type: "array"
description: "Список карт компании."
items:
$ref: "#/components/schemas/CardInfoResponse"
offset:
type: "integer"
description: "Количество пропущенных карт."
format: "int32"
limit:
type: "integer"
description: "Количество карт на странице."
format: "int32"
totalNumber:
type: "integer"
description: "Общее количество карт."
format: "int32"
CreateJobInfo:
required:
- "position"
type: "object"
properties:
position:
type: "string"
description: "Должность."
description: "Информация о работе."
Phone1:
required:
- "type"
type: "object"
properties:
type:
$ref: "#/components/schemas/PhoneType1"
number:
type: "string"
description: "Номер телефона."
BeneficiaryIpNonresidentRequest:
required:
- "addresses"
- "birthDate"
- "citizenship"
- "documents"
- "firstName"
- "inn"
- "lastName"
- "registrationDate"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип бенефициара:\n* `FL_RESIDENT` — физическое лицо, резид\
ент.\n* `FL_NONRESIDENT` — физическое лицо, нерезидент.\n* `UL_RESIDENT`\
\ — юридическое лицо, резидент.\n* `UL_NONRESIDENT` — юридическое лицо\
, нерезидент.\n* `IP_RESIDENT` — ИП, резидент.\n* `IP_NONRESIDENT` — И\
П, нерезидент.\n* `LITE_CONTACT` — легкий контакт."
enum:
- "FL_RESIDENT"
- "FL_NONRESIDENT"
- "UL_RESIDENT"
- "UL_NONRESIDENT"
- "IP_RESIDENT"
- "IP_NONRESIDENT"
- "LITE_CONTACT"
firstName:
type: "string"
description: "Имя."
middleName:
type: "string"
description: "Отчество."
lastName:
type: "string"
description: "Фамилия."
birthDate:
type: "string"
description: "Дата рождения."
format: "date"
birthPlace:
type: "string"
description: "Место рождения."
citizenship:
pattern: "^([A-Z]{2})$"
type: "string"
description: "Гражданство. Код страны в формате `ISO 3166-1 alpha-2`."
phoneNumber:
pattern: "^((\\+[0-9])([0-9]){6,14})$"
type: "string"
description: "Номер телефона. phoneNumber или email обязателен к заполне\
нию."
email:
type: "string"
description: "Электронная почта. phoneNumber или email обязателен к запо\
лнению."
documents:
minItems: 1
type: "array"
description: "\nДокументы. Обязательно — минимум 2 документа. Основной д\
окумент нерезидента РФ в большинстве случаев — `FOREIGN_PASSPORT`. Вто\
рой документ — любой из документов, подтверждающих право на пребывание\
\ в РФ. Подробнее о документах.\n\n\n Для нерезидентов с гражданством BY\
\ достаточно 1 документа с типом `FOREIGN_PASSPORT`\n"
items:
$ref: "#/components/schemas/Document2"
addresses:
minItems: 1
type: "array"
description: "Адреса."
items:
$ref: "#/components/schemas/Address"
registrationDate:
type: "string"
description: "Дата регистрации."
format: "date"
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
ogrn:
pattern: "^(\\d{15})$"
type: "string"
description: "Основной государственный регистрационный номер."
BeneficiaryListResponse:
required:
- "limit"
- "offset"
- "size"
- "total"
type: "object"
properties:
offset:
type: "integer"
description: "Запрошенное количество бенефициаров для пропуска."
format: "int32"
limit:
type: "integer"
description: "Запрошенное количество бенефициаров для вывода."
format: "int32"
size:
type: "integer"
description: "Количество бенефициаров в ответе."
format: "int32"
total:
type: "integer"
description: "Всего бенефициаров у компании."
format: "int32"
results:
type: "array"
description: "Список бенефициаров."
items:
$ref: "#/components/schemas/BeneficiaryResponse"
FieldValidationError1:
required:
- "errorDescription"
- "fieldName"
type: "object"
properties:
fieldName:
type: "string"
description: "Название поля с ошибкой."
errorDescription:
type: "string"
description: "Описание ошибки."
PaymentRegistryStatus1:
type: "string"
description: "Статус платежного реестра://
. "
corrAccountNumber:
pattern: "\\d{20}"
type: "string"
description: "Корреспондентский счет банка получателя.\n\n\nС 1 января 2021\
\ года при уплате налогов указывается номер счета банка получателя, вх\
одящий в состав единого казначейского счета (ЕКС). Раньше это поле зап\
олнялось нулями. "
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета. ВАЖНО: Для бюджетных платежей с 01.01.2021\
\ в данном поле нужно указывать новые номера казначейских счетов."
description: "Реквизиты получателя платежа."
CreatePaymentRegistryRequest:
required:
- "correlationId"
type: "object"
properties:
correlationId:
type: "string"
description: "Идентификатор, связывающий запрос создания с запросом полу\
чения ответа."
format: "uuid"
companyAccountNumber:
type: "string"
description: "\nНомер счета компании, с которого будут списаны деньги дл\
я оплаты реестра (при наличии РКО в Т-Банке).fnsLink
.fnsLink
.ACCEPTED
."
format: "int32"
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета для списания."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
documentNumber:
minimum: 1
type: "integer"
description: "Номер распоряжения, определяемый клиентом. Заполняется на\
\ усмотрение плательщика. Номер документа — не больше 6 цифр. "
format: "int32"
executionOrder:
maximum: 5
minimum: 1
type: "integer"
description: "Очередность платежа."
format: "int32"
deprecated: true
dueDate:
type: "string"
description: "Дата, до которой нужно провести платеж. При неуспешных поп\
ытках платежа он будет повторен вплоть до указанной даты. Если дату не\
\ передать, платеж не будет повторен в случае неуспешной попытки. Врем\
я на проведение платежа не может быть больше 30 дней."
format: "date-time"
meta:
type: "object"
additionalProperties:
type: "string"
description: "Дополнительные метаданные в формате JSON. Сохраняются при\
\ создании платежа и возвращаются при получении статуса."
ApplicationResult:
type: "string"
description: "Результат по заявке со статусом DONE."
enum:
- "REGISTERED"
- "DEREGISTERED"
- "REGISTRATION_DENIED"
- "DEREGISTRATION_DENIED"
- "DEREGISTRATION_ERROR"
- "REGISTRATION_ERROR"
TaxReturnReasonResponse:
required:
- "title"
type: "object"
properties:
title:
type: "string"
description: "Название группы налоговых вычетов."
options:
maxItems: 100
type: "array"
description: "Детализация налоговых вычетов в рамках группы."
items:
$ref: "#/components/schemas/OptionResponse"
BeneficiaryResponse:
oneOf:
- $ref: "#/components/schemas/BeneficiaryFlNonresidentResponse"
- $ref: "#/components/schemas/BeneficiaryFlResidentResponse"
- $ref: "#/components/schemas/BeneficiaryIpNonresidentResponse"
- $ref: "#/components/schemas/BeneficiaryIpResidentResponse"
- $ref: "#/components/schemas/BeneficiaryLiteContactResponse"
- $ref: "#/components/schemas/BeneficiaryUlNonresidentResponse"
- $ref: "#/components/schemas/BeneficiaryUlResidentResponse"
Vat:
type: "string"
description: "НДС. `None` — без НДС."
enum:
- "None"
- "0"
- "10"
- "18"
- "20"
Info:
required:
- "oktmo"
- "registeredAt"
type: "object"
properties:
registeredAt:
type: "string"
description: "Дата и время последней постановки на учет в UTC. Возвращае\
тся в формате ISO-8601."
format: "date-time"
activityCodes:
type: "array"
description: "Виды деятельности, которые самозанятый указал при регистра\
ции."
items:
type: "string"
oktmo:
type: "string"
description: "Регион деятельности самозанятого."
permissions:
type: "array"
description: "Список прав, которые самозанятый выдал Т-Банку."
items:
$ref: "#/components/schemas/PermissionTypeEnum"
CreationSelfEmployedStatus:
type: "string"
description: "\nСтатус создания:\n\nQUEUED
— самозаняты\
й стоит в очереди на создание;CREATED
— самозаняты\
й создан;ERROR
— самозанятый не был создан. Ошибки\
\ перечислены в параметре errors.ACTIVE
— получ\
атель самозанятый, привязан к Т-Банку. Доступны выплаты с чеками.NOT_ACTIVE
\
\ — получатель не самозанятый или не привязан к Т-Банку. Выплаты с чеками\
\ недоступны.REGISTRATION_WAIT
— получатель ожидает\
\ постановки на учет в качестве самозанятого. Статус возможен в случае, ес\
ли в методе создания самозанятого было передано значение registrationInfo
.NOT_CONFIRM
\
\ — статус самозанятости неизвестен.01
— налогоплательщик (плательщик сборов)\
\ — юрлицо; 02
— налоговый агент; 08
— плательщик-юрлицо (ИП), осуществляющий уплату стра\
ховых взносов и иных платежей в бюджетную систему РФ; 13
\
\ — физическое лицо, уплачивающее налоги, сборы за совершение налоговы\
ми органами юридически значимых действий, страховые взносы и иные плат\
ежи, администрируемые налоговыми органами; 14
\
\ — указывается плательщиком, который осуществляет транзакции в пользу\
\ физлиц; 19
— организации и их филиалы, пере\
числяющие средства, удержанные из заработной платы (дохода) должника —\
\ физлица в счет погашения задолженности по платежам в бюджет на основ\
ании исполнительного документа; 24
— плательщ\
ик-физлицо, осуществляющий уплату страховых взносов и иных платежей в\
\ бюджетную систему РФ. ТП
— платежи текущ\
его года; ЗД
— добровольное погашение задолже\
нности по истекшим налоговым, расчетным (отчетным) периодам при отсутс\
твии требования налогового органа об уплате налогов (сборов); РС
— погашение рассроченной задолженности; ОТ
— погашение отсроченной задолженности; Р\
Т
— погашение реструктурируемой задолженности; П\
Б
— погашение должником задолженности в ходе процедур, применяе\
мых в деле о банкротстве; ИН
— погашение инве\
стиционного налогового кредита; ТЛ
— погашени\
е учредителем (участником) должника или собственником имущества должни\
ка — унитарного предприятия или третьим лицом задолженности в ходе про\
цедур, применяемых в деле о банкротстве; ЗТ
—\
\ погашение текущей задолженности в ходе процедур, применяемых в деле\
\ о банкротстве; 00
— иные случаи (для таможе\
нных платежей); 0
— при незнании основания пл\
атежа. IN_PROGRESS
\
\ — проверка в процессе, проверьте результат через некоторое время."
enum:
- "READY"
- "IN_PROGRESS"
BeneficiaryFlResidentResponse:
required:
- "beneficiaryId"
- "birthDate"
- "firstName"
- "isSelfEmployed"
- "lastName"
- "type"
type: "object"
properties:
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
type:
type: "string"
description: "Тип бенефициара:\n* `FL_RESIDENT` — физическое лицо, резид\
ент.\n* `FL_NONRESIDENT` — физическое лицо, нерезидент.\n* `UL_RESIDENT`\
\ — юридическое лицо, резидент.\n* `UL_NONRESIDENT` — юридическое лицо\
, нерезидент.\n* `IP_RESIDENT` — ИП, резидент.\n* `IP_NONRESIDENT` — И\
П, нерезидент.\n* `LITE_CONTACT` — легкий контакт."
enum:
- "FL_RESIDENT"
- "FL_NONRESIDENT"
- "UL_RESIDENT"
- "UL_NONRESIDENT"
- "IP_RESIDENT"
- "IP_NONRESIDENT"
- "LITE_CONTACT"
firstName:
type: "string"
description: "Имя."
middleName:
type: "string"
description: "Отчество."
lastName:
type: "string"
description: "Фамилия."
isSelfEmployed:
type: "boolean"
description: "Самозанятый."
birthDate:
type: "string"
description: "Дата рождения."
format: "date"
birthPlace:
type: "string"
description: "Место рождения."
citizenship:
pattern: "^([A-Z]{2})$"
type: "string"
description: "Гражданство. Код страны в формате `ISO 3166-1 alpha-2`."
phoneNumber:
pattern: "^((\\+[0-9])([0-9]){6,14})$"
type: "string"
description: "Номер телефона."
email:
type: "string"
description: "Электронная почта почта."
documents:
type: "array"
description: "Документы."
items:
$ref: "#/components/schemas/Document2"
addresses:
type: "array"
description: "Адреса."
items:
$ref: "#/components/schemas/Address"
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
snils:
pattern: "^(\\d{11})$"
type: "string"
description: "СНИЛС."
EmployeesResponse:
required:
- "firstName"
- "lastName"
- "number"
- "status"
type: "object"
properties:
number:
type: "integer"
description: "Номер сотрудника, переданный клиентом при создании."
format: "int32"
employeeId:
type: "integer"
description: "Идентификатор сотрудника в зарплатном проекте. Может не пр\
ийти, если при создании сотрудника возникли ошибки."
format: "int32"
firstName:
type: "string"
description: "Имя."
lastName:
type: "string"
description: "Фамилия."
middleName:
type: "string"
description: "Отчество."
status:
$ref: "#/components/schemas/CreationEmployedStatus"
errors:
type: "array"
description: "Список ошибок."
items:
required:
- "errorDescription"
- "fieldName"
type: "object"
properties:
fieldName:
type: "string"
description: "Название поля, в котором возникла ошибка, на русском\
\ языке."
errorDescription:
type: "string"
description: "Описание ошибки."
SelfEmployedIncomeType:
type: "string"
description: "\nМожет принимать одно из двух значений:\n5
.\n\n\n\
1
— алиментные удержания из заработной платы, компенсации\
\ вреда жизни и здоровью. Основания для уплаты — алиментный договор, з\
аверенный у нотариуса, судебный приказ, исполнительный лист от судебны\
х приставов.\n\n2
— погашение задолженностей по зарплата\
м сотрудникам, выплаты выходных пособий и авторских вознаграждений. Ос\
нование для уплаты — исполнительный лист, судебный приказ.\n\n3
\
\ — выплаты зарплат сотрудникам по трудовым соглашениям, принудительна\
я уплата налогов и отчислений во внебюджетные фонды. Основание для упл\
аты — расчетная документация, платежные требования и инкассовые поруче\
ния от ИФНС, ФСС, ПФР.\n\n4
— принудительные выплаты, кот\
орые не вошли в первую, вторую и третью очередь, например задолженност\
и по договорам, штрафы, неустойки, коммунальные платежи. Основание для\
\ уплаты — исполнительные документы, требования, постановления, приказ\
ы, судебные решения.\n\n5
— все остальные, не вошедшие в\
\ первую, вторую, третью и четвертую категории — например, добровольна\
я уплата долгов, пеней, штрафов.\n\nПодробнее"
format: "int32"
amount:
type: "number"
description: "Сумма платежа в рублях."
dueDate:
type: "string"
description: "Дата, до которой нужно провести платеж. При неуспешных поп\
ытках платежа он будет повторен вплоть до указанной даты. Если дату не\
\ передать, платеж не будет повторен в случае неуспешной попытки. Врем\
я на проведение платежа не может быть больше 30 дней."
format: "date-time"
revenueTypeCode:
type: "string"
description: "Код вида выплаты. Подробнее."
enum:
- "1"
- "2"
- "3"
- "4"
- "5"
collectionAmount:
type: "number"
description: "Удержанная сумма из заработной платы и иных доходов работн\
ика в рублях. Подробнее\
."
meta:
type: "object"
additionalProperties:
type: "string"
description: "Дополнительные метаданные в формате JSON. Сохраняются при\
\ создании платежа и возвращаются при получении статуса."
PaymentRegistryResponse:
required:
- "paymentsCount"
- "status"
- "totalSum"
type: "object"
properties:
status:
$ref: "#/components/schemas/PaymentRegistryStatus"
companyAccountNumber:
type: "string"
description: "\nНомер счета компании, с которого будут списаны деньги дл\
я оплаты реестра — при наличии РКО в Т-Банке.DRAFT
, ACCEPTED
, PART_EXEC
\
\ или EXECUTED
."
format: "int32"
description: "Данные сотрудника, находящегося в статусах `ACTIVE` или `FIRED`."
sum:
type: "number"
description: "Сумма платежа."
periodStart:
type: "string"
description: "Начало периода платежа."
format: "date"
periodEnd:
type: "string"
description: "Окончание периода платежа."
format: "date"
revenueTypeCode:
type: "string"
description: "Код вида дохода."
enum:
- "1"
- "2"
- "3"
- "4"
- "5"
collectionAmount:
type: "number"
description: "Удержанная сумма."
CreateApplicationRequest:
required:
- "accountNumber"
- "cardNetwork"
- "employeeIdentificationApplicationId"
type: "object"
properties:
employeeIdentificationApplicationId:
type: "string"
description: "ID заявки на удаленную идентификацию сотрудника."
format: "uuid"
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер счета, к которому выпускается карта."
cardNetwork:
$ref: "#/components/schemas/CardNetwork"
EmployeeStatus:
type: "string"
description: "Статус сотрудника:BLLE
\
\ — первичная блокировка договора ЮЛ. Находится в этом статусе до моме\
нта активации (переход в NORM) или закрытия (переход в CLSC/CLSB).ARSS
\
\ — частичный арест.ARSF
— полный арест.ARMF
\
\ — полная блокировка.CAIN
— картотека.CLBL
\
\ — в процессе закрытия.CLSC
— закрыт по инициат\
иве клиента.CLSB
— закрыт по инициативе банка.Z
\
\ или +00:00
."
format: "date-time"
services:
type: "array"
description: "Список услуг."
items:
$ref: "#/components/schemas/ReceiptService"
customerInn:
pattern: "^(\\d{10})$"
type: "string"
description: "ИНН покупателя-компании."
customerOrganization:
type: "string"
description: "Название организации, которой самозанятый оказывал услуги."
Application:
required:
- "changedAt"
- "status"
type: "object"
properties:
status:
$ref: "#/components/schemas/ApplicationStatus"
subStatus:
$ref: "#/components/schemas/ApplicationSubStatus"
changedAt:
type: "string"
description: "Дата и время последнего изменения данных по заявке в UTC.\
\ Возвращается в формате ISO-8601."
format: "date-time"
result:
$ref: "#/components/schemas/ApplicationResult"
reason:
type: "string"
description: "Причина, по которой рассмотрение заявки не завершилось усп\
ехом. Может быть у заявок в статусе DONE."
reasonDescription:
type: "string"
description: "Более подробное описание причины неуспеха. Может быть у за\
явок в статусе DONE."
description: "Объект с информацией о последней заявке на изменение самозанят\
ости в Т-Банке. Изначально имеет статус IN_PROGRESS и переходит в DONE при\
\ завершении процесса (как успешном, так и с ошибкой). Если от пользовател\
я требуется выдать права в ЛК ФНС, то будет иметь subStatus PERMISSION_REQUESTED.\
\ После создания новой заявки — предыдущая исчезает. Нельзя завести новую\
\ заявку, если текущая IN_PROGRESS."
Recipient:
required:
- "inn"
type: "object"
properties:
inn:
pattern: "^(\\d{12}|\\d{10}|0{1})$"
type: "string"
description: "ИНН получателя."
name:
type: "string"
description: "Наименование получателя."
account:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Счет получателя."
description: "Информация о получателе."
CreateRegularPaymentRequest:
required:
- "accountNumber"
- "amount"
- "beneficiaryId"
- "purpose"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип платежа:\n* `REGULAR` — обычный.\n* `TAX` — налоговый."
enum:
- "REGULAR"
- "TAX"
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер номинального счета."
bankDetailsId:
type: "string"
description: "Идентификатор банковских реквизитов."
format: "uuid"
amount:
type: "number"
description: "Сумма платежа."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
BankDetails:
oneOf:
- $ref: "#/components/schemas/CardBankDetails"
- $ref: "#/components/schemas/RkcBankDetails"
- $ref: "#/components/schemas/SbpBankDetails"
TacqOperationResponse:
type: "object"
properties:
lastTransactionDate:
type: "string"
description: "Последняя дата совершения транзакции для выборки в UTC. Фо\
рмат — `yyyy-MM-ddTHH:mm:ssZ`."
format: "date-time"
operations:
type: "array"
description: "Список операций по терминалу."
items:
$ref: "#/components/schemas/Operation"
SelfEmployedReceiptsRequestStatus:
type: "string"
description: "Статус запроса на получение чеков."
enum:
- "FINISHED"
- "IN_PROGRESS"
- "ERROR"
AddressType:
type: "string"
description: "Тип адреса."
enum:
- "Жительства"
- "Регистрации"
- "Работы"
ListOfArrest:
required:
- "sum"
type: "object"
properties:
sum:
type: "number"
description: "Список блокировок."
values:
type: "array"
items:
$ref: "#/components/schemas/Arrest"
description: "Данные о блокировках."
JobInfo:
type: "object"
properties:
position:
type: "string"
description: "Должность."
description: "Информация о работе."
PaymentInfoRegistryStatus:
type: "string"
description: "Статус платежа:READY
— бенефициар у\
спешно проверен."
enum:
- "READY"
- "IN_PROGRESS"
CreateIndividualReceiptRequest:
required:
- "incomeType"
type: "object"
properties:
incomeType:
type: "string"
description: "От кого самозанятый получил доход:\n* `FROM_INDIVIDUAL` —\
\ от физического лица;\n* `FROM_LEGAL_ENTITY` — от компании;\n* `FROM_FOREIGN_AGENCY`\
\ — от иностранной компании."
enum:
- "FROM_INDIVIDUAL"
- "FROM_LEGAL_ENTITY"
- "FROM_FOREIGN_AGENCY"
incomeReceivedAt:
type: "string"
description: "Дата и время получения дохода в UTC. Ожидается в ISO-8601\
\ формате yyyy-MM-ddTHH:mm:ss<.fff>Z
или +00:00
."
format: "date-time"
services:
type: "array"
description: "Список услуг."
items:
$ref: "#/components/schemas/ReceiptService"
CreateAndSendInvoiceResponse:
required:
- "invoiceId"
- "pdfUrl"
type: "object"
properties:
pdfUrl:
type: "string"
description: "Ссылка на PDF выставленного счета. Действительна в течение\
\ 10 дней."
invoiceId:
type: "string"
description: "Идентификатор выставленного счета."
format: "uuid"
RecipientResponse:
required:
- "amount"
- "beneficiaryId"
- "dealId"
- "recipientId"
- "stepId"
type: "object"
properties:
dealId:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
stepId:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
recipientId:
type: "string"
description: "Идентификатор реципиента."
format: "uuid"
amount:
type: "number"
description: "Сумма реципиента."
tax:
type: "number"
description: "Налог реципиента."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
bankDetailsId:
type: "string"
description: "Идентификатор банковских реквизитов."
format: "uuid"
keepOnVirtualAccount:
type: "boolean"
description: "Вывод на виртуальный счет в рамках номинального счета — true
,\
\ на реальные реквизиты — false
.\n\nПри создании реципиен\
та без банковских реквизитов, платеж в рамках сделки автоматически буд\
ет выполнен на виртуальный счет бенефициара."
AuthStatus:
type: "string"
description: "Статус авторизации"
enum:
- "succeed"
- "cancelled"
CreateTaxPaymentRequest:
required:
- "accountNumber"
- "amount"
- "bankDetails"
- "beneficiaryId"
- "purpose"
- "tax"
- "type"
- "uin"
type: "object"
properties:
type:
type: "string"
description: "Тип платежа:\n* `REGULAR` — обычный.\n* `TAX` — налоговый."
enum:
- "REGULAR"
- "TAX"
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер номинального счета."
bankDetails:
$ref: "#/components/schemas/BankDetails"
amount:
type: "number"
description: "Сумма платежа."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
uin:
pattern: "0|[А-Яа-яA-Za-z0-9]{4}|[А-ЯA-Z0-9]{15}|[а-яА-Яa-zA-Z0-9№\\s!\"\
#$%;'()*+,-\\.\\/:;;=>?@\\]\\[\\\\\\^_`{|}~]{20}|[а-яА-Яa-zA-Z0-9№\\s!\"\
#$%;'()*+,-\\.\\/:;;=>?@\\]\\[\\\\\\^_`{|}~]{25}"
type: "string"
description: "Уникальный идентификатор платежа."
tax:
$ref: "#/components/schemas/TaxPaymentParameters"
BeneficiaryScoringInfoV2:
oneOf:
- $ref: "#/components/schemas/FAILED"
- $ref: "#/components/schemas/IN_PROGRESS"
- $ref: "#/components/schemas/SUCCEEDED"
Address1:
required:
- "country"
- "house"
- "region"
type: "object"
properties:
zipCode:
type: "string"
description: "Почтовый код."
country:
type: "string"
description: "Страна."
region:
type: "string"
description: "Регион."
district:
type: "string"
description: "Район."
city:
type: "string"
description: "Город."
settlement:
type: "string"
description: "Населенный пункт."
street:
type: "string"
description: "Улица."
house:
type: "string"
description: "Дом."
building:
type: "string"
description: "Строение."
apartment:
type: "string"
description: "Квартира."
description: "Адрес регистрации."
BeneficiaryFlNonresidentResponse:
required:
- "beneficiaryId"
- "birthDate"
- "citizenship"
- "firstName"
- "isSelfEmployed"
- "lastName"
- "type"
type: "object"
properties:
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
type:
type: "string"
description: "Тип бенефициара:\n* `FL_RESIDENT` — физическое лицо, резид\
ент.\n* `FL_NONRESIDENT` — физическое лицо, нерезидент.\n* `UL_RESIDENT`\
\ — юридическое лицо, резидент.\n* `UL_NONRESIDENT` — юридическое лицо\
, нерезидент.\n* `IP_RESIDENT` — ИП, резидент.\n* `IP_NONRESIDENT` — И\
П, нерезидент.\n* `LITE_CONTACT` — легкий контакт."
enum:
- "FL_RESIDENT"
- "FL_NONRESIDENT"
- "UL_RESIDENT"
- "UL_NONRESIDENT"
- "IP_RESIDENT"
- "IP_NONRESIDENT"
- "LITE_CONTACT"
firstName:
type: "string"
description: "Имя."
middleName:
type: "string"
description: "Отчество."
lastName:
type: "string"
description: "Фамилия."
isSelfEmployed:
type: "boolean"
birthDate:
type: "string"
description: "Дата рождения."
format: "date"
birthPlace:
type: "string"
description: "Место рождения."
citizenship:
pattern: "^([A-Z]{2})$"
type: "string"
description: "Гражданство. Код страны в формате `ISO 3166-1 alpha-2`."
phoneNumber:
pattern: "^((\\+[0-9])([0-9]){6,14})$"
type: "string"
description: "Номер телефона."
email:
type: "string"
description: "Электронная почта."
documents:
type: "array"
description: "Документы."
items:
$ref: "#/components/schemas/Document2"
addresses:
type: "array"
description: "Адреса."
items:
$ref: "#/components/schemas/Address"
inn:
pattern: "^(\\d{12})$"
type: "string"
description: "ИНН."
Arrest:
required:
- "amount"
- "currency"
- "date"
- "id"
- "status"
- "unblockDate"
type: "object"
properties:
id:
type: "string"
description: "Уникальный идентификатор."
externalId:
type: "string"
description: "Внешний идентификатор требования. Обеспечивается связь нес\
кольких блокировок."
amount:
type: "number"
description: "Сумма требования."
currency:
pattern: "^\\d{3}$"
type: "string"
description: "Код валюты по ОКВ."
status:
$ref: "#/components/schemas/EptArrestStatus"
date:
type: "string"
description: "Дата регистрации требования."
format: "date-time"
unblockDate:
type: "string"
description: "Дата отмены блокировки."
format: "date-time"
circumstances:
type: "string"
description: "Обстоятельства."
officeName:
type: "string"
description: "Наименование площадки."
SelfEmployedReceipt:
required:
- "number"
- "selfEmployedInfo"
- "status"
type: "object"
properties:
number:
type: "integer"
description: "Идентификатор платежа на стороне клиента."
format: "int32"
selfEmployedInfo:
required:
- "firstName"
- "lastName"
type: "object"
properties:
firstName:
type: "string"
description: "Имя (кириллица)."
lastName:
type: "string"
description: "Фамилия (кириллица)."
middleName:
type: "string"
description: "Отчество (кириллица)."
recipientId:
type: "integer"
description: "Идентификатор самозанятого."
format: "int32"
description: "Данные самозанятого."
link:
type: "string"
description: "Ссылка на чек."
status:
$ref: "#/components/schemas/SelfEmployedReceiptsStatus"
error:
required:
- "errorCode"
- "errorMessage"
type: "object"
properties:
errorCode:
type: "string"
description: "Код ошибки."
errorMessage:
type: "string"
description: "Описание ошибки."
description: "Ошибка во время получения чека."
RecipientListResponse:
required:
- "limit"
- "offset"
- "size"
- "total"
type: "object"
properties:
offset:
type: "integer"
description: "Запрошенное количество реципиентов для пропуска."
format: "int32"
limit:
type: "integer"
description: "Запрошенное количество реципиентов для вывода."
format: "int32"
size:
type: "integer"
description: "Количество реципиентов в ответе."
format: "int32"
total:
type: "integer"
description: "Всего реципиентов, подходящих под условия запроса."
format: "int32"
results:
type: "array"
description: "Список реципиентов этапа сделки."
items:
$ref: "#/components/schemas/RecipientResponse"
CobrandResponse:
required:
- "programStatus"
type: "object"
properties:
programStatus:
type: "boolean"
description: "`true/false` — признак наличия кобрэнда."
accounts:
type: "array"
description: "Список аккаунтов."
items:
$ref: "#/components/schemas/CobrandAccount"
BlockCardRequest:
required:
- "reason"
type: "object"
properties:
reason:
type: "string"
description: "Причина блокировки:\n* `LOST` — карта утеряна;\n* `STOLEN`\
\ — карта украдена;\n* `BROKEN` — карта повреждена;\n* `FRAUD` — мошен\
ничество;\n* `CLIENTINITIATED` — другая причина."
enum:
- "LOST"
- "STOLEN"
- "BROKEN"
- "FRAUD"
- "CLIENTINITIATED"
comment:
type: "string"
description: "Комментарий."
InvoicePayerInfo:
type: "object"
properties:
name:
maxLength: 512
minLength: 1
type: "string"
description: "Наименование плательщика."
inn:
pattern: "^(\\d{12}|\\d{10})$"
type: "string"
description: "ИНН плательщика."
kpp:
pattern: "^(\\d{9})$"
type: "string"
description: "КПП плательщика."
description: "Информация о плательщике."
PaymentInfo:
required:
- "employeeInfo"
- "status"
- "sum"
type: "object"
properties:
number:
type: "integer"
description: "Идентификатор платежа на стороне клиента."
format: "int32"
status:
$ref: "#/components/schemas/PaymentInfoRegistryStatus"
employeeInfo:
$ref: "#/components/schemas/EmployeeInfo"
accountNumber:
type: "string"
description: "Номер счета сотрудника."
paymentPurpose:
type: "string"
description: "Назначение платежа."
sum:
type: "number"
description: "Сумма платежа."
periodStart:
type: "string"
description: "Начало периода платежа."
format: "date"
periodEnd:
type: "string"
description: "Окончание периода платежа."
format: "date"
BalanceListItem:
required:
- "accountNumber"
- "amount"
- "amountOnHold"
- "beneficiaryId"
type: "object"
properties:
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер номинального счета."
amount:
type: "number"
description: "Текущий баланс бенефициара."
amountOnHold:
type: "number"
description: "Заблокированные средства бенефициара."
UpdateRecipientBankDetailsRequest:
required:
- "bankDetailsId"
type: "object"
properties:
bankDetailsId:
type: "string"
description: "Идентификатор банковских реквизитов."
format: "uuid"
CreateTaskRequest:
required:
- "template"
type: "object"
properties:
template:
type: "string"
description: "Шаблон, определяющий бизнес-логику задания."
commentForAgent:
type: "string"
description: "Комментарий к заданию для представителя."
parentTaskId:
type: "string"
description: "Идентификатор родительского задания."
meta:
type: "object"
additionalProperties:
type: "string"
description: "Дополнительные метаданные в формате JSON."
contacts:
type: "array"
description: "Группа объектов с информацией о данных каждого участника з\
адания, подлежащего удостоверению на встрече."
items:
$ref: "#/components/schemas/Contact"
StepRequest:
required:
- "description"
type: "object"
properties:
description:
maxLength: 4096
minLength: 3
type: "string"
description: "Описание этапа сделки."
DealResponse:
required:
- "accountNumber"
- "dealId"
- "status"
type: "object"
properties:
dealId:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер номинального счета."
status:
type: "string"
description: "Статус сделки. \n\n![payment-statuses](https://business.t-static.ru/static/images/opensme/nominal-accounts/deal-statuses.svg)\n\
* `DRAFT` — сделка создана и доступна для редактирования.\n* `ACCEPTED`\
\ — параметры сделки подтверждены, средства зарезервированы.\n* `IN_PROGRESS`\
\ — сделка в процессе.\n* `CANCELLED` — сделка отменена.\n* `COMPLETED`\
\ — сделка успешно завершена."
enum:
- "DRAFT"
- "ACCEPTED"
- "IN_PROGRESS"
- "CANCELLED"
- "COMPLETED"
Etp:
required:
- "amount"
- "bank"
- "currency"
- "date"
- "id"
- "payedAmount"
- "recipient"
- "senderInn"
- "status"
type: "object"
properties:
id:
type: "string"
description: "Уникальный идентификатор."
externalId:
type: "string"
description: "Внешний идентификатор требования. Обеспечивается связь нес\
кольких блокировок."
amount:
type: "number"
description: "Сумма требования."
currency:
pattern: "^\\d{3}$"
type: "string"
description: "Код валюты по ОКВ."
status:
$ref: "#/components/schemas/EptArrestStatus"
date:
type: "string"
description: "Дата регистрации требования."
format: "date-time"
payedAmount:
type: "number"
description: "Оплаченная сумма."
paymentPurpose:
type: "string"
description: "Назначение платежа."
senderInn:
pattern: "^(\\d{12}|\\d{10}|0{1})$"
type: "string"
description: "ИНН плательщика."
recipient:
$ref: "#/components/schemas/Recipient"
bank:
$ref: "#/components/schemas/Bank"
officeName:
type: "string"
description: "Наименование площадки."
BeneficiaryUlNonresidentResponse:
required:
- "beneficiaryId"
- "name"
- "registrationDate"
- "registrationNumber"
- "type"
type: "object"
properties:
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
type:
type: "string"
description: "Тип бенефициара:\n* `FL_RESIDENT` — физическое лицо, резид\
ент.\n* `FL_NONRESIDENT` — физическое лицо, нерезидент.\n* `UL_RESIDENT`\
\ — юридическое лицо, резидент.\n* `UL_NONRESIDENT` — юридическое лицо\
, нерезидент.\n* `IP_RESIDENT` — ИП, резидент.\n* `IP_NONRESIDENT` — И\
П, нерезидент.\n* `LITE_CONTACT` — легкий контакт."
enum:
- "FL_RESIDENT"
- "FL_NONRESIDENT"
- "UL_RESIDENT"
- "UL_NONRESIDENT"
- "IP_RESIDENT"
- "IP_NONRESIDENT"
- "LITE_CONTACT"
name:
type: "string"
description: "Наименование организации."
phoneNumber:
pattern: "^((\\+[0-9])([0-9]){6,14})$"
type: "string"
description: "Номер телефона."
email:
type: "string"
description: "Электронная почта."
addresses:
type: "array"
description: "Адреса."
items:
$ref: "#/components/schemas/Address"
nza:
type: "string"
description: "Номер записи об аккредитации."
registrationDate:
type: "string"
description: "Дата регистрации."
format: "date"
registrationNumber:
type: "string"
description: "Номер регистрации."
opf:
type: "string"
description: "Организационно-правовая форма."
inn:
pattern: "^(\\d{10})$"
type: "string"
description: "ИНН."
kio:
type: "string"
description: "Код иностранной организации."
SnilsResponse:
type: "object"
properties:
snils:
pattern: "^(\\d{11})$"
type: "string"
description: "СНИЛС."
Employee:
required:
- "bankInfo"
- "firstName"
- "id"
- "lastName"
- "status"
type: "object"
properties:
id:
type: "integer"
description: "Идентификатор сотрудника."
format: "int32"
status:
$ref: "#/components/schemas/EmployeeStatus"
firstName:
type: "string"
description: "Имя."
lastName:
type: "string"
description: "Фамилия."
middleName:
type: "string"
description: "Отчество."
birthDate:
type: "string"
description: "Дата рождения."
format: "date"
phones:
type: "array"
description: "Номера телефонов."
items:
$ref: "#/components/schemas/Phone"
documents:
type: "array"
description: "Документы."
items:
$ref: "#/components/schemas/Document"
jobInfo:
$ref: "#/components/schemas/JobInfo"
bankInfo:
$ref: "#/components/schemas/BankInfo1"
SignerStatusResponse:
required:
- "isSigner"
type: "object"
properties:
isSigner:
type: "boolean"
description: "Является ли пользователь подписантом."
BeneficiaryRequest:
oneOf:
- $ref: "#/components/schemas/BeneficiaryFlNonresidentRequest"
- $ref: "#/components/schemas/BeneficiaryFlResidentRequest"
- $ref: "#/components/schemas/BeneficiaryIpNonresidentRequest"
- $ref: "#/components/schemas/BeneficiaryIpResidentRequest"
- $ref: "#/components/schemas/BeneficiaryLiteContactRequest"
- $ref: "#/components/schemas/BeneficiaryUlNonresidentRequest"
- $ref: "#/components/schemas/BeneficiaryUlResidentRequest"
CreateDocument1:
required:
- "date"
- "organization"
- "serial"
- "type"
type: "object"
properties:
type:
$ref: "#/components/schemas/CreateDocumentType"
serial:
type: "string"
description: "Серия."
number:
type: "string"
description: "Номер документа."
date:
type: "string"
description: "Дата."
format: "date"
organization:
type: "string"
description: "Кем выдан."
division:
type: "string"
description: "Код подразделения."
expireDate:
type: "string"
description: "Дата истечения."
format: "date"
SelfEmployedResponse:
type: "object"
properties:
recipients:
type: "array"
description: "Список самозанятых."
items:
$ref: "#/components/schemas/SelfEmployed"
InvoiceItemInfo:
required:
- "amount"
- "name"
- "price"
- "unit"
- "vat"
type: "object"
properties:
name:
type: "string"
description: "Наименование."
price:
type: "number"
description: "Цена за единицу в рублях."
unit:
type: "string"
description: "Единицы измерения."
vat:
$ref: "#/components/schemas/Vat"
amount:
type: "number"
description: "Количество единиц."
DeliveryTask:
required:
- "id"
- "status"
- "template"
type: "object"
properties:
id:
type: "string"
description: "Идентификатор задания."
status:
type: "string"
description: "Статус задания."
template:
type: "string"
description: "Шаблон задания."
meetResult:
type: "string"
resolution:
type: "string"
description: "Результат задания."
subResolution:
type: "string"
description: "Детальное описание результата задания."
parentTaskId:
type: "string"
description: "Идентификатор родительского задания."
meta:
type: "object"
additionalProperties:
type: "string"
description: "Дополнительные метаданные в формате JSON."
attachments:
type: "array"
description: "Группа объектов с информацией о документах, относящихся к\
\ заданию. Может быть пустым, если документы не нужны в качестве резул\
ьтатов задания."
items:
$ref: "#/components/schemas/Attachment"
photos:
type: "array"
description: "Группа объектов с информацией о фото, относящихся к задани\
ю."
items:
$ref: "#/components/schemas/Photo"
IdentificationDocumentType:
type: "string"
description: "Тип документа"
enum:
- "PASSPORT"
CreateSelfEmployedRequest:
required:
- "correlationId"
type: "object"
properties:
correlationId:
type: "string"
description: "Идентификатор, связывающий запрос создания с запросом полу\
чения ответа."
format: "uuid"
recipients:
type: "array"
description: "Список самозанятых на создание."
items:
$ref: "#/components/schemas/CreateSelfEmployedData"
AmountDistributionItem:
required:
- "amount"
- "beneficiaryId"
type: "object"
properties:
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
amount:
type: "number"
description: "Сумма пополнения."
CardInfoResponse:
required:
- "accountNumber"
- "cardBin"
- "cardLastFourDigits"
- "embossedName"
- "isActive"
- "status"
- "ucid"
type: "object"
properties:
ucid:
type: "integer"
description: "Уникальный идентификатор карты."
format: "int64"
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер расчетного счета, к которому привязана карта."
cardBin:
maxLength: 6
minLength: 6
pattern: "\\d{6}"
type: "string"
description: "Первые 6 цифр номера карты (BIN карты)."
cardLastFourDigits:
maxLength: 4
minLength: 4
pattern: "\\d{4}"
type: "string"
description: "Последние 4 цифры номера карты."
isActive:
type: "boolean"
description: "Флаг активации карты."
status:
$ref: "#/components/schemas/CardStatus"
embossedName:
type: "string"
description: "Имя держателя карты."
EmployeeInfo:
required:
- "firstName"
- "lastName"
type: "object"
properties:
firstName:
type: "string"
description: "Имя (кириллица)."
lastName:
type: "string"
description: "Фамилия (кириллица)."
middleName:
type: "string"
description: "Отчество (кириллица)."
employeeId:
type: "integer"
description: "Идентификатор сотрудника. Возвращается для реестров в стат\
усе DRAFT
, ACCEPTED
, PART_EXEC
\
\ или EXECUTED
."
format: "int32"
description: "Данные сотрудника."
ContractGPD:
required:
- "date"
- "number"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип документа."
enum:
- "PASSPORT"
- "FOREIGN_PASSPORT"
- "FOREIGN_PASSPORT_OF_FOREIGN_CITIZENS"
- "OFFICIAL_PASSPORT"
- "DIPLOMATIC_PASSPORT"
- "MIGRATION_CARD"
- "TEMPORARY_RESIDENCE_PERMIT"
- "VISA"
- "RESIDENCE_PERMIT"
- "CONTRACT"
- "CONTRACT_GPD"
- "PATENT"
number:
type: "string"
description: "Номер документа."
date:
type: "string"
description: "Дата выдачи."
format: "date"
expireDate:
type: "string"
description: "Дата истечения."
format: "date"
CreatePhone1:
required:
- "number"
- "type"
type: "object"
properties:
type:
$ref: "#/components/schemas/CreatePhoneType"
number:
type: "string"
description: "Номер телефона."
AccountOperation:
required:
- "accountAmount"
- "accountNumber"
- "amount"
- "authDateTime"
- "card"
- "currency"
- "operationStatus"
- "operationType"
type: "object"
properties:
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер счета"
authDateTime:
type: "string"
description: "Дата авторизации"
format: "date-time"
trxnDateTime:
type: "string"
description: "Дата транзакции"
format: "date-time"
authId:
type: "string"
description: "Идентификатор авторизации"
trxnId:
type: "string"
description: "Идентификатор транзакции"
authStatus:
$ref: "#/components/schemas/AuthStatus"
operationType:
$ref: "#/components/schemas/AccountOperationType"
operationStatus:
$ref: "#/components/schemas/AccountOperationStatus"
amount:
type: "number"
description: "Сумма операции в валюте операции"
currency:
type: "string"
description: "Валюта операции"
accountAmount:
type: "number"
description: "Сумма операции в валюте счета"
description:
type: "string"
description: "Назначение платежа"
card:
$ref: "#/components/schemas/Card"
merch:
$ref: "#/components/schemas/Merch"
rrn:
type: "string"
description: "RRN"
acquirerId:
type: "string"
description: "acquirerId"
CardIssueApplicationStatus:
type: "string"
description: "\nСтатус заявки:\n//
. "
description: "Информация о банке получателя."
PaymentStatusResponse:
required:
- "status"
type: "object"
properties:
status:
$ref: "#/components/schemas/PaymentStatus"
errorMessage:
type: "string"
description: "Описание ошибки."
meta:
type: "object"
additionalProperties:
type: "string"
description: "Дополнительные данные, переданные в поле meta запро\
са платежа."
ApiForeignAgentResponse:
required:
- "isForeignAgent"
type: "object"
properties:
isForeignAgent:
type: "boolean"
description: "Является ли пользователь иностранным агентом."
RegularPaymentResponse:
required:
- "accountNumber"
- "amount"
- "bankDetails"
- "beneficiaryId"
- "paymentId"
- "purpose"
- "status"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип платежа:\n* `REGULAR` — обычный.\n* `TAX` — налоговый."
enum:
- "REGULAR"
- "TAX"
paymentId:
type: "string"
description: "Идентификатор платежа."
format: "uuid"
beneficiaryId:
type: "string"
description: "Идентификатор бенефициара."
format: "uuid"
accountNumber:
pattern: "^(\\d{20}|\\d{22})$"
type: "string"
description: "Номер номинального счета."
bankDetails:
$ref: "#/components/schemas/BankDetails"
dealId:
type: "string"
description: "Идентификатор сделки."
format: "uuid"
stepId:
type: "string"
description: "Идентификатор этапа сделки."
format: "uuid"
recipientId:
type: "string"
description: "Идентификатор реципиента."
format: "uuid"
amount:
type: "number"
description: "Сумма платежа."
status:
type: "string"
description: "Статус платежа \n\n![payment-statuses](https://business.t-static.ru/static/images/opensme/nominal-accounts/payment-statuses.svg)\n\
* `PENDING` — Ожидает обработки.\n* `IN_PROGRESS` — В процессе.\n* `FAILED`\
\ — Неуспешен.\n* `CANCELLED` — Отменен.\n* `SUCCEEDED` — Успешно заве\
ршен."
enum:
- "PENDING"
- "IN_PROGRESS"
- "FAILED"
- "CANCELLED"
- "SUCCEEDED"
errorMessage:
type: "string"
description: "Описание ошибки в случае неуспешности платежа."
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
operationId:
type: "string"
description: "Уникальный ID операции."
format: "uuid"
EmployeeRegistryCreateTypeRequest:
type: "string"
description: "\nМожет принимать одно из двух значений:\ntrue
,\
\ на реальные реквизиты — false
.\n\nПри создании реципиен\
та без банковских реквизитов, платеж в рамках сделки автоматически буд\
ет выполнен на виртуальный счет бенефициара."
CreateCardPaymentRequest:
required:
- "amount"
- "from"
- "id"
- "purpose"
- "to"
type: "object"
properties:
id:
maxLength: 64
minLength: 1
type: "string"
description: "Идентификатор платежа. Должен быть уникален в пределах инт\
еграции платежей по банковским\
\ реквизитам."
from:
$ref: "#/components/schemas/CardPayerRequisites"
to:
$ref: "#/components/schemas/AgreementNumberRequisites"
purpose:
maxLength: 210
minLength: 1
type: "string"
description: "Назначение платежа."
documentNumber:
minimum: 1
type: "integer"
description: "Номер распоряжения, определяемый клиентом. Заполняется на\
\ усмотрение плательщика. Номер документа — не больше 6 цифр. "
format: "int32"
amount:
type: "number"
description: "Сумма платежа в рублях"
executionOrder:
maximum: 5
minimum: 1
type: "integer"
description: "Очередность платежа."
format: "int32"
deprecated: true
dueDate:
type: "string"
description: "Дата, до которой нужно провести платеж. При неуспешных поп\
ытках платежа он будет повторен вплоть до указанной даты. Если дату не\
\ передать, платеж не будет повторен в случае неуспешной попытки. Врем\
я на проведение платежа не может быть больше 30 дней."
format: "date-time"
ReceiptInProgressOperation:
required:
- "createdAt"
- "status"
- "type"
type: "object"
properties:
status:
$ref: "#/components/schemas/ReceiptOperationStatus"
type:
$ref: "#/components/schemas/ReceiptOperationType"
createdAt:
type: "string"
description: "Дата и время создания операции в UTC. Возвращается в форма\
те ISO-8601."
format: "date-time"
IncomingTransactionListResponse:
required:
- "limit"
- "offset"
- "size"
- "total"
type: "object"
properties:
offset:
type: "integer"
description: "Запрошенное количество неидентифицированных пополнений для\
\ пропуска."
format: "int32"
limit:
type: "integer"
description: "Запрошенное количество неидентифицированных пополнений для\
\ вывода."
format: "int32"
size:
type: "integer"
description: "Количество неидентифицированных пополнений в ответе."
format: "int32"
total:
type: "integer"
description: "Всего неидентифицированных пополнений."
format: "int32"
results:
type: "array"
description: "Список неидентифицированных пополнений."
items:
$ref: "#/components/schemas/IncomingTransactionListItem"
IdentificationStatusResponse:
required:
- "isIdentified"
type: "object"
properties:
isIdentified:
type: "boolean"
description: "Идентифицирован ли пользователь."
ForeignPassportOfForeignCitizens:
required:
- "date"
- "number"
- "organization"
- "type"
type: "object"
properties:
type:
type: "string"
description: "Тип документа."
enum:
- "PASSPORT"
- "FOREIGN_PASSPORT"
- "FOREIGN_PASSPORT_OF_FOREIGN_CITIZENS"
- "OFFICIAL_PASSPORT"
- "DIPLOMATIC_PASSPORT"
- "MIGRATION_CARD"
- "TEMPORARY_RESIDENCE_PERMIT"
- "VISA"
- "RESIDENCE_PERMIT"
- "CONTRACT"
- "CONTRACT_GPD"
- "PATENT"
number:
type: "string"
description: "Номер документа."
date:
type: "string"
description: "Дата выдачи."
format: "date"
organization:
type: "string"
description: "Кем выдан."
EptArrestStatus:
type: "string"
description: "Статус требования."
enum:
- "PAYED"
- "ACTIVE"
- "PAUSE"
- "CANCELED"
CreateReceiptRequest:
oneOf:
- $ref: "#/components/schemas/CreateForeignAgencyReceiptRequest"
- $ref: "#/components/schemas/CreateIndividualReceiptRequest"
- $ref: "#/components/schemas/CreateLegalEntityReceiptRequest"
PaymentError1:
required:
- "number"
type: "object"
properties:
number:
type: "integer"
description: "Идентификатор платежа, переданный клиентом при создании."
format: "int32"
accountNumber:
type: "string"
description: "Номер счета самозанятого."
errors:
type: "array"
description: "Ошибки валидации."
items:
$ref: "#/components/schemas/FieldValidationError"
ReceiptStatus:
type: "string"
description: "Статус чека."
enum:
- "IN_PROGRESS"
- "REGISTERED"
- "DECLINED"
- "REGISTERED_OFFLINE"
- "CANCELLED"
OutputLimitPeriod:
type: "string"
description: "\nПериод обновления доступного остатка лимита на снятия наличн\
ых:\n