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

ВЭД

Обновлено 3 декабря 2024

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

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

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

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

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

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


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

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

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

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

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

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

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


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


Шаги

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

Участники usecase

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

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

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

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

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

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

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

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

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


Шаги

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

Участники usecase

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

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

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

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

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

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

МетодТочка вызоваОписаниеОперация в scopeШаг в схеме
1Alt text/fintech/api/v1/bank-control-statements/reg-curr-contracts/listПолучение списка ВБК по контрактуBANK_CONTROL_STATEMENT1. Получить все идентификаторы контрактов
2Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid1. Получить все идентификаторы контрактов
3Alt text/fintech/api/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Шаг в схеме
1Alt text/fintech/api/v1/confirmatory-documents-inquiriesСоздание справки о подтверждающих документахCONFIRMATORY_DOCUMENTS_INQUIRY3. Отправить запрос на создание СПД
2Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid3. Отправить запрос на создание СПД
3Alt text/fintech/api/v1/confirmatory-documents-inquiries/{externalId}/stateПолучение статуса справки о подтверждающих документахCONFIRMATORY_DOCUMENTS_INQUIRY4. Получить статус запроса
4Alt text/fintech/api/v1/confirmatory-documents-inquiries/{externalId}Получение справки о подтверждающих документахCONFIRMATORY_DOCUMENTS_INQUIRY4. Получить статус запроса
Получение СВО

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

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


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


Шаги

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

Участники usecase

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

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

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

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

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

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

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

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

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


Шаги

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

Участники usecase

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

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

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

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

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

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

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

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


Шаги

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

Участники usecase

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

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

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

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

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

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

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

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

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


Шаги

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

Участники usecase

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

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

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

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

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

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

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

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


Шаги

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

Участники usecase

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

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

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

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

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

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

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

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

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


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

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


Шаги

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

Участники usecase

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

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

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

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

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

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

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

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


Шаги

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

Участники usecase

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

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

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

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

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

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

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

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


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

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

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


Шаги

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

Участники usecase

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

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

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

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

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

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

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

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