ym88659208ym87991671
ВЭД | Документация для разработчиков

ВЭД

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

Информация о сервисе

Внешнеэкономическая деятельность (ВЭД) — представляет собой комплексную систему экономических отношений между субъектами хозяйствования страны и иностранными партнерами.

Она включает в себя торговые отношения, международные инвестиции, сотрудничество в области науки и техники, обмена технологиями и культурный обмен.

Основные функции Банка в ВЭД:

  • Валютные операции. Банки предоставляют услуги по обмену валюты, что позволяет клиентам совершать сделки с иностранными партнерами.
  • Международные расчеты. Банки обеспечивают проведение международных платежей, включая аккредитивы, инкассо и переводы. Это упрощает процесс оплаты товаров и услуг между контрагентами из разных стран.
  • Торговое финансирование. Банки предлагают различные формы финансирования для поддержки внешнеторговых операций, такие как кредиты, гарантии и аккредитивы.
  • Документарные операции. Банки осуществляют проверку документов, необходимых для проведения внешнеэкономических сделок, таких как контракты, счета-фактуры и транспортные документы.
  • Консультирование. Банки предоставляют консультации по вопросам валютного контроля, таможенного оформления и другим аспектам ВЭД.

Таким образом, банк является ключевым звеном в процессе осуществления внешнеэкономической деятельности, обеспечивая безопасность и эффективность финансовых операций между участниками ВЭД.

Варианты реализации

Ниже будут приведены примеры реализации. Сценарии могут быть для вас отправной точкой и идеей для финального способа реализации функциональности.

Сценарии описали общие, для более легкого восприятия информации описания работы с сервисом.

Можно использовать разные триггеры запуска того или иного сценария - действия пользователя, регламентный запуск по времени, наступление определенных событий и другие варианты.

Варианты реализации
Постановка контракта на учет

В схеме можно использовать автоматизированное подписание документа. Данная возможность доступна только при использовании ЭЦП сотрудника вашей компании (для отправки по собственной компании) или сотрудника дочерней компании (для отправки по дочерней компании).

Подробнее об использовании ЭЦП в Sber API можно почитать в одноименном разделе.

Для постановки контракта на учет в Банке потребуется загрузить документы. Для загрузки документов используйте сценарий Загрузка файлов в Банк (описан ниже).

Шаги

  1. Получить данные по контракту
  2. Загрузить файлы контракта в Банк
  3. Создать заявление на регистрацию контракта
  4. Получить статус заявления
  5. Получить полные данные контракта

Участники usecase

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформа)
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • Пользователь имеет пользовательский профиль в СберБизнес своей компании
  • Пользователь находится в пространстве Платформы
  • Пользователь прошел авторизацию с помощью СберБизнес ID

Результат применения

  • Банк поставил на учет валютный контракт
Постановка контракта на учет

Используемые запросы

МетодОписаниеОперация в scopeШаг в схеме
1GET /v1/client-infoПолучение расширенной информацииGET_CLIENT_ACCOUNTS1. Получить данные по контракту
2POST /v2/oauth/tokenОбновление токена доступаopenid1. Получить данные по контракту
3POST /v1/bank-control-statements/reg-curr-contractsСоздание валютного контракта с нерезидентомBANK_CONTROL_STATEMENT3. Создать заявление на регистрацию контракта
4GET /v1/bank-control-statements/{externalId}/stateПолучение статуса ведомости банковского контроляBANK_CONTROL_STATEMENT4. Получить статус заявления
5GET /v1/bank-control-statements/reg-curr-contracts/{externalId}Получение документа валютный контракт с нерезидентомBANK_CONTROL_STATEMENT4. Получить статус заявления
Получение информации по контрактам

В рамках Sber API можно будет вывести информацию по валютным контрактам, которые были поставлены на учет также с помощью Sber API и СберБизнес.

Шаги

  1. Получить все идентификаторы контрактов
  2. Получить информацию по контракту
  3. Вывести пользователю интересующий контракт

Участники usecase

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформа)
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • Пользователь имеет пользовательский профиль в СберБизнес своей компании
  • Пользователь находится в пространстве Платформы
  • Пользователь прошел авторизацию с помощью СберБизнес ID
  • Платформа успешно поставила на учет хотя бы 1 валютный контракт с помощью сценария «Постановка контракта на учет»

Результат применения

  • Пользователь получил информацию по интересующему его валютному контракту
Получение информации по контрактам

Используемые запросы

