Skip to main content

​
I have an export error. What do I do?

Here’s how to figure out what went wrong, fix the most common issues, and get your payment data into your accounting system. One thing to keep in mind: once a payment hits an error, Garde won’t automatically try to send it again — even after you fix the underlying problem. After resolving the issue, head to Accounting > Export, select the payment in error, and press Send to retry the export.
This article covers payment export errors specifically. For invoice-related errors, see How to Troubleshoot Common Invoice Export Errors.

​
Uncovering the Error

On the accounting export page, you can filter to show only exports in error. Click the Filter button next to the date selector and choose the Error status. To see what’s causing an export error, click the word “Error” in red. That pulls up an audit trail of the export history for your payment, including the last response from your accounting system describing the error.

​
Common Payment Export Errors

​
Duplicate Document Error / Check Already in Accounting System

This means the check you’re trying to export already exists in your accounting system — same check number from the same checking account. Example Messages
  • “org.apache.http.client.HttpResponseException: Unexpected response status: 400 {“Fault”:{“Error”:[{“Message”:“Duplicate Document Number Error”,“Detail”:“Duplicate Document Number Error : You must specify a different number. This number has already been used. DocNumber=#### is assigned to TxnType=Check with TxnId=####”,“code”:“6140”,“element”:""}],“type”:“ValidationFault”},“time”:”####“BL01001973
  • Replace the check number ##### with an un-used check number against the [mapped bank account name], then try again. Please enter unique check number [Support ID: #####]
How to fix it If this check already exists in your accounting system, you can skip exporting it from Garde.

​
Exported the Check Payment Before the Invoice Was Exported

To pay an invoice with a check payment, that invoice needs to already be in the accounting system. If you try to send a check payment before the invoice has been successfully exported, the check will error out because it has nothing to mark as paid. Example Messages
  • One or more orders associated with Bill Payment have not yet been sent to accounting.
How to fix it Export the missing invoice first, then export your check payment again. If you’re not sure which invoice is missing, you can find all the invoices paid with that check number in the error log (see example below). Tips:
  • You can use the search bar to look for invoice numbers or check numbers. Searching for a check number will also show invoices paid with that check.
  • If you can’t find the invoice, check your date range filter — it might fall outside the range you’re currently viewing.
  • If an invoice shows an error status, it hasn’t successfully exported and needs to be sent before the check payment can go through.
  • If you don’t see the check, try changing your filter to include Sent and Skipped. If the invoice is in Skipped status, you can export it and then send the check payment. If it’s in Sent status, you should be able to just re-export the check by selecting it and pressing Send on the Accounting > Export page.

​
Check Number Used to Pay Multiple Vendors

This error happens when the same check number appears on invoices written to more than one vendor. Example Messages
  • Invalid Check Data Entered. Check number is used on invoices from multiple remote vendors.
How to fix it Contact Garde support. We’ll need to reopen the invoices in question and adjust the check numbers.

​
Payment Account is Not Mapped

If an invoice is closed to a payment account that hasn’t been mapped to the corresponding balance sheet account in your accounting system, the payment won’t export. Example Messages
  • Payment Account (Payment Account Name) is not mapped to an accounting system account. Map this account on Accounting > Payment Accounts.
How to fix it Go to Accounting > Payment Accounts, find the listed payment account, and map it. For full instructions, see Your Default Payment Account. Then head to Accounting > Export, select the payment, and press Send. If the payment account is already mapped, you’ll still need to manually resend the payment since it’s in error status. Go to Accounting > Export, select the payment, and press Send.

​
Invoice is Missing Remote ID

When Garde sends an invoice to your accounting system, it attaches a remote ID so that when a payment exports, the system knows which invoice to mark as paid. If someone edits that invoice directly in your accounting system, it can strip out the remote ID — and the payment export will fail. Example Messages
  • Object Not Found : Something you’re trying to use has been made inactive. Check the fields with accounts, customers, items, vendors or employees.
How to fix it If the payment is tied to a single invoice, delete that invoice from your accounting system and re-export both the invoice and payment from Garde. If multiple invoices are associated with the payment in error, there’s no way to tell which one was edited. You have two options:
  1. Delete all associated invoices from your accounting system and re-export everything (invoices and payment) from Garde.
  2. Manually enter the payment into your accounting system and mark it as Skipped on the Accounting > Export page in Garde.