Полное описание интеграции с системой dostavka guru по средствам web-сервисов



Скачать 387.84 Kb.
страница1/8
Дата31.07.2016
Размер387.84 Kb.
  1   2   3   4   5   6   7   8
guru_v_png_prew


Полное описание интеграции с системой DOSTAVKA.guru по средствам WEB-сервисов




Оглавление


1. Введение: 3

1.1 Получение секретного ключа API 3

2. Интеграция в КОРЗИНУ или на страницу оформления заказа интернет магазина 4

2.1 Требования к адресу 4

2.2 Интерактивная строка ввода адреса с подсказками 4

2.3 Вставка карты ПВЗ с событиями для корзины 7

2.4 Калькулятор 20

2.5 Получение списка ПВЗ по названию города 23

2.6 Проверка наличия курьерской доставки в регионы по индексу, городу и названию региона 24

3. Интеграция в АДМИН ПАНЕЛЬ интернет магазина 26

3.1 Описание полей для отправки данных о заказе 26

3.2 Метод отправки данных о заказе 27

3.3 Алгоритм получения ответа 28

3.4 Распечатка штрих-кодов 29

3.5 Проверка статуса созданного заказа в системе 31

3.6 Получение ближайших 30 релевантных дат доставки 32

4. Дополнительно 35

4.1 Получение полного списка ПВЗ 35

4.2 Получение информации о ПВЗ по его ID 37

4.3 Получение списка городов с ПВЗ 39

4.4 Вставка карты ПВЗ на сайт, как информационная страница 40

4.5 Проверка качества адреса 41




1. Введение:


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

Обмен осуществляется по методу отправки POST данных на сервер и получение соответствующего ответа. Отправка POST данных должны быть в кодировке UTF-8. Ответ от сервера, если нет ошибок, будет передаваться в формате XML, в случае ошибок в ответе сервера будет передаваться стек с ошибками:



Error:{наименование ошибки 1}

Error:{наименование ошибки 2}

1.1 Получение секретного ключа API


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

Тестовый ID партнера: 9999

Тестовый ключ-API: 827ccb0eea8a706c4c34a16891f84e7b

После успешной интеграции с тестовыми данными, Вы должны подать заявку на получение боевого ключа API менеджерам по электронному адресу info@dostavka.guru с указанием 3-4 номеров заказов, прошедших удачный обмен в тестовом режиме.

Тема письма: Ключ API

Текст письма:

Название интернет-магазина (грузоотпрваитель): Ромашка.рф

ID клиента в системе (логин в личном кабинете): 1234 или cl_1234

Номера заказов, прошедших обмен: 1234, 5678, а14

2. Интеграция в КОРЗИНУ или на страницу оформления заказа интернет магазина


В данном разделе описаны сервисы для автоматизации оформления заказов в системах управления интернет магазинами.

2.1 Требования к адресу


Все адреса проходят проверку по базам КЛАДР и ФИАС. Чтобы адрес был правильным и система его пропустила он должен быть:

  • Реальным – адрес должен быть зарегистрирован в реестре КЛАДР и ФИАС

  • Адрес должен быть полным и указан как минимум до дома

  • Адрес не должен содержать: этаж, код домофона, или фразы типа "салон красоты", "сразу за макдональдсом", "территория завода" и пр.

Схема составления адреса:

{Регион}, {Район}, {Нас. пункт}, ул. {улица}, д. {дом}, к. {корпус/строение}, кв. {квартира}



Примеры:

Московская обл., Королев, ул. Комитетский Лес, д. 18, к. 1, кв. 247

г Москва, ул Мусы Джалиля, д 2 к 1 кв 3

2.2 Интерактивная строка ввода адреса с подсказками


Автоматизированная строка поиска адреса позволит избежать ошибки при вводе адреса клиентом.

Пример работы скрипта можно посмотреть здесь:

http://api.dostavka.guru/client/search_addr.html

addr

Скрипт вставки поисковой строки:

Пример html кода со стилями (атрибут id="address2" обязателен для идентификации строки адреса). Блок с классом : является контейнером для вывода списка подсказок.





Введите первые 4 буквы адреса:







Скрипт для получения списка подсказок и извлечения всех параметров адреса (Для работы скрипта необходимо наличие подключенной библиотеки jquery с поодержкой конструкции "$(document).on('..."). В функции get_result_addr_list_GURU() - необходимо поставить Ваши ключ API и ID партнера:







Поделитесь с Вашими друзьями:
  1   2   3   4   5   6   7   8


База данных защищена авторским правом ©uverenniy.ru 2019
обратиться к администрации

    Главная страница