IT интеграция с интернет магазином

IT интеграция с Интернет Магазином.

Версия 4

Оглавление

2        Информационное взаимодействие        2

3        Выбор типа интеграции        3

4        Выбор Покупателем пунктов сети Hermes Russia        3

4.1        Описание работы веб-компонента        3

4.1.1        Выбор способа доставки        3

4.1.2        Поиск пункта выдачи        4

4.1.3        Выбор пункта выдачи        11

4.1.4        Информация о пункте выдачи        12

4.2        Способы интеграции PS Chooser в сайт Интернет-магазина        12

5        Штрих-коды и идентификация заказов        13

5.1        Требования к наклейке и к штрих-коду        15

5.1.1        Рекомендации        16

6        Личный Кабинет Интернет-магазина        17

7        Контактная информация и уведомление получателей        18

8        Отслеживание состояния отправления        18

9        Планирование интеграции        19

9.1        Необходимая для интеграции информация        19

9.2        Этапы интеграции        19

9.3        Размещение информации о Hermes Russia на сайте Интернет-магазина        20

9.4        Извещение о Hermes Russia в Контакт-Центре Интернет-магазина        21

10        Контакты        22

Информационное взаимодействие

Данный раздел предназначен для руководства Интернет-магазина и содержит краткий обзор аспектов информационного взаимодействия Интернет-магазина и Раша» в процессе совместной работы по выполнению доставки, выдачи и оплаты заказа:

Выбор типа интеграции: API и/или Личный кабинет Выбор пунктов сети Hermes Russia во время оформления заказа выполняется Получателем, используя PS Chooser – основанное на картах и схемах метро веб приложение, встраиваемое в веб сайт клиента (подробно описано ниже). По каждому пункту выдачи описаны адрес, время работы, маршрут и сервисные условия. Веб приложение PS Chooser встраивается в систему приема заказов Интернет-магазина таким образом, что Получатель считает, что использует только сайт Интернет-магазина. Для загрузки в систему Интернет-магазина Раша» предоставляет в личном кабинете Интернет-магазина полный и обновляемый список пунктов выдачи с информацией, необходимой для регистрации заказов в системе Интернет-магазина. Для осуществления доставки, выдачи и оплаты Интернет-магазин передает через личный кабинет Раша» список заказов, в котором должна быть вся ключевая информация об отправлении (номер пункта выдачи, номер заказа с наклейки, стоимость, контактная информация Получателя). По условиям договора уведомление получателей может осуществляться Раша» на основе контактной информации, переданной в заказе. Для отслеживания состояния доставки на веб сайте Раша» Получатель вводит номер заказа (отправления) и получает информацию о заказе, такую как: в пути, доставлен в пункт выдачи, выдан, возвращен на склад Интернет-магазина. Также в информации о заказе Получатель видит ссылку на страницу описания пункта выдачи. Запросы от Получателя к службе поддержки Раша» направляются через форму обратной связи на веб сайте Интернет-магазина, после чего служба поддержки подтверждает запрос используя введенную контактную информацию. Отчеты о промежуточном состоянии и о завершении операции по заказам формируются Раша» и предоставляются Интернет-магазину через личный кабинет. Подробнее работа с личным кабинетом описана ниже.

Выбор типа интеграции

Интернет-магазину доступны следующие современные способы интеграции.

Автоматизированный процесс через API

Документация и примеры к сервисам доступны на сайте https://test-api. hermesrussia. ru/

Документация к сервисам прилагается к этому документу отдельно

Работа через веб-интерфейс личного кабинета

Описание работы прилагается к этому документу отдельно

По умолчанию всем клиентам выдается доступ к личному кабинету и ведется интеграция по этому способу. Если клиент желает полностью автоматизировать работу, можно в дополнении использовать веб-сервисы API.

Выбор Покупателем пунктов сети Hermes Russia Описание работы веб-компонента

