Интеграция

Как добавить карту доставки на свой сайт

Добавьте виджет на свой сайт, чтобы вашим клиентам было проще и удобнее выбрать пункт выдачи. Виджет можно настроить под ваши потребности. Клиенты на карте смогут:

  • выбрать пункты с нужным способом оплаты при получении: наличными или картой;
  • посмотреть пункты с опцией примерки одежды или обуви.

Как добавить виджет на сайт #

  1. Перейдите в раздел Настройки личного кабинета и выберите вкладку Виджет доставки.
  2. Нажмите кнопку Копировать скрипт.
  3. Настройте нужные параметры для виджета.
  4. Вставьте виджет на свой сайт.

Как настроить виджет #

В виджет встроено несколько параметров:

  • defaultcity — город, по которому будет центрироваться карта. По умолчанию карта центрируется по Москве.
  • hideselect — скрывает кнопку выбора пункта выдачи или постамата. Этот параметр стоит использовать только для информационных карт, так как клиент не сможет выбрать нужный пункт на такой карте. По умолчанию «false».
  • hidepvz — скрыть выбор пункта выдачи. По умолчанию «false».
  • hidepostamat — скрыть выбор постамата. По умолчанию «false».
  • packages[[weight, width, height, length], [weight, width, height, length]] — указать для коробок в отправлениях вес в граммах и габариты в миллиметрах. По умолчанию [5000, 200, 200, 200].
  • fromplaceid — идентификатор склада отгрузки. По умолчанию первый склад из вашего списка.
  • showdeliveryprice — показывать стоимость доставки. По умолчанию «false».
  • showdeliverytime — показывать дату доставки. По умолчанию «false».
  • deliverypricemarkupfix — фиксированная сумма изменения стоимости доставки. Может быть положительной и отрицательной.
  • deliverypricemarkuppercent — процент изменения стоимости доставки. Может быть положительным или отрицательным. Если указан deliverypricemarkupfix, deliverypricemarkuppercent не применяется.
  • deliverytimemarkup — количество дней, на которое нужно изменить сроки доставки.
  • showPrepaymentOnly — показывает пункты выдачи, которые работают только по предоплате.
  • showPostpaymentOnly — показывает пункты выдачи, которые работают только по постоплате.

Как получить данные из виджета #

Виджет может передавать на ваш сайт данные:

  • ID точки.
  • Тип доставки: курьером, в пункт выдачи или в постамат.
  • Адрес точки.
  • Дополнительные услуги, которые потребуются клиенту: примерка одежды или обуви.

Чтобы при оформлении заказа виджет передавал эти данные, добавьте на ваш сайт функцию:


window.addEventListener("message", receiveMessage, false);
function receiveMessage(event)
{
    // Важно не слушать чужие события
    if (event.origin !== "https://rocket.ozon.ru")
     return;
    console.log(event.data)
}

После добавления функции на сайт вы сможете получать данные, выбранные клиентом на карте, в формате:


{
id: 15973726093000,
type: "Пункт выдачи",
address: "Россия, г. Москва, ул. Пырьева, д. 16",
fittingClothesAvailable: true,
fittingShoesAvailable: false,
price: 100,
time: "28 декабря"
}

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




  

Выбор города #

Чтобы изменить город, по которому будет центрироваться карта, добавьте в виджете в конце ссылки &defaultcity=название города. Например:

&defaultcity=Санкт-Петербург: https://rocket.ozon.ru/lk/widget?token=XQoStt3Pr8TFIJfRTw7txw%3D%3D&defaultcity=Санкт-Петербург.

При добавлении этой настройки карта центрируется по указанному вами городу.

Пример виджета:






Скрыть кнопку выбора #

Чтобы скрыть кнопку выбора на карте, добавьте в виджете в конце ссылки
&hideselect=true: https://rocket.ozon.ru/lk/widget?token=XQoStt3Pr8TFIJfRTw7txw%3D%3D&hideselect=true.

При добавлении этой настройки карта будет информационной. У клиента не получится выбрать на карте способ и адрес доставки, но сможет ознакомиться с доступными пунктами выдачи и постаматами.

Пример виджета:






Скрыть пункты выдачи на карте #

Чтобы скрыть пункты выдачи на карте, добавьте в виджете в конце ссылки
&hidepvz=true: https://rocket.ozon.ru/lk/widget?token=XQoStt3Pr8TFIJfRTw7txw%3D%3D&hidepvz=true.

При добавлении этой настройки пункты выдачи не отображаются на карте.

Пример виджета:






Скрыть постаматы на карте #

Чтобы скрыть постаматы на карте, добавьте в виджете в конце ссылки
&hidepostamat=true: https://rocket.ozon.ru/lk/widget?token=XQoStt3Pr8TFIJfRTw7txw%3D%3D&hidepostamat=true.

При добавлении этой настройки постаматы не отображаются на карте.

Пример виджета:






Указать габариты коробок в отправлениях #

Чтобы указать габариты коробок в отправлениях, добавьте в виджете в конце ссылки
&packages[[weight, width, height, length], [weight, width, height, length]]. Например, https://rocket.ozon.ru/lk/widget?token=XQoStt3Pr8TFIJfRTw7txw%3D%3D&packages[[6000, 200, 200, 200], [5000, 200, 200, 300]].

