Специальные счета (tbank.special_accounts)

Специальные счета участников закупок: аресты средств и картотеки ЭТП (электронных торговых площадок). SDK покрывает выгрузку операций за период.

• Хост: business.tbank.ru/openapi по Bearer-токену.

• Суммы: Decimal в рублях. Провод: camelCase.

• Клиенты: tbank.special_accounts.SpecialAccountsClient (async) и tbank.special_accounts.sync.SpecialAccountsClient (sync).

from tbank.special_accounts import SpecialAccountsClient

client = SpecialAccountsClient(token="business-token")

ops = await client.get_arrest_etp_operations(
    account_number="40817810000000000001",
    from_date="2026-01-01",
    till="2026-06-30",
)
print(ops.arrests.sum)                 # общая сумма арестов
for arrest in ops.arrests.values or []:
    print(arrest.amount, arrest.unblock_date)
for fee in ops.etp_fees or []:
    print(fee.amount, fee.recipient.name)

Клиент

class tbank.special_accounts.aio.SpecialAccountsClient(token, *, base_url=None, sandbox=False, retry=None, transport=None)

Базовые классы: BaseAsyncClient

Асинхронный клиент специальных счетов: операции ареста и картотеки ЭТП.

Работает на обычном хосте по Bearer-токену. Суммы — Decimal в рублях.

Параметры:

• token (str)

• base_url (Optional[str])

• sandbox (bool)

• retry (Optional[RetryPolicy])

• transport (Optional[AsyncTransport])

decimal_body: ClassVar[bool] = True

True → тело парсится с parse_float=Decimal (точные денежные суммы).

async get_arrest_etp_operations(account_number, from_date, till)

Аресты и картотеки ЭТП по спецсчёту за период (даты — YYYY-MM-DD).

Параметры:

• account_number (str)

• from_date (str)

• till (str)

Тип результата:

OperationsResponse

Модели

class tbank.special_accounts.models.SpecialAccountModel

Базовые классы: BaseModel

Базовая модель домена: snake_case в Python, camelCase на проводе.

model_config = {'alias_generator': <function to_camel>, 'extra': 'ignore', 'populate_by_name': True, 'validate_by_alias': True, 'validate_by_name': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class tbank.special_accounts.models.Recipient(*, inn, name=None, account=None)

Базовые классы: SpecialAccountModel

Параметры:

• inn (str)

• name (str | None)

• account (str | None)

model_config = {'alias_generator': <function to_camel>, 'extra': 'ignore', 'populate_by_name': True, 'validate_by_alias': True, 'validate_by_name': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class tbank.special_accounts.models.Bank(*, bik=None, corAccount=None, name=None)

Базовые классы: SpecialAccountModel

Параметры:

• bik (str | None)

• corAccount (str | None)

• name (str | None)

model_config = {'alias_generator': <function to_camel>, 'extra': 'ignore', 'populate_by_name': True, 'validate_by_alias': True, 'validate_by_name': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class tbank.special_accounts.models.Etp(*, id, amount, currency, status, date, payedAmount, senderInn, recipient, bank, externalId=None, paymentPurpose=None, officeName=None)

Базовые классы: SpecialAccountModel

Списание по картотеке ЭТП / за нарушение контракта.

Параметры:

• id (str)

• amount (Decimal)

• currency (str)

• status (EtpArrestStatus)

• date (datetime)

• payedAmount (Decimal)

• senderInn (str)

• recipient (Recipient)

• bank (Bank)

• externalId (str | None)

• paymentPurpose (str | None)

• officeName (str | None)

model_config = {'alias_generator': <function to_camel>, 'extra': 'ignore', 'populate_by_name': True, 'validate_by_alias': True, 'validate_by_name': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class tbank.special_accounts.models.Arrest(*, id, amount, currency, status, date, unblockDate, externalId=None, circumstances=None, officeName=None)

Базовые классы: SpecialAccountModel

Арест средств на специальном счёте.

Параметры:

• id (str)

• amount (Decimal)

• currency (str)

• status (EtpArrestStatus)

• date (datetime)

• unblockDate (datetime)

• externalId (str | None)

• circumstances (str | None)

• officeName (str | None)

model_config = {'alias_generator': <function to_camel>, 'extra': 'ignore', 'populate_by_name': True, 'validate_by_alias': True, 'validate_by_name': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class tbank.special_accounts.models.ArrestList(*, sum, values=None)

Базовые классы: SpecialAccountModel

Параметры:

• sum (Decimal)

• values (List[Arrest] | None)

model_config = {'alias_generator': <function to_camel>, 'extra': 'ignore', 'populate_by_name': True, 'validate_by_alias': True, 'validate_by_name': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class tbank.special_accounts.models.OperationsResponse(*, arrests, etpFees=None, contractBreaches=None)

Базовые классы: SpecialAccountModel

Операции по специальному счёту: аресты, картотеки ЭТП, списания.

Параметры:

• arrests (ArrestList)

• etpFees (List[Etp] | None)

• contractBreaches (List[Etp] | None)

model_config = {'alias_generator': <function to_camel>, 'extra': 'ignore', 'populate_by_name': True, 'validate_by_alias': True, 'validate_by_name': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

Перечисления

class tbank.special_accounts.enums.EtpArrestStatus(*values)

Базовые классы: str, Enum

Статус картотеки ЭТП / ареста на специальном счёте.

PAYED = 'PAYED'

ACTIVE = 'ACTIVE'

PAUSE = 'PAUSE'

CANCELED = 'CANCELED'