GoSmoko and Xero

Send finished invoices straight to your ledger

Connect the Xero organisation your accountant already works in. When you mark an invoice as sent in GoSmoko, it is created in Xero as an accounts-receivable invoice against the matching contact, with your GST rate and line items intact. Payments recorded in Xero flow back so GoSmoko knows what has been settled.

Connects via
OAuth 2.0
API
Xero Accounting API 2.0 (OAuth 2.0)
Regions
New Zealand, Australia, United Kingdom, Global
A laptop and notepad on a wooden desk
Photo: 2H Media / Unsplash

Supported today

What the Xero integration does

Every capability below is built and running. Nothing on this list is a plan.

GoSmoko → provider

Invoices to Xero

Sent invoices are created in Xero as ACCREC invoices with line items, GST, due date, and reference back to the GoSmoko job.

GoSmoko → provider

Customers as contacts

Customers are matched to Xero contacts by name and email, and created when no match exists. No duplicate contacts.

Provider → GoSmoko

Payment reconciliation

Payments applied in Xero are pulled back onto the GoSmoko invoice, so the status matches your ledger.

On the roadmap — not available yet

  • Quotes to Xero

    Accepted quotes can be pushed as Xero quotes for a full paper trail before the job starts.

  • Chart of accounts mapping

    Choose which revenue account labour and materials post against instead of using the Xero default.

Setup

Connecting Xero, step by step

  1. 1

    Tap Connect Xero

    You are handed to Xero's own sign-in screen. GoSmoko never sees your Xero password.

  2. 2

    Approve access

    Allow invoices and contacts. That is everything GoSmoko needs to put sent invoices in your ledger.

  3. 3

    Pick the organisation if asked

    If your login can reach several Xero organisations, choose the one for this trade business.

  4. 4

    Send an invoice

    The next invoice you mark as sent lands in Xero against the matching contact.

You will need

  • A Xero login that can administer the organisation — Adviser, or Standard with reports.
  • A Xero plan that includes the Accounting API. Paid plans do.

Limits worth knowing

  • One Xero organisation per GoSmoko business. Multi-entity groups need one GoSmoko business each.
  • GoSmoko is the source of truth for invoice content. Editing a synced invoice in Xero will not push changes back.
  • Attachments and photos are not copied to Xero.
  • A Xero organisation can only connect two uncertified apps. If Connect fails, disconnect an unused app in Xero first.
  • Xero Early plans cap approved sales invoices at 20 a month. That is Xero's plan, not GoSmoko.
Xero API documentation

Data flow

Exactly what moves, and which way

No surprises in your ledger. This is the complete list of what crosses the boundary between GoSmoko and your provider.

RecordDirectionFields
InvoiceGoSmoko → providerNumber, line items, quantities, unit prices, GST, due date, notes.
CustomerGoSmoko → providerName, email, phone, and street address. Matched before creating.
PaymentProvider → GoSmokoAmount and date applied in Xero.
Job & quoteGoSmoko → providerReferenced on the invoice so you can trace it back from Xero.

Ready to connect Xero?

Start the free trial and set it up from Settings → Integrations. It takes minutes, and you can disconnect at any time.