SmartERP Documentation An Ashewa Technology Solutions Platform

ECX Specialty Cupping, Defect Counts & Q-Grading

Execute sensory cupping protocols, record physical defect counts, and classify green coffee into Specialty Grades (Q1, Q2) or Commercial.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for ECX Specialty Cupping, Defect Counts & Q-Grading 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

Execute sensory cupping protocols, record physical defect counts, and classify green coffee into Specialty Grades (Q1, Q2) or Commercial.

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.

Physical Defect Evaluation (350g Sample)#

Prior to roasting, cuppers evaluate a representative 350-gram sample of green coffee:

  • Primary Defects (Severe): Full black, full sour, dried cherry pod, fungus/mold, foreign matter. (Specialty coffee permits 0 Primary Defects).
  • Secondary Defects: Partial black, partial sour, broken/chipped bean, insect damage, immature bean.
  • Moisture & Water Activity ($a_w$): Target moisture $10.5\% - 11.5\%$, water activity $< 0.70\, a_w$ to ensure mold-free maritime transit.

Standardized Sensory Cupping Protocol#

Cupping follows the standardized SCA and ECX 100-point protocol:

  1. Roast 100g sample to light-medium roast (Agtron 58–63); grind within 15 minutes.
  2. Infuse with 93°C pure water at 8.25g coffee per 150ml water across 5 cups.
  3. Score 10 sensory attributes on a 0–10 scale:
    • Fragrance/Aroma, Flavor, Aftertaste, Acidity, Body, Balance, Uniformity, Clean Cup, Sweetness, Overall Impression.

$$\text{Total Score} = \sum_{i=1}^{10} \text{Attribute Scores} - \text{Taint / Defect Penalties}$$

Statutory ECX / ECTA Grade Classification#

  • Specialty Grade 1 (Q1): Score $\ge 85.00$ points (Zero primary defects).
  • Specialty Grade 2 (Q2): Score $80.00 – 84.99$ points (Max 3 secondary defects).
  • Commercial Grade 3 to 9 (UG): Score $< 80.00$ points (Sold as standard commercial grade).

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