SmartERP Documentation An Ashewa Technology Solutions Platform

Customs clearance and Ethiopian statutory taxation

Harmonized System (HS Code) tariffs, Ethiopian Customs Commission (ECC) duty calculations, Excise, VAT, Sur-Tax, and Single Window integration.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Customs clearance and Ethiopian statutory taxation within SmartERP.

Module map showing dependencies between SmartERP Supply Chain Core, Tenders, Store Vouchers, Landed Costs, and WMS.
SmartERP Supply Chain and Sourcing architectural module map.

SmartERP Application Interface and Dashboard

Clearing international cargo through Ethiopian customs borders requires calculating layered statutory taxes administered by the Ethiopian Customs Commission (ECC). SmartERP Freight integrates an automated valuation and duty calculation engine.

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.

Statutory customs tax calculation formula#

Customs taxation is calculated progressively based on the Cost, Insurance, and Freight (CIF) value converted to Ethiopian Birr (ETB):

1. Customs Duty:
   Duty Amount = CIF Value × Duty Rate (0% to 35%)

2. Excise Tax:
   Excise Base = CIF Value + Duty Amount
   Excise Amount = Excise Base × Excise Rate (0% to 500%)

3. Value Added Tax (VAT 15%):
   VAT Base = CIF Value + Duty Amount + Excise Amount
   VAT Amount = VAT Base × 15%

4. Sur-Tax (10%):
   Sur-Tax Base = CIF Value + Duty Amount + Excise Amount
   Sur-Tax Amount = Sur-Tax Base × 10%

5. Withholding Tax (WHT 3%):
   WHT Amount = CIF Value × 3%

Total Payable Customs Import Tax =
   Duty + Excise + VAT + Sur-Tax + WHT

Harmonized System (HS Code) master catalog#

  • Standard 8-Digit Tariffs: Stores national tariff schedules with pre-configured duty, excise, and sur-tax percentages.
  • Duty-Free & Incentive Schemes: Supports Second Schedule duty exemption privileges (e.g., Ethiopian Investment Commission manufacturing incentives, diplomatic franchises, and NGO exemptions).
  • Electronic Payment Integration: Connects directly with commercial bank payment systems for single-reference settlement of Customs Tax Assessment Notices.

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.
Last updated: 2026-11-15