Как подключить Ozon Доставку к сайту на Тильде: пошаговая инструкция

Проверьте этот список заранее: без любого из пунктов цепочка «корзина → оплата → Ozon» не замкнётся.

• Платный тариф Тильды — Personal или Business. На тарифе Free не работают приём оплаты и передача данных форм, а без них оплаченный заказ не дойдёт до сервиса. Подробнее — в статье какой тариф Тильды нужен.
• Корзина ST100 и онлайн-оплата. Доставка Ozon работает только с предоплатой: отправление создаётся после того, как покупатель оплатил заказ.
• Кабинет «Ozon Доставка для бизнеса» с договором страхования, методом доставки, ключами API и положительным балансом.
• Регистрация в сервисе — на странице tilda.ev-gerasimov.ru/signup: почта, адрес сайта и ИНН организации или ИП (сервис — для юрлиц и ИП). Кабинет откроется по ссылке из письма, без пароля. В кабинете мастер «Подключение» ведёт по тем же шагам, что в этой инструкции, и сам отмечает выполненные: видит код виджета на сайте, вариант и скрытые поля в корзине, проверочный запрос вебхука и первый заказ. Если письмо не пришло, проверьте «Спам».
• Вес и размеры товаров в карточках Тильды. Если их нет, сервис возьмёт вес и коробку по умолчанию из настроек, но цена будет точнее с реальными данными.

Всё на этом шаге делается в кабинете Ozon Доставки один раз и одинаково для любого сайта, поэтому подробности — в общих статьях:

1. Договор страхования. Страхование посылок обязательно; договор оформляет Управляющий кабинета. См. договор страхования.
2. Метод доставки. Через API доступна самостоятельная отгрузка: вы сами сдаёте посылки в пункт отгрузки Ozon. См. метод доставки и пункт отгрузки.
3. Ключи API. В кабинете доставки → «Управление частными приложениями» создайте приложение с правами delivery-api.* и скопируйте client_id и client_secret. См. ключи API.
4. Баланс. Ozon проверяет его, когда вы подтверждаете собранную посылку. См. баланс кабинета.

В разделе «Настройки» кабинета сервиса:

• Ключи Ozon — client_id и client_secret. Секретный ключ хранится на сервере сервиса в зашифрованном виде и в браузер не попадает; в кабинете его можно только заменить, но не посмотреть.
• Метод доставки — кнопка «Найти методы доставки» покажет методы из вашего кабинета Ozon, останется выбрать нужный.
• Домены сайта на Тильде — по одному в строке: адрес вида *.tilda.ws и ваш собственный домен. Виджет работает только на этих доменах.
• Название варианта — с какого слова начинается вариант доставки в корзине (по умолчанию «Ozon»).
• Телефон магазина для примерной цены. Ozon не считает цену без номера телефона, поэтому до того, как покупатель введёт свой номер, примерная цена считается по номеру магазина. Номер должен быть зарегистрирован в Ozon; покупателю он не показывается.
• Посылка — вес товара без веса, вес упаковки и размеры коробки по умолчанию.
• Цена — наценка, шаг округления вверх и «бесплатно от суммы». Как это складывается, рассказано в статье как считается цена доставки.
• Тексты — описание посылки для Ozon (без персональных данных) и предупреждение о номере телефона, которое покупатель увидит в корзине.
• Ключ Яндекс.Карт — необязательно: без него выбор пункта работает списком. См. карта пунктов.
• Свой токен DaData — необязательно: с ним покупатель видит подсказки адреса при вводе (город, улица, дом) и сразу получает ближайшие пункты. Без токена поиск по адресу и «Рядом со мной» работают как обычно. Получить его просто: зарегистрируйтесь на dadata.ru → «Личный кабинет» → «API-ключ». Бесплатно — до 10 000 подсказок в сутки; нужен только API-ключ, секретный ключ не нужен. Токен хранится в сервисе зашифрованным и в браузер не попадает.
• Почта для уведомлений — сюда придут письма о заказах, которые требуют внимания.

Откройте блок корзины (ST100) → «Контент» → поле «Доставка». Нужен простой режим поля, а не «Службы доставки». Добавьте вариант:

Ozon — пункт выдачи

Цену указывать не нужно: виджет подставит её сам после выбора пункта. Главное, чтобы название начиналось со слова из настроек сервиса. Свою радиокнопку виджет в корзину не вставляет — он работает с вариантом, который создали вы, поэтому Тильда знает о нём и обрабатывает как обычный вариант доставки.

Там же сделайте ещё две вещи:

• Поле «Телефон»: включите маску с кодом страны и поставьте страну по умолчанию «Россия». Без выбранной страны маска может подставить чужой код, а доставка Ozon работает только на номера +7.
• Три скрытых поля с переменными ozon_point_id, ozon_point_address, ozon_quote_id. Через них пункт выдачи попадёт в письмо о заказе и в заявки Тильды. Если полей нет, виджет добавит их сам, но объявленные в блоке поля надёжнее.

Тильда сверяет цену доставки на своём сервере. Для встроенных служб она считает цену сама, а цену варианта Ozon ставит виджет в браузере, поэтому при строгом уровне проверки Тильда может отклонить такой заказ.

В настройках платёжных систем проекта (Настройки сайта → Платёжные системы → Общие настройки) найдите «Уровень проверки цены доставки» и выберите значение, которое не запрещает заказ при отличии цены, — например, «Только помечать в заявке». Цену при этом всё равно проверяет сервис: он сверяет оплаченную сумму доставки с расчётом Ozon. Подробно — в статье уровень проверки цены доставки.

Откройте Настройки сайта → Ещё → HTML-код для вставки внутрь head и вставьте две строки из раздела «Установка» кабинета сервиса:

• стиль, который прячет вариант Ozon, пока виджет не загрузился и сервис не подтвердил, что способ включён;
• подключение скрипта виджета с публичным идентификатором вашего магазина.

Секретов в этом коде нет: ключи Ozon остаются на сервере. Код в head действует на всех страницах сайта, поэтому корзина с Ozon откроется на любой из них.

Вебхук — то, через что Тильда сообщает сервису об оплаченном заказе.

1. Откройте Настройки сайта → Формы → Webhook и вставьте адрес вебхука из кабинета сервиса.
2. Заполните API-ключ: «API Method» — в заголовке, «API Name» и «API Key» — как указано в кабинете сервиса. Секрет показывается там же; его можно выпустить заново, если он попал не в те руки.
3. Подключите вебхук в настройках блока корзины: «Контент» → «Приём данных».
4. В настройках платёжной системы оставьте включённым «Отправлять данные в сервисы приёма данных только после оплаты».

При подключении Тильда шлёт проверочный запрос — сервис отвечает на него сам. Подробно о сроках, повторах и защите — в статье вебхук Тильды.

Откройте опубликованный сайт, положите товар в корзину, выберите «Ozon — пункт выдачи», найдите пункт, введите свой номер телефона и оплатите заказ. После оплаты:

1. Заказ появится в кабинете сервиса на странице «Заказы», а отправление в Ozon создастся автоматически в течение минуты.
2. Нажмите «Собрано» и проверьте, что отправление стало «Готов к отгрузке» и открывается «Этикетка PDF».
3. Если заказ тестовый, нажмите «Отменить отправление» до сдачи посылки — до отгрузки отмена бесплатна. Деньги за тестовый заказ возвращаете вы сами в платёжной системе.