Skip to main content

Accounting System Integration

In one sentence: ServCraft integrates with Sage One, Xero, and QuickBooks to automatically sync your invoices to your accounting system — eliminating double-entry and keeping your books accurate.


Why Integrate?​

Without accounting integration, someone has to manually re-enter every invoice from ServCraft into the accounting system. This is:

  • Time-consuming
  • Error-prone
  • Creates a lag between billable work and your financial records

With integration, invoices created in ServCraft flow automatically (or with one click) into your accounting system, where your bookkeeper or accountant can work with them.


Which Accounting Systems Are Supported?​

SystemRegionNotes
Sage One (Sage Business Cloud)South Africa (primary)Most common for ServCraft customers
XeroInternationalPopular with accountants
QuickBooks OnlineInternationalPopular with small businesses

Your business can only be integrated with one accounting system at a time.


How the Sync Works​

What Gets Synced (Customer Invoices)​

When an invoice is synced from ServCraft to your accounting system:

Field in ServCraftWhere It Goes in Accounting System
Customer nameCustomer/Contact record
Invoice numberInvoice number (or reference)
Invoice dateInvoice date
Due dateDue date
Line items (description, quantity, price)Invoice line items
Tax (VAT)Tax amounts on the invoice
Grand totalInvoice total

What Gets Synced Back (from Accounting System to ServCraft)​

  • The accounting system's document number, shown on the invoice as "Synced: [number]". ServCraft also saves this number as the invoice's own invoice number. With the default settings it is the number ServCraft sent. When the integration uses the accounting system's numbering sequence, it is a new number that replaces the one ServCraft gave the invoice (see Invoice Numbering below).
  • Invoice status update to Paid — when the invoice shows as paid in the accounting system, ServCraft marks the corresponding invoice as Paid. With Xero, an invoice that turns out not to be fully paid can also be moved back from Paid to Unpaid.

Important: The payment itself does not sync back as a payment record on the ServCraft invoice. No payment entry appears in ServCraft — only the invoice status changes to Paid. The amount, date, and method of payment remain in the accounting system only.


Customer Sync Direction​

The integration's settings screen under Settings → Company → Integrations has a Customer Direction dropdown that decides which way customer records travel between ServCraft and the accounting system. Supplier Direction and Inventory Direction dropdowns sit next to it and do the same job for suppliers and items. The options are:

OptionWhat happens to customers
NoneNothing is pulled from the accounting system, and the regular sync does not send ServCraft's customers either.
Sage One to ServCraft (Xero: Xero to ServCraft, QuickBooks: Quickbooks to ServCraft)Customers created or changed in the accounting system are copied into ServCraft. The regular sync does not send ServCraft's customer changes.
ServCraft to Sage One (Xero: ServCraft to Xero, QuickBooks: ServCraft to Quickbooks)New and changed ServCraft customers are sent to the accounting system. Nothing is pulled back.
BidirectionalBoth of the above.

Whatever the direction, an invoice needs a customer on the accounting side. When an invoice syncs for a customer that has never been linked to the accounting system, ServCraft sends that one customer first. With None or the "to ServCraft" option, this is the only time a ServCraft customer reaches the accounting system.

When a customer is pulled from the accounting system, ServCraft skips it if the ServCraft record was changed more recently than the accounting record. A customer that is inactive in the accounting system and has no match in ServCraft is ignored rather than created.

Deactivating a customer in ServCraft​

Turning off a customer's Active switch in ServCraft queues the customer for sync. What reaches the accounting system depends on the provider, and only when the Customer Direction is the "ServCraft to" option or Bidirectional:

Accounting systemWhat happens there
XeroThe contact is archived in Xero. Turning the customer active again in ServCraft makes the contact active again.
QuickBooksThe customer is made inactive in QuickBooks. Turning the customer active again in ServCraft makes it active again.
Sage OneNothing happens in Sage One. The Sage One sync only sends active customers, so the customer stays active in Sage One with the details it had at its last sync. If it must be inactive in Sage One, someone has to deactivate it there by hand. Turning the customer active again in ServCraft sends it on the next sync.

With Sage One on Bidirectional, a customer deactivated only in ServCraft can come back. If someone later edits that customer in Sage One, the Sage One record is now the newer one, and the next pull copies its details onto the ServCraft customer, including its active setting. The customer is then active in ServCraft again.

Deactivating or deleting a customer in the accounting system​

When the Customer Direction is the "to ServCraft" option or Bidirectional, a customer made inactive in Sage One or QuickBooks, or archived in Xero, becomes inactive in ServCraft on the next pull. The usual rule applies: if the ServCraft record was changed more recently, the pull skips it.

ServCraft finds out that a customer was deleted in Sage One when it next syncs an invoice for that customer, whatever the Customer Direction. That invoice fails with the message "Customer has been deleted on sage.", the ServCraft customer is made inactive, and its sync status changes to Deleted.