Система выбора пункта выдачи Раша» (Parcel Shop Chooser или PS Chooser) реализуется на веб сайте Интернет-магазина в виде элемента IFRAME или через подключение Javascript-библиотеки.

Интернет-магазин при использовании компонента соглашается с правилами использования сервиса Яндекс. Карты.

Выбор способа доставки

Интернет-магазин добавляет ссылку на PS-chooser на веб-странице, где Получатель, уже сформировавший заказ, выбирает варианты доставки.

Поиск пункта выдачи

Следуя этой ссылке, Покупатель попадает на следующую страницу сайта Интернет-магазина, в которую встраивается функционал PS Chooser.

Компонент определяет геопозицию пользователя и фокусируется на регион, где предположительно находится покупатель.

Пункты выдачи группируются в кластеры по их количеству в отображаемой области, щелкнув по кластеру, карта будет приближена и список точек будет отображен на ней.

В фильтрах отображены основные параметры фильтрации и параметры выбранного города. Для очистки данных необходимо нажать на ссылку «Очистить»

Через город

При ошибках определении геопозиции или при принудительном выборе города необходимо использовать кнопку

Выбрав город, карта сфокусируется на регион этого города. Также Заказчик сможет дополнительно выполнять поиск пункта выдачи по списку адресов по кнопке «Список ПВЗ». Кнопка появляется только при выборе города.

Через ближайшее метро

Для г. Москвы и Московской области доступна кнопка для выбора ПВЗ в районе станции.

Аналогично реализован выбор для г. Санкт-Петербург и Ленинградской области

При щелчке по станции отобразится карта в районе этого метро (например, Парк Победы)

Выбор пункта выдачи

При этом отображаться на карте будут исключительно те из пунктов выдачи Hermes Russia, которые уже согласованы с Интернет-магазином по конкретному бизнес-юниту. На карте отображаются только открытые ПВЗ.

Информация о списке пунктов и описание каждого пункта выдачи всегда поддерживается ООО "Гермес Раша" в актуальном состоянии.

Информация о пункте выдачи

Для выбора пункта выдачи, необходимо нажать на кнопку «Выбрать этот пункт выдачи».

Кнопка «Печать» подготавливает страницу к печатной форме и вызывает стандартный процесс печати.

Кнопка «Как добраться» открывает Яндекс карты и выстраивает маршрут. На мобильных устройствах может открываться приложение, которое также построит маршрут до ПВЗ.

Способы интеграции PS Chooser в сайт Интернет-магазина

Hermes Russia предлагает два простых и удобных способа интеграции для выбора покупателем пунктов выдачи заказов:

Подключить к своему сайту JavaScript-библиотеку и встроить функционал выбора пункта выдачи непосредственно на свой сайт Разместить на своем сайте html-элемент iframe, в котором будет отображаться сайт выбора пункта выдачи

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

При возникновении вопросов интеграции веб-компонента PSCHOOSER просьба обращаться в it. *****@***ru

Штрих-коды и идентификация заказов

У интернет-магазина есть 2 способа идентификации заказов

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

Интернет-магазин назначает каждому заказанному отправлению номер в следующих целях:

Для печати штрих кода с идентификационным номером на наклейке отправлений В процессе транспортировки на этапе приемки груза на транспортном терминале Для идентификации отправления при уведомлении получателей; Для отслеживания получателями состояния отправления; В процессе хранения и выдачи отправления в пункте выдачи; Для отчетов ООО "Гермес Раша" об оказанных сервисах Интернет-магазину; Для коммуникации между Интернет-магазином и ООО "Гермес Раша" в случае вопросов по конкретным отправлениям.

Номер отправления должен отвечать следующим требованиям:

Уникальность – идентификационный номер должен быть разным на разных отправления и не должен повторяться в течении длительного периода времени. Как правило, он базируется на «внутреннем» номере заказа Интернет-магазина.

В зависимости от формата номера заказа в системе Интернет-магазина, применяют различные методы получения уникального идентификатора отправления, что согласовывается в процессе интеграции

