Описание сервиса

 

Сервис информационного взаимодействия реализует набор методов, необходимых для передачи и синхронизации данных между компанией СДЭК и клиентом интернет-магазином или партнером, представляющим интернет-магазин.

Взаимодействие с сервисом происходит в режиме онлайн с помощью стандартного протокола HTTPS и формата JSON.

Инициатором запросов является как ИС клиента, так и СДЭК (в части вебхуков).

Режим взаимодействия

Платформа интеграции ИС СДЭК реализует асинхронный режим, предусматривающий синхронный возврат ответа.

Иными словами, мы принимаем запрос на выполнение действия над какой-либо сущностью (например, заказом), синхронно выполняем предварительную статичную валидацию.. Если данный этап выполнился успешно, то возвращается ответ (HTTP 202) с UUID сущности. Параллельно ответу (HTTP 202) в системе запускается фоновый процесс полной валидации (например, проверка доступности маршрута, тарифа и т.д.) и выполнение действия над сущностью в основной системе СДЭК.

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

Информация по заказам, созданным через сервис Интеграция, хранится в базе данных Интеграции 1 год. Получить информацию по заказам, которые были созданы ранее, вы можете через ЭК5.

Правила формирования сообщений

При формировании сообщения необходимо руководствоваться следующими правилами:

• В заголовке обязательно необходимо передавать токен авторизации.
• Обмен сообщениями должен осуществляться в кодировке UTF-8.

• Если элемент сообщения является необязательным, то такой элемент в сообщении может отсутствовать, либо значение элемента может быть пустым. 

• Если элемент сообщения является обязательным, то он не может быть пустым.