Пример виджета:






Указать идентификатор склада отгрузки #

Чтобы указать идентификатор склада, с которого вы будете отгружать товары, добавьте в виджете в конце ссылки &fromplaceid=идентификатор нужного склада. Например, https://rocket.ozon.ru/lk/widget?token=XQoStt3Pr8TFIJfRTw7txw%3D%3D&fromplaceid=9042178932000.

По умолчанию стоимость доставки будет рассчитываться от первого склада в вашем списке. Его можно узнать в личном кабинете, в выпадающем списке «Пункт приёма Ozon».

Этот параметр важен в тех случаях, когда вы хотите отображать на карте стоимость или дату доставки не от первого склада в списке. Идентификатор нужного склада отгрузки можно найти в личном кабинете, в разделе Импорт товаров.

Пример виджета:






Показывать на карте стоимость доставки #

Чтобы показывать клиентам стоимость доставки до выбранного пункта выдачи, добавьте в виджете в конце ссылки &showdeliveryprice=true: https://rocket.ozon.ru/lk/widget?token=XQoStt3Pr8TFIJfRTw7txw%3D%3D&showdeliveryprice=true.

Чтобы виджет мог рассчитать стоимость доставки, вам нужно указать склад отгрузки с помощью параметра fromplaceid. Если вы не укажете идентификатор другого склада, стоимость доставки будет по умолчанию рассчитываться от первого склада в вашем списке.

Пример виджета:






Показывать на карте дату доставки #

Чтобы показывать клиентам дату доставки до выбранного пункта выдачи, добавьте в виджете в конце ссылки &showdeliverytime=true: https://rocket.ozon.ru/lk/widget?token=XQoStt3Pr8TFIJfRTw7txw%3D%3D&showdeliverytime=true.

Если у вас выбрано несколько складов отгрузки, не забудьте указать идентификатор удобного склада с помощью параметра &fromplaceid. Если вы не укажете идентификатор другого склада, дата доставки будет по умолчанию рассчитываться от первого склада в вашем списке.

Пример виджета:






Изменить стоимость доставки для покупателя в рублях #

Чтобы изменить стоимость доставки для покупателя в рублях, добавьте в виджете в конце ссылки &deliverypricemarkupfix=нужная сумма. Например, https://rocket.ozon.ru/lk/widget?token=XQoStt3Pr8TFIJfRTw7txw%3D%3D&deliverypricemarkupfix=-50.

Сумма может быть положительной, если вы хотите увеличить стоимость доставки для покупателя, или отрицательной — если хотите уменьшить. Если вы примените эту функцию, мы будем всегда повышать или понижать стоимость доставки для покупателя на указанную сумму.

Если указан параметр deliverypricemarkupfix, deliverypricemarkuppercent не применяется. Если указаны оба значения, виджет отобразит функцию deliverypricemarkupfix.

Чтобы показывать стоимость доставки на карте, используйте параметр &showdeliveryprice.

Пример виджета:






Изменить стоимость доставки для покупателя в процентах #

Чтобы изменить стоимость доставки для покупателя в процентах, добавьте в виджете в конце ссылки &deliverypricemarkuppercent=нужный процент. Например, https://rocket.ozon.ru/lk/widget?token=XQoStt3Pr8TFIJfRTw7txw%3D%3D&deliverypricemarkuppercent=10.

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

Если указан параметр deliverypricemarkupfix, deliverypricemarkuppercent не применяется. Если указаны оба значения, виджет отобразит функцию deliverypricemarkupfix.

Чтобы показывать стоимость доставки на карте, используйте параметр &showdeliveryprice.

Пример виджета:






Увеличить количество дней доставки #

Если вы хотите увеличить количество дней доставки, в виджете в конце ссылки добавьте &deliverytimemarkup=количество дней. Например, https://rocket.ozon.ru/lk/widget?token=XQoStt3Pr8TFIJfRTw7txw%3D%3D&deliverytimemarkup=2.

Вы можете указать только положительное число в значении этого параметра. Использовать её нужно тогда, когда вы хотите на несколько дней отсрочить дату доставки. Например, если вам нужно несколько дополнительных дней на сборку.

Чтобы клиент видел на карте дату доставки, используйте параметр &showdeliverytime.

Пример виджета:






Показывать только пункты, которые работают по предоплате #

Чтобы показать только пункты, работающие по предоплате, добавьте в виджете в конце ссылки &showPrepaymentOnly. Например, https://rocket.ozon.ru/lk/widget?token=XQoStt3Pr8TFIJfRTw7txw%3D%3D&showPrepaymentOnly.

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

Пример виджета:






Показывать только пункты, которые работают по постоплате #

Чтобы показать только пункты, работающие по постоплате, добавьте в виджете в конце ссылки &showPostpaymentOnly. Например, https://rocket.ozon.ru/lk/widget?token=XQoStt3Pr8TFIJfRTw7txw%3D%3DshowPostpaymentOnly.

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

Пример виджета:






Если у вас остались вопросы или есть предложения по улучшению сервиса, напишите нам на help@rocket.ozon.ru.