Page tree
Skip to end of metadata
Go to start of metadata

Виджет ПВЗ

Для отображения и выбора ПВЗ разработан виджет ПВЗ. Для внедрения виджета на страницу сайта необходимо ознакомиться с инструкцией ниже. Пример с внедренным виджетом ПВЗ можно посмотреть на сайте [1]. Сам виджет ПВЗ расположен по адресу [2]. При выборе пользователем ПВЗ виджетом выдаются параметры выбранного ПВЗ. В этих параметрах есть external_id, значение этого параметра необходимо использовать в поле PickupPoint->Id при создании заказа или расчёте тарифа.

Инструкция по внедрению виджета ПВЗ

Виджет интегрируется путем размещения html элемента div с id="app", JavaScript кода, который скачивает JS скрипт виджета с ресурса, кода инициализации виджета. Для отображения отладочной информации необходимо разместить элемент pre c id="debug".

В код страницы необходимо вставить код:

 <div id="app"></div>

Вставить JS скрипт виджета после тега выше:

<script type="text/javascript" src="https://pvz.ponyexpress.ru/e-commerce/widget1.0.js"></script>

После JS скрипта нужно разместить код инициализации виджета, содержащий дополнительные параметры в поле params.

<script type="text/javascript">
new PvzWidget({
		mount: document.getElementById('app'),
		params: {
			ignore_ids: []
		},
		onSelectPoint: function (poi) {
			console.log(poi);
			document.getElementById('debug').innerText = JSON.stringify(poi);
		},
		toggleFullscreen: function () {
			if (document.getElementById('app').className == 'fullscreen') {
				document.getElementById('app').className = '';
			} else {
				document.getElementById('app').className = 'fullscreen';
			}
		}
	});
</script>

Описание возможных параметров приведено ниже в таблице. Пример см. в [1].

ПараметрПримерФормат, комментарий
ignore_idsignore_ids: [1, 2, 6, 53],возможность не выводить точки с опр. ID
providersproviders: [],возможность выводить точки опр. провайдера
ignore_typesignore_types: ['Пункт самовывоза'],возможность не выводить точки опр. типа
ignore_postal_codesignore_postal_codes: [420101],возможность не выводить точки опр. индекса
regionsregions: ['Московская'],возможность не выводить точки опр. региона
ignore_cash_paymentignore_cash_payment: false,не выводить точки с возможностью оплаты наличными
ignore_prepaymentignore_prepayment: false,не выводить точки с возможностью оплаты предоплаты
ignore_card_paymentignore_card_payment: false,не выводить точки с возможностью оплаты картой
ignore_required_documentsignore_required_documents: false,не выводить точки, где требуют документы
show_thank_windowshow_thank_window: trueпосле выбора точки показывать окно Спасибо или нет
init_locationinit_location:          {   
                   region: 'Санкт-Петербург',
                   city: 'Санкт-Петербург',
                   center: [59.887315, 30.268079],
                   zoom: 14
               }
местоположение при инициализации

Как это работает

 Шаг 1. Открываем в браузере ссылку http://widget-examples.p2e.ru/WidgetPVZ

Шаг 2. Кликаем иконку ПВЗ на карте. Например, около Апрелевки.

Шаг 3. Нажимаем кнопку "ВЫБРАТЬ".

Отобразятся параметры выбранного ПВЗ, среди которых есть external_id. Значение этого параметра нужно передать в поле PickupPoint->Id при создании заказа или расчёте тарифа.

  • No labels