МетодОписаниеОперация в scopeШаг в схеме
1GET /v1/bank-control-statements/reg-curr-contracts/listПолучение списка ВБК по контрактуBANK_CONTROL_STATEMENT1. Получить все идентификаторы контрактов
2POST /v2/oauth/tokenОбновление токена доступаopenid1. Получить все идентификаторы контрактов
3GET /v1/bank-control-statements/reg-curr-contracts/{externalId}Получение документа валютный контракт с нерезидентомBANK_CONTROL_STATEMENT2. Получить информацию по контракту
Получение СПД

В схеме можно использовать автоматизированное подписание документа. Данная возможность доступна только при использовании ЭЦП сотрудника вашей компании (для отправки по собственной компании) или сотрудника дочерней компании (для отправки по дочерней компании).

Подробнее об использовании ЭЦП в Sber API можно почитать в одноименном разделе.

Справка о подтверждающих документах (СПД) – это документ, который оформляется в рамках валютного контроля при проведении внешнеэкономических операций. Она представляет собой заявление резидента о выполнении обязательств по контракту перед нерезидентом и подтверждает факт передачи подтверждающих документов в уполномоченный банк.

Оформление СПД необходимо для соблюдения требований валютного законодательства Российской Федерации. Это позволяет банкам контролировать выполнение контрактных обязательств и предотвращать нарушения валютных правил.

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

Важно отметить, что порядок оформления и подачи СПД регулируется нормативными актами Центрального Банка Российской Федерации и может изменяться со временем. Поэтому перед подготовкой СПД рекомендуется ознакомиться с актуальной информацией на сайте ЦБ РФ или обратиться за консультацией к специалистам в области валютного регулирования.

Шаги

  1. Заполнить данные по СПД
  2. Загрузить документы в банк
  3. Отправить запрос на создание СПД
  4. Получить статус запроса

Участники usecase

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформа)
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • Успешно выполнен сценарий "Получение информации по контрактам"
  • Платформа сохранила данные контракта, в рамках которого оформляется СПД
  • Пользователь находится в UI с валютным контрактом, по которому хочет сформировать СПД

Результат применения

  • Оформлена СПД в рамках валютного контракта, поставленного на учет в Сбере
Получение СПД

Используемые запросы

МетодОписаниеОперация в scopeШаг в схеме
1POST /v1/confirmatory-documents-inquiriesСоздание справки о подтверждающих документахCONFIRMATORY_DOCUMENTS_INQUIRY3. Отправить запрос на создание СПД
2POST /v2/oauth/tokenОбновление токена доступаopenid3. Отправить запрос на создание СПД
3GET /v1/confirmatory-documents-inquiries/{externalId}/stateПолучение статуса справки о подтверждающих документахCONFIRMATORY_DOCUMENTS_INQUIRY4. Получить статус запроса
4GET /v1/confirmatory-documents-inquiries/{externalId}Получение справки о подтверждающих документахCONFIRMATORY_DOCUMENTS_INQUIRY4. Получить статус запроса
Получение СВО

В схеме можно использовать автоматизированное подписание документа. Данная возможность доступна только при использовании ЭЦП сотрудника вашей компании (для отправки по собственной компании) или сотрудника дочерней компании (для отправки по дочерней компании).

Подробнее об использовании ЭЦП в Sber API можно почитать в одноименном разделе.

Сведения о валютной операции (СВО) является одним из документов, оформляемых в рамках валютного контроля при проведении внешнеэкономических операций. Предназначена для подтверждения факта совершения валютной операции и выполнения резидентом своих обязательств перед нерезидентом. СВО может понадобиться для предоставления в государственные органы, банки и другие организации для подтверждения факта проведения валютной операции и соблюдения валютного законодательства.

Шаги

  1. Заполнить данные по СВО
  2. Загрузить документы в банк
  3. Отправить запрос на создание СВО
  4. Получить статус запроса

Участники usecase

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформа)
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • Пользователь имеет пользовательский профиль в СберБизнес своей компании
  • Пользователь находится в пространстве Платформы
  • Пользователь прошел авторизацию с помощью СберБизнес ID

Результат применения

  • Оформлена СВО
Получение СВО

Используемые запросы

МетодОписаниеОперация в scopeШаг в схеме
1POST /v1/currency-operation-detailsСоздание сведений о валютной операцииCURRENCY_OPERATION_DETAILS3. Отправить запрос на создание СВО
2POST /v2/oauth/tokenОбновление токена доступаopenid3. Отправить запрос на создание СВО
3GET /v1/currency-operation-details/{externalId}/stateПолучение статуса сведений о валютной операцииCURRENCY_OPERATION_DETAILS4. Получить статус запроса
4GET /v1/currency-operation-details/{externalId}Получение сведений о валютной операцииCURRENCY_OPERATION_DETAILS4. Получить статус запроса
Валютный перевод

