Логотип

Документация по макросам и шаблонам UMI.CMS

Подключение Яндекс.Быстрый заказ

Назначение и принцип действия

Функционал для подключения интерфейса Яндекс.Быстрый заказ (предоставляющего возможность пользователям при оформлении заказа автоматически заполнять форму с адресом доставки) уже интегрирован в систему UMI.CMS. Для того, чтобы применить этот функционал разместите специальную кнопку на странице оформления заказа на вашем сайте. При нажатии на данную кнопку пользователь перейдет в свой профиль на Яндекс, откуда можно загрузить данные адреса, контактов и т.п. После выбора данных для загрузки пользователь будет перенаправлен на страницу магазина, указанную при размещении кнопки. На ту же страницу передаются данные из профиля, и поля формы заполняются автоматически.

Как подключить интерфейс

Заполните форму регистрации в программе "Быстрый заказ". Обязательно укажите URL страницы, на которую необходимо отправлять загружаемые данные.
Далее вам будет предложен код кнопки, которую необходимо установить на странице оформления заказа. Также будет сгенерирован параметр url_id.

Как добавить кнопку

Далее необходимо встроить кнопку в шаблон страницы оформления заказа. Вы можете воспользоваться кодом кнопки, предложенным после регистрации, или написать его самостоятельно.
URL кнопки должен иметь вид: http://market.yandex.ru/addresses.xml?callback={callback_url}&size={mini}&type={xml|json}

Параметры URL:

  • callback — обязательный параметр. Содержит указанный при подключении интерфейса URL, на который необходимо отправлять данные из профиля. URL должен быть в URL-encoded виде.
  • size — необязательный параметр. Допустимое значение: mini. Предназначен для отображения интерфейса профиля в небольшом окне.
  • type — необязательный параметр. Задает формат, в котором на страницу вашего сайта передаются выбранные пользователем данные. Допустимые значения: json, xml. При отсутствии данного параметра данные передаются в виде пар «key=value», разделенных символом &.

Пример URL:

<a href="http://market.yandex.ru/addresses.xml?callback=http%3A%2F%2Fc-fox.umi.ru%2Femarket%2Fpurchase%2Fautofill%2Fyandex"></a>

Как загрузить данные из профиля

При нажатии на кнопку откроется страница профиля пользователя в Яндексе. Пользователю необходимо будет авторизоваться и выбрать данные для загрузки на страницу оформления заказа, это могут быть адресные данные для доставки, личные и контактные данные. Далее пользователь будет перенаправлен на URL, указанный при подключении интерфейса. Данные выбранного адреса передаются на этот же URL в виде POST-запроса.

Если в URL кнопки отсутствует параметр type, то метод POST вернет следующие параметры:

Параметр Описание Тип
operation_id уникальный идентификатор операции передачи адреса строка
id идентификатор адреса целое число
title название адреса строка
street улица строка
building номер дома целое число
suite корпус строка
flat квартира целое число
entrance подъезд целое число
floor этаж целое число
intercom домофон строка
city город строка
country страна строка
zip индекс целое число
metro станция метро строка
cargolift наличие грузового лифта значение «yes» при наличии, значение «no» при отсутствии
firstname имя строка
lastname фамилия строка
fathersname отчество строка
phone телефон строка
phone-extra дополнительный телефон строка
email электронный адрес для связи строка
comment комментарий к адресу строка

 

Если в URL кнопки задан параметр type, то в POST-запросе передаются следующие параметры:

Параметр Описание Тип
operation_id уникальный идентификатор операции передачи адреса строка
address адрес доставки и информация о пользователе в URL-encoded виде в формате, указанном в параметре type xml или json
Была ли данная статья полезна?