Customs clearance and Ethiopian statutory taxation

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.

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.

{screenshot:customs-and-statutory-taxation-overview-dashboard}

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 Module 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. Select the Freight Logistics app icon.
4. From the top navigation bar, open Freight Logistics → Shipments → Ocean / Air / Road Transits / Customs Clearance.

{screenshot:customs-and-statutory-taxation-app-switcher-navigation}

Step 2: Creating and Parameterizing Records#

1. Click the New button in the top-left control panel.
2. Complete the mandatory fields in the record form:
   • Master / House Bill of Lading (Mandatory): International shipping line BL or airline AWB reference
   • Shipper & Consignee (Mandatory): Commercial exporter and Ethiopian importing legal entity
   • Mode of Transport (Mandatory): Ocean FCL/LCL, Air Express, or Multimodal Rail/Road
   • Container Seal Number (Mandatory): Verified customs security seal and container ISO code
3. Configure optional operational parameters and localized tags as required:
   • Demurrage Free Days (Optional): Allowed grace period at port before penalty fees apply
   • Marine / Cargo Insurance Policy (Optional): Cover note reference and declared insured cargo value
   • Inland Dry Port Destination (Optional): Modjo, Kality, Semera, or Dire Dawa dry port terminal
4. Click the Save icon in the control bar to commit the record.

{screenshot:customs-and-statutory-taxation-record-creation-form}

Step 3: Validating and Processing Transactions#

• State Transitions: Execute operational state progression (Booking Confirmed → Port Origin Loaded → In Transit → Customs Assessment (Modjo/Djibouti) → Duty Paid → Delivered).
• Ledger & System Impact: Customs duties, freight charges, and port fees post directly to shipment cost absorption accounts, computing actual landed cost per imported item.
• Audit Verification: Automated recording of author ID, timestamp, and immutable revision history.

{screenshot:customs-and-statutory-taxation-transaction-processing-state}

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#