Purchase Order Integration

• Flight Linking: Associate purchase orders with specific flights
• Aircraft Linking: Connect purchases to aircraft
• Auto-Assignment: Aircraft auto-populates when flight is selected
• Purchase Tracking: Count and view purchases from flight/aircraft records
• Smart Buttons: Quick access to related purchase orders

Flight Service Management

• Service Lines: Track individual services linked to flights
• Purchase Integration: Connect services to purchase order lines
• Mass Collection: Bulk import services from purchase orders
• Aerodrome Assignment: Link services to specific airports
• Status Tracking: Monitor purchase and invoice status

Data Protection

• Lock Mechanism: Locked flights prevent service modifications
• Audit Trail: Complete history of purchase-flight relationships
• Unique Constraints: Prevent duplicate service entries
• Data Integrity: Related field updates propagate automatically

Workflow Automation

• Auto-Population: Aircraft fills from flight selection
• Service Collection: One-click import of purchase order lines
• Deduplication: Prevents adding duplicate services
• Smart Filtering: Context-aware purchase order views

purchase.order (Extended)

Extension of Odoo's purchase.order model:

New Fields:

• flight_id: Many2one to flight.flight (with tracking)
• aircraft_id: Many2one to flight.aircraft (with tracking)

Methods:

• _onchange_flight_id(): Auto-populates aircraft_id when flight is selected

Behavior:

When a flight is selected on a purchase order, the aircraft is automatically filled from the flight's aircraft_id. Users can override this if purchasing for a different aircraft.

flight.flight (Extended)

Extension of flight.flight model:

New Fields:

• purchase_count: Integer (computed)
• service_line_ids: One2many to flight.service.line

Computed Fields:

• purchase_count: Counts purchase orders where flight_id = current flight

Methods:

• _compute_purchase_count(): Computes number of related purchase orders
• action_view_purchases(): Opens filtered view of related purchases
• action_collect_services(): Mass action to collect services from purchase orders

Action: Collect Services:

Mass action that:

1. Finds all purchase orders linked to flight or aircraft
2. Gets all purchase order lines from those orders
3. Checks for existing service lines to avoid duplicates
4. Creates new service lines for unlinked purchase order lines
5. Returns notification with count of services added

flight.aircraft (Extended)

Extension of flight.aircraft model:

New Fields:

• purchase_count: Integer (computed)

Methods:

• _compute_purchase_count(): Counts purchase orders for aircraft
• action_view_purchases(): Opens filtered view of aircraft purchases

flight.service.line (New Model)

New model linking purchase order lines to flights:

Fields:

• flight_id: Many2one to flight.flight (required, cascade delete)
• purchase_order_line_id: Many2one to purchase.order.line (required, restrict)
• aerodrome_id: Many2one to flight.aerodrome
• purchase_order_id: Related field from purchase_order_line_id
• supplier_id: Related field from purchase_order_id
• state: Related purchase order state
• invoice_status: Related invoice status
• product_id: Related product from purchase order line
• description: Related description from purchase order line
• quantity: Related product quantity
• price_unit: Related unit price
• price_subtotal: Related subtotal
• currency_id: Related currency
• aerodrome_icao: Related ICAO from aerodrome_id

Inheritance:

• flight.lock.mixin: Locked flights prevent service line modifications

SQL Constraints:

• Unique constraint on (flight_id, purchase_order_line_id) combination

Display Name:

Uses record ID as display name (_rec_name = "id")

Requirements

• Odoo 16.0
• SmartOps Flight Management module
• Odoo Purchase Management module

Steps

1. Install SmartOps Flight Management if not already installed
2. Install Flight Purchase from Odoo Apps menu
3. Purchase order forms will show Flight and Aircraft fields
4. Flight and Aircraft forms will show purchase count smart buttons
5. Flight forms will show Services tab

Linking Purchases to Flights

Creating New Purchase Order:

1. Navigate to Purchase > Orders > Purchase Orders
2. Click Create
3. Select supplier
4. Select a Flight (optional)
5. Aircraft auto-fills from flight (can be changed)
6. Add purchase order lines
7. Save and confirm

Editing Existing Purchase Order:

1. Open an existing purchase order
2. Add or change the Flight field
3. Aircraft updates automatically
4. Save changes

Viewing from Flight:

1. Open a flight record
2. Click the Purchases smart button
3. See all related purchase orders
4. Click Create to add new purchase with pre-filled flight/aircraft

Managing Flight Services

Manual Service Addition:

1. Open a flight record
2. Navigate to the Services tab
3. Click Add a line
4. Select a Purchase Order Line
5. Assign Aerodrome if applicable
6. Save the record

Mass Service Collection:

