Freight AI Copilot and trade intelligence
Specialized Gemini AI assistant for forwarding operations: trade corridor disruption intelligence, demurrage risk scoring, and automated client notifications.
1. Overview & Business Value#
This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Freight AI Copilot and trade intelligence within SmartERP.


SmartERP Freight AI (smarterp_freight_ai, Agent ID 19) provides an intelligent co-pilot for freight forwarders, cargo owners, and customs brokers. Powered by Gemini AI via muk_ai, it automates client communications, predicts corridor bottlenecks, and minimizes demurrage exposure.
2. Prerequisites & Security Access Groups#
- Required Modules:
smarterp_freight, smarterp_logistics - Security Groups:
Freight Forwarding Agent(Technical ID:smarterp_freight.group_freight_user)Customs Broker(Technical ID:smarterp_freight.group_freight_customs)Logistics Operations Director(Technical ID:smarterp_freight.group_freight_manager)
- Master Data Dependencies: Shipping lines, airlines, Modjo dry port customs codes, Djibouti corridor transit checkpoints, multimodal waybills, and demurrage tariffs.
3. Step-by-Step Configuration & Execution#
Step 1: Navigating to the Interface#
- Log into your SmartERP instance at
https://smarterp.et/odoo. - Open the main App Switcher (grid icon in the top-left corner).
- Navigate to Settings → Technical.

Step 2: Operational Data Parameters & Controls#
Ensure all mandatory parameters comply with enterprise operational standards:
- Authorized Operator: Action executed under assigned RBAC permissions (System Administrator, Certified Specialist).
- Relational Integrity: Linked to upstream master records, approval requests, or transactional ledgers.
- Statutory & Quality Controls: Verified against Ethiopian statutory regulations and corporate governance standards.
Step 3: Operational Execution & State Progression#
- State Progression Gate: Advance record from Draft through Audited to Confirmed / Certified.
- Integrated System Impact: Automatically updates real-time operational states and posts financial/inventory journal moves.
- Audit Verification: System registers tamper-evident audit records logging user ID, timestamp, and cryptographic transaction digests.
Key AI copilot capabilities#
- Demurrage Risk Prediction: Analyzes current customs clearance status, remaining free-time days at Doraleh or Modjo, and historical gate dwell times to calculate a 0–100 Demurrage Risk Score.
- Automated Client Milestone Notifications: Drafts professional cargo tracking emails in English and Amharic to update importers whenever major status milestones change (Vessel Berthing, Customs Release, Dry Port Arrival).
- Customs Valuation Guidance: Recommends appropriate HS Code classifications and flags missing shipping documents (e.g., Certificate of Origin, Phytosanitary Certificate, Commercial Invoice) prior to border arrival.
- Container Loading Optimization (3D CBM): Calculates optimal cargo packing sequences to maximize container volumetric efficiency and prevent axle weight violations.
4. Advanced Configuration Points#
- Automated Actions & Scheduled Tasks (Crons):
Freight: Update container tracking checkpoints(smarterp_freight.ir_cron_tracking): Runs every 4 hours to sync transit milestones along Djibouti corridorFreight: Demurrage risk alert(smarterp_freight.ir_cron_demurrage_alert): Runs daily to notify operations of shipments nearing demurrage expiration
- Custom Print Templates & Reports:
- Multimodal Freight Delivery Order & Transit Manifest
- Cargo Packing List & Commercial Invoice Dossier
- Customs Duty & Demurrage Settlement Summary
- Multi-Company Rules: Record-level security isolation under Company 1 (
Ashewa Technology Solutions S.C.), preventing cross-company ledger leakage across parent and subsidiary legal entities.
5. Comprehensive Troubleshooting Matrix#
| Error Symptom / Exception | Probable Root Cause | Corrective Action / Resolution |
|---|---|---|
Dry Port Delay: Missing customs declaration document | Transit manifest lacks registered electronic declaration code. | Upload customs assessment notice to shipment file. |
Weight Discrepancy: Manifest vs. weighbridge variance | Physical weighbridge measurement differs from shipping manifest beyond 2% tolerance. | Request official port re-weighing and verify cargo packing list. |
Demurrage Penalty Warning | Container has exceeded free storage days at Modjo dry port. | Prioritize customs clearance release and assign transport truck immediately. |
Last updated: 2026-11-15