Rozetka Delivery & Justin Shipping — ROZETKA and Justin pick-up points for OpenCart 2.3, 3.x and 4.x

Rozetka Delivery & Justin Shipping is a shipping module for OpenCart 2.3, 3.x and 4.x with two methods, ROZETKA Delivery and Justin. The customer picks a city and a pick-up point right in the cart and the order address is filled in automatically. For ROZETKA the module also creates the waybill and prints the label from the shipments list.

What the customer sees

At the delivery step a ROZETKA pickup point selection block appears: the customer types a city name, picks it from the list, then picks a specific pickup point — from small branches to large electronics hypermarkets. The choice is saved in the session and written to the order automatically, together with the pickup point address.

Justin — pick-up points in Silpo stores

A separate “Justin” shipping method in the same package. The customer picks a city from the list and a Justin pick-up point in a Silpo store; the module writes the point address into the order (“Justin: street, building” plus the spot inside the store). The list — about 300 points in ~80 cities — comes from justin.ua and is refreshed daily by cron; if justin.ua is down, the last good copy stays in use. The order cannot be placed with Justin until a point is chosen.

The module does not create Justin waybills: Justin has no public shipments API, so you create the shipment in your Justin account. Waybills from the admin are for ROZETKA Delivery only.

The Justin price is fixed (there is no rates API), plus a free-shipping threshold, geo zone, tax class and sort order. The method is installed, configured and switched off separately from ROZETKA; the settings show how many points are loaded and when, with a “Refresh the list now” button.

What the admin gets

One settings page: a static API token, a rate (weight tiers, free-delivery threshold, volumetric weight), sender details (city and pickup point are pulled from your ROZETKA Delivery partner dashboard), geozone and tax class. A separate “Shipments” screen shows every order with its chosen pickup point and buttons for creating a waybill, updating status and cancelling.

Under the hood

• Three separate builds — native for OpenCart 4.x (PSR-4 namespaces, events API), classic for OpenCart 3.x (event table, Bootstrap 3), PHP 5.6-compatible for OpenCart 2.3 (an address fallback via an ocmod patch, since 2.3 has no controller events).
• API token encrypted in the database — AES-256-CBC with HMAC and a secret unique to each store. If someone dumps the database, the token won’t read out in plain text.
• Local cache of cities and pickup points — the ROZETKA Delivery directories are served without authorisation, so cart hints work even before the token is set up.
• The same licence client as CatCode’s other Pro modules: a 7-day trial, the key is checked on the CatCode server.

How to install

1. Download the build you need via Extensions → Installer in your OC admin: rozetka_delivery.ocmod.zip for OpenCart 4.x, rozetka_delivery-oc3-1.1.3.ocmod.zip for OpenCart 3.x, rozetka_delivery-oc2-1.1.3.ocmod.zip for OpenCart 2.3.
2. Activate it in the list, then go to settings → click “Install” (this creates the database tables, events, cron jobs).
3. Paste the static token from your ROZETKA Delivery partner dashboard, click “Check token”.
4. Choose the sender’s city and pickup point, fill in the contact details → save.
5. Done — the ROZETKA pickup point selection block will appear in the cart.
6. For Pro features: click “Try Pro” (free for 7 days) or paste your purchased licence key → “Activate”.
7. For Justin: Extensions → Shipping → “Justin” → “Install”, enable the method, set the price and save; the point list loads by itself (or with the “Refresh the list now” button).

Upgrading from 1.0.x

• OpenCart 4.x — starting with 1.1.1, the settings, token, licence and Justin settings survive uninstalling and reinstalling the module through the Installer. This does not work from 1.0.x (the old version kept no copy of the settings): either copy the archive contents over FTP into extension/rozetka_delivery/ — the settings stay; or reinstall the module through the Installer and configure it again (the token has to be entered again).
• OpenCart 3.x — upload the new zip through Extensions → Installer over the old one: the settings are kept. Then install the “Justin” method in Extensions → Shipping.
• OpenCart 2.3 — first delete the old “ROZETKA Delivery” 1.0 modification in Extensions → Modifications, then upload the new zip, copy the upload/ folder over FTP (the 2.3 installer does not copy files without FTP) and click Modifications → Refresh.