SmartERP Documentation An Ashewa Technology Solutions Platform

NBE 50/50 FX Retention & Currency Repatriation

Automate compliance with National Bank of Ethiopia export foreign exchange retention directives, currency splits, and retention accounts.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for NBE 50/50 FX Retention & Currency Repatriation within SmartERP.

Ethiopian coffee origination, station processing, ECTA/ECX cupping scores, and export lot consolidation.
Coffee origination, wet/dry processing, and ECX specialty cupping lifecycle.

Coffee Export Contracts, Washing Stations and Consignments

Automate compliance with National Bank of Ethiopia export foreign exchange retention directives, currency splits, and retention accounts.

2. Prerequisites & Security Access Groups#

  • Required Modules: smarterp_commodity_export, smarterp_agri_traceability
  • Security Groups:
    • Export Logistics Officer (Technical ID: smarterp_export.group_export_user)
    • Coffee Quality Lab Grader (Q-Grader) (Technical ID: smarterp_export.group_export_qa)
    • Export Commercial Director (Technical ID: smarterp_export.group_export_manager)
  • Master Data Dependencies: Coffee origination zones (Yirgacheffe, Sidama, Guji, Jimma, Harar), ECX contracts, washing stations, export container lots, and NBE 50/50 FX retention accounts.

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 Coffee Export → Origination → Lots.

Coffee Export Contracts, Washing Stations and Consignments

Step 2: Operational Data Parameters & Controls#

Ensure all mandatory parameters comply with enterprise operational standards:

  • Authorized Operator: Action executed under assigned RBAC permissions (Export General Manager, Cupper/Q-Grader, Export Logistics Lead).
  • 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.

The NBE Foreign Exchange Retention Directive#

Under active National Bank of Ethiopia (NBE) Foreign Exchange Directives, export proceeds repatriated from international trade must be split at the commercial bank:

The statutory FX split and LC flow:

Export Letter of Credit (LC) negotiation, foreign exchange inflow, and NBE 50/50 foreign currency retention account workflow.
Agro-export LC documentation, FX repatriation, and NBE foreign currency retention workflow.

$$\text{Export Proceeds ($USD$)} = \text{Surrender Component (50%)} + \text{Retention Account (50%)}$$

  1. Surrender Portion (50%): Converted immediately by the commercial bank into Ethiopian Birr (ETB) at the prevailing official interbank exchange rate and credited to the exporter's local operational account.
  2. Forex Retention Account (50%): Retained indefinitely in the exporter's foreign currency account ($USD$), available exclusively to import raw materials, agricultural chemicals, spare parts, or pay international logistics.

Automated Journal Accounting in SmartERP#

When foreign currency remits against an export invoice ($100,000 USD at $130 ETB/USD$):

  1. Debit: Commercial Bank ETB Operational Account (50,000 USD * 130 = 6,500,000 ETB)
  2. Debit: NBE Foreign Currency Retention Account (50,000 USD * 130 = 6,500,000 ETB)
  3. Credit: Accounts Receivable Foreign Buyer (100,000 USD * 130 = 13,000,000 ETB)
  4. Any currency fluctuations between contract booking date and settlement date post automatically to Realized Foreign Exchange Gain / Loss (410800 / 510800).

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • Export: Track NBE 50/50 FX retention account expiration (smarterp_export.ir_cron_fx_retention): Runs weekly to monitor statutory 30-day conversion windows
    • Traceability: Monitor container transit milestones (smarterp_export.ir_cron_container_tracking): Runs daily to update Modjo dry port to Djibouti customs handoffs
  • Custom Print Templates & Reports:
    • ECTA Coffee Quality & Traceability Inspection Dossier
    • Export Commercial Invoice, Packing List & Certificate of Origin
    • Bole Cargo / Modjo Dry Port Multimodal Shipping Manifest
    • NBE Foreign Exchange Retention & Commercial Bank Allocation Slip
  • 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
FX Retention Block: 50% ETB conversion window expiredForeign proceeds not converted to local currency within mandatory 30-day window per NBE directives.Contact commercial bank international banking department to process statutory conversion.
Quality Grade Rejection: Moisture content exceeds 12.0%Export sample failed ECTA moisture tolerance threshold.Return lot to processing facility for further mechanical or sun drying prior to re-sampling.
Customs Clearance Missing: Phytosanitary certificate not attachedMandatory Ministry of Agriculture clearance document missing from shipment file.Complete inspection sampling and attach approved certificate before filing Modjo customs manifest.
Last updated: 2026-11-15