Smileline
Settings

Accounting

Connect Xero or QuickBooks Online, post one balanced journal per location per day, and send your stock value and supplier bills to the books.

Smileline posts the practice's takings to its books as one balanced journal per location per business day. Nothing in the books is edited afterwards: a day whose ledger changes posts a reversal and a new revision, and a correction made later lands on the day it was made. Once you switch them on, Smileline also posts what your stock is worth each day and turns each delivery you receive into a supplier bill.

Connect the provider

Open Settings → Accounting and click Connect Xero or Connect QuickBooks. The button opens the selected provider's authorisation page. Sign in and approve access; you return to the same page with the connection marked Active. Complete authorisation within ten minutes; if the link expires, return to Settings → Accounting and click Connect again. Smileline keeps only the provider's refresh token and the company it covers, encrypted; the books are never read back into Smileline.

Only owners and managers connect, map and disconnect. Pause posting holds journals until Resume posting. Disconnect stops posting and moves the grant aside; a journal already claimed under the old grant parks instead of posting, and a fresh connection carries on from there.

Each provider needs its developer app configured on the Smileline platform. While a provider is not configured, its card reads Not configured and its connect button is disabled.

Once connected, the card shows the provider, the company it posts to, a coloured status (Active, Paused, Error …), Last posted and Books built through. A problem the connection hit is shown in red across the bottom of the card.

Map the accounts

The Account mappings section lists every place a ledger entry can land, with the provider's chart of accounts to choose from, in five groups.

Ledger accounts

  • Patient balances — the control account: charges debit it, payments credit it.
  • Other revenue (exempt) — charges with no procedure category, such as manual charges and membership fees.
  • VAT on standard-rated charges — the tax on a standard-rated charge.
  • Stamp duty recharged — the Italian imposta di bollo line an exempt invoice above €77.47 carries; a pass-through owed to the tax authority, mapped to its own account.
  • Deposits held — payments taken against a deposit request credit this instead of patient balances.
  • Refunds — optional; when unset a refund reduces patient balances.
  • Write-offs & adjustments — discounts, write-offs and their reversals.

Revenue by procedure category — one row per procedure category; a charge for a procedure in that category credits it net of tax.

Payment types — one row per payment type; a payment debits it.

Bank account per location — one row per location, for payments with no method mapping and insurance payments.

Stock and purchases — needed only for stock postings and supplier bills:

  • Inventory — the balance sheet account that holds what your stock is worth.
  • Change in inventory — where each daily stock posting lands, against inventory (usually a cost of sales account).
  • Purchases — the account supplier bills post to. The tax rate beside it goes on bill lines with no reclaimable tax.
  • Reclaimable tax on purchases — one provider tax code per tax rate on your deliveries, used when you reclaim VAT or sales tax. Type a rate in Rate (%), click Add a rate and pick its tax code; Remove drops one. A bill line taxed at a rate with no code waits until you add one, and the bill names the rate it needs.

Pick a tax rate beside a revenue account where the provider needs one. Click Save mappings. A journal whose day needs a mapping that is not set is not built; the page names what is missing.

Journals

Every morning Smileline builds the journal for every day it has not yet covered, from the day after the one shown as Books built through up to yesterday, for each location, and posts them on the next delivery tick. A day that cannot be built — its ledger needs a mapping that is not set — holds the line there: the connection names the waiting day, later days are not skipped, and the next morning tries again. Fix the mapping and click Build journal now for that day, or wait for the next tick.

A reversal never rewrites the day it corrects: it posts the opposite movement on its own date, to the accounts the original's journal used — a mapping changed in between does not move it (rebuild both days to move both). A charge or payment recorded after its day was already covered rides the next journal built, exactly once, however many builds run at the same time. A booking deposit credits Deposits held when it is taken and leaves it on the day it is applied to a charge; a refund of the deposit gives back what is still held and charges the part already applied to patient balances.