Формат штрих-кода заказа Интернет-магазина

Ограничения на номер заказа отсутствует, единственное, длина не должна превышать 256 символов

Формат штрих-кода заказа в системе Hermes Russia

Формат штрих-кода в случае автоматической генерации на стороне Hermes Russia будет 14-значным числом. Если Интернет-магазин не выбирает автогенерацию, то формат может быть любым текстовым значением из латинских букв и цифр, который согласуется в процессе интеграции и передается Интернет-магазину. Для числового диапазона можно использовать просто набегающий номер в данном диапазоне.

Альтернативно Интернет-магазин может формировать номер штрих-кода на основе номера заказа. Если № заказа Интернет-магазина содержит менее 14 разрядов, то слева добавляется (до 14 разрядов) определенная комбинация цифр. Например, если номер заказа 23045201, а старшие цифры диапазона 660, которые соответствуют номеру магазина, то вариант допустимого идентификатора 66000023045201 (подчеркнуты добавленные цифры). Лучше всего нули размещать в середине штрих-кода.

Для каждого отправления Интернет-магазин распечатывает наклейку, которая должна содержать следующие поля:

ФИО заказчика (получателя отправления) Штрих-код идентификатора отправления в формате CODE 128, если формат отличается, необходимо проверить его работоспособность в Hermes Russia Идентификатор отправления в виде цифр, читаемых человеком (14 знаков)

Для формирования наклейки с изображением штрих-кода Интернет-магазин может использовать один из методов:

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

Загрузив заказы, Интернет-магазин сообщает ООО "Гермес Раша" список отправлений, а также сможет получить документ, содержащий набор разложенных по листам наклеек со всеми необходимыми полями, включая штрих-код.

Самостоятельно использовать средства печати штрих-кода, предлагаемые системой 1С «Торговля и склад» Самостоятельно установить на компьютере Интернет-магазина специализированное программное обеспечении для печати наклеек со штрих-кодами.

Требования к наклейке и к штрих-коду

В случае использование средств печати Интернет-магазином, необходимо учесть следующие требования к наклейке

Логотип Hermes (печатный вариант вы можете запросить у вашего менеджера Hermes Russia) Наименование Интернет-магазина ФИО получателя Штрих-код Текстовое значение штрих-кода

Пример наклейки из личного кабинета клиента

И к штрих-коду

1. Допустимые форматы штрих-кодов

1.1.        Code 39, Code 39 Full ASCII, Code 39 Trioptic

1.2.        Code 128, Code 128 Full ASCII

1.3.        Interleaved 2 of 5 (ITF)

1.5        EAN

2. Допустимые символы в штрих-коде

2.1.        числа (Ascii [48 – 57])

2.2.        латинские буквы (Ascii [65 – 90] and [97 – 122])

2.3.        дефис - (Ascii 45)

2.4.        нижнее подчеркивание _ (Ascii 95)

2.5.        звёздочка * (Ascii 42)

2.6.        тильда ~ (Ascii 126)

2.7.        решётка # (Ascii 35)

2.8.        амперсанд & (Ascii 38)

2.9.        собачка @ (Ascii 64)

2.10.        скобки ( ) [ ] { } (Ascii 40, 41, 91, 93, 123, 125)

3. Под изображением штрих-кода должно быть текстовое значение штрих-кода

4. Фон штрих-кода должен быть белым

5. Цвет штрих-кода не может быть желтым

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

Рекомендации
Цвет штрих-кода и текста должен быть черным Шрифт должен быть Arial 14pt или любой читаемый Все символы штрих-кода должны быть одного регистра Предварительно передать отсканированную наклейку в Hermes Russia для проверки читаемости штрих-кода
Личный Кабинет Интернет-магазина

Простой способ интеграции - Личный кабинет клиента (далее – ЛК) – защищенный веб-интерфейс обмена данными, выделенный конкретному Интернет-магазину.

