Получение детальной информации поручения на покупку/продажу валюты

Обновлено 8 июня 2026

Возвращает данные поручения на покупку/продажу валюты

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

Рекомендации по тестированию в песочнице

1. Позитивный сценарий:

• в параметре пути (path) указывайте произвольное значение externalId в формате UUID

• Результат:

• HTTP 200 OK

• Тело ответа:

  • generalData.bankStatus = "CREATED"
  • generalData.bankComment = "Операция обрабатывается банком"
  • модель данных документа

---

2 Альтернативные сценарии:

• для получения документа в статусе IMPLEMENTED, необходимо заполнить externalId = "d481c762-1dc7-4f63-9db5-8d6b442d6f35"
  • generalData.bankStatus = "IMPLEMENTED"
  • модель данных документа
• для получения документа в статусе REFUSEDBYBANK, необходимо заполнить externalId = "dc245537-28b5-47bc-8d73-ee9dfdb04298"
  • generalData.bankStatus = "REFUSEDBYBANK"
  • generalData.bankComment = "Операция отказана банком"
  • модель данных документа
• для получения ошибки HTTP 400 с кодом BUSINESS_EXCEPTION, необходимо заполнить externalId = "8024e5eb-8ae6-4719-abed-789173ef1b70"
  • cause = "BUSINESS_EXCEPTION"
  • message = "Документ с таким externalId не найден."
  • internalErrorCode = 188.1-1003
• для получения ошибки HTTP 500 с кодом TECHNICAL_EXCEPTION, необходимо заполнить externalId = "6ca178cc-658c-435f-ab00-b27b190f64c1"
  • cause = "TECHNICAL_EXCEPTION"
  • message = "Документ с таким externalId не найден."
  • internalErrorCode = 188.1-5003
• для получения ошибки HTTP 500 с кодом UNKNOWN_EXCEPTION, необходимо заполнить externalId = "c56c1281-9d44-427c-8973-731f6750350d"
  • cause = "UNKNOWN_EXCEPTION"
  • message = "Документ с таким externalId не найден."
  • internalErrorCode = 188.1-1000

Запрос

Ответы

Успешный ответ

"Ошибка в запросе"

Cause	Message	Description
DOC_NOT_FOUND	Документ по операции не найден	Если операции по такому externalId нет в базе данных currency_operation
TECHNICAL_EXCEPTION	Техническая ошибка	Если возникли прочие технические ошибки
BUSINESS_EXCEPTION	Ошибка бизнес-процесса	Если возникли различные бизнес ошибки

"Не авторизован"

Cause	Message	Description
UNAUTHORIZED	accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х	Указан некорректный или просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос.

"Операция не может быть выполнена: доступ к ресурсу запрещен"

Cause	Message	Description
ACTION_ACCESS_EXCEPTION	Операция не может быть выполнена: доступ к ресурсу запрещен	Используемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API. В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция CONVERSION_OPERATION_CURRENCY. Необходимо добавить одному или несколько операций в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token.

"Ошибка валидации запроса"

Cause	Message	Description
VALIDATION_FAULT	Валидация запроса завершилась ошибкой	Модель запроса не прошла валидацию на SOWA

"Превышен лимит запросов"

Cause	Message	Description
TOO_MANY_REQUESTS	Превышен лимит запросов. Повторите операцию позже.	Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее

"Внутренняя ошибка сервера"

Cause	Message	Description
UNKNOWN_EXCEPTION	Внутренняя ошибка сервера	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.

"Сервис временно недоступен"

Cause	Message	Description
UNAVAILABLE_RESOURCE_EXCEPTION	Внутренняя ошибка сервера	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.

Loading...