Skip to main content
The FBO fuel management system tracks fuel inventory, deliveries, quality control inspections, pricing, and sales transactions. Requires the FBO module with Fuel Management enabled.

Fuel Types

Supported aviation fuel types, each with specific storage, handling, and quality control requirements:
Fuel TypeCodeDescriptionTypical Use
Jet-Ajet_aKerosene-based turbine fuel meeting ASTM D1655 specificationTurbine-powered aircraft (jets, turboprops)
Jet-A1jet_a1Kerosene-based turbine fuel with lower freeze point (-47 C) meeting DEF STAN 91-091International operations, cold-weather turbine aircraft
100LL100llLow-lead aviation gasoline (avgas) meeting ASTM D910 specificationPiston-engine aircraft
SAFsafSustainable Aviation Fuel — a drop-in replacement blended with conventional Jet-A per ASTM D7566Turbine aircraft (blend ratios up to 50% per current approvals)
UL94ul94Unleaded aviation gasoline meeting ASTM D7547 specificationApproved piston-engine aircraft (limited fleet compatibility)
SAF is tracked as a separate fuel type for environmental reporting and carbon offset calculations. When blended with Jet-A, the system records both the SAF percentage and the total volume dispensed. Blend ratios must comply with the aircraft manufacturer’s approved limits and current ASTM D7566 annex specifications.

Tank Status Values

Fuel storage tanks progress through operational states that determine whether fuel can be dispensed.
StatusAPI ValueDescription
ActiveactiveTank is in service. Fuel can be received and dispensed.
LowlowTank level is at or below the reorder threshold. Fuel can still be dispensed but a resupply order should be placed.
EmptyemptyTank has reached minimum operational level. No fuel should be dispensed.
HeldheldTank is placed on quality hold pending QC resolution. No fuel may be dispensed until the hold is released.
Out of Serviceout_of_serviceTank is offline for maintenance, inspection, or cleaning. No fuel operations permitted.
ReceivingreceivingTank is currently accepting a fuel delivery. Dispensing is suspended during receiving operations.

Tank Fields

FieldTypeDescription
tank_idStringUnique identifier for the tank.
nameStringDisplay name (e.g., “Jet-A Tank 1”, “100LL Underground”).
fuel_typeEnumType of fuel stored. See Fuel Types.
capacity_gallonsNumberMaximum capacity in US gallons.
current_level_gallonsNumberCurrent fuel level in US gallons.
reorder_threshold_gallonsNumberLevel at which the tank status changes to low.
minimum_level_gallonsNumberMinimum operational level. Below this the tank reads empty.
statusEnumCurrent tank status. See table above.
last_delivery_atTimestampDate and time of the most recent fuel delivery.
last_qc_inspection_atTimestampDate and time of the most recent QC inspection.
locationStringPhysical location at the facility (e.g., “Ramp East”, “Underground Farm”).
created_atTimestampWhen the tank record was created.

Delivery Statuses

Fuel deliveries track the receipt of fuel from suppliers into storage tanks.
StatusAPI ValueDescription
ScheduledscheduledDelivery is confirmed with the supplier for a future date.
In Transitin_transitSupplier has dispatched the delivery.
ReceivedreceivedDelivery arrived and fuel has been transferred to the tank. QC inspection is pending or complete.
AcceptedacceptedDelivery passed QC inspection and fuel is cleared for dispensing. Terminal state.
RejectedrejectedDelivery failed QC inspection. Fuel is quarantined or returned to supplier. Terminal state.
CancelledcancelledDelivery was cancelled before receipt. Terminal state.

Delivery Fields

FieldTypeDescription
delivery_idStringUnique identifier.
supplier_nameStringName of the fuel supplier.
fuel_typeEnumType of fuel delivered.
quantity_gallonsNumberQuantity delivered in US gallons.
tank_idStringDestination tank for the delivery.
bill_of_ladingStringSupplier’s bill of lading or delivery ticket number.
temperature_fNumberFuel temperature at receipt (Fahrenheit).
specific_gravityNumberMeasured specific gravity at receipt.
statusEnumCurrent delivery status.
scheduled_dateDateExpected delivery date.
received_atTimestampActual receipt timestamp.
received_byStringUser who received the delivery.

QC Inspection Types

Quality control inspections follow NATA Safety 1st standards and industry best practices. Each inspection type has specific criteria and required frequency.
Inspection TypeAPI ValueFrequencyDescription
Visual AppearancevisualEvery delivery + dailyCheck fuel for color, clarity, and absence of visible contamination (water, sediment, microbial growth)
Water Detectionwater_detectionEvery delivery + dailyTest for dissolved and free water using chemical detection paste or electronic sensors
Specific Gravityspecific_gravityEvery deliveryMeasure fuel density to verify it falls within specification range
API Gravityapi_gravityEvery deliveryCalculate API gravity from specific gravity and temperature
Filter Differential Pressurefilter_dpDaily (during operations)Check differential pressure across filter/separator elements. Exceeding limits indicates filter saturation
Sump and Drainsump_drainDaily (start of operations)Drain sumps on storage tanks and filter vessels to remove accumulated water and sediment
Millipore / ParticulateparticulateMonthly + as neededMembrane filter test to measure particulate contamination levels
MicrobiologicalmicrobiologicalQuarterlyTest for microbial contamination (bacteria and fungi) in fuel and tank bottoms
Thermal Stabilitythermal_stabilityPer supplier batch (lab)JFTOT test for thermal oxidative stability of jet fuel
Electrical ConductivityconductivityPer deliveryVerify conductivity units (CU) are within specification for static dissipator additive

