ym88659208ym87991671
Создание сведений о валютной операции | Документация для разработчиков

Создание сведений о валютной операции

Обновлено 12 марта 2026

Для создания СВО необходимо отправить POST-запрос /fintech/api/v1/currency-operation-details с токеном доступа (access_token) пользователя в параметре Authorization заголовка и реквизитами документа в теле.

В параметре scope ссылки авторизации пользователя должен быть указан сервис CURRENCY_OPERATION_DETAILS для получения доступа к этому запросу.

  • Если в запросе на создание заявления передать ЭП к документу (объект digestSignatures), то Банк сразу начнет обработку документа.
  • Если в запросе не передавать ЭП к документу, то заявление будет создано в статусе черновик. Для начала обработки документа Банком потребуется зайти в интерфейс СберБизнес и подписать его.
Дайджест

Дайджест это текстовый документ, содержащий перечень и значения полей запроса, к которому он относится и предназначенный для подписания ЭЦП. Сохраняйте порядок и количество полей дайджеста, как показано в примере ниже, иначе подписать его не получится.

Формат дайджеста:

Если в запросе contractNumberType = 2, то в дайджесте необходимо указать passportNumber.

Наименование поляОписание поляПример
accountNumberНомер счета40702810123643875107
addInfoДополнительная информацияДополнительная информация
authPersonNameФИО ответственного лицаИванов Иван Иванович
authPersonTelfaxТелефон ответственного лица+7 123 1456 56 56
bankNonResidentCountryNameНаименование страныСОЕДИНЕННОЕ КОРОЛЕВСТВО
bankNonResidentCountryNumericCodeКод страны826
correctionПризнак корректировкиfalse
correctionNumberНомер корректировки1
currencyDocDateДата валютного документа2019-05-16
currencyDocNumberНомер валютного документа54321
currencyDocTypeТип валютного документаPayDocCur
dateДата документа2019-05-16
externalIdИдентификатор документа в организации-партнере75d8d497-05cc-4cc6-9b78-070ae0a605fd
isAccountInOtherBankПризнак счета в другом банкеfalse
isNumberAbsentПризнак отсутствия номера валютного документаfalse
paymentAmount.amountСумма платежа2.02
paymentAmount.currencyCodeЦифровой код валюты платежа840
paymentAmount.currencyNameISO код валюты платежаUSD
paymentDirectionНаправление платежа1
senderInnИНН клиента7582099944
senderNameПолное наименование клиентаОрганизация NyJurbsIJTXzRTL
senderOkpoОКПО клиента1350995802
TABLESЗначение указывается при наличии UUID-ов больших файлов или Операций
Table=BfAttachmentsЗначение указывается при наличии UUID-ов больших файлов
fileIdUUID больших файлов08ba3412-118a-4f4d-be23-e93f81d58fdc
#Разделитель строк таблицы
fileIdUUID больших файлов81ff03ad-bceb-4a8a-b5bf-8c8439519bab
#Разделитель строк таблицы
Table=OperationsЗначение указывается при наличии операций
additionalInfoДополнительная информацияПримечание
amount.amountСумма платежа2.02
amount.currencyCodeЦифровой код валюты платежа840
amount.currencyNameISO код валюты платежаUSD
contractDateДата договора2019-05-16
contractNumberНомер договора123
contractNumberTypeТип заполнения номера договора0
creditAmount.amountСумма договора33.33
creditAmount.currencyCodeЦифровой код валюты договора840
creditAmount.currencyNameISO код валюты договораUSD
dataCompositionСостав предоставляемой информации3
expectedDateОжидаемый срок2019-05-16
operationCodeКод вида валютной операции20300
operationCodeDescriptionОписание валютной операцииОплата нерезидента резиденту по договору аренды движимого или недвижимого имущества
operationReasonОснование проведения операции1
passportNumberУникальный номер контракта (кредитного договора)120123A0/1234/GU23/1/2
paymentConditionsУсловия расчета1
serialNumberНомер по порядку0

Пример дайджеста:

accountNumber=40702810123643875107
addInfo=Дополнительная информация
authPersonName=Иванов Иван Иванович
authPersonTelfax=+7 123 1456 56 56
bankNonResidentCountryName=СОЕДИНЕННОЕ КОРОЛЕВСТВО
bankNonResidentCountryNumericCode=826
correction=false
correctionNumber=1
currencyDocDate=2019-05-16
currencyDocNumber=54321
currencyDocType=PayDocCur
date=2019-05-16
externalId=75d8d497-05cc-4cc6-9b78-070ae0a605fd
isAccountInOtherBank=false
isNumberAbsent=false
paymentAmount.amount=2.02
paymentAmount.currencyCode=840
paymentAmount.currencyName=USD
paymentDirection=1
senderInn=7582099944
senderName=Организация NyJurbsIJTXzRTL
senderOkpo=1350995802
TABLES
Table=BfAttachments
fileId=08ba3412-118a-4f4d-be23-e93f81d58fdc
#
fileId=81ff03ad-bceb-4a8a-b5bf-8c8439519bab
#
Table=Operations
additionalInfo=Примечание
amount.amount=2.02
amount.currencyCode=840
amount.currencyName=USD
contractDate=2019-05-16
contractNumber=123
contractNumberType=0
creditAmount.amount=33.33
creditAmount.currencyCode=840
creditAmount.currencyName=USD
dataComposition=3
expectedDate=2019-05-16
operationCode=20300
operationCodeDescription=Оплата нерезидента резиденту по договору аренды движимого или недвижимого имущества
operationReason=1
passportNumber=120123A0/1234/GU23/1/
paymentConditions=1
serialNumber=0
#
Рекомендации по тестированию в песочнице

При тестировании создания сведений о валютной операции в Песочнице соблюдайте правила:

  • Не нужно устанавливать промышленные сертификаты электронной подписи (ЭП) — Песочница использует тестовые идентификаторы ЭП (certificateUuid).
  • Все остальные поля запроса заполняйте произвольными данными (реквизиты, суммы) в соответствии с требованиями в документации.

Сценарии тестирования

Для тестирования сценариев используйте фиксированные значения certificateUuid. При использовании любых других значений certificateUuid вернется ошибка INVALIDEDS.


1. Чтобы создать черновик СВО, отправьте запрос без объекта digestSignatures.

2. Для отправки документа с единственной или двумя подписями передайте в объекте digestSignatures тестовые certificateUuid.

Параметры:

  • bb014b5d-8159-40be-97c1-eafeed4a8c3d (единственная подпись)
  • d5d4f811-f4d4-4205-a70f-58f772eeab72 (первая подпись)
  • 4f29c8ef-b55d-43c7-a321-f2b1303a29cd (вторая подпись)

Статус в ответе: bankStatus: "EXPORTED"

Пример:

#Единственная подпись
  "digestSignatures": [
    \{
      "certificateUuid": "bb014b5d-8159-40be-97c1-eafeed4a8c3d",
      "base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
    \}
  ],


#Первая и вторая подпись
  "digestSignatures": [
    \{
      "certificateUuid": "d5d4f811-f4d4-4205-a70f-58f772eeab72",
      "base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
    \},
    \{
      "certificateUuid": "4f29c8ef-b55d-43c7-a321-f2b1303a29cd",
      "base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
    \}
  ],

Запрос

Ответы

Создан

Loading...
Это полезный материал?
Заметили ошибку?
Выделите текст и нажмите
Ctrl
+
Enter
, чтобы сообщить нам об ошибке
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.