The External API Logs page shows invoices that failed to transfer from Brightflag to your Accounts Payable (AP) system.
This page helps Admin users review integration errors and determine what needs to be corrected before the invoice can be sent again.
⚠️ This applies only to invoices sent using an API-enabled AP Route.
How to Check the External API Logs
Go to Menu → Admin Settings → External API Logs
Review the list of failed invoices or enter the invoice ID to locate a specific invoice
Click the dropdown arrow on the right-hand side to see various fields, including the Body and Response fields. These detail what data was sent to the external system (e.g., Oracle, Coupa, a middleware program, etc.) and the error returned to Brightflag.
Important
The error messages displayed in the External API Logs are returned directly from your AP or middleware system. It's important to understand how your company's integration is configured, as there might be specific processes/errors not covered in this guide.
Each AP system has different validation rules, so the required fix will depend on the error message.
Most issues stem from a mismatch between Brightflag data and your AP system's requirements. For example, the allocation codes assigned to the invoice in Brightflag don't match those configured in your AP system.
Common API Errors
Error | Cause | Resolution |
Invoice number already used | The invoice number already exists for the vendor in the AP system | Cancel or change the invoice if necessary |
API account invalid | Allocation or accounting code mismatch | Check allocation AP codes in Admin Settings → Allocations |
Tax code required | Tax jurisdiction does not match invoice currency or jurisdiction | Reject and request the vendor re-upload with the correct tax selection |
Unexpected character | Special characters in the matter name are not supported | Remove unsupported characters and resend the invoice |
Next Step
After correcting the issue, you can resend the invoice to your AP system by clicking on the Resend button.
Important: Clicking the Resolve button clears the error from the log. Therefore, click the Resolve button only after the invoice has been successfully received in AP.
If you have any questions about how to troubleshoot the log further, please contact Brightflag Support: How to Contact Brightflag Client Support