SprigrBooks
SprigrBooks is small-business accounting that lives inside your Sprigr install rather than connecting to an outside system. It is a double-entry ledger with contacts, an items catalogue, quotes, sales and purchase orders, invoices and bills, payments and credit notes, manual journals, bank reconciliation, fixed assets, budgets, inventory, and the standard reports: profit and loss, balance sheet, trial balance, aged receivables and payables, GST summary and statements. Agents do the bookkeeping from chat, and a read-only web dashboard shows the books.
Prerequisites
Section titled “Prerequisites”- Admin or Owner role in your Sprigr Team organisation to install the app.
Installing and setting up
Section titled “Installing and setting up”-
Install the app
Sign in to team.sprigr.com, open Apps in the sidebar, find SprigrBooks under Available, and install it. No secrets are requested. See Installing Apps.
-
Set up the business
Ask your agent to set the business details, tax rates and financial year, and to review the default chart of accounts. Add tax rates such as GST and any accounts you need beyond the defaults.
-
Add contacts and items
Ask the agent to create your customers and suppliers, and an items catalogue of what you sell and buy, so invoices and bills can be built from names rather than typed line by line.
-
Open the dashboard
The app’s page from Apps > Installed shows month-to-date profit, receivables, recent documents, and tabs for Invoices, Bills, Quotes, Contacts and Reports, with PDF download and payment links on invoices.
How the books work
Section titled “How the books work”- Documents move through states. Quotes can be accepted and converted to invoices; orders convert to documents; invoices, bills and credit notes are drafts until authorised, after which they post to the ledger and can be voided but not edited. A period lock date stops changes to closed periods.
- Payments and credits. Payments are recorded against documents; credit notes are allocated to invoices or refunded.
- Bank reconciliation. Import bank lines, let the agent suggest matches, reconcile or create adjustments, and report on the reconciliation.
- Assets, budgets and inventory. Fixed assets with depreciation runs and disposals; budgets with budget-versus-actual reporting; optional inventory tracking with receipts, consumption, adjustments and valuation.
- Invoice delivery.
generate_invoice_documentrenders the client-facing PDF, attaches it and returns a download link. - Confirmation before destructive changes. Fifteen actions pause for your confirmation: voiding documents and credit notes, removing payments and credit allocations, refunds, deleting drafts, quotes, orders, budgets, bank lines and recurring templates, and archiving accounts, contacts and items.
Running alongside Xero
Section titled “Running alongside Xero”SprigrBooks and Xero are not either-or. You can keep raising invoices in SprigrBooks and have your accountant work in Xero: every sales invoice authorised in SprigrBooks while the sync is on, and its contact, is pushed one way to Xero. A schedule pushes queued invoices every 5 minutes, the contact first and then the invoice. Pushing the same invoice again finds the existing Xero record instead of creating a second one.
-
Install and connect Xero
Install the Xero app and connect a Xero login.
-
Name the sync connection in Xero
An owner or admin who has connected their own Xero login opens the Xero app’s Sync connection page and clicks Use my Xero connection. The page is not linked from the app’s dashboard: open the Xero app from Apps, then add
/settings/sync-connectionto the end of its address. Every push is written to that connection’s selected organisation. -
Allow SprigrBooks to write
In Sprigr Team, an owner or admin opens Apps, then SprigrBooks, then Configure (
/dashboard/apps/sprigr-books/configure). Under Connections, they switch Xero on for thesprigr-books/accounting_sinkinterface and allow write operations. -
Map accounts and tax rates, then switch it on
Ask the agent to map each SprigrBooks revenue account and tax rate your invoices use to its Xero account code and tax type, and to turn the ledger sync on (
update_ledger_sync). Invoices are created in Xero as drafts unless you ask for them to be created as authorised.
Only invoices authorised while the sync is on are pushed; one authorised while it is off is never queued, even after it is switched back on. Bills, payments, credit notes and voids are not pushed, and nothing comes back from Xero.
When an invoice is held. An invoice is held, not pushed, when one of its lines uses an account or tax rate with no Xero mapping (SprigrBooks never falls back to a default account), when Xero refuses it for a reason a person has to fix, such as no sync connection named, or when it has kept failing for 24 hours. Ask the agent to show the ledger sync (get_ledger_sync): it lists each held invoice with the reason. Adding a missing mapping retries held invoices; the agent can also retry them once the cause is fixed.
What agents can do
Section titled “What agents can do”The app exposes a single sprigr_books tool that takes an action, with 96 actions across settings, chart of accounts, tax rates, contacts, items, quotes, recurring templates, orders, invoices and bills, payments, credit notes, journals, bank reconciliation, fixed assets, budgets, inventory, invoice delivery, reports and the ledger sync to Xero. Amounts are handled to the cent. Ask the agent what it can do in SprigrBooks to see the full catalogue.
Common use cases
Section titled “Common use cases”- Invoicing from chat. Describe the work and the agent drafts, authorises and sends the invoice.
- Bill entry. Forward a supplier bill and the agent records it against the right account and tax rate.
- Month end. The agent reconciles the bank feed lines, runs depreciation and produces the P&L, balance sheet and GST summary.
- Recurring billing. Recurring templates generate the month’s invoices on schedule.
- Debtor chasing. A weekly workflow reads aged receivables and drafts reminders.
Troubleshooting
Section titled “Troubleshooting”A document cannot be edited Authorised invoices, bills and credit notes are posted to the ledger. Void and re-issue, or use a credit note.
Changes to an old period are refused The period lock date is set. Ask the agent to move it, or post in the open period.
Balance sheet reports out of balance The Reports tab flags this. It follows from manual journals or bank adjustments that do not balance; the agent can list recent journals to find the entry.
An action is waiting for confirmation Voids, refunds, deletes and archives pause until you confirm in the chat.
Next steps
Section titled “Next steps”- Xero: Push your authorised invoices to Xero, or work in Xero directly.
- Workflows: Schedule recurring invoices and debtor reminders.
- Integrations Overview: See all available integrations.