Quick Start: 15-Minute Harvest to Air Cargo Dispatch

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Quick Start: 15-Minute Harvest to Air Cargo Dispatch within SmartERP.

Step-by-step walkthrough of logging a greenhouse harvest, executing stem grading, packing an export box, and booking an air cargo dispatch.

{screenshot:quick-start-overview-dashboard}

2. Prerequisites & Security Access Groups#

• Required Modules: smarterp_commodity_export, smarterp_agri_traceability
• Security Groups:
  • Cold Chain & Packhouse Officer (Technical ID: smarterp_export.group_export_user)
  • Floriculture Quality Inspector (Technical ID: smarterp_export.group_export_qa)
  • Floriculture Export Manager (Technical ID: smarterp_export.group_export_manager)
• Master Data Dependencies: Greenhouse greenhouse blocks, rose stem varieties, cold storage temperature telemetry (2°C–4°C), Ethiopian Airlines Bole Cargo space bookings, and European auction buyers.

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 Floriculture Export app icon.
4. From the top navigation bar, open Floriculture Export → Greenhouse → Harvest / Cold Chain / Packhouse / Air Waybills.

{screenshot:quick-start-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:
   • Greenhouse Harvest Batch (Mandatory): Block origin, stem length (cm), and cut date/time
   • Rose Variety & Head Size (Mandatory): Commercial cultivar (Rhodos, Red Naomi, Athena) and bud profile
   • Pre-Cooling Verification (Mandatory): Confirmed forced-air cooling record achieving 2°C–4°C core temperature
   • Bole Cargo e-AWB Number (Mandatory): Ethiopian Airlines booked air waybill identifier
3. Configure optional operational parameters and localized tags as required:
   • Cold Chain Logger ID (Optional): Digital temperature datalogger serial number placed in pallet
   • Auction Consignment Code (Optional): Royal FloraHolland auction lot reference
   • MoA Phytosanitary Seal Number (Optional): Official government export inspection security tag
4. Click the Save icon in the control bar to commit the record.

{screenshot:quick-start-record-creation-form}

Step 3: Validating and Processing Transactions#

• State Transitions: Execute operational state progression (Harvested → Pre-Cooled (2°C) → Packhouse Sorted → Cold Truck Transit → Bole Airport Loaded → Cleared).
• Ledger & System Impact: Direct greenhouse labor and packaging costs absorb into crop inventory; e-AWB air freight dispatch recognizes export revenue in foreign currency.
• Audit Verification: Automated recording of author ID, timestamp, and immutable revision history.

{screenshot:quick-start-transaction-processing-state}

Objective & Prerequisites#

This guide demonstrates a complete cut-flower export workflow in under 15 minutes:

1. Log a morning rose cut harvest from Greenhouse Block B.
2. Process packhouse stem grading and box packing.
3. Verify pre-cooling temperature logs.
4. Issue an Air Waybill (AWB) dispatch sheet.

Prerequisites: Access to Floriculture, Inventory, and Dispatch workspaces.

Step 1: Log Greenhouse Harvest Batch (3 Minutes)#

1. Open Floriculture > Greenhouse > Harvest Batches and click New.
2. Select parameters:
   • Greenhouse Block: Block 04 - Rose Unit.
   • Variety: Rhodos (Deep Red T-Hybrid).
   • Cut Stage: Stage 2.5 (Standard Commercial Export).
   • Harvested Stems Count: 5,000 Stems.
   • Hydration Bucket Solution: Chrysal RVB Clear (Concentration 1%).
3. Click Confirm Harvest & Route to Packhouse.

Step 2: Stem Grading & Packhouse Run (4 Minutes)#

1. In Floriculture > Packhouse > Grading Runs, click New.
2. Select the incoming harvest batch.
3. Record grading breakdown:
   • 60cm Stems: 2,200 Stems (88 Bunches of 25 stems).
   • 70cm Stems: 1,800 Stems (72 Bunches).
   • 50cm Stems: 800 Stems (32 Bunches).
   • Culls / Defects: 200 Stems (Stem bent, botrytis, thrips damage).
4. Click Complete Grading & Generate Bunch Barcodes.

Step 3: Packing Export Boxes & Pre-Cooling (4 Minutes)#

1. Switch to Floriculture > Packhouse > Box Packing.
2. Create Packing Sheet for 60cm Rhodos:
   • Box Type: Standard Export Two-Piece Telescopic Carton (100x33x20 cm).
   • Packing Density: 350 Stems (14 Bunches) per Box.
   • Boxes Packed: 6 Full Cartons.
3. Transfer boxes into the Forced-Air Pre-Cooler:
   • System sensor logs pulp pulldown: $18^\circ C \longrightarrow 3.2^\circ C$ in 45 minutes.
4. Click Certify Temperature Clearance.

Step 4: Book Air Cargo Dispatch (4 Minutes)#

1. Navigate to Floriculture > Logistics > Air Freight Dispatches.
2. Create Dispatch Order:
   • Carrier: Ethiopian Airlines Cargo (ET-Cargo).
   • Flight: ET-3714 (Bole Addis Ababa -> Liege Belgium LGG).
   • Master AWB: 071-8841-9921.
   • Cargo Weight: 450 kg Gross.
3. Attach verified MoA Phytosanitary Certificate.
4. Click Authorize Reefer Truck Loading & Seal Dispatch.

4. Advanced Configuration Points#

• Automated Actions & Scheduled Tasks (Crons):
  • Cold Chain: Alert temperature breach above 4°C (smarterp_export.ir_cron_temp_monitor): Runs every 15 minutes checking IoT temperature telemetry
  • Air Cargo: Track Bole cargo flight departure (smarterp_export.ir_cron_flight_status): Runs hourly checking Ethiopian Airlines cargo flight tracking
• Custom Print Templates & Reports:
  • Cold Chain Temperature Compliance Certificate
  • MoA Phytosanitary Export Inspection Dossier
  • Bole Cargo Air Waybill (e-AWB) & Pallet Manifest
  • Consignment Net Realization & Auction 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#