1. Go to Flights > Flights
2. Select one or multiple flights (checkbox)
3. Click Actions > Collect Services
4. System processes all selected flights:
   • Finds purchase orders linked to flight or aircraft
   • Creates service lines for unlinked purchase order lines
   • Skips duplicate service lines
   • Shows notification with results
5. Review added services in Services tab

Service Line Details:

Service lines automatically display:

• Purchase Order reference
• Supplier
• Product/Service
• Description
• Quantity and Unit Price
• Subtotal and Currency
• Purchase State
• Invoice Status
• Aerodrome (if assigned)

Viewing Related Purchases

From Flights:

Flight form view shows purchase count smart button. Click to:

• View all purchase orders for that flight
• Filter by purchase state
• Create new purchases with flight pre-filled

From Aircraft:

Aircraft form view shows purchase count smart button. Click to:

• View all purchase orders for that aircraft
• Track maintenance and parts procurement
• Analyze aircraft-specific spending

Fuel and Handling Services

Scenario: Charter operator books fuel and handling services for each flight leg.

Workflow:

1. Create purchase order for fuel at departure aerodrome
2. Link to flight
3. Create purchase order for handling at arrival aerodrome
4. Link to same flight
5. Use "Collect Services" to import all services to flight
6. Assign aerodromes to each service line
7. Track total flight service costs

Benefits: Complete per-flight service cost tracking, vendor performance analysis, budget vs. actual comparison.

Catering and Supplies

Scenario: Aircraft management company orders catering and cabin supplies per flight.

Workflow:

1. Create catering purchase order
2. Link to flight
3. Add passenger count and menu details in PO lines
4. Confirm and receive
5. Services automatically available on flight record
6. Track catering costs per passenger

Benefits: Optimize catering spend, analyze vendor pricing, ensure service consistency.

Maintenance and Parts

Scenario: Maintenance performed on aircraft; parts purchased and tracked.

Workflow:

1. Create purchase order for parts
2. Link to aircraft (not specific flight)
3. If parts used during specific flight, link to flight also
4. View all maintenance purchases from aircraft record
5. Track part usage by flight if applicable

Benefits: Complete aircraft maintenance history, cost tracking, regulatory compliance.

Charter Trip Costing

Scenario: Charter operator needs accurate per-trip costs for billing.

Workflow:

1. Create flight record for charter trip
2. Create purchase orders for all services: fuel, handling, catering, permits
3. Link all purchases to the charter flight
4. Use smart button to view total purchase costs
5. Services tab shows itemized breakdown by aerodrome
6. Generate invoice with markup

Benefits: Accurate cost allocation, transparent client billing, profitability analysis.

Purchase Order Management

• Link Early: Associate purchases with flights at creation time
• Use Aircraft: Link aircraft-wide purchases (maintenance) to aircraft only
• Flight-Specific: Link trip-specific purchases (fuel, catering) to both flight and aircraft
• Consistent Vendors: Maintain vendor relationships for pricing leverage

Service Line Organization

• Assign Aerodromes: Always assign aerodrome to services when applicable
• Regular Collection: Run "Collect Services" regularly to keep data current
• Review Services: Periodically review service lines for accuracy
• Lock Flights: Lock completed flights to protect service data

Cost Analysis

• Track Trends: Monitor service costs over time
• Compare Vendors: Analyze pricing across suppliers
• Aerodrome Costs: Compare costs by airport
• Budget Planning: Use historical data for accurate budgeting

Data Integrity

• Locked Flights: Respect the lock mechanism—don't try to modify locked services
• Duplicate Prevention: Review existing services before manual additions
• Related Updates: Changes to PO lines update service lines automatically
• Audit Trails: Use tracking fields to review change history

Dependencies

'depends': [
    'base',
    'purchase',
    'flight',
]

Security

Access rights defined in security/ir.model.access.csv:

• Flight User: Read access to service lines
• Flight Manager: Full CRUD access to service lines
• Purchase User: Can link flights/aircraft to purchase orders

Views

Purchase Order Views:

• Extended form view with flight_id and aircraft_id fields
• Context passes default values when creating from flight

Flight Views:

• Services tab in flight form view (One2many field)
• Purchases smart button with purchase count
• Services tree, form, and search views

Aircraft Views:

• Purchases smart button with purchase count

Menu Structure:

Service lines accessible via flight form Services tab. No separate menu item needed.

Actions

action_view_purchases (flight.flight):

Returns action to view purchase orders filtered by flight_id.

action_view_purchases (flight.aircraft):

Returns action to view purchase orders filtered by aircraft_id.

action_collect_services (flight.flight):

Server action that processes selected flights and creates service lines from purchase orders. Returns notification with results.