If your invoice has failed to generate in your Xero ledger or failed to reconcile after payment is paid out to you, there may be an error reported by Xero to explain why.
​
Currently, you can review any Xero errors in a client's Invoices tab. Click into an invoice and you can view the activity log in the Activity section.

For the most common errors, we have documented below why they occur and what you can do to rectify them.
​
After taking the appropriate actions, try to re-send the invoice if it is un-deployed (if it is an invoice deployment error) - or contact our support team to re-run invoice reconciliation on your account (if it is an invoice reconciliation error).

An invoice cannot be created as the tax type code is not able to be published to this type of account in Xero.
​
This often happens if you are using a revenue account with an expenses code or vice versa.

Solution:

You can either:

Once this is completed, try to re-send the invoice to Xero using the cog next to the invoice on the proposal.
​

An invoice cannot be created as the account not compatible with this.
​
This can happen if you are using a revenue account with an expenses code or vice versa.
​
This can also happen if you are trying to publish into an incompatible Xero account - e.g., a Bank or Direct Cost account.

Solution:

1. Check your account type can publish accounts receivables invoices - usually a revenue account, 
​

If yes, it is a revenue account

2. Go to Xero and allow that tax code type to be used on that account;

If no, you are using an incompatible account

3. Change the account on that service in Ignition to one that accommodates that tax type

Once this is completed, try to re-send the invoice to Xero using the cog next to the invoice on the proposal.
​

An invoice cannot be created as the account is not compatible with this.
​
This can happen if you are using a revenue account with an expenses code or vice versa.
​
This can also happen if you are trying to publish into an incompatible account - e.g., a Bank or Direct Cost account.

Solution:

1. Check your account type can publish accounts receivables invoices - usually a revenue account, 
​

If yes, it is a revenue account:

2. Go to Xero and allow that tax code type to be used on that account;

If no, you are using an incompatible account:

3. Change the account on that service in Ignition to one that accommodates that tax type

Once this is completed, try to re-send the invoice to Xero using the cog next to the invoice on the proposal.
​

An invoice cannot be created as it is dated before the "lock date" (an end-of-period date set in your Xero account).
​
Xero sees this period as closed, so it won't "accept" any invoices that are dated prior.

Solution:
​
Change the lock date in Xero a refer to Xero's information on working with lock dates here.
​
Once this is completed, try to re-send the invoice to Xero using the cog next to the invoice on the proposal.
​

An invoice cannot be created as it is dated before the "lock date" (an end-of-period date set in your Xero account).
​
Xero sees this period as closed, so it won't "accept" any invoices that are dated prior.

Solution:
​
Change the lock date in Xero a refer to Xero's information on working with lock dates here.
​
Once this is completed, try to re-send the invoice to Xero using the cog next to the invoice on the proposal.
​

An invoice cannot be created as you are on the trial version of Xero, or on their "Starter" plan and have exceeded your limit.

Both of these will impose a limit on the number of approved invoices that you can have in Xero. Read more on their website.

Solution:

Move off trial or upgrade your plan. 

Once this is completed, try to re-send the invoice to Xero using the cog next to the invoice on the proposal.
​

An invoice cannot be created as Xero does not support sending invoices with less than zero value (negative value).

Solution:

All invoices on a proposal will need to have a positive value. 

If you need to issue a credit to a client, add a credit note in Xero.
​

An invoice cannot be created as there is a contact in Xero with the same name as on the invoice attempting to be created.

This can happen if clients have been incorrectly mapped in Ignition.

Solution:

Once this is completed, try to re-send the invoice to Xero using the cog next to the invoice on the proposal.
​

An invoice in Xero cannot be created when these steps occur in sequence

Solution:

Please check your client's Xero Contact mapping in Ignition by navigating to the specific client → Edit client → Apps tab → App client mappings.

An invoice branding theme is selected that no longer exists in Xero.

Solution:

Select a new branding theme under Apps → Xero → Settings in Ignition.
​

An invoice cannot be created as the Xero Authentication access token has expired and you need to re-authenticate with Xero.

Solution:

Re-authenticate your Xero credentials in Ignition by going to Apps → Xero.

An invoice cannot be created as the Xero Authentication access token has expired and you need to re-authenticate with Xero.

Solution:

Re-authenticate your Xero credentials in Ignition by going to Apps → Xero.
​

An invoice cannot be created as the invoice number already in use.
​
This may occur if an invoice was voided and recreated before Xero was able to release the number or if you have changed your Xero invoice numbering scheme.

Solution:

If you have not edited your Xero numbering scheme, wait for a short time and attempt to re-create the invoice.
​
If you have changed the invoice numbering scheme, check to ensure it will generate unique invoice numbers. Refer to Xero's help article here.

An invoice can't be reconciled as the clearing account used by Ignition to clear funds has been archived. 

Solution:

Un-archive the Xero clearing account associated with Ignition. This will usually be called Ignition Clearing Account or IgnitionPayments.

After completing this, contact our support team to re-run invoice reconciliation on your account.
​

An invoice can't be reconciled as the invoice has been deleted.

Solution:

Re-create the invoice in Ignition from the cog next to the invoice. If the invoice is not automatically reconciled, contact our support team to re-run invoice reconciliation on your account.
​

An invoice can't be reconciled as the invoice has been voided.

Solution:

Re-create the invoice in Ignition from the cog next to the invoice. If the invoice is not automatically reconciled, contact our support team to re-run invoice reconciliation on your account.
​

An invoice can't be reconciled as it is not found in the ledger.

This may occur if you have changed the connected ledger since the invoice was raised or if the invoice is in a state that a payment cannot be raised against it.

Solution:

First check that you have the correct Xero ledger connected under Apps → Xero.

If so, Re-create the invoice in Ignition from the cog next to the invoice. If the invoice is not automatically reconciled, contact our support team to re-run invoice reconciliation on your account.
​

An invoice can't be reconciled as the clearing account is of an incompatible account type.

When Ignition creates a clearing account, the account type will be set as "Current Asset". 

Solution:

Change the Ignition Clearing Account to account type "Current Asset".

After completing this, contact our support team to re-run invoice reconciliation on your account.

An invoice can't be reconciled as the payment amount differs to the invoiced amount.

This may occur if a partial payment or credit has been added to the invoice. It may also occur if the tax settings are different on the invoice than the payment.

Solution:

Check that the invoice does not have a partial payment or credit applied.

If it does, you can either manually reconcile the invoice or remove this and contact our support team to re-run invoice reconciliation on your account.

There could be two possible reasons for this:

Solution:

Check your current Xero subscription, if you have a starter account, you'll need to either void some of the invoices to continue testing. If you have a trial account, you'll need to activate your Xero account to continue.

Once this is completed, try to re-send the invoice to Xero using the cog next to the invoice on the proposal.

This error occurs when a payment cannot sync to Xero because the payment amount is greater than the open balance of the bill or invoice in Xero.

Please note that the payment amounts need to be less or equal to the open balance of invoice for it to sync successfully to Xero.

Solution:

Remove any duplicate manually applied for payment from the bill or invoice in Xeo.

Once this is completed, try to re-send the invoice to Xero using the cog next to the invoice on the proposal.