Numbers Game

NumbersGame for Square

NumbersGame connects a client's Square account (point of sale, invoices and subscriptions) to their books in QuickBooks Online or Xero, and lets you work it from Claude. Accounting firms use it to:

How the books see Square

Square is the subledger. Individual orders, payments and customers stay in Square; they are never copied one by one into QuickBooks or Xero. The books get period totals through accounts of their own:

Sales are split into revenue buckets: a few income lines such as drinks, food and merchandise, set per Square category, with an item rule only for an exception. Each location (shop) can book to its own class and sales tax account.

A Square invoice is booked only when it is paid, through the period summary. An unpaid one stays in Square.

Prerequisites

In Square

In NumbersGame

In Claude

Set it up

  1. Connect Square. Open the client's company in NumbersGame and go to its Square accounts section. Click Connect Square. Square opens; the account holder approves NumbersGame, and you return to the same section, which shows the account or explains why not.
  2. Assess the account. Ask Claude "Assess the Square account for Acme." It looks at the locations, the catalog categories with 30 days of sales, the payout banks and the ledger accounts still to map, and lists the next steps. It writes nothing.
  3. Set up the accounts. Agree with Claude, or on the company page under Set up accounts, which ledger account each Square line books to: Square Clearing, cash clearing, sales, refunds, sales tax payable, tips payable, gift card liability, Square fees, chargebacks, reserve, adjustments and, if the client has one, the Square Capital loan and its fee. Claude uses accounts already in the chart, and creates only what is missing after you agree. Choose the cadence (monthly or daily), the time zone and the cutoff: the first day NumbersGame books.
  4. Agree the revenue buckets. Under Revenue buckets on the company page, or with Claude, map each Square category (plus custom amounts and named service charges) to an income account and, if you like, a class.
  5. Refresh the connector in Claude if it says it has no Square tools: refresh the connector's tool list and start a new conversation.

Every month

  1. Propose the summary. "Build the Square sales journal for Acme for September." Claude drafts one journal per location for an ended period and lists anything it holds back (sales no rule covers, other currencies, orders that don't balance). Nothing posts until you approve.
  2. Book it. On your OK Claude posts exactly the journal you were shown. If Square changed since (a late refund), nothing posts and you see the new version. The first period booked needs a word on what happened before the cutoff, because Square's own sync or a person may already have posted those sales.
  3. Book the payouts. "Book Acme's paid Square payouts." Each payout moves from Square Clearing to the bank (on the bank-feed line when there is one), with its fees, Capital repayments and reserves as one journal. A payout waits, booking nothing, when its bank-feed line hasn't arrived or something it needs isn't set up.
  4. Tie out. "Tie out Square for Acme." Every payout since the cutoff (does it add up, is it booked), payouts still unbooked, and the Square Clearing and cash clearing balances. Differences are shown, never posted away.

Everyday Square tasks from Claude

Ask Claude. Anything that changes Square is shown to you first and happens only when you confirm.

TaskAsk Claude
Who owes what on Square invoices"Square AR aging for Acme."
Find an invoice or a customer"Which Square invoices for Acme are unpaid?"
Look up what was sold"What did Acme's Main Street shop sell on Saturday?"
Create a customer or an invoice"Create a Square invoice for Jane Doe for the catering order." Created as a draft: you review it and publish it in Square
Cancel an unpaid invoice"Cancel Square invoice 0042." Square tells the customer
Cancel a subscription"Cancel Jane Doe's subscription." Square ends it at the end of the current period. Starting a subscription or changing its plan is done in Square

What to ask Claude

Permissions and data

NumbersGame asks Square to read the business profile, payments, orders, payouts, catalog items, bank accounts, gift cards, disputes, cash drawers, customers, invoices and subscriptions. To act when you ask, it can also write customers, invoices (create or cancel) and subscriptions (cancel only; Square does not let our app create a subscription or change its plan). Every change is previewed and needs your confirmation. A firm viewer, and any company set read-only in NumbersGame, can never change anything.

NumbersGame stores the connection (the Square account, its business name, the permissions granted and the encrypted access tokens), the setup and revenue buckets you chose, and a record of each period and payout it booked, so nothing is booked twice. Square customers, orders and payments are read when you ask and passed to Claude. Details are in the privacy policy.

Disconnecting

Troubleshooting

FAQ

Does NumbersGame copy Square orders into QuickBooks or Xero? No. The books get one summary journal per location per period; the detail stays in Square.

Can Claude change things in Square? Yes, when you ask: it creates customers and draft invoices, and cancels invoices and subscriptions. Each is shown first and happens only when you confirm. Publishing an invoice, starting a subscription or changing its plan, and anything that charges a card are done in Square. Viewers and read-only companies cannot.

Can I use it next to Square's own QuickBooks or Xero sync? Not for the same sales. If Square's sync already posts them, the connector would book them a second time. Use one or the other, and set the cutoff to the first day the connector books.

Can one Square account book into two companies? No, one at a time.

Which currencies? The company's home currency. Orders in other currencies are listed as held, not booked.

Support: support@numbersgame.xyz · Security: security policy