The PNR_V3 is recommended for expense management integrations. It operates at the individual booking level, delivering focused payloads for each financial transaction.
The following table describes a typical expense management workflow using the PNR_V3 webhook:
| Step | Operation | Action and next steps |
|---|---|---|
| 1 | BOOKING_CREATED | A traveler books a flight. Your system receives the booking details and registers that a new trip is in progress. |
| 2 | BOOKING_TICKETED | The airline tickets the booking and payment is charged. Your system creates an expense entry using the pricing, traveler, and organization data in the payload. |
| 3 | INVOICE_GENERATED | An invoice PDF file has been generated for the booking. You can store this invoice for auditing purpose later. |
| 4 | TICKET_VOIDED | The traveler cancels within the void period. Your system receives this information and reverses or updates the expense entry. |
| 5 | TICKET_REFUNDED | The traveler cancels after the voidable time limit but within the refundable limit. Your system receives this information and reverses or updates the expense entry based on the amount refunded. |
- For air bookings, Spotnana is directly involved in the transaction and provides detailed financial data including the ticket amount, taxes, fees, and ticket number. For transactions processed via Stripe, a Stripe ID is included in the payload for reconciliation.
- For hotel and car bookings, the charge is processed directly by the supplier. Prepaid is paid online, while postpaid is paid offline at the hotel reception. Spotnana provides the quoted rate and booking details, but does not control the actual charge. Reconciliation with credit card statements requires matching on dates, property name, location, and amount.
- The URLs of the invoice PDF URLs are included in the
PNR_V3payload. You can also make an API call to the Spotnana get gocuments API. Note that free cancellations, such as a hotel booking with no charge, do not generate invoices. - The webhook payload does not include a PDF receipt. Partners that need a receipt can either generate one on their side using the payload data, or call the Spotnana Documents API to download the invoice.