Базовая интеграция

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

Результат работы базового скрипта

Скрипт для вставки на страницу интернет-магазина

На одной стрнице может быть только один скрипт

Скопировать скрипт в буфер

Параметры

Параметр Необходимость Описание
data-client-id обязательно Содержит ID клиента Maxima-express.
data-triggers обязательно Содержит ID HTML элемента по клику на который виджет будет открываться.
data-allow-select опционально Открывает виджет в режиме ознакомления. Виджет позволяет производить все необхдимые действия по навигации и поиску без возможности окончательного выбора пункта выдачи заказа или оформить заявку на доставку курьером. Пример можно посмотреть на странице описания возможнотей виджета.
Используется для предоставления конечному пользователю интернет-магазина информации о возможностях доставки и ее стоимости без оформления самой доставки.
data-point-description-element опционально Содержит ID HTML элемента. Разрешает после выбора пользователем пункта выдачи заказа или оформления курьерской доставки и закрытия виджета передать в указанный ID элемента текстовый блок со всеми параметрами в зависимости от выбранного пользователем типа доставки. Элемент может быть DIV, INPUT или TEXTAREA. Пример использования параметра на странице возможностей.
Используется для информирования пользователя интернет-магазина, какой пункт доставки он выбрал.
data-form-element опционально Содержит ID HTML элементы типа <form id='.....' и разрешает виджету после выбора пункта выдачи заказа или оформления курьерской доставки передать на страницу интернет-магазина в форму все данные в виде невидимых полей. Список полей приведен в разделе 'Возвращаемые значения'.
Используется для полного управления полученными из виджета данными после его закрытия. Например для добавления в заказ стоимости доставки перед переходом в оплату. Особенно необходимо, если стоимость доставки зависит от зоны доставки и заранее стоимость заказа с учетом доставки неизвестна.
data-callback опционально Содержит название JavaScript функции, которую необходимо вызвать после закрытия виджета. Важно: Закрытием является момент исчезновения виджета по любой из причин: Выбор пункта доставки или закрытие по кнопке закрытия без выбора пункта доставки. Пример использования можно посмотреть на странице 'Возможности'. Функция выводит console.log().
Используется для полного управления полученными из виджета данными после его закрытия.

Возвращаемые значения

Если в виджет передавался параметр data-form-element то после закрытия виджета, если пользователь выбрал пункт выдачи заказа или оформил заявку на доставку курьером, то в форме с ID из значения параметра data-form-element будет созданы невидимые INPUT поля со всеми данными из виджета. В разделе 'возможности' инструментами разработчика можно отследить появление полей в теге <form.

Поле Тип доставки Значение
mx_widget_result_text любой Содержит в себе HTML форматированный блок текста со всеми параметрами о выбранном типе, адресе и стоимости доставки.
mx_widget_result_name любой Содержит текст ФИО получателя если выбрана доставка курьером или название пункта выдачи заказа
mx_widget_result_cost любой Содержит стоимость доставки
mx_widget_result_notify любой Содержит true или false, в зависимости от решения пользователя получать SMS уведомления.
mx_widget_result_phone любой Содержит номер телефона, даже если пользователь отказался от SMS уведомлений.
mx_widget_result_delivery_type любой 0 - доставка на пункт выдачи заказа, 1 - доставка курьером
mx_widget_result_address любой Содержит текст с полным адресом, который ввел пользователь в заявке на курьерскую доставку или адрес пункта выдачи заказа.
mx_widget_result_comment доставка курьером Содержит текст который пользователь ввел в поле 'комментарий' в форме оформления заявки на курьерскую доставку.
mx_widget_result_delivery_time доставка курьером Содержит удобное время доставки, выбранное пользователем.
mx_widget_result_id пункт выдачи заказа Содержит ID Maxima-Express пункта выдачи заказа
mx_widget_result_description пункт выдачи заказа Содержит описание пункта выдачи заказа.
mx_widget_result_delivery_period пункт выдачи заказа Содержит срок доставки до пункта выдачи заказа.