ЛК предоставляет Интернет-магазину функционал

Управления заказами Печать наклеек, акта-приёма передачи Отслеживание статусов и возвратов Список доступных ПВЗ

Ниже приведена информация о демонстрационном доступе

Адрес:        https://test-my.hermesrussia.ru/

Логин:        testlogin

Пароль:        testpassword

Примечание: при открытии Личного Кабинета, помимо запроса логина и пароля, браузер, возможно, выдаст предупреждение безопасности, в ответ на которое нужно продолжить работу.

Отслеживание статусов невозможна из-за технических ограничений тестовой версии личного кабинета.

Пользовательская документация доступна после авторизации в личном кабинете в меню пользователя, раздел «Документация к системе» или по ссылке

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

Контактная информация и уведомление получателей

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

Уведомления рассылаются в формате email, SMS при наличии необходимых контактных данных.

Отслеживание состояния отправления

Для отслеживания состояния отправления могут использоваться следующие способы:

Отслеживание получателем на сайте ООО "Гермес Раша" www.hermesrussia.ru путем ввода номера отправления или внутреннего номера заказа Интернет-магазина Через личный кабинет Интернет-магазина Через веб-сервисы (API) Интернет-магазина Отслеживание получателем на сайте Интернет-магазина, при условии использования Интернет-магазином данных о статусах отправлений, передаваемых ООО "Гермес Раша" интернет-магазину; Отслеживание получателем на сайте Интернет-магазина, при условии использования Интернет-магазином фрагмента отслеживания с сайта ООО "Гермес Раша".

Ниже приведен пример формы отслеживания на сайте ООО "Гермес Раша" с результатом запроса:

Планирование интеграции Необходимая для интеграции информация

Для интеграции Интернет-магазина с сетью Hermes Russia необходима следующая информация:

Ожидаемый объем отгрузок; Расписание отгрузок; Список регионов, в которые Интернет-магазин будет отгружать заказы; Регион склада Интернет-магазина; Телефон контактного центра Интернет-магазина; Возможность печати на складе Интернет-магазина наклейки с уникальным штрих кодом; Возможность автоматизации обмена данными через предложенные ООО "Гермес Раша" средства; Тип заказываемых товаров; Максимальная величина наложенного платежа; Выбор Интернет-магазином способа встраивания на сайте Интернет-магазина функции выбора пункта выдачи при оформлении заказа; Встроить на сайт Интернет-магазина веб компонент ООО "Гермес Раша" (PSChooser) с указанием идентификатора ID для каждого каталога/сайта Интернет-магазина Использовать на сайте Интернет-магазина свою карту с добавлением в нее пунктов

выдачи ООО "Гермес Раша", используя API ООО "Гермес Раша" в качестве данных

Использовать на сайте Интернет-магазина список пунктов выдачи без карты

Примечание: По результатам выбора Интернет-магазином способа представления пунктов на сайте Интернет-магазина необходимо согласовать технические детали интеграции карты и/или данных о пунктах выдачи в системе Интернет-магазина.

Данная информация обсуждается на этапе переговоров как для предложения коммерческих и операционных условий, так и предложения конкретной конфигурации технической интеграции.

Этапы интеграции

Проект интеграции состоит из следующих основных этапов:

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

№	Название этапа	Примерная длительность
Заполнение Интернет-магазином документов по интеграции (по списку)	1
Выбор способа интеграции: личный кабинет или API	1
Присвоение ООО "Гермес Раша" ID для каждого каталога/сайта Интернет-магазина	1
Получение Интернет-магазином адреса, логин и пароля для личного кабинета Интернет-магазина или для API	1
Получение в личном кабинете и загрузка тестового списка ПВЗ в тестовую систему Интернет-магазина	1
Передача Интернет-магазином через личный кабинет тестовых заказов	3
Проверка Интернет-магазином файла отчета о статусах по тестовым посылкам	3
Изменение ПО на стороне Интернет-магазина согласно результатам теста	5
Пробная отгрузка реальных посылок и выдача пробному получателю	1
Решение Интернет-магазина о дате начала реальных заказов и отгрузок	1
Размещение выбора ПВЗ (PS Chooser Hermes Russia либо карта собственной разработки Интернет-магазина либо список ПВЗ) на сайте Интернет-магазина	1
Загрузка Интернет-магазином актуального списка ПВЗ в систему Интернет-магазина	1
Запуск (реальные заказы, отгрузки, выдачи)	1

