Troubleshooting the AP API Log Troubleshooting the AP API Log

Troubleshooting the AP API Log

The AP API Log 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 AP API Log

  1. Go to Menu → Admin Settings → AP API Log
  2. Review the list of failed invoices
  3. Click the Message or Response field to view the error returned by your AP system

These messages explain why the invoice could not be created in the AP system.


Important

The error messages displayed in the AP API Log are returned directly from your AP system.

This means the issue is usually caused by a mismatch between Brightflag data and the requirements of your AP system.

Each AP system has different validation rules, so the required fix will depend on the error message.


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.

See: Resending or Removing Invoices in the AP API Log