В схеме можно использовать автоматизированное подписание документа. Данная возможность доступна только при использовании ЭЦП сотрудника вашей компании (для отправки по собственной компании) или сотрудника дочерней компании (для отправки по дочерней компании).

Подробнее об использовании ЭЦП в Sber API можно почитать в одноименном разделе.

Шаги

  1. Получить реквизиты перевода
  2. Создать и подписать валютное платежное поручение

Участники usecase

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформа)
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • Пользователь имеет пользовательский профиль в СберБизнес своей компании
  • Пользователь находится в пространстве Платформы
  • Пользователь прошел авторизацию с помощью СберБизнес ID

Результат применения

  • Создано и подписано валютное платежное поручение
Валютный перевод

Используемые запросы

МетодОписаниеОперация в scopeШаг в схеме
1GET /v1/client-infoПолучение расширенной информацииGET_CLIENT_ACCOUNTS1. Получить реквизиты перевода
2POST /v2/oauth/tokenОбновление токена доступаopenid1. Получить реквизиты перевода
3POST /v1/pay-doc-curСоздание валютного платежного порученияPAY_DOC_CUR2. Создать и подписать валютное платежное поручение
Проверка статуса и корректности оплаты (В)

Время начала и частоту проверки статуса и корректности оплаты вы определяете самостоятельно исходя из своих бизнес-задач.

Шаги

  1. Получить статус оплаты
  2. Проверить корректность

Участники usecase

  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • Успешно выполнен сценарий «Валютный перевод»
  • Платформа сохранила идентификатор (extertalId) валютного платежного поручения, созданного в рамках сценария «Валютный перевод»

Результат применения

  • Валютное платежное поручение оплачено
  • Проверена корректность проведенной оплаты
Проверка статуса и корректности оплаты (В)

Используемые запросы

МетодОписаниеОперация в scopeШаг в схеме
1GET /v1/pay-doc-cur/{externalId}/stateПолучение статуса валютного платежного порученияPAY_DOC_CUR1. Получить статус оплаты
2POST /v2/oauth/tokenОбновление токена доступаopenid1. Получить статус оплаты
3GET /v1/pay-doc-cur/{externalId}Получение валютного платежного порученияPAY_DOC_CUR2. Проверить корректность
Рублевый перевод

В схеме можно использовать автоматизированное подписание документа. Данная возможность доступна только при использовании ЭЦП сотрудника вашей компании (для отправки по собственной компании) или сотрудника дочерней компании (для отправки по дочерней компании).

Подробнее об использовании ЭЦП в Sber API можно почитать в одноименном разделе.

Шаги

  1. Получить реквизиты перевода
  2. Создать и подписать рублевое платежное поручение

Участники usecase

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформа)
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • Пользователь имеет пользовательский профиль в СберБизнес своей компании
  • Пользователь находится в пространстве Платформы
  • Пользователь прошел авторизацию с помощью СберБизнес ID

Результат применения

  • Создано и подписано рублевое платежное поручение
Рублевый перевод

Используемые запросы

МетодОписаниеОперация в scopeШаг в схеме
1GET /v1/client-infoПолучение расширенной информацииGET_CLIENT_ACCOUNTS1. Получить реквизиты перевода
2POST /v2/oauth/tokenОбновление токена доступаopenid1. Получить реквизиты перевода
3POST /v1/paymentsСоздание рублевого платежного порученияPAY_DOC_RU2. Создать и подписать рублевое платежное поручение
Проверка статуса и корректности оплаты (Р)

Время начала и частоту проверки статуса и корректности оплаты вы определяете самостоятельно исходя из своих бизнес-задач.

Шаги

  1. Получить статус оплаты
  2. Проверить корректность

Участники usecase

  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • Успешно выполнен сценарий «Рублевый перевод»
  • Платформа сохранила идентификатор (extertalId) рублевого платежного поручения, созданного в рамках сценария «Рублевый перевод»

Результат применения

  • Рублевое платежное поручение оплачено
  • Проверена корректность проведенной оплаты
Проверка статуса и корректности оплаты (В)

Используемые запросы

