Automatic tracking checks
Register Canada Post tracking numbers once and process eligible shipments automatically on schedule.
DOCUMENTATION — VERSION 1.0.1
Fencair Canada Post Auto Tracking & Order Status Automation
Installation, activation and operations guide for automatic Canada Post tracking and merchant-controlled OpenCart order status automation. Version 1.0.1 includes guided Scheduled Tracking / Cron Setup in the module admin.
CURRENT RELEASE
v1.0.1
Current package: fencair-canada-post-auto-tracking-1.0.1-oc3.ocmod.zip. v1.0.1 adds the in-admin Scheduled Tracking / Cron Setup panel while preserving the existing tracking, licensing and activation architecture.
OVERVIEW
What the extension automates
Fencair checks Canada Post shipment activity and turns configured carrier states into explicit OpenCart order status decisions, reducing repetitive manual tracking and status administration.
Status normalization
Normalize carrier results before merchant-controlled mapping rules run.
Automatic order status updates
Apply merchant-configured OpenCart status changes through the normal order-history path.
Scheduled processing
Process eligible tracking records through the local CLI runner.
Dry-run diagnostics
Evaluate eligible work without mutating tracking or order state.
Signed licensing
Use production, staging or development activations with signed local entitlement verification.
INSTALLATION01 02 03 04
Install on OpenCart 3
Back up the store before installing or updating extensions.
Upload the package
In OpenCart Admin open Extensions → Installer and upload fencair-canada-post-auto-tracking-1.0.1-oc3.ocmod.zip.
Refresh modifications if required
Open Extensions → Modifications and refresh the modification cache when your OpenCart installation requires it.
Install the module
Open Extensions → Extensions → Modules, find Fencair Canada Post Auto Tracking & Order Status Automation and select Install.
Open module settings
Configure licensing, Canada Post API access, status mapping, scheduler guidance and diagnostics.
LICENSE
Activate the Fencair license
Choose the correct Store Type and activate the license from the module. Direct purchases use the Fencair license key. OpenCart Marketplace purchases use the Marketplace Order ID + purchase-email claim flow.
Each license permits one active production/live store plus one shared non-production staging/development/test installation. Production activation may be transferred after explicitly deactivating the previous production installation.
CANADA POST API
Configure merchant-controlled Canada Post credentials
Select the Canada Post Test or Production environment and enter the merchant-owned API Client ID and Client Secret. Production is required before live automation can be enabled. Normal Canada Post tracking traffic goes directly from the store to Canada Post; Fencair does not proxy ordinary carrier tracking requests.
STATUS MAPPING
Map Canada Post states to automatic OpenCart order updates
Fresh installations are intentionally conservative. Normalized states remain log-only or manual-review until the merchant explicitly maps them. Unknown states are never guessed into an order status. Duplicate and stale events cannot replay completed actions or regress final workflow state.
SCHEDULED TRACKING
Use the in-admin Cron Setup panel
Version 1.0.1 adds Scheduled Tracking / Cron Setup directly in the module admin. The panel shows the detected CLI Runner path, a recommended 15-minute Cron Example, the Dry-run Command and the Dry-run JSON Command, with Copy buttons for each value.
Recommended cadence: every 15 minutes. Run the displayed dry-run command first, then copy the generated live cron command into cPanel, Plesk, ISPmanager, system cron or the hosting provider’s equivalent scheduler. The extension does not require a public cron URL or query-string cron secret.
CLI reference: php cli/fencair-canadapost-tracking.php
Dry-run reference: php cli/fencair-canadapost-tracking.php --dry-run --json
DIAGNOSTICS
Validate before unattended operation
Use dry-run before enabling unattended processing. Review normalized status, last checked time, safe operational logs and error counters. Keep raw carrier payload storage disabled unless it is specifically needed for troubleshooting.
LIVE DEMO
Inspect the OpenCart admin integration
The public demo runs OpenCart 3.0.5.1 with the current module UI. Canada Post production credentials are intentionally not connected. Use the demo to inspect configuration, status mapping, Marketplace licensing UI and the Scheduled Tracking / Cron Setup panel.
CERTIFIED COMPATIBILITY
Exact tested combinations
Only these exact rows are represented as certified. Nearby or unlisted combinations may work but are not claimed as certified.
| OpenCart | PHP | Database | Runtime |
|---|---|---|---|
| 3.0.3.9 | 7.4 | MariaDB 10.11 | Apache |
| 3.0.3.9 | 8.1 | MariaDB 10.11 | Apache |
| 3.0.4.1 | 7.4 | MariaDB 10.11 | Apache |
| 3.0.4.1 | 8.2 | MariaDB 10.11 | Apache |
| 3.0.4.1 | 8.4 | MariaDB 10.11 | Apache |
| 3.0.5.1 | 8.1 | MariaDB 10.11 | Apache |
| 3.0.5.1 | 8.4 | MariaDB 10.11 | Apache |
| 3.0.5.1 | 8.5 | MariaDB 10.11 | Apache |
| 3.0.4.1 | 8.2 | MySQL 8.0 | Apache |
| 3.0.5.1 | 8.4 | MariaDB 10.6 | Apache |
| 3.0.4.1 | 8.2 | MariaDB 10.11 | Nginx 1.27 + PHP-FPM |
SAFETY
Important runtime behavior
Unknown carrier states remain non-destructive. Duplicate events are idempotent. Final states do not regress from stale carrier events. Historical events from reused tracking numbers are guarded. Dry-run is read-only for tracking/order outcomes. Configured order changes flow through OpenCart’s stock order-history boundary.
TROUBLESHOOTING01 02 03 04 05
Before contacting support
Collect safe, reproducible information. Do not send passwords, license secrets or Canada Post credentials in public comments.
Check compatibility
Confirm the OpenCart/PHP/database/runtime combination is certified or clearly identify it as unlisted.
Check license state
Confirm the module shows the expected license state and Store Type.
Check Canada Post environment
Confirm Test/Production matches the credentials being used.
Run dry-run JSON
Use the exact Dry-run JSON Command displayed in Scheduled Tracking / Cron Setup.
Review logs
Provide safe diagnostic output, module version and the affected order/tracking context to Fencair Support.
SUPPORT
Need help with installation or activation?
Support and software updates are included for 12 months from purchase. Target first response is within one business day, Monday–Friday excluding Canadian statutory holidays.