ВЭД

Обновлено 29 ноября 2024

Компаниям

Холдингам

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

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

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

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

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

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

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

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

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

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

Постановка контракта на учет

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

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

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

Шаги

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

Участники usecase

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

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

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

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

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

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

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

Получение информации по контрактам

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

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

Шаги

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

Участники usecase

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

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

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

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

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

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

№	Метод	Точка вызова	Описание	Операция в scope	Шаг в схеме
1		/fintech/api/v1/bank-control-statements/reg-curr-contracts/list	Получение списка ВБК по контракту	BANK_CONTROL_STATEMENT	1. Получить все идентификаторы контрактов
2		/ic/sso/api/v2/oauth/token	Обновление токена доступа	openid	1. Получить все идентификаторы контрактов
3		/fintech/api/v1/bank-control-statements/reg-curr-contracts/{externalId}	Получение документа валютный контракт с нерезидентом()	BANK_CONTROL_STATEMENT	2. Получить информацию по контракту

Получение СПД

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

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

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

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

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

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

Шаги

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

Участники usecase

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

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

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

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

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

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

№	Метод	Точка вызова	Описание	Операция в scope	Шаг в схеме
1		/fintech/api/v1/confirmatory-documents-inquiries	Создание справки о подтверждающих документах	CONFIRMATORY_DOCUMENTS_INQUIRY	3. Отправить запрос на создание СПД
2		/ic/sso/api/v2/oauth/token	Обновление токена доступа	openid	3. Отправить запрос на создание СПД
3		/fintech/api/v1/confirmatory-documents-inquiries/{externalId}/state	Получение статуса справки о подтверждающих документах	CONFIRMATORY_DOCUMENTS_INQUIRY	4. Получить статус запроса
4		/fintech/api/v1/confirmatory-documents-inquiries/{externalId}	Получение справки о подтверждающих документах	CONFIRMATORY_DOCUMENTS_INQUIRY	4. Получить статус запроса

Получение СВО

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

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

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

Шаги

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

Участники usecase

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

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

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

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

• Оформлена СВО

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

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

Валютный перевод

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

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

Шаги

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

Участники usecase

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

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

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

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

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

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

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

Проверка статуса и корректности оплаты (В)

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

Шаги

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

Участники usecase

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

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

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

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

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

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

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

Рублевый перевод

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

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

Шаги

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

Участники usecase

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

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

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

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

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

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

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

Проверка статуса и корректности оплаты (Р)

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

Шаги

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

Участники usecase

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

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

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

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

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

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

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

Отправка письма в валютный контроль

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

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

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

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

Шаги

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

Участники usecase

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

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

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

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

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

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

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

Получение писем от валютного контроля

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

Шаги

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

Участники usecase

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

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

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

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

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

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

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

Загрузка файлов в Банк

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

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

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

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

Шаги

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

Участники usecase

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

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

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

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

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

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

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