МетодОписаниеОперация в scopeШаг в схеме
1GET /v1/pay-doc-cur/{externalId}/stateПолучение статуса валютного платежного порученияPAY_DOC_CUR1. Получить статус оплаты
2POST /v2/oauth/tokenОбновление токена доступаopenid1. Получить статус оплаты
3GET /v1/pay-doc-cur/{externalId}Получение валютного платежного порученияPAY_DOC_CUR2. Проверить корректность
Отправка письма в валютный контроль

Сценарий позволит отправить обращение в Валютный контроль Банка по вопросам, связанным с работой ВЭД в рамках Сбера.

Также у пользователя появляется возможность ответить на запросы Валютного контроля по СПД, СВО, процессу постановки контракта на учет и переводам в рублях и валюте.

В схеме можно использовать автоматизированное подписание документа. Данная возможность доступна только при использовании ЭЦП сотрудника вашей компании (для отправки по собственной компании) или сотрудника дочерней компании (для отправки по дочерней компании).

Подробнее об использовании ЭЦП в Sber API можно почитать в одноименном разделе.

Шаги

  1. Получить данные для письма
  2. Загрузить документы в банк
  3. Создать и подписать письмо в банк
  4. Получить статус отправки письма

Участники usecase

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформа)
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • Пользователь имеет пользовательский профиль в СберБизнес своей компании
  • Пользователь находится в пространстве Платформы
  • Пользователь прошел авторизацию с помощью СберБизнес ID
  • Если сценарий выполняется в качестве ответного письма на запрос Валютного контроля, то может потребоваться выполнение других сценариев для сбора контекста ответа

Результат применения

  • Письмо отправлено и принято Валютным контролем Банка
Отправка письма в валютный контроль

Используемые запросы

МетодОписаниеОперация в scopeШаг в схеме
1POST /v1/curr-control-messages/to-bankСоздание письма для целей ВК (в банк)CURR_CONTROL_MESSAGE_TO_BANK3. Создать и подписать письмо в банк
2POST /v2/oauth/tokenОбновление токена доступаopenid3. Создать и подписать письмо в банк
3GET /v1/curr-control-messages/to-bank/{externalId}/stateПолучение статуса письма для целей ВК (в банк)CURR_CONTROL_MESSAGE_TO_BANK4. Получить статус отправки письма
Получение писем от валютного контроля

Сценарий позволит получить письма от Валютного контроля. Необходимо с учетом ваших бизнес-потребностей предусмотреть регламентный запуск данного сценария, чтобы своевременно получать актуальную информацию по переписке с Банком.

Шаги

  1. Получить письма из банка

Участники usecase

  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • У Платформы есть токены доступа Пользователя, полученные с помощью СберБизнес ID

Результат применения

  • Платформа получила письма от Валютного контроля за период
Получение писем от валютного контроля

Используемые запросы

МетодОписаниеОперация в scopeШаг в схеме
1GET /v1/curr-control-messages/from-bankПолучение писем для целей ВК (из банка)CURR_CONTROL_MESSAGE_FROM_BANK1. Получить письма из банка
2POST /v2/oauth/tokenОбновление токена доступаopenid1. Получить письма из банка
Загрузка файлов в Банк

Этот сценарий позволяет загружать файлы и документы в систему Банка. Ссылки на эти файлы и документы можно будет использовать в запросах API.

Мы рекомендуем использовать сценарий с автоматическим запуском в других сценариях.

Представим, что ваша Платформа предлагает Пользователю создать запрос на постановку контракта на учет через форму в пользовательском интерфейсе (UI). В этой форме Пользователь загружает документы контракта.

Когда файлы загружаются в UI Платформы, и Пользователь подтверждает отправку запроса, автоматически запускается соответствующий сценарий для каждого файла.

Шаги

  1. Получить ссылку для загрузки
  2. Загрузить файл
  3. Получить статус загрузки

Участники usecase

  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • Запускается внутри одного из сценариев *У Платформы есть токены доступа Пользователя, полученные с помощью СберБизнес ID

Результат применения

  • Файл загружен в Банк
  • Платформа получила ссылку на файл в системе Банка
Загрузка файлов в Банк

Используемые запросы

МетодОписаниеОперация в scopeШаг в схеме
1POST /v1/files/uploadЗапрос ссылки на загрузку файла в БанкFILES1. Получить ссылку для загрузки
2POST /v2/oauth/tokenОбновление токена доступаopenid1. Получить ссылку для загрузки
3GET /v1/files/upload/{fileId}/stateПолучение статуса загрузки файлаFILES3. Получить статус загрузки

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.