Краткое описание В данном документе описаны спецификации веб-сервисов компании Hermes Russia. Веб-сервисы компании Hermes Russia позволяют клиентам осуществить интеграцию для выполнения основных операций.
Для клиентов доступны два типа взаимодействия с веб-сервисами: REST и классический SOAP.
Описание терминов ПВЗ – Пункт выдачи заказов
Штрих-код посылки – уникальный номер посылки, используемый для графического отображения на наклейке на посылке и для всех взаимодействий по посылке между клиентом, получателем и Hermes Russia
Бизнес-юнит – структурное подразделение клиента. Если у клиента есть несколько каталогов, сайтов или брендов, для которых на всех стадиях жизненного цикла доставки посылки должно быть явно известно, к которому из них она относится, то такие структуры клиента необходимо выделить в самостоятельные бизнес-юниты
«Экспресс-возврат» - услуга возврата уже выкупленных сколько угодно давно получателем товаров в любом состоянии. Товары могут быть из разных посылок. В одном возврате могут быть не все товары из первоначальной посылки. Первоначальная посылка могла быть доставлена другой службой доставки.
Предзаказ - Информация о еще не переданных на доставку посылках.
Расположение Веб-сервисы Hermes Russia расположены по адресу
Тестовая версия:
Основной модуль API
SOAP https://test-api.hermes-dpd.ru/ws/webservice.svc?wsdl
https://test-api.hermes-dpd.ru/ws/webservice.svc?singlewsdl
REST https://test-api.hermes-dpd.ru/ws/restservice.svc?wsdl
https://test-api.hermes-dpd.ru/ws/restservice.svc?singlewsdl
Тестовая учетная запись
пользователь – testlogin, пароль – testpassword,
код бизнес-юнита BusinessUnitCode – 1000
код склада DirectDistributionCenterCode/ReturnDistributionCenterCode – 437, при создании заказа CreatePreadvice можно не указывать, т.к. система сама попытается найти и подставить нужный номер.
для тестовой версии при создании заказа CreatePreadvice поле ParcelBarcode нужно оставить пустым, т.к. код посылки будет сгенерирован автоматически.
При вызове метода получения статусов по посылкам GetStatusesByParcelBarcodes используйте следующие номера посылок для примера: 99000176079743,33332000009663,99000176131090,99000176157939,99000176207399.
Модуль API генерации наклеек
SOAP https://test-api.hermes-dpd.ru/ss/webservice.svc?wsdl
https://test-api.hermes-dpd.ru/ss/webservice.svc?singlewsdl
REST https://test-api.hermes-dpd.ru/ss/restservice.svc?wsdl
https://test-api.hermes-dpd.ru/ss/restservice.svc?singlewsdl
Производственная версия:
Описание всех сервисов – https://api.hermes-dpd.ru
Основной модуль API
SOAP https://api.hermes-dpd.ru/ws/webservice.svc?wsdl
https://api.hermes-dpd.ru/ws/webservice.svc?singlewsdl
REST https://api.hermes-dpd.ru/ws/restservice.svc?wsdl
https://api.hermes-dpd.ru/WS/restservice.svc?singlewsdl
Модуль API генерации наклеек
SOAP https://api.hermes-dpd.ru/ss/webservice.svc?wsdl
https://api.hermes-dpd.ru/ss/webservice.svc?singlewsdl
REST https://api.hermes-dpd.ru/ss/restservice.svc?wsdl
https://api.hermes-dpd.ru/ss/restservice.svc?singlewsdl
В качестве транспортного протокола используется https протокол. Авторизация пользователей производится по паре логин-пароль. Для получения логина и пароля необходимо обратиться в отдел продаж компании Hermes Russia. Авторизация для всех сервисов идентична.
|