Назначение и принцип действия
Функционал для подключения интерфейса Яндекс.Быстрый заказ (предоставляющего возможность пользователям при оформлении заказа автоматически заполнять форму с адресом доставки) уже интегрирован в систему 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 | дополнительный телефон | строка |
| электронный адрес для связи | строка | |
| comment | комментарий к адресу | строка |
Если в URL кнопки задан параметр type, то в POST-запросе передаются следующие параметры:
| Параметр | Описание | Тип |
| operation_id | уникальный идентификатор операции передачи адреса | строка |
| address | адрес доставки и информация о пользователе в URL-encoded виде в формате, указанном в параметре type | xml или json |