Monitoring & Troubleshooting
Keeping the booking integration running smoothly means checking a few places regularly and knowing where the error messages live. This guide covers both.
Start at the Role Center
The Business Manager Role Center carries two tile groups that give you the whole picture at a glance. Use them as your daily starting point -- each tile opens the relevant list when you click the number.
Travel — Requires Action counts what is blocked or waiting:
- AIR Imports with Errors -- imports that failed
- Missing Vendor -- imports waiting for a vendor to be created
- Awaiting Voucher Decision -- imports waiting for a voucher decision
- Missing Destination -- imports waiting for a destination code
- Unhandled Orders and Unhandled Credit Memos -- documents not yet posted
- Credit card tiles for posted invoices and credit memos where card processing or validation failed
Travel — Status counts what is in progress:
- Vouchers Pending and Vouchers with Errors
- Credit Card Pending for posted invoices and credit memos
- Travel Card Validation Errors
Checking Import Status
The AIR Import List shows the state of every import:
- Draft -- waiting to be processed. This is normal.
- Processed -- a sales order or credit memo was created.
- Error -- needs your attention.
Filter by Status = Error to find everything that needs action, then look at the Pending Reason column to see what kind of problem it is.
The Three Queues
Three problems have dedicated queue pages, and all three resolve the same way: fix the missing data in the queue, and the import is processed again automatically.
| Queue | Pending Reason | What to do |
|---|---|---|
| Missing Vendor Queue | Missing Vendor | Choose Create Vendor to create the hotel or rental company from the booking data (details) |
| Voucher Decision Queue | Awaiting Voucher Decision | Choose Set Voucher or Set Confirmation (details) |
| Missing Destination Queue | Missing Destination | Choose Add Destination and fill in the country code (details) |
Check these queues daily so bookings do not pile up before the travel dates.
Reading Error Messages
Error messages are not on the import card header -- they are in the AIR Import Log:
- Open the import card and look at the Import Log part at the bottom, or
- Select the import in the AIR Import List and choose Show Import Log to open the full log page.
On the log page:
- Errors are shown in red, warnings in yellow.
- Show Latest Run Only filters to the most recent processing attempt, which is usually what you want after a failed retry.
- Show All Runs brings back the complete history.
- Show/Hide Duplicates toggles repeated messages, which are hidden by default.
A summary of errors and warnings is also shown on screen straight after processing.
Common Issues and Solutions
| Issue | Cause | Solution |
|---|---|---|
| Pending Reason Missing Vendor | The hotel or car rental company is not a vendor in Business Central | Create it from the Missing Vendor Queue |
| Pending Reason Awaiting Voucher Decision | The customer's voucher default is Manual for a web booking | Decide in the Voucher Decision Queue |
| Pending Reason Missing Destination | The destination code is not in the AIR Destinations list | Add it from the Missing Destination Queue |
| Missing item mapping | No mapping exists for that combination of product type, region, service type, web flag, and voucher flag | Add the row in AIR Order Item Mapping, then process the import again |
| Item blocked or missing | The mapped item does not exist or is blocked for sales | Correct the item, then process the import again |
| No price on the service fee item | The service fee item has no price for the customer, the price group, or all customers | Add a price, then process the import again |
| Customer not found | The account number in the booking does not match any customer | Correct the customer record or the booking data |
| Salesperson not found | The salesperson code in the booking is unknown | Create the salesperson or correct the code |
| Missing exchange rate | The booking uses a currency with no rate for the working date | Update the rate on the Currencies page, then process the import again |
| Bookings not arriving at all | The integration platform may be down or misconfigured | Contact your administrator to check the Azure platform and the tenant configuration |
General Troubleshooting Steps
- Read the log -- open the AIR Import Log and use Show Latest Run Only.
- Check the related setup -- vendors, customers, items, prices, destinations, and currencies referenced by the booking.
- Process the import again -- go to the AIR Import List and choose Process to Order. If the import already has status Processed and you need a new document, use Reprocess Record instead.
- Escalate if needed -- if the error persists after the setup is correct, contact your Business Central administrator or TBC support with the sequence number and the exact message from the log.
Checking the role center tiles and the queues once a day is usually enough to catch problems before they affect invoicing.