Выставление счета на оплату по свободным реквизитам
/v1/payments/from-invoice-any
Запрос создает черновик платежного поручения по свободным реквизитам.
Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка.
Для доступа к этому методу в параметре scope
ссылки авторизации пользователя должен быть указан сервис PAY_DOC_RU_INVOICE_ANY
.
Получение денежных средств возможно на счета сторонних банков, а получателем денежных средств может быть любая организация.
Запрос
- 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-9]{9}$
БИК банка получателя платежа
Возможные значения: Value must match regular expression ^[0-9]{20}$
Кор. счет банка получателя платежа
Возможные значения: Value must match regular expression ^([0-9]{5}|[0-9]{10}|[0-9]{12}|0)$
ИНН получателя платежа
Возможные значения: Value must match regular expression ^([0-9]{9}|0)$
КПП получателя платежа
Возможные значения: <= 254 characters
Наименование получателя платежа
Дата истечения заказа (платеж должен быть подтвержден клиентом)
Номер заказа
Признак того, что платежное поручение будет оплачено за счет кредитных средств
Номер кредитного договора
Успешный запрос
- 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"
}