AddThisFeature

QuickBooks Invoice Creation

Turn app transactions into QuickBooks invoices with the right customer, items, and tax.

involved Payments & Finance

What it adds

Server-side creation of an invoice in the connected accounting company from an app transaction, with the external reference stored.

What your agent is told to do

5
  1. 1

    Resolve the customer before building the invoice: look up the stored external reference first, then attempt a deliberate match, and create a new customer only when neither finds anything.

  2. 2

    Require an explicit mapping from each app product or charge to an income item and a tax code in the connected company. Do not guess a default account, because the wrong account is an accounting error someone has to unwind by hand later.

  3. 3

    Compute totals as exact decimals under one defined rounding rule, and reconcile the app's total against the total the provider returns before marking the transaction synced.

  4. 4

    Store the returned invoice identifier and its version against the app transaction and use them for every later read or update. Xero Invoice Sync solves the same problem for a different ledger, so keep customer matching, queueing, and reconciliation in one shared path and vary only the provider adapter.

  5. 5

    Run the whole exchange server-side under the workspace's stored credentials, refreshing an expired token before the call and prompting for re-authorization when the refresh fails. Never place accounting credentials anywhere the browser can read them.

Edge cases it handles

8
  • Two app records for the same real customer must not produce two ledger customers. Match deliberately, and when the match is ambiguous surface it rather than creating a second entry an accountant has to merge.
  • An item or tax code made inactive in the accounting system is rejected on use. Validate the saved mapping against the company's current lists before sending, and name the stale mapping to the operator.
  • Rounding differences of one cent per line become real discrepancies at volume. Apply rounding at one defined point and refuse to post an invoice whose total does not match the app's.
  • The provider rejects an update that carries an outdated version of the object. Re-read the invoice, reapply the change, and retry once rather than forcing the write through.
  • A closed accounting period refuses a posting outright. Report that to the operator as a period problem with a suggested date, not as a generic sync failure.
  • Without the stored invoice reference, a retried job creates a second invoice for the same transaction. Write the reference in the same transaction that marks the app record as sent.
  • Payments, credits, and voids applied inside the accounting system must flow back to the app, or the app will keep showing an invoice as outstanding long after it was paid.
  • When the provider is unavailable the app transaction must still complete. Queue the invoice, show it as pending, and never block a customer-facing action on an accounting write.

Definition of done

9
  • Each app transaction produces exactly one invoice, even when the creation job is retried.
  • Customers are matched before creation, and ambiguous matches are surfaced rather than duplicated.
  • Every synced product or charge has an explicit income item and tax code mapping, validated against the company's current lists.
  • Invoice totals reconcile exactly with the app's totals, with rounding applied at one defined point.
  • Version conflicts and closed-period rejections produce specific, actionable operator messages.
  • Credentials refresh server-side and are never exposed to the browser.
  • A provider outage leaves invoices queued and visible as pending without failing the originating transaction.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.