SmartERP Documentation An Ashewa Technology Solutions Platform

Landed Cost Variance Analysis & Import Tariff Copilot

Import cost analyzer tracking customs duties, shipping demurrage, port handling charges, and final landed cost variances.

1. Overview & Business Value#

The Landed Cost Variance Analyzer tracks international shipping shipments through Djibouti port and Modjo Dry Port, identifying duty and logistics cost variances.

1. Overview & Cost Absorption Model#

The agent matches estimated maritime freight, insurance, and Ethiopian Customs Commission duty payments against actual invoices, allocating landed costs proportionally by weight or value.

{screenshot:ai-landed-cost-variance-matrix}

2. Step-by-Step Variance Audit#

  1. Open Inventory → Accounting → Landed Cost Copilot.
  2. Select target shipment (e.g., LC-SHP-2026-042).
  3. Compare estimated versus actual logistics line items.
  4. Click Apply Real-Time Valuation Adjustment to update inventory asset values.

2. Prerequisites & Security Access Groups#

  • Required Modules: muk_ai, muk_mcp, smarterp_ai_suite
  • Security Group: Ashewa AI / User (Technical ID: muk_ai.group_ai_user)
  • Master Data Dependencies: Configured AI provider credentials, active system prompts, and departmental cost centers.

3. Step-by-Step UI Execution & Verification#

Step 1: Navigating to the Operational Interface#

  1. Log into your SmartERP instance at https://smarterp.et/odoo.
  2. Open the main App Switcher and select Ashewa AI.
  3. Select the operational workspace corresponding to this agent suite.

{screenshot:68-landed-cost-variance-analyzer-step1-navigation}

Step 2: Executing Agent Actions#

  1. Review agent prompts and execution parameters.
  2. Trigger the scheduled or on-demand workflow action.
  3. Validate output in the generated operational log.

{screenshot:68-landed-cost-variance-analyzer-step2-execution}

4. Advanced Configuration Points#

  • Scheduled Crons: muk_ai.ir_cron_agent_health_check runs every 30 minutes.
  • Multi-Company Isolation: Multi-company record rules ensure agent context is isolated to Company 1 (Ashewa Technology Solutions S.C.).

5. Comprehensive Troubleshooting Matrix#

Symptom / ErrorProbable Root CauseResolution Action
Agent unresponsive or timeoutNetwork latency or API endpoint outage.Verify provider connection in Settings → AI Providers.
Access Denied during agent executionUser lacks assigned operational permissions.Assign user to the designated operational group.
Last updated: 2026-10-30