Pass/Fail Criteria

InspectionPass CriteriaFail Criteria
Visual AppearanceClear, bright, free of visible contaminationHazy, cloudy, discolored, visible particulate or microbial growth
Water DetectionNo color change on detection paste; < 30 ppm dissolved waterColor change indicating free water; > 30 ppm dissolved water
Specific GravityJet-A: 0.775—0.840 at 15 C; 100LL: 0.690—0.720 at 15 COutside specification range
Filter DPBelow manufacturer’s maximum DP limit (typically < 15 psi)At or above maximum DP limit
Sump and DrainClear fuel, no water or sedimentWater or sediment present
Particulate< 1.0 mg/L per ASTM D2276>= 1.0 mg/L
Microbiological< 500 CFU/mL (moderate) or negative on rapid test>= 500 CFU/mL or positive high-contamination result
Conductivity50—600 CU per ASTM D2624Outside 50—600 CU range
A failed QC inspection places the affected tank on quality hold. No fuel may be dispensed from a held tank until the issue is resolved, a re-inspection passes, and an authorized user releases the hold. This is a safety-critical control per NATA Safety 1st and ATA 103 standards.

Inspection Record Fields

FieldTypeDescription
inspection_idStringUnique identifier.
tank_idStringTank inspected.
delivery_idString (optional)Associated delivery, if inspection is delivery-triggered.
inspection_typeEnumType of inspection performed.
resultEnumpass or fail.
valueString (optional)Measured value (e.g., “0.812” for specific gravity).
notesText (optional)Inspector notes or observations.
inspector_idStringUser who performed the inspection.
performed_atTimestampWhen the inspection was conducted.
follow_up_requiredBooleanWhether a follow-up action or re-inspection is needed.

Fuel Pricing Models

The FBO fuel system supports multiple pricing models to accommodate different customer relationships and market conditions.
ModelAPI ValueDescription
Posted RatepostedStandard retail price displayed to transient customers. Updated manually or via market data feed.
Contract RatecontractNegotiated rate for customers with fuel purchase agreements. Tied to a specific customer or account.
Cost Pluscost_plusSupplier cost plus a fixed margin (e.g., cost + $0.45/gal). Adjusts automatically when supplier cost changes.
Volume Discountvolume_discountTiered pricing based on purchase volume. Higher volumes receive lower per-gallon rates.
Tenant RatetenantDiscounted rate for hangar tenants. Automatically applied to customers with active bookings.

Pricing Fields

FieldTypeDescription
price_idStringUnique identifier.
fuel_typeEnumFuel type this price applies to.
modelEnumPricing model. See table above.
price_per_gallonNumberPrice per US gallon in USD.
effective_dateDateWhen this price takes effect.
expiration_dateDate (optional)When this price expires (for contract and promotional rates).
minimum_gallonsNumber (optional)Minimum purchase quantity for this price to apply (volume discount).
customer_idString (optional)Specific customer for contract rates.
is_activeBooleanWhether this price is currently in effect.

Fuel Sales Transaction Types

Every fuel dispensing event generates a transaction record.
TypeAPI ValueDescription
Standard Salestandard_saleNormal fuel sale to a customer at the applicable rate.
Contract Upliftcontract_upliftFuel dispensed under a contract rate agreement.
Into-Planeinto_planeFuel delivered directly into an aircraft on the ramp.
Truck Filltruck_fillFuel loaded into a refueling truck from a storage tank (internal transfer, not a customer sale).
DefueldefuelFuel removed from an aircraft and returned to storage. Recorded as a negative quantity.
AdjustmentadjustmentManual correction to tank levels (e.g., after physical inventory reconciliation).

Transaction Fields

FieldTypeDescription
transaction_idStringUnique identifier.
transaction_typeEnumType of fuel transaction.
fuel_typeEnumFuel type dispensed.
quantity_gallonsNumberQuantity in US gallons (negative for defuel operations).
price_per_gallonNumberApplied price per gallon.
total_amountNumberTotal transaction amount in USD.
tank_idStringSource tank for the fuel.
aircraft_tailString (optional)Tail number of the aircraft fueled.
customer_idString (optional)Customer account charged.
meter_startNumber (optional)Fuel meter reading at start of dispensing.
meter_endNumber (optional)Fuel meter reading at end of dispensing.
dispensed_byStringUser who performed the fueling.
created_atTimestampWhen the transaction was recorded.
Discrepancies between calculated tank levels (based on deliveries and dispensing records) and physical measurements may indicate meter calibration issues, leaks, or data entry errors.

FBO Statuses

Booking, payment, unit, maintenance, and till statuses.

Manage Fuel

Fuel operations, delivery receipt, and QC inspection procedures.

FBO Point of Sale

POS order fields, payment methods, and product catalog.

FBO Billing

Invoicing and payment processing for fuel sales.
Last modified on April 11, 2026