Invoice Numbering: ServCraft or the Accounting System​

Each accounting integration has a switch on its settings screen under Settings → Company → Integrations that decides which system numbers your invoices. It is labelled Use SageOne invoice numbering sequence, Use Xero invoice numbering sequence or Use QuickBooks invoice numbering sequence, and it is off by default. Sage One has a second switch, Use SageOne purchase order numbering sequence, for purchase orders.

When the switch is off, ServCraft's invoice number is the invoice number. ServCraft sends it to the accounting system, and the accounting system uses it.

When the switch is on, the number changes once the invoice syncs:

  1. When the invoice is first saved, ServCraft gives it the next number from its own sequence, as usual. Treat this number as temporary.
  2. Draft invoices do not sync. Once the invoice is Unpaid, Overdue or Paid, ServCraft sends it to the accounting system without a number, and the accounting system allocates the next number in its own sequence.
  3. ServCraft replaces the temporary number on the invoice with the accounting system's number. From then on the invoice carries the accounting system's number in both systems.

Send the invoice to the customer only after it has synced. An invoice emailed or printed before the sync shows the temporary number, and after the sync that number no longer belongs to the invoice. Xero and QuickBooks never receive the temporary number, so a payment that quotes it as the reference does not match any number on the invoice there. Sage One copies the temporary number into the invoice's Reference field, after your own reference. With the switch on, finalise the invoice, wait until it shows "Synced: [number]" and the new invoice number, then send it from ServCraft or from the accounting system.

The temporary number does not stay on the invoice in ServCraft after the sync, so use the accounting system's number to find the invoice later.


Sync Status — What You See on the Invoice​

When an accounting integration is active, the invoice screen shows the invoice's sync state:

StatusWhat You See / What It Means
NeverA "Send Invoice to [Partner]" button — the invoice has not been synced yet
PendingA "Pending Invoice to [Partner]" indicator — the invoice is queued for sync
Synced"Synced: [document number]" — the invoice exists in the accounting system, shown with its accounting-system document number
FailedA "Retry Invoice to [Partner]" button with an alert icon — hover the icon to view the error message
Not SyncableThe invoice can't be synced in its current state
DeletedThe synced document was removed on the accounting side

The same information is available for every document in one place: Settings → Company → Integrations, Integration Hub tab. It lists each item with its Module, Sync Status, any Message, the External Doc Number and the date it was last updated, which makes it the quickest way to see why several invoices are stuck.


How to Trigger a Sync​

Manual Sync​

To queue an invoice yourself:

  1. Open the invoice
  2. Click Send Invoice to [Partner] (or Retry Invoice to [Partner] after a failure)
  3. The invoice is queued for sync

In the mobile app, open the invoice and tap the menu to reach Invoice Actions, then choose Invoice to [Partner] (Retry Invoice to [Partner] after a failure). The option appears only while the invoice has not synced or has failed. If the app is still syncing its own data, it asks you to wait and try again. A banner on the invoice then shows Pending Invoice to [Partner], Synced: [number] or Failed Invoice to [Partner].

Note: Only approved invoices go across — invoices still in Draft (and Cancelled invoices) are not sent to the accounting system.


Sage One Integration​

What Is Sage One?​

Sage One (now called Sage Business Cloud Accounting) is South Africa's most popular accounting software for small to medium businesses. Many ServCraft customers use it.

How It Works​

  • ServCraft sends invoice data to Sage One via the Sage One API
  • Sage One creates a Tax Invoice document in your Sage account
  • The Sage invoice number is recorded back in ServCraft
  • When an invoice shows as paid in Sage, the ServCraft invoice is marked Paid during sync (the payment details themselves stay in Sage)

Setup​

An administrator sets up Sage One integration in Settings → Company → Integrations, on the Accounting Integration setup tab. Choose the Sage One partner, then connect in one of two ways. Enter your Sage username and password and click Connect to Sage One, or click Connect with Sage Account if you sign into Sage with a Sage Account. If the first way fails with "Could not connect to Sage One", try the Sage Account option before contacting support.

Important Rules for Sage One​

  • Once an invoice is synced to Sage, do not delete it in Sage without also cancelling in ServCraft
  • If you need to correct a synced invoice, issue a credit note in Sage (see Credit Notes)
  • Tax codes in ServCraft must match what's configured in Sage — talk to your accountant if you're unsure
  • Customer records must exist in both systems — ServCraft creates or links customer records in Sage during sync

Xero Integration​

What Is Xero?​

Xero is a cloud-based accounting platform popular with accountants and businesses with an international presence.

How It Works​

  • ServCraft connects to Xero via a secure OAuth 2.0 connection (you authorise the connection once)
  • Invoices sync as Sales Invoices in Xero

Setup​

