Отправка СПД

POST

https://business.tbank.ru/openapi/api/v1/openapi/reference

Метод для отправки СПД на проверку

Авторизация

Security

Bearer API Token

RPS

Ограничение — 20 запросов в секунду

Scopes

Справки о подтверждающих документах → Работа с методами сервиса СПД

Запрос

Header parameters

X-Request-Id

String<uuid>

Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.

Request body schema application/json

Required

documentId

String<string>

Уникальный идентификатор документа полученный от клиента

Required

uniqueContractNumber

String

Requirements: Value must match regular expression ^\d{8}/\d{4}/\d{4}/\d/\d$

Уникальный номер контракта

Required

referenceDate

String<date>

Дата подачи СПД

Required

documents

Array of objects ()

Requirements: >= 1 items, <= 1000 items

Список документов входящие в СПД

Required

rowNumber

Integer<int32>

Номер строки (начиная с 1)

documentNumber

String

Requirements: <= 100 characters

Номер документа

isDocumentNumberEmpty

Boolean

Признак отсутствия номера документа

documentDate

String<date>

Дата документа

Required

typeCode

String

Requirements: <= 4 characters

Код вида подтверждающего документа (01_3, 02_3 и т.д)

supplyAttribute

Integer<int32>

Признак поставки (1, 2, 3, 4 либо null)

Required

documentSum

Object (CurrencySumOpenApiRequestL29wZW4tYXBpLWN1cnJlbmN5LWRvY3VtZW50cy55YW1s)

Required

amount

Number<double>

Общая стоимость

amountAdditional

Number<double>

Сумма аванса

Required

currency

String

Requirements: <= 3 characters

Код валюты в численном формате (643 - Рубль)

contractSum

Object (CurrencySumOpenApiRequestL29wZW4tYXBpLWN1cnJlbmN5LWRvY3VtZW50cy55YW1s)

Required

amount

Number<double>

Общая стоимость

amountAdditional

Number<double>

Сумма аванса

Required

currency

String

Requirements: <= 3 characters

Код валюты в численном формате (643 - Рубль)

plannedTerm

String<date>

Планируемый срок реализации

shipmentCountryCode

String

Requirements: <= 3 characters

Код страны отправки в численном формате (156)

isThirdPartyPaymentChina

Boolean

Код китайского контрагента (156)

isFreeDelivery

Boolean

Признак бесплатной доставки

note

String

Requirements: <= 1000 characters

Примечание

attachments

Array of objects ()

Requirements: <= 1000 items

Список вложений

documentName

String

Requirements: <= 100 characters

Имя документа

documentId

Number<int64>

Идентификатор документа

version

Integer<int64>

Версия документа

Ответ

200

Успешная отправка СПД на проверку

400

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

401

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

403

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

422

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

429

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

500

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

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

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