Hold reasons
When Xaldro cannot post an order exactly as Webflow recorded it, it does not guess. It holds the order: the ledger's status shows Failed with a message (hover it, or open the order). This page lists every message Xaldro writes, what it means and what you do.
Words in angle brackets, such as <amount>, are filled in with the order's own values. "Xero" reads "QuickBooks" for a QuickBooks hold.
Which holds clear by themselves
Only three kinds post again without you pressing Retry:
- Trial ended and monthly orders used: they post again after the owner subscribes or upgrades.
- Access lost: they post again after the owner reconnects that ledger.
For every other hold, fix the cause and press Retry on the order, or Retry all failed for the site.
Plan and access
| Message |
What it means |
What you do |
| Your free trial has ended. Subscribe in Billing; orders held for this post by themselves after you subscribe. |
The trial (14 days or 100 posted orders) is over and there is no active subscription. |
Subscribe in Billing. Held orders then post by themselves. |
| No active subscription. Subscribe in Billing; orders held for this post by themselves after you subscribe. |
The subscription was cancelled or a payment failed. |
Subscribe again, or update the payment method under Manage billing. Held orders then post by themselves. |
Your <plan> plan's <limit> orders this month are used. Upgrade in Billing, or retry next month. |
The plan's monthly order limit is reached. |
Upgrade (held orders then post by themselves), or press Retry after the month ends. |
| Xero access was lost or revoked. Reconnect Xero in Settings, then retry. |
Xaldro can no longer reach your ledger: access expired or was revoked. |
The owner presses Reconnect. Held orders then post by themselves. |
| Xero is not connected. Connect it in Settings, then retry. |
The site is mapped to Xero but no Xero organisation is connected. |
Connect it, then Retry. |
| The Xero organisation this site was mapped to is no longer connected. Reconnect it, or choose another in Settings, then retry. |
The organisation the mapping names was disconnected. |
Reconnect it, or pick another organisation in Settings and save, then Retry. |
| The Xero organisation this site was mapped to is no longer connected. Check the organisation and accounts in Settings and save them, then retry. |
Same, after a ledger was disconnected and connected again. |
Check the organisation and accounts in Settings, save, then Retry. |
Mapping
| Message |
What it means |
What you do |
| Xero is not set up for this site. Choose its accounts in Settings, then retry. |
There is no mapping for this ledger on this site. |
Map the accounts in Settings, then Retry. |
| Choose a revenue account for QuickBooks in Settings, then retry. |
No revenue account is mapped. |
Map one, then Retry. |
this order includes <amount> of tax, but no sales tax code is mapped for this accounting system, so the invoice total would be short by the tax. Set your sales tax rate in Settings, then retry. |
The order carries tax and no tax code applies to its destination. |
Map a default rate or a region rule (Tax & VAT), then Retry. |
| This order carries no tax, and QuickBooks needs a VAT code on every line. In Settings, choose the VAT code for orders without tax (for example zero-rated, exempt or no VAT, as your accountant advises), then retry. |
QuickBooks outside the US needs a 0% code on untaxed lines. |
Choose VAT code for orders without tax in Settings, then Retry. |
| "TAX" only marks a line as taxable in a US QuickBooks company. Choose the state or agency sales tax code (for example your state) as the sales tax rate in Settings, then retry. |
A US QuickBooks company needs a state or agency code. |
Map the state or agency code, then Retry. |
Totals and tax
| Message |
What it means |
What you do |
line items do not reconcile with the order: lines sum to <amount> but the order net (excl. tax) is <amount>. Not posting to avoid a wrong invoice. |
The order's lines, shipping and discount do not add up to Webflow's own total minus tax. Nothing was posted. |
Check the order in Webflow, then contact support. |
the invoice would total <amount> but the customer paid <amount>. The mapped tax rate likely does not match the order's tax. Not posting. |
Checked before posting: the invoice would not equal what was paid. Nothing was posted. |
Check the tax mapping, then Retry. |
posted invoice total <amount> did not match the order total <amount>; the invoice was voided. The mapped sales tax rate likely does not match this order. Fix it in Settings and retry. |
The read-back found a total more than 1 cent off. Xaldro voided the invoice it had just created. |
Fix the tax mapping, then Retry. A new invoice is posted. |
posted invoice tax <amount> did not match the tax the customer paid (<amount>); the invoice was voided. The mapped tax rate does not match this order's rate. Fix it in Settings and retry. |
The read-back found tax more than 1 cent off. The invoice was voided. |
Map the code with the order's rate, then Retry. |
Xero already has invoice <number> for order <order ID> with a total of <amount>, not <amount>. Xaldro does not post a second invoice. Void that one in Xero if it is wrong, then retry. |
Your ledger already holds an invoice with this order's reference and a different total. |
Void it in your ledger if it is wrong, then Retry. |
Xero already has an invoice for order <order ID> whose total is <amount> (or "whose tax is"), not what the customer paid. Xaldro does not post a second invoice. Correct or void that one in Xero, then retry. |
An existing invoice was linked, and on read-back it does not match. Xaldro does not void invoices it did not create. |
Correct or void it in your ledger, then Retry. |
Currency
| Message |
What it means |
What you do |
orders in <currency> are not supported yet: <currency> does not use two decimal places, and Xaldro posts only currencies with two decimal places for now. Contact support if you sell in <currency>. |
A zero- or three-decimal currency. See Currencies. |
Contact support. |
the order currency "<code>" is not a valid ISO currency code. Not posting. |
Webflow sent a currency Xaldro does not recognise. |
Contact support. |
This order is in <currency>, but your Xero organisation is not set up for <currency>. Enable multi-currency in Xero, or the order currency must match your accounting base currency. |
Your ledger refused the currency. |
Turn on multicurrency (and the currency) in your ledger, then Retry. |
This order is in <currency>, but your QuickBooks company keeps its books in <home currency> and multicurrency is off, so it cannot hold a <currency> invoice. Turn on multicurrency in QuickBooks (Settings, Account and settings, Advanced, Currency), then retry. |
QuickBooks multicurrency is off. |
Turn it on, then Retry. |
QuickBooks has no <currency> to <home currency> exchange rate for <date>. Add one in QuickBooks (Settings, Currencies), then retry. |
QuickBooks holds no rate for that day, and Xaldro does not post at 1 to 1. |
Add the rate in QuickBooks, then Retry. |
Data from Webflow
| Message |
What it means |
What you do |
Webflow sent the order total as "<value>", which is not a whole number of minor units. Not posting; contact support. |
The amount is not in the format Xaldro expects. |
Contact support. |
the order total from Webflow (<value>) does not match its own display amount (<text>). Not posting a possibly wrong amount; contact support. |
Webflow's amount and its own display text disagree. |
Contact support. |
| Webflow did not send the amount the customer paid for this taxed order, so Xaldro cannot be sure the total is right. Not posting; contact support. |
Without that amount, the total of a taxed order could be wrong. |
Contact support. |
Refused by your ledger
| Message |
What it means |
What you do |
Xero refused it: <Xero's own message> |
Xero rejected the document, for example an archived account, a closed period or an unusable tax code. Xaldro shows Xero's own words. |
Fix what Xero names, then Retry. |
Refunds
A refund that could not post shows Refund failed next to the ledger status; hover it for the message, then press Retry refund. Refunds can show the plan, access, mapping and currency messages above, and these:
| Message |
What it means |
What you do |
Xero already has credit note <number> for this refund with a total of <amount>, not <amount>. Xaldro does not post a second one. Void it in Xero if it is wrong, then retry. |
A credit with this refund's reference and a different total exists. |
Void it if it is wrong, then retry the refund. |
QuickBooks already has a credit (<number>) for this refund with a total of <amount>, not <amount>. Xaldro does not post a second one. Delete it in QuickBooks if it is wrong, then retry. |
Same, in QuickBooks. |
Delete it if it is wrong, then retry the refund. |
the Xero credit totalled <amount>, not the refunded <amount>, so it was removed. Check the order's tax mapping in Settings, then retry. |
The read-back found the credit more than 1 cent off; Xaldro voided it (Xero) or deleted it (QuickBooks). |
Check the tax mapping, then retry the refund. |
the Xero credit carried <amount> tax, not the <amount> the order charged, so it was removed. Check the order's tax mapping in Settings, then retry. |
Same, for the credit's tax. |
Check the tax mapping, then retry the refund. |
A refund for an order whose invoice is held or skipped waits; it is credited once the invoice posts.
Not holds
| Shown |
What it means |
What you do |
Skipped: order total <amount> is below your <amount> minimum. |
A sync rule left the order out. |
Nothing, or change the rule and import the window again. |
Skipped: order is not fulfilled yet (status: <status>). It will sync once fulfilled. |
The "only fulfilled" rule. |
It is checked again when Webflow reports the change. |
| Review: order edited after sync; invoice left unchanged for manual review |
The order's total changed in Webflow after its invoice posted. |
Adjust the invoice in your ledger by hand if needed. |
| Any other message on a Failed status |
A temporary error, for example a timeout. |
Xaldro retries by itself, up to 10 times with growing delays. If it stays, press Retry or contact support. |