An administrator sets up Xero integration in Settings → Company → Integrations: choose Xero, and you'll be prompted to log into your Xero account and authorise the connection.

Important Rules for Xero​

  • The Xero connection uses your Xero login — if you change your Xero password, the connection may need to be re-authorised
  • Chart of accounts must be configured in Xero before syncing (line items need GL account codes)
  • Xero operates in multiple currencies — ensure your Xero is set to ZAR if you're a South African business
  • Each inventory line is matched to a Xero item by its code. If an item cannot be sent to Xero, the invoice fails with "Invoice unable to sync because inventory failed to sync to partner", so fix the item first and then retry the invoice
  • Xero allows a limited number of requests in 24 hours. When the limit is reached, the integration page shows "Xero 24-hour limit reached, the integration will be retried automatically at [time]" and syncing resumes by itself at that time

QuickBooks Integration​

What Is QuickBooks?​

QuickBooks Online (QBO) is Intuit's cloud accounting platform, widely used in the US and internationally.

How It Works​

  • ServCraft connects to QuickBooks Online via OAuth 2.0
  • Invoices sync as invoices in QBO

Setup​

An administrator sets up QuickBooks integration in Settings → Company → Integrations: choose QuickBooks and authorise the connection with your Intuit account.


When Sync Fails​

Common Reasons for Sync Failure​

ReasonWhat to Do
Customer doesn't exist in accounting systemCreate the customer in the accounting system, then retry the sync
Missing or invalid GL account codeEnsure line items have the correct financial category assigned
Accounting system credentials expiredRe-authorise the integration in Settings
Network timeoutWait and retry
Duplicate invoice numberCheck if invoice already exists in accounting system
Sage One: "Each Delivery Address Line cannot be more than 100 characters"Shorten the long delivery address line on the customer or location, then retry
Xero: "Invoice unable to sync because inventory failed to sync to partner"Check the item on the invoice exists in Xero with the same code, fix it, then retry
Invalid tax codeEnsure tax settings match between ServCraft and your accounting system

When the Whole Integration Has a Problem​

If the connection itself fails, a banner appears across the top of every screen. When the integration has an error message, the banner shows that message, for example the Xero 24-hour limit message, with a button to dismiss it. When the integration is paused without a message, the banner says "Your accounting integration is currently paused." Users with the Integrations permission get a Check Integration button on that banner, which opens the integrations page, and everyone else is told to ask their admin to check it. The banner refreshes about every five minutes. Fix the cause, or re-authorise the connection from Settings → Company → Integrations, and syncing resumes.

How to Retry a Failed Sync​

  1. Open the invoice with the Failed sync status
  2. Hover the alert icon next to the retry button to read the error message
  3. Fix the underlying issue (see table above)
  4. Click Retry Invoice to [Partner]

The Golden Rule: One Version of the Truth​

Never edit the same invoice in both ServCraft and your accounting system independently.

Once an invoice is synced, changes should flow in one direction: from ServCraft to the accounting system (for new invoices), and from the accounting system back to ServCraft (for payments and credit notes).

Making changes in both places creates inconsistency and reconciliation headaches.


What Accounting Integration Does NOT Cover​

FunctionHow to Handle It
QuotesQuotes are never pushed to the accounting system — not as quotes and not as invoices. Convert the accepted quote to an invoice first (Copy To → Invoice on the quote screen), then use Send Invoice on that invoice. See the question below about the mobile app's "Invoice to …" option
Expenses / supplier billsUse your accounting system directly
PayrollUse your payroll system
Fixed assetsUse your accounting system directly
Tax returnsDone in your accounting system

Common Questions​

"We have an accountant — should they be setting this up?"​

Ideally yes. Accounting integration touches GL codes, tax types, and financial categories. Your accountant or bookkeeper should be involved in the initial setup to ensure the chart of accounts is correctly mapped.

"Can we have both Sage and Xero running at the same time?"​

No. ServCraft supports one accounting system integration per business.

"Can we push a quote straight to Xero / Sage One / QuickBooks?"​

No. The accounting sync sends invoices (plus customers, suppliers, inventory items and purchase orders) — it never sends quotes, not even accepted ones. Convert the accepted quote to an invoice with Copy To → Invoice on the quote screen, then use Send Invoice on the new invoice.

"An invoice synced to Sage but the amounts are wrong. What do we do?"​

Do not edit the invoice in Sage directly. Issue a credit note in Sage against the incorrect invoice, then create a new correct invoice in ServCraft and sync it.

"We want to stop using our accounting integration"​

Contact ServCraft support or your administrator to deactivate the integration in Settings. Invoices already synced remain in your accounting system but new invoices will not be synced going forward.

"Does ServCraft sync historical invoices when we first set up the integration?"​

No. Only invoices created or updated after the integration is activated will be synced. Historical invoices remain in your accounting system as-is.