Xero is your accounting system, and WSManager doesn't try to replace it. WSManager holds no ledger. It builds the invoice from what was recorded on the job, sends it to Xero, and then shows you the status Xero reports. This page lists exactly what moves between the two, and what doesn't.

What goes to Xero

  • Invoices. When you select Send to Xero on an invoice draft, the invoice is created in Xero once. Lines are built from the labour, travel, mileage, parts, ordered components and sundries recorded on the job, each with the job's tracking option. Progress claims go the same way. A line for a Xero item part is sent with the item's code, and GST is worked out line by line the way Xero does it.
  • Due dates. Xero doesn't work out a due date for an invoice sent from another system, so WSManager reads the payment terms held in Xero (the contact's, else the organisation's) and sends the due date they give.
  • Customers. A customer created in WSManager is created in Xero, and edits you make are sent on. Only the name, email, phone, mobile and addresses go.
  • Job tracking options. When you create a job, WSManager creates an option in your chosen Xero tracking category, named with the job number. Counter sales don't get one. Options are archived when a job is cancelled and a set number of days after it is complete.
  • Parts, if you choose Xero items. When Xero items are your parts list, a part's code, description, cost and sell price are shared with the item. Parts that exist only in WSManager are added to Xero as new items.
  • Updates to a sent invoice. While Xero holds an invoice as a draft or awaiting approval, you can change it in WSManager and send it again.

What comes back from Xero

  • Invoice status. Every 30 minutes, WSManager reads the status and amount due of sent invoices that aren't yet paid, and shows them on the invoice, the job and the Invoices list. A void or deletion in Xero releases the work on that invoice so it can be invoiced again.
  • Customers. Changes made in Xero are brought into WSManager, and you can import Xero contacts as customers or link existing customers by name. If a customer has changed in both places, nothing is overwritten until you choose.
  • Items. Xero's changes to items come in every 30 minutes, in full once a day, or on demand with Sync with Xero now.
  • Supplier bills, supplier credit notes and purchase orders. WSManager reads them every 30 minutes, or straight away with Check Xero now. Only lines on the job cost accounts you chose come in, so overheads such as power and rent don't. You link each line to a job, so the real cost lands on the right job.
  • Open jobs. At go-live, you can import the jobs you already track as options in Xero, keeping their numbers.

How the link is set up

Only an Owner can connect Xero. Under Settings, then Xero, select Connect to Xero, sign in to Xero, allow WSManager, and choose your organisation if you're asked. Then you choose the mappings, loaded live from Xero:

  • the labour, parts, ordered components and sundries sales accounts;
  • the output tax type for GST on sales;
  • the job cost accounts, and the date from which bills and purchase orders come in;
  • the job tracking category, and how many days after completion a job's option is archived;
  • payment terms for contacts WSManager creates.

Next you link or import your customers, and choose whether your parts list is kept in WSManager or in Xero items. The page shows whether you are Connected, Needs reconnecting or Not connected. If a change can't reach Xero, it waits and is sent when Xero is back, and the rest of WSManager keeps working.

Checks before an invoice is sent

The invoice draft has a Checks before sending panel. These stop the invoice being sent until you fix them:

  • the customer is linked to a Xero contact;
  • an order number is present, when the customer needs one and the job has none;
  • Xero is connected and the account mappings are set;
  • the job's Xero tracking option is ready;
  • the total is more than zero.

These are warnings and don't stop the send: time that isn't yet approved, someone still clocked on to the job, ordered parts without a supplier bill, and zero-value lines. If margin is low, the Job costing panel warns you as well. While anything is stopping the send, the button says Not ready to send.

What stays in WSManager

  • Notes, labour rates, discounts, contacts, assets, the order number flag and job costs are never sent to Xero.
  • Job time, timesheets, leave and payroll hours stay in WSManager.
  • A part's category, supplier, markup, unit and active setting stay in WSManager, even when Xero items are your parts list.

WSManager doesn't send the invoice to your customer or take payment: that happens in Xero. It doesn't record payments, make credit notes, create purchase orders or bills, post work in progress journals, or put several jobs on one invoice. Suppliers stay in Xero only.

FAQ

Does WSManager replace Xero?

No. Invoices, bills, payments and credit notes all live in Xero. WSManager builds the invoice and reads back the status.

What status does an invoice have in Xero when it arrives?

A new invoice arrives in Xero as a draft or already approved, depending on the Invoice status on send setting in WSManager. The invoice page then shows its Xero status (Draft in Xero, Awaiting approval in Xero, Approved, Paid or Voided), and Open in Xero takes you straight to it.

What if Xero is down or the connection lapses?

Changes for Xero wait and are sent when it's back. If a banner says Xero needs reconnecting, an Owner selects Reconnect, and nothing already in Xero is changed.

What if sending fails?

The job isn't changed. You can Retry, which won't make a second invoice, or go back to a draft, fix it and send again. Check Xero first so a duplicate isn't created.

What happens if I void an invoice in Xero?

WSManager marks it as voided and releases its time and parts so you can invoice them again.

Can I keep my parts list in Xero?

Yes. An Owner chooses Xero items as the parts list source, and edits can be made in either place.