Skip to main content
The FBO module uses several status systems to track the lifecycle of bookings, units, maintenance tasks, payments, tills, service orders, purchase orders, vendors, gift cards, discounts, and credits. This reference covers every status value, its meaning, and valid transitions.

Booking Statuses

Booking statuses track the lifecycle of FBO reservations from creation through checkout. The status determines available actions and the guest’s current relationship with the facility.
StatusAPI ValueDescription
ReservedreservedBooking has been created and a unit is held for the guest. No check-in has occurred.
ConfirmedconfirmedGuest or operator has confirmed the reservation. The booking is guaranteed.
Checked Inchecked_inGuest has arrived and check-in is complete. The unit is now occupied.
Checked Outchecked_outGuest has departed and the unit has been released. This is a terminal state.
CancelledcancelledBooking has been cancelled before checkout. This is a terminal state.

Booking Lifecycle

A booking can be cancelled from any non-terminal state — reserved, confirmed, or checked_in. Once a booking reaches checked_out or cancelled, no further transitions are possible.

Payment Statuses

Payment statuses track the financial state of a booking independently from its booking status. A booking can be checked out while its payment status is still partial or unpaid.
StatusAPI ValueDescription
UnpaidunpaidNo payment has been received for this booking.
PartialpartialSome payment has been received, but a balance remains.
PaidpaidThe booking has been paid in full.
RefundedrefundedA refund has been issued for a previously paid booking.
Payment status is independent of booking status. For example, a booking in checked_in status could have a payment status of paid (pre-paid), partial (deposit received), or unpaid (payment due on checkout).

Unit Statuses

Unit statuses describe the current operational state of a hangar, tiedown, or ramp space.
StatusAPI ValueDescription
AvailableavailableThe unit is operational and can accept bookings.
InactiveinactiveThe unit has been taken offline and is not available for booking. Typically used for seasonal closures or decommissioning.
MaintenancemaintenanceThe unit is undergoing maintenance and cannot be booked. One or more maintenance records are linked.
Units in inactive or maintenance status do not appear in the availability calendar as bookable options. A unit returns to available once maintenance is complete or the unit is ready for use.

Maintenance Statuses

Maintenance records track work performed on FBO units. Each record moves through a three-stage lifecycle.
StatusAPI ValueDescription
ScheduledscheduledMaintenance has been planned with a start date. Work has not yet begun.
In Progressin_progressWork is actively underway on the unit.
CompletedcompletedMaintenance work is finished. The unit can be returned to available status.

Maintenance Lifecycle

Maintenance Priorities

Each maintenance record is assigned a priority level that determines urgency and scheduling order.
PriorityAPI ValueDescription
LowlowRoutine maintenance that can be scheduled at convenience.
NormalnormalStandard maintenance that should be completed within the planned window.
HighhighImportant maintenance that should be prioritized over normal tasks.
UrgenturgentCritical maintenance requiring immediate attention. May require taking the unit offline immediately.

Till Statuses

Till statuses track the operational state of point-of-sale cash registers.
StatusAPI ValueDescription
ActiveactiveThe till is open and processing transactions.
InactiveinactiveThe till exists but is not currently in use. It can be activated when needed.
ClosedclosedThe till has been closed out. The final balance has been reconciled.

Invoice Statuses

Invoice statuses track the lifecycle of billing documents sent to customers.
StatusAPI ValueDescription
PendingpendingThe invoice has been created but not yet sent to the customer.
SentsentThe invoice has been delivered to the customer.
PaidpaidThe customer has paid the invoice in full.
OverdueoverdueThe invoice due date has passed without full payment.
CancelledcancelledThe invoice has been voided.

Contract Statuses

Contract statuses track the state of service agreements between the FBO and its guests.
StatusAPI ValueDescription
DraftdraftThe contract is being prepared and has not yet been activated.
ActiveactiveThe contract is in effect and governs the service relationship.
ExpiredexpiredThe contract end date has passed.
CancelledcancelledThe contract was terminated before its end date.

Transaction Statuses

Transaction statuses indicate the processing state of financial transactions in the POS system.
StatusAPI ValueDescription
CompletedcompletedThe transaction was processed successfully.
PendingpendingThe transaction is awaiting processing or confirmation.
FailedfailedThe transaction could not be processed.
ReversedreversedA previously completed transaction has been reversed.

Service Order Statuses

Service order statuses track ramp services requested for aircraft movements on the flight board. Each service order moves through a four-stage lifecycle.
StatusAPI ValueDescription
PendingpendingThe service has been requested but work has not started.
In Progressin_progressWork is actively underway on the service.
CompletedcompletedThe service has been performed and is finished.
CancelledcancelledThe service request was cancelled before completion.

Service Order Lifecycle

A service order can be cancelled from pending or in_progress status. Once a service order reaches completed or cancelled, no further transitions are possible.

Purchase Order Statuses

Purchase order statuses track procurement requests sent to vendors from draft through fulfillment.
StatusAPI ValueDescription
DraftdraftThe purchase order is being prepared. Line items can still be edited.
SentsentThe purchase order has been submitted to the vendor. Line items are locked.
ReceivedreceivedThe ordered goods have been delivered and verified. Inventory is updated.
CancelledcancelledThe purchase order has been voided. This is a terminal state.

Purchase Order Lifecycle

A purchase order can be cancelled from draft or sent status. Once a PO reaches received or cancelled, no further transitions are possible.

Vendor Statuses

Vendor statuses indicate whether a vendor is available for new purchase orders.
StatusAPI ValueDescription
Activeactive (is_active = 1)The vendor is available for selection on new purchase orders.
Inactiveinactive (is_active = 0)The vendor has been deactivated and does not appear in vendor dropdowns for new POs. Existing POs are unaffected.
Vendors can be toggled between active and inactive at any time. Deactivating a vendor preserves all historical purchase order data.

Gift Card Statuses

Gift card statuses track the lifecycle of prepaid value cards issued to customers.
StatusAPI ValueDescription
ActiveactiveThe gift card has a remaining balance and can be redeemed at the POS.
RedeemedredeemedThe gift card balance has been fully used. No further redemptions are possible.
ExpiredexpiredThe gift card has passed its expiration date. It cannot be redeemed even if a balance remains.

Discount Statuses

Discount statuses indicate whether a discount code can be applied to orders.
StatusAPI ValueDescription
Activeactive (is_active = 1)The discount code is available for redemption, subject to validity dates and usage limits.
Expiredexpired (is_active = 0 or past valid_to)The discount code is no longer valid. It has been deactivated or its validity window has closed.
A discount also becomes effectively unavailable if its used_count reaches max_uses, even while the status remains active.

Credit Statuses

Credit statuses track account-level credits issued to FBO customers.
StatusAPI ValueDescription
ActiveactiveThe credit has a remaining balance and can be applied to future orders.
UsedusedThe credit balance has been fully redeemed.
ExpiredexpiredThe credit has passed its expiration date.
VoidedvoidedThe credit has been manually cancelled. The balance is set to zero.

FBO Point of Sale Reference

Order fields, payment methods, product catalog, and inventory tracking.

Manage FBO Bookings

Booking creation, tracking, and lifecycle management.

Manage FBO Units

Hangar, tiedown, and ramp space configuration and maintenance.

Manage FBO Ramp Services

Service order creation, assignment, and completion workflow.

Manage FBO Purchase Orders

Purchase order creation, vendor assignment, and receiving.

Handle FBO Billing

Invoices, rates, contracts, transactions, and customer billing.
Last modified on April 11, 2026