Skip to content

The sync queue

Once Xero or QuickBooks Online is connected, Invoicing → Sync queue shows every issued invoice and credit note on its way there, and the payments going each way. It’s in place of Finance export, which is for the file.

Use Show to see All, or just what’s Refused, Waiting, Held or Sent, each with how many. If sending is paused, or the link isn’t connected, the page says so at the top, with a link to Accounts package.

Columns chooses your columns, including Attempts, Queued, Account ref, Due date, Net, VAT and the document’s reference in the accounts package. Select a heading to sort by it, or its filter icon to filter by it: this covers the most recent 500 items.

Each invoice or credit note dated on or after the start date goes on the queue as it’s issued, and is sent within a minute or so:

  1. Its customer goes first. It’s created there, or updated if its name, address, email, VAT number or terms changed since it last went. A customer you’ve matched uses the contact (or QuickBooks customer) you picked.
  2. The invoice or credit note goes, with our number, its lines, their nominal codes (in QuickBooks, their items) and tax rates, and each line’s VAT as on our invoice.
  3. Their totals are checked against ours. They must match to the penny.
  4. Our PDF is attached, if that’s switched on.
  5. A credit note is applied to the invoice it credits, for whatever is still owed on it.

Then it’s marked Sent, and the invoice shows Sent to the accounts package with the date. A credit note waits for the invoice it credits to go first.

Nothing is ever sent twice. If a send is interrupted, it carries on from where it stopped. If Xero or QuickBooks already has a document with our number, Customry One links to it instead of making another.

StatusWhat it means
WaitingOn its way. If Xero or QuickBooks was busy or couldn’t be reached, Next try says when it goes again.
HeldWaiting for Send all held now (when Send as they’re issued is off). Tick some to send just those: the button becomes, for example, Send 2 now.
RefusedSomething has to be put right first. The reason is shown under the document.
SentIt’s there. Open in Xero (or Open in QuickBooks Online) goes to it.

When something is refused, or can’t be sent after several tries, the people who look after the link are told under the bell, with the reason. See Notifications.

The queue also shows the payments going to and coming from the accounts package (Payments with Xero, Payments with QuickBooks), each against its invoice:

Shown asWhat it is
PaymentA payment recorded here, going to the accounts package. Amount is the payment.
Payment voidedA payment voided here, being deleted in Xero or voided in QuickBooks.
Payments read backCustomry One reading an invoice’s payments from the accounts package after it changed there.
Checked for changesThe regular check for anything changed in the accounts package that was missed.
Payment looked upQuickBooks: a new payment was made there, and Customry One is finding which invoices it’s for. Their payments are then read back.

The reason says what to fix. The usual ones:

  • A VAT rate isn’t matched to a tax rate there: match it on Administration → Accounts Package.
  • A line has no nominal code, or Xero says an account code isn’t valid: see nominal codes.
  • A contact with that name already exists: match the customer to it on Administration → Accounts Package, or rename one of them.
  • The totals there don’t match: both sets of figures are shown. Correct the document in Xero.
  • No bank account is chosen for a payment: choose one under Payments on Administration → Accounts Package.
  • Xero or QuickBooks refuses a payment, for example because it’s more than is still owed there: check the invoice there.
  • QuickBooks: a nominal code or carriage has no item there: pick or create one under Items on Administration → Accounts Package (Connect QuickBooks).
  • QuickBooks: its number is too long, or it went as a different number: QuickBooks takes 21 characters at most, and keeps our numbers only with Custom transaction numbers on. Put it right there, then retry.

Then tick it and press Retry 1 (the button counts what you ticked), or press Retry all refused.

Invoices and credit notes dated on or after the start date but issued before the link was connected haven’t gone anywhere. The page says how many. Select Queue them: they’re added as Held, so you can check them first, then select Send all held now.