/

Разработчику оформления заказа

СТАТЬЯ 24

В штатном sale.order.ajax модуль подключает выбор ПВЗ и адрес курьера автоматически. В самописной форме необходимо проверить не только виджет, но и передачу назначения, телефона и запуск пересчёта после изменений.

Компоненты и свойства заказа

Для ручного размещения доступны:

  • topman:ozondelivery.point.select — выбор ПВЗ;
  • topman:ozondelivery.address — адрес курьера.

Компоненты используют DELIVERY_ID, PERSON_TYPE_ID и CONTAINER_ID. Компонент ПВЗ также поддерживает HUMAN_INPUT_NAME для поля читаемого адреса магазина. Передавайте фактические значения текущего заказа и профиля, а не ID с тестового сайта.

Пункт хранится в служебном свойстве OZON_DELIVERY_POINT, курьерский адрес — в OZON_ADDRESS. Наличие адреса в обычном текстовом поле не заменяет эти данные. Для курьера используется результат геокодера с подписью модуля; произвольный JSON с координатами не является корректной интеграцией.

Если форма полностью своя и не использует штатный экземпляр OrderAjaxComponent, подключите пересчёт самого шаблона после сохранения нового назначения и телефона. Универсальной строки JavaScript для любого оформления нет: сначала выясните, как шаблон отправляет поля заказа и обновляет результат расчёта.

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

Получение номера и даты из PHP

Для чтения уже сохранённых данных можно использовать:

<?php

use Bitrix\Main\Loader;
use Topman\OzonDelivery\Posting\Info;

if (Loader::includeModule('topman.ozondelivery')) {
    // $shipmentId — ID нужной отгрузки в вашем контексте.
    $trackingNumber = Info::trackingNumber($shipmentId);
    $plannedDate = Info::deliveryDate($shipmentId);
    $plannedDateText = Info::format($plannedDate);
}

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

Для всех отправлений заказа доступен Info::forOrder($orderId), для отдельной отгрузки — Info::forShipment($shipmentId). Не выбирайте первую посылку вслепую, если заказ разбит на несколько отгрузок.

Цена в карточке товара

Точный расчёт требует не только города, но и параметров посылки, метода, конкретного ПВЗ либо координат курьерского адреса и подходящего телефона. Поэтому вызов «рассчитать доставку до города» нельзя считать тем же расчётом, что в оформлении заказа.

Если нужен предварительный виджет в карточке товара, определите, какое назначение и упаковку он использует, и подпишите результат как предварительный. Выполняйте расчёт на сервере через действующую логику службы, не передавайте ключи Ozon в JavaScript и не создавайте сохранённый заказ ради получения цены.

Интеграцию проверяйте на установленной версии модуля: смена города, телефона, количества, плательщика, доставки и AJAX-перерисовка не должны возвращать старую цену или старый адрес.