Выставление счета на оплату по свободным реквизитам
/v1/payments/from-invoice-any
Запрос создает черновик платежного поручения по свободным реквизитам.
Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка.
Для доступа к этому методу в параметре scope
ссылки авторизации пользователя должен быть указан сервис PAY_DOC_RU_INVOICE_ANY
.
Получение денежных средств возможно на счета сторонних банков, а получателем денежных средств может быть любая организация.
Запрос
- application/json
Body
required
Счет на оплату по свободным реквизитам
Array [
]
Идентификатор документа, присвоенный партнером (UUID)
Номер платежного поручения
Дата составления документа
По умолчанию: 0
Сумма платежа
Значение должно соответствовать регулярному выражению ^01$
По умолчанию: 01
Код операции
З начение должно соответствовать регулярному выражению ^(электронно|срочно|0)$
Вид платежа
Значение должно соответствовать регулярному выражению ^[4-5]{1}$
По умолчанию: 5
Очередность платежа
Код срочности
Возможные значения: <= 210 characters
Назначение платежа
Значение должно соответствовать регулярному выражению ^[0-9]{20}$
Счет получателя платежа
vat
object
nullable
Данные НДС
Возможные значения: [INCLUDED
, ONTOP
, NO_VAT
, MANUAL
]
Способ расчета НДС
Значение должно соответствовать регулярному выражению ^(0|5|7|10|20)$
Ставка НДС
Сумма НДС
linkedDocs
object[]
Связанные документы
Идентификатор документа в организации-партнере (UUID)
Возможные значения: non-empty
и <= 50 characters
Тип связанного документа
Значение должно соответствовать регулярному выражению ^[0-9]{9}$
БИК банка получателя платежа
Значение должно соответствовать регулярному выражению ^[0-9]{20}$
Кор. счет банка получателя платежа
Значение должно соответствовать регулярному выражению ^([0-9]{5}|[0-9]{10}|[0-9]{12}|0)$
ИНН получателя платежа
Значение должно соответствовать регулярному выражению ^([0-9]{9}|0)$
КПП получателя платежа
Возможные значения: <= 254 characters
Наименование получателя платежа
Дата истечения заказа (платеж должен быть подтвержден клиентом)
Номер заказа
Признак того, что платежное поручение будет оплачено за счет кредитных средств
Номер кредитного договора
Успешный запрос
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
Номер документа
Дата составления документа
digestSignatures
object[]
Электронные подписи по дайджесту документа
Уникальный идентификатор сертификата ключа проверки электронной подписи (UUID)
Возможные значения: non-empty
Значение электронной подписи, закодированное в Base64
Статус документа
Банковский комментарий к статусу документа
Идентификатор документа, присвоенный партнером (UUID)
По умолчанию: 0
Сумма платежа
Значение должно соответствовать регулярному выражению ^01$
Код операции
Значение должно соответствовать регулярному выражению ^(электронно|срочно|0)
Идентификатор документа, присвоенный партнером (UUID)
Значение должно соответствовать регулярному выражению ^[1-5]{1}$
Очередность платежа
Код срочности
Значение должно соответствовать регулярному выражению ^[0-9]{5}$
Код вида валютной операции
Возможные значения: <= 210 characters
Назначение платежа
departmentalInfo
object
Реквизиты налогового, таможенного или иного бюджетного платежа
Возможные значения: <= 25 characters
, Value must match regular expression [A-ZА-Я0-9/]+
Уникальный идентификатор платежа
Возможные значения: <= 2 characters
Показатель статуса налогоплательщика (реквизит - 101)
Значение должно соответствовать регулярному выражению ([A-ZА-Я0-9]{1,20})$
Код бюджетной классификации (реквизит - 104)
Значение должно соответствовать регулярному выражению (.{1,11})$
Код OKTMO (реквизит - 105)
Возможные значения: <= 2 characters
Показатель основания платежа (реквизит - 106)
Значение должно соответствовать регулярному выражению ^(0|[0-9]{8}|([0-9]{2}|МС|КВ|ПЛ|ГД)\.[0-9]{2}\.[0-9]{4})$
Налоговый период / код таможенного органа (реквизит - 107)
Возможные значения: <= 15 characters
Номер налогового документа (реквизит - 108)
Значение должно соответствовать регулярному выражению ^(0|00|[0-9]{2}\.[0-9]{2}\.[0-9]{4})$
Дата налогового документа (реквизит - 109)
Возможные значения: <= 2 characters
Тип налогового платежа (реквизит - 110)
Возможные значения: <= 254 characters
Полное наименование плательщика
Значение должно соответствовать регулярному выражению ^([0-9]{5}|[0-9]{10}|[0-9]{12}|0)$
ИНН плательщика
Значение должно соответствовать регулярному выражению ^([0-9]{9}|0)$
КПП плательщика
Значение должно соответствовать регулярному выражению ^[0-9]{20}$
Счет плательщика
Значение должно соответствовать регулярному выражению ^[0-9]{9}$
БИК банка плательщика
Значение должно соответствовать регулярному выражению ^[0-9]{20}$
Корсчет банка плательщика
Возможные значения: <= 254 characters
Полное наименование получателя платежа
Значение должно соответствовать регулярному выражению ^([0-9]{5}|[0-9]{10}|[0-9]{12}|0)$
ИНН получателя платежа
Значение должно соответствовать регулярному выражению ^([0-9]{9}|0)$
КПП получателя платежа
Значение должно соответствовать регулярному выражению ^[0-9]{20}$
Счет получателя пл атежа
Значение должно соответствовать регулярному выражению ^[0-9]{9}$
БИК получателя платежа
Значение должно соответствовать регулярному выражению ^[0-9]{20}$
Корсчет банка получателя платежа
Hash от ключевых полей документа
vat
object
nullable
Данные НДС
Возможные значения: [INCLUDED
, ONTOP
, NO_VAT
, MANUAL
]
Способ расчета НДС
Значение должн о соответствовать регулярному выражению ^(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"
}