Отправка КСПД

POST

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

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

Авторизация

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

amendmentIndicator

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)

note

String

Requirements: <= 1000 characters

Примечание

attachments

Array of objects ()

Requirements: <= 1000 items

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

documentName

String

Requirements: <= 100 characters

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

documentId

Number<int64>

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

version

Integer<int64>

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

Ответ

200

Success

400

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

401

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

403

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

422

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

429

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

500

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

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

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