Monitoring & Troubleshooting
Keeping the booking integration running smoothly requires regular monitoring and knowing how to resolve common issues. This guide covers how to check the health of the import process and what to do when something goes wrong.
Checking Import Status
Your primary monitoring tool is the AIR Import List. Search for it in Business Central (Alt+Q) and review the list regularly:
- New entries are waiting to be processed -- this is normal.
- Processed entries have been successfully turned into sales orders.
- Error entries need your attention.
Filter the list by Status = Error to quickly find imports that require action. Open the import card to see the specific error message.
Reviewing Queue Pages
The system provides queue pages for specific issues that need resolution before bookings can be processed:
- Missing Vendor Queue -- lists bookings that reference a vendor not yet set up in Business Central.
- Voucher Decision Queue -- lists bookings where a manual decision is needed regarding voucher handling.
Check these queue pages regularly to prevent a backlog of unprocessed bookings.
Common Issues and Solutions
| Issue | Cause | Solution |
|---|---|---|
| Import shows Error status | Missing or invalid data in the booking | Open the import card, read the error message, and correct the underlying issue |
| Missing vendor | The booking references a vendor that does not exist in Business Central | Create the vendor record, then re-process the import |
| Missing item mapping | A product type in the booking has no matching item configured | Go to AIR Setup and add the correct item mapping for the product type |
| Invalid customer | The customer reference in the booking does not match any customer in Business Central | Verify the customer exists and that the reference matches, then re-process |
| Missing exchange rate | The booking uses a foreign currency with no rate for the booking date | Update exchange rates on the Currencies page, then re-process |
| Bookings not arriving | The integration platform may be down or misconfigured | Contact your administrator to verify the Azure platform is running and the tenant configuration is correct |
General Troubleshooting Steps
When you encounter an error you have not seen before, follow these steps:
- Read the error message -- open the import card and note the exact error text.
- Check related setup -- verify that vendors, customers, items, and currencies referenced by the booking exist and are correctly configured.
- Re-process the import -- after correcting the issue, use the Process action on the import card to try again.
- Escalate if needed -- if the error persists after correcting setup data, contact your Business Central administrator or Stricct support with the sequence number and error message.
Regular monitoring -- ideally checking the import list and queue pages at least once per day -- helps catch and resolve issues before they affect invoicing timelines.