В процессе интеграции производятся два теста:

Тестовый обмен данными без реальной перевозки посылок. На этом этапе проверяется: Корректность загрузки Интернет-магазином данных о пунктах выдачи (если требуется, например, при использовании PS Chooser ООО "Гермес Раша" такая загрузка необязательна, но может требоваться в зависимости от системы Интернет-магазина); Корректность выгрузки Интернет-магазином заказов с данными о посылках (в частности проверяется формат, а также корректность идентификаторов брендов Интернет-магазина и идентификаторов пунктов выдачи ООО "Гермес Раша"); Корректность получения Интернет-магазином статусов посылок (при ручной обработке такого файла Интернет-магазином проверяется интерпретация данных Интернет-магазином). Реальная доставка заказов тестовых получателей (обычно работников Интернет-магазина) с обмена данными между реальными системами. На этом этапе проверяется: Доступность склада Интернет-магазина для забора груза; Корректность накладных; Корректность обмена данными между реальными системами. Размещение информации о Hermes Russia на сайте Интернет-магазина

Для информирования клиентов о способе доставки, на сайте Интернет-магазина размещается информация о Hermes Russia. В тексте выделяются ссылки на сайт Hermes Russia.

Стандартный вариант размещения информации - после Почты России «Экспресс-доставка в пункты выдачи Hermes Russia»:

Экспресс-доставка в пункты выдачи Hermes Russia

Hermes Russia дает Вам свободу выбора времени и места получения Вашего заказа при сохранении всех преимуществ быстрой и надежной доставки.

Широкая сеть пунктов выдачи заказов Hermes Russia развернута на базе предприятий розничной торговли шаговой доступности и предлагает удобный график работы, включая выходные и праздничные дни.

Отследить Ваш заказ можно на сайте www. hermesrussia. ru (ссылка на сайт)

Когда посылка будет доставлена в пункт выдачи Hermes Russia, по указанному Вами адресу электронной почты и/или на мобильный телефон Вы получите уведомление о доставке, содержащее следующую информацию:

Номер посылки Адрес пункта выдачи и ссылка на карту с подробным описанием маршрута Часы работы пункта выдачи Сумму к оплате (если посылка не была предоплачена) Срок хранения посылки Содержимое посылки Телефон центра поддержки Hermes Russia

Получение заказа:

Назовите сотруднику пункта выдачи фамилию, на которую был оформлен заказ Оплатите заказ наличными и/или по карте, получите кассовый чек Если заказ предоплачен, предъявите кассиру пин-код или документ, удостоверяющий личность Срок хранения заказа в пунктах выдачи Hermes Russia до 14 дней

Специалисты центра поддержки Hermes Russia готовы ответить на Ваши вопросы относительно получения заказов 7 дней в неделю.

Извещение о Hermes Russia в Контакт-Центре Интернет-магазина

Сценарий для Контакт-Центра при оформлении заказа покупателем по телефону и запросе о способе доставки его посылки:

- И. О., Вы можете получить заказ в пункте выдачи Hermes Russia – это ускоренные сроки доставки, удобное расположение и экономия на почтовом сборе, а также другими способами (перечислить). Как Вам будет удобнее?

Контакты

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

Вопросы по срокам, этапам проекта интеграции, стоимости заказов и другим организационным моментам необходимо направлять в отдел продаж [email protected]