Версия движка:
OcStore 2.1.0.2.1
Необходимо разработать модуль (способ) доставки (который будет отображаться/включаться/настраиваться там, где и остальные способы доставки в данной CMS и подтягиваться при выборе способа доставки) для Укрпочты, который сможет трекать посылки через API Укрпочты и менять статусы заказов по расписанию.
С API можна ознакомиться здесь: https://dev.ukrposhta.ua/uploads/Status-tracking-API-16102019.pdf
Вкратце: API возвращает код (int) и краткое описание события. Т.е. посылку приняли - один код, доставили - другой, клиент отказался - третий, вручена - четвертый и т.д.
Что будет нужно сделать:
- Добавить в просмотр, редактирование заказа поле для ввода трек-номера. Также, очень желательно добавить это же поле в расширенный редактор заказа OrderPro (он частично кодирован, тут нужно смотреть, возможно ли это в принципе).
- Вынести в настройки модуля стандартные настройки для модулей доставки: стоимость, класс налога, географическая зона, статус, порядок сортировки.
- При автоматическом смене статуса заказа в комментарий выводить описание события, полученное из API.
Добавить настройки, которые касаются именно этого модуля:
- поле для ввода ID для авторизации в API
- расписание, с какой частотой проверяются статусы заказов.
- настройка отслеживания статусов заказов (т.е. выглядеть это может как список всех статусов заказов, рядом с ними есть чекбоксы. Если чекбокс установлен, то заказы с таким статусом отслеживаются, если нет - то игнорируются. К примеру, неотгруженные и доставленные заказы трекать смысла нет).
- список кодов событий из API, которым можно назначить соответствующие статусы заказов (т.е. что-то типа таблицы - код события в API и выпадающий список со статусами заказа напротив. Нужно для того, чтобы задать соответствие возвращаемому коду события из API и статусу заказа).
Как это должно работать:
Заказу со способом доставки "Укрпочта" присваивается трек-номер и указывается один из статусов, который трекается (к примеру, "отгружен"). По расписанию модуль связывается с API, получает статус события по этому трек-номеру и меняет статус заказа на соответствующий, согласно настройкам. И так до конца, пока заказ не получит уже некий статус, который не нужно будет трекать (к примеру, "доставлен" или "возврат"). При смене статуса в историю заказа (т.е. комментарий, который может оставить менеджер при смене статуса заказа) автоматом добавляется информация, полученная из API.
Т.е. если у нас одному статусу заказа "в пути" соответствует несколько разных кодов от API (принят, на сортировке, на пункте выдачи и т.д.) это будет видно при просмотре заказа.
Важно:
- Трекаться должны только заказы с заполненным трек-номером и ЭТИМ выбранным способом доставки. Т.е. если заказу присвоен трек, а способ доставки другой (или наоборот), то трекать его не нужно.
- Если по ходу работы что-то не ясно, можно сделать 2-мя способами и т.д. - лучше спросите
- Модуль делается для себя и под себя. Не на продажу и никуда более.