The Journals list holds every revision ever built, newest day first. It opens on the last 30 days: change From and To, or pick a Location when the practice has several, to read any part of the history, and click Load more to continue it. Each revision shows its latest state as a coloured label: Waiting (grey), Claimed or Sent (blue), Acked (green, with the provider's reference), Parked (amber) or Rejected (red), with the reason under the row. A parked journal retries on its own with a growing pause; nothing is dropped for age or count.

Click Attempts under a revision to see every delivery attempt, not just the last: its number and state, when it was sent or parked, the reason or error, and the provider's reference.

If the list can't be read, it says Couldn't load the journals. with Retry. A failed read never shows as an empty list; when a refresh fails, the revisions already shown stay, marked as possibly out of date.

Click Build journal now to build a day early or to rebuild a day whose ledger or mappings changed. A day already posted with the same figures through the same mappings is left alone; a changed day posts a reversal of the earlier revision and a new one. When a build makes a revision, the list turns to that day and opens the new revision.

A rejected journal opens a review task naming the reason. The task isn't assigned to anyone, so the revision shows Open the review task, which opens that task in To do whoever you are, over Team tasks, where it waits for whoever takes it on. Fix the mapping and rebuild the day. A journal rejected before this link existed keeps the revision in its task's note only.

Stock and purchases

Three switches under Stock and purchases decide what else reaches the books. Each saves as soon as you change it. A switch whose accounts are not mapped yet is refused, and the page names the accounts to map first.

  • Post the daily stock value — needs Inventory and Change in inventory mapped.
  • Send supplier bills from — pick the first day, then switch it on. Every delivery received on or after that day becomes a bill. Needs Purchases mapped, and with We reclaim VAT/sales tax on, a code under Reclaimable tax on purchases too (without it, bills post the gross with no tax and need no tax code). Change the date and click Save to move it; switch it off to stop new bills.
  • We reclaim VAT/sales tax — off by default, so stock is valued with tax included. Switched on, deliveries received from then on are valued net of tax and their bills carry the tax as reclaimable. Deliveries received before keep the value they were saved with.

Stock postings

Smileline values stock the periodic way: once a day, with the morning's journals, it posts one balanced journal that moves Inventory to the value of the stock Smileline holds, against Change in inventory. The amount is the change since the last posting your books accepted. Every item counts, archived ones included (archiving an item keeps its stock).

Before the first posting, Stock postings asks How much stock do your books already hold? Enter the figure from your balance sheet (0 if the books hold none) and click Save. The first posting moves Inventory from that figure to Smileline's value, shown as Stock value now. A new connection asks again.

Only one posting is in flight at a time. If the books refuse one, it shows Retry and Cancel: fix the cause (usually a mapping) and click Retry to send the same posting again, or Cancel to give it up. The next daily posting then covers the whole change, so nothing is lost. Click Attempts under a posting to see every delivery attempt.

If a send may have reached your books without an answer that says so — the provider took it but its answer could not be read, the connection dropped, the provider had an outage, or the send was interrupted — the posting shows Unconfirmed. It is tried again by itself, under the same key. If you find it in your books, click Mark as posted; the next posting moves on from it. If it is refused afterwards and you have checked that your books do not hold it, Cancel asks you to confirm that before it gives it up.

If you map Inventory to a different account, the next posting first moves the balance already posted from the old account to the new one.

Postings cover the sites of the connection's legal entity. The sites of another legal entity are listed as Not posted (another legal entity); a site moved to another entity takes its stock with it at the next posting.

Supplier bills

Each delivery you receive against a purchase order becomes one bill in the books, from the supplier, dated the day it was received and numbered with the supplier's invoice number when you entered one. Smileline finds the supplier among the books' contacts, or adds it.

Bills post to Purchases. With We reclaim VAT/sales tax off, each line goes in at its full price with no tax. With it on, each line goes in net with its tax, under the Reclaimable tax on purchases code for its rate; a line without tax takes the tax rate beside Purchases. Smileline sends the tax of each line as you received it — enter a line's Tax rate (%) when you receive the delivery and the tax is worked out for you.

Xero creates supplier bills as drafts. Purchases and the supplier balance stay unposted in Xero until you approve each bill there; stock postings go on regardless.

Supplier bills lists every bill, newest first; pick a Status to see only Open, Parked, Posted, Resolved or Discarded bills, and click Load more to continue the list. Each bill shows the supplier, purchase order, date, total, a coloured status and, while it waits, why in words. Click Details to inspect its lines, how the supplier was matched in the books, every version sent (What was sent) with each attempt's state, time, reason and provider reference, and the answers from Xero or QuickBooks: each with what it answered, its HTTP status and time. Click Show to read an answer exactly as it arrived; one kept only as a fingerprint says so.

A bill waiting on something it can fix on its own — the connection being paused, a mapping, the supplier being added — carries on once that is done. A bill that needs you parks:

  • Retry sends it again after you fix the cause, for example a refused bill after a mapping change, or a supplier whose name matched several contacts in the books after you merged them.
  • Resolve marks it handled by hand. Add a Note and, if you entered or found the bill in the books yourself, its Bill ID in the books, then click Mark as handled.
  • Discard drops it: add a Note, click Discard and confirm. Nothing is sent and the bill stays as the record.

A delivery at a site of another legal entity parks as a bill for that entity's books; enter it there by hand and resolve it.

The list stays after you disconnect, as long as there are bills: you can still inspect, retry, resolve or discard them, but Send earlier receipts needs a connection.

Send earlier receipts

Deliveries received before the day in Send supplier bills from are not billed automatically. To bill them, pick a From day under Supplier bills and click Send earlier receipts: every delivery from that day up to the day before Send supplier bills from that has no bill becomes one, and the page says how many were created. A delivery already billed is left alone, so it is safe to run twice. A discarded bill whose delivery came before that day can be sent again this way.

Xero connections made before supplier bills

Bills need permissions an older Xero connection does not have. While Send supplier bills from is on, the connection card says supplier bills are waiting with Reconnect Xero: reconnect to the same company and the waiting bills go. Journals and stock postings keep posting meanwhile.

Connecting a different company

Connecting a different Xero or QuickBooks company starts a new connection: map its accounts, switch on what you need and answer the opening stock question again. The old connection's unfinished bills and postings stay with it and are never sent to the new company, and history already posted is not sent again.

What stays by hand

  • Settlement between legal entities — stock or purchases one entity pays for on another's behalf.
  • Shop supplier credits and refunds — credit notes and refunds from suppliers.

On this page