የSmartERP መመሪያ የAshewa Technology Solutions መድረክ
ይህ ገጽ ገና ወደ አማርኛ አልተተረጎመም። የእንግሊዝኛው ጽሑፍ ቀርቧል።

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 አቅርቦት ሰንሰለት እና ግዢ ሞጁሎች አጠቃላይ ካርታ።

SmartERP Application Interface and Dashboard

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#

  1. Log into your SmartERP instance at https://smarterp.et/odoo.
  2. Open the main App Switcher (grid icon in the top-left corner).
  3. Navigate to Settings → Technical.

SmartERP Application Interface and Dashboard

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 corridor
    • Freight: 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 / ExceptionProbable Root CauseCorrective Action / Resolution
Dry Port Delay: Missing customs declaration documentTransit manifest lacks registered electronic declaration code.Upload customs assessment notice to shipment file.
Weight Discrepancy: Manifest vs. weighbridge variancePhysical weighbridge measurement differs from shipping manifest beyond 2% tolerance.Request official port re-weighing and verify cargo packing list.
Demurrage Penalty WarningContainer has exceeded free storage days at Modjo dry port.Prioritize customs clearance release and assign transport truck immediately.
መጨረሻ የተሻሻለው: 2026-11-15