Выставление счета на оплату по фиксированным реквизитам
/v1/payments/from-invoice
Запрос создает черновик платежного поручения с фиксированным сроком действия, без возможности изменить сумму оплаты и реквизиты получателя.
Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка.
Для доступа к этому методу в параметре scope
ссылки авторизации пользователя должен быть указан сервис PAY_DOC_RU_INVOICE
.
Получение денежных средств возможно только на расчетный счет в Сбербанке, который принадлежит вашей организации.
Запрос
- application/json
Body
required
Счет на оплату по фиксированным реквизитам
Array [
]
Идентификатор документа, присвоенный партнером (UUID)
Номер платежного поручения
Дата составления документа
По умолчанию: 0
Сумма платежа
Возможные значения: Value must match regular expression ^01$
По умолчанию: 01
Код операции
Возможные значения: Value must match regular expression ^(электронно|срочно|0)$
Вид платежа
Возможные значения: Value must match regular expression ^[4-5]{1}$
По умолчанию: 5
Очередность платежа
Код срочности
Возможные значения: <= 210 characters
Назначение платежа
Возможные значения: Value must match regular expression ^[0-9]{20}$
Счет получателя платежа
vat
object
nullable
Данные НДС
Возможные значения: [INCLUDED
, ONTOP
, NO_VAT
, MANUAL
]
Способ расчета НДС
Возможные значения: Value must match regular expression ^(0|5|7|10|20)$
Ставка НДС
Сумма НДС
linkedDocs
object[]
Связанные документы
Идентификатор документа в организации-партнере (UUID)
Возможные значения: non-empty
и <= 50 characters
Тип связанного документа
Возможные значения: Value must match regular expression ^[0-9a-f]{64}$
Идентификатор получателя платежа
Дата истечения заказа (платеж должен быть подтвержден клиентом)
Номер заказа
Успешный запрос
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
Номер документа
Дата составления документа
digestSignatures
object[]
Электронные подписи по дайджесту документа
Уникальный идентификатор сертификата ключа проверки электронной подписи (UUID)
Возможные значения: non-empty
Значение электронной подписи, закодированное в Base64
Статус документа
Банковский комментарий к статусу документа
Идентификатор документа, присвоенный партнером (UUID)
По умолчанию: 0
Сумма платежа
Возможные значения: Value must match regular expression ^01$
Код операции
Возможные значения: Value must match regular expression ^(электронно|срочно|0)
Идентификатор документа, присвоенный партнером (UUID)
Возможные значения: Value must match regular expression ^[1-5]{1}$
Очередность платежа
Код срочности
Возможные значения: Value must match regular expression ^[0-9]{5}$
Код вида валютной операции
Возможные значения: <= 210 characters
Назначение платежа
departmentalInfo
object
Реквизиты налогового, таможенного или иного бюджетного платежа
Возможные значения: <= 25 characters
, Value must match regular expression [A-ZА-Я0-9/]+
Уникальный идентификатор платежа
Возможные значения: <= 2 characters
Показатель статуса налогоплательщика (реквизит - 101)
Возможные значения: Value must match regular expression ([A-ZА-Я0-9]{1,20})$
Код бюджетной классификации (реквизит - 104)
Возможные значения: Value must match regular expression (.{1,11})$
Код OKTMO (реквизит - 105)
Возможные значения: <= 2 characters
Показатель основания платежа (реквизит - 106)
Возможные значения: Value must match regular expression ^(0|[0-9]{8}|([0-9]{2}|МС|КВ|ПЛ|ГД)\.[0-9]{2}\.[0-9]{4})$
Налоговый период / код таможенного органа (реквизит - 107)
Возможные значения: <= 15 characters
Номер налогового документа (реквизит - 108)
Возможные значения: Value must match regular expression ^(0|00|[0-9]{2}\.[0-9]{2}\.[0-9]{4})$
Дата налогового документа (реквизит - 109)
Возможные значения: <= 2 characters
Тип налогового платежа (реквизит - 110)
Возможные значения: <= 254 characters
Полное наименование плательщика
Возможные значения: Value must match regular expression ^([0-9]{5}|[0-9]{10}|[0-9]{12}|0)$
ИНН плательщика
Возможные значения: Value must match regular expression ^([0-9]{9}|0)$
КПП плательщика
Возможные значения: Value must match regular expression ^[0-9]{20}$
Счет плательщика
Возможные значения: Value must match regular expression ^[0-9]{9}$
БИК банка плательщика
Возможные значения: Value must match regular expression ^[0-9]{20}$
Корсчет банка плательщика
Возможные значения: <= 254 characters
Полное наименование получателя платежа
Возможные значения: Value must match regular expression ^([0-9]{5}|[0-9]{10}|[0-9]{12}|0)$
ИНН получателя платежа
Возможные значения: Value must match regular expression ^([0-9]{9}|0)$
КПП получателя платежа
Возможные значения: Value must match regular expression ^[0-9]{20}$
Счет получателя платежа
Возможные значения: Value must match regular expression ^[0-9]{9}$
БИК получателя платежа
Возможные значения: Value must match regular expression ^[0-9]{20}$
Корсчет банка получателя платежа
Hash от ключевых полей документа
vat
object
nullable
Данные НДС
Возможные значения: [INCLUDED
, ONTOP
, NO_VAT
, MANUAL
]
Способ расчета НДС
Возможные значения: Value must match regular expression ^(0|5|7|10|20)$
Ставка НДС
Сумма НДС
Возможные значения: <= 2 characters
Код вида дохода получателей выплаты по 229-ФЗ
{
"number": 1,
"date": "2018-12-31",
"digestSignatures": [
{
"certificateUuid": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
"base64Encoded": "HlaeIHXXEcGT1bFxo1NlpAzpr+kJ2IQrcxVdvDTep6xjsmD1FDb+6NIyLT+/T24S0mPfVCU75sieOMt71TBS7w=="
}
],
"bankStatus": "string",
"bankComment": "string",
"externalId": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
"amount": "1.01",
"operationCode": "01",
"deliveryKind": "электронно",
"priority": "5",
"urgencyCode": "string",
"voCode": "61150",
"purpose": "Оплата заказа №123. НДС нет.",
"departmentalInfo": {
"uip": 0,
"drawerStatus101": 1,
"kbk": 18210102010011000000,
"oktmo": 1701000,
"reasonCode106": "ТП",
"taxPeriod107": "ГД.00.2018",
"docNumber108": 123,
"docDate109": "31.12.2022",
"paymentKind110": "ПН"
},
"payerName": "string",
"payerInn": "7707083893",
"payerKpp": "222201001",
"payerAccount": "40802810600000200000",
"payerBankBic": "044525225",
"payerBankCorrAccount": "30101810400000000225",
"payeeName": "string",
"payeeInn": "7707083893",
"payeeKpp": "222201001",
"payeeAccount": "40802810600000200000",
"payeeBankBic": "044525225",
"payeeBankCorrAccount": "30101810400000000225",
"crucialFieldsHash": "string",
"vat": {
"type": "NO_VAT",
"rate": 10,
"amount": 1.01
},
"incomeTypeCode": "2"
}
"Ошибка в запросе"
Cause | Message | Description |
---|---|---|
DESERIALIZATION_FAULT | Неверный формат запроса | Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в responce в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request запроса. Скорректируйте заполнение атрибутов и повторите запрос. |
VALIDATION_FAULT | Ошибка валидации | Данные не соответствуют требованиям валидации. Сведения о некорректных атрибутах request содержатся в массивах fieldNames и checks. Подробные требования к атрибутам описаны в request запроса, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос. |
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
Причина или основание сообщения
Сообщение
Уникальный идентификатор ошибки (UUID)
Внутренний код ошибки.
Указывайте его при обращении в поддержку вместе с отве том по возникшей ошибке.
{
"checks": [
{
"level": "ERROR",
"message": "string",
"fields": [
"string"
]
}
],
"cause": "string",
"message": "string",
"referenceId": "string",
"internalErrorCode": "string"
}
"Не авторизован"
Cause | Message | Description |
---|---|---|
UNAUTHORIZED | accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х | Указан некорректный или просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос. |
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
Причина или основание сообщения
Сообщение
Уникальный идентификатор ошибки (UUID)
Внутренний код ошибки.
Указывайте его при обращении в поддержку вместе с ответом по возникшей ошибке.
{
"checks": [
{
"level": "ERROR",
"message": "string",
"fields": [
"string"
]
}
],
"cause": "string",
"message": "string",
"referenceId": "string",
"internalErrorCode": "string"
}
"Операция не может быть выполнена: доступ к ресурсу запрещен"
Cause | Message | Description |
---|---|---|
ACTION_ACCESS_EXCEPTION | Операция не может быть выполнена: доступ к ресурсу запрещен | Используемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API. В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция PAY_DOC_RU . Необходимо добавить одному или несколько операций в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token. |
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
Причина или основание сообщения
Сообщение
Уникальный идентификатор ошибки (UUID)
Внутренний код ошибки.
Указывайте его при обращении в поддержку вместе с ответом по возникшей ошибке.
{
"checks": [
{
"level": "ERROR",
"message": "string",
"fields": [
"string"
]
}
],
"cause": "string",
"message": "string",
"referenceId": "string",
"internalErrorCode": "string"
}
Данные не найдены
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
Причина или основание сообщения
Сообщение
Уникальный идентификатор ошибки (UUID)
Внутренний код ошибки.
Указывайте его при обращении в поддержку вместе с ответом по возникшей ошибке.
{
"checks": [
{
"level": "ERROR",
"message": "string",
"fields": [
"string"
]
}
],
"cause": "string",
"message": "string",
"referenceId": "string",
"internalErrorCode": "string"
}
"Превышен лимит запросов"
Cause | Message | Description |
---|---|---|
TOO_MANY_REQUESTS | Превышен лимит запросов. Повторите операцию позже. | Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее |
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
Причина или основание сообщения
Сообщение
Уникальный идентификатор ошибки (UUID)
Внутренний код ошибки.
Указывайте его при обращении в поддержку вместе с ответом по возникшей ошибке.
{
"checks": [
{
"level": "ERROR",
"message": "string",
"fields": [
"string"
]
}
],
"cause": "string",
"message": "string",
"referenceId": "string",
"internalErrorCode": "string"
}
"Внутренняя ошибка сервера"
Cause | Message | Description |
---|---|---|
UNKNOWN_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
Причина или основание сообщения
Сообщение
Уникальный идентификатор ошибки (UUID)
Внутренний код ошибки.
Указывайте его при обращении в поддержку вместе с ответом по возникшей ошибке.
{
"checks": [
{
"level": "ERROR",
"message": "string",
"fields": [
"string"
]
}
],
"cause": "string",
"message": "string",
"referenceId": "string",
"internalErrorCode": "string"
}
"Сервис временно недоступен"
Cause | Message | Description |
---|---|---|
UNAVAILABLE_RESOURCE_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
Причина или основание сообщения
Сообщение
Уникальный идентификатор ошибки (UUID)
Внутренний код ошибки.
Указывайте его при обращении в поддержку вместе с ответом по возникшей ошибке.
{
"checks": [
{
"level": "ERROR",
"message": "string",
"fields": [
"string"
]
}
],
"cause": "string",
"message": "string",
"referenceId": "string",
"internalErrorCode": "string"
}