flowaccount

Official Panya Technologies n8n node for FlowAccount (Thai accounting SaaS) — full coverage: quotations, billing notes, tax/cash invoices, receipts, credit/debit notes, purchase orders, purchases, expenses, withholding tax, journal entries, contacts, prod

Documentation

n8n-nodes-flowaccount

The official Panya Technologies n8n community node for FlowAccount — Thailand's leading accounting SaaS. Full accounting coverage: quotations, billing notes, tax & cash invoices, receipts, credit/debit notes, purchase orders, purchases, expenses, withholding tax, journal entries, contacts, products, and document conversion — as workflow steps or as tools for an n8n AI Agent.

A Panya Technologies Co., Ltd. product (Bangkok, Thailand) · developed by AutoNinja · not affiliated with FlowAccount Co., Ltd.

Installation

Self-hosted n8n: Settings → Community Nodes → Install → n8n-nodes-flowaccount.

Licence key (required)

This node requires a Panya licence key (PANYA-XXXX-XXXX-XXXX), issued with your Panya Technologies course. Enter it in the credential; the node activates against Panya's licence server (device-bound, seat-limited, revocable). Without a valid key the node will not connect to FlowAccount.

Get a key / support: admin@panyatechnologies.co.th · panyatechnologies.co.th

FlowAccount credentials

You also need FlowAccount Open API credentials (client ID + client secret) — your own:

  • Sandbox: request via FlowAccount developer support. Sandbox tenants expire after ~30 days.
  • Production: a paid FlowAccount package with Open API enabled.
Credential field Value
Panya License Key from your Panya course
Environment Sandbox (test) or Production
Client ID / Client Secret from FlowAccount
Scope flowaccount-api (default)

The node handles the OAuth2 client_credentials token exchange automatically (24h tokens, auto-refresh on 401) and strips invisible zero-width characters from pasted secrets (a common FlowAccount copy-paste failure).

Resources & operations

Every operation below is end-to-end tested against the live FlowAccount API before release.

Resource Operations
Quotation Get Many · Get · Create · Delete · Change Status
Billing Note Get Many · Get · Create · Delete · Change Status
Tax Invoice Get Many · Get · Create · Create With Payment · Delete · Change Status
Cash Invoice Get Many · Get · Create · Create With Payment · Delete · Change Status
Debit Note Get Many · Get · Create · Delete · Change Status
Credit Note Get Many · Get · Delete · Change Status (created via a source document)
Receipt Get Many · Get · Delete · Change Status · Get Business/Accounting Categories (created via Document Conversion)
Purchase Order Get Many · Get · Create · Delete · Change Status
Purchase (Receiving Inventory) Get Many · Get · Create · Create With Payment · Delete · Change Status
Expense Get Many · Get · Create · Create With Payment · Delete · Change Status · Get Categories
Withholding Tax Get Many · Get · Create · Update · Delete
Journal Entry Create Draft · Create Approved
Document Conversion Convert to Billing Note / Tax Invoice (± payment) / Receipt (± payment)
Contact Get Many · Get · Create · Update · Delete
Product / Product Master Get Many · Get · Create · Update · Delete
Chart of Accounts Get (read-only)
Company Get Info · Update Info
Bank Get Accounts · Get Cheque/CreditCard/PettyCash Channels · Create Bank Account
Settings Get Documents Remark

Create is inline — pass the contact fields inside the document body and FlowAccount auto-creates the customer/vendor; no separate contact call needed. Totals must be self-consistent (subTotal, vatAmount, grandTotal); the API does not recompute them. Each create returns recordId (the numeric id used by Get/Delete/Change Status) and documentSerial (the human reference, e.g. INV2026070007).

Document Conversion turns a source into a downstream document (quotation → tax invoice → receipt): set documentReference[].recordId to the source's recordId and referenceDocumentSerial to its serial. A source can be converted once.

Change Status / Delete follow FlowAccount's document-state rules — e.g. an approved document may need to be voided before it can be deleted; a product with stock cannot be deleted. These are FlowAccount business rules, surfaced as clear API errors.

Enum reference (avoid the common errors)

  • paymentMethod (odd-numbered!): 1=Cash · 3=Cheque · 5=Transfer · 7=CreditCard · 9=PushPay · 11=PettyCash · 13=Other. (2 is invalid.)
  • Document line item vatType: 3=VAT 7% · 5=exempt · 7=none. (Inline items may instead use vatRate: 7, 0, -1.)
  • Product sellVatType/buyVatType (VatTypes): 1=Include · 3=Exclude · 5=Zero · 7=None.
  • creditType: 1=Credit (with due date) · 3=Cash · 5=Credit (no due date).
  • contactType: 3=Client · 5=Vendor · 7=Both. contactGroup: 1=Individual · 3=Juristic.
  • Convert documentReference[].referenceDocumentType: 3=Quotation · 5=Billing Note · 7=Tax Invoice · 25=Receivable Invoice · 9=Receipt.
  • Journal documentType: 51=General · 53=Purchase · 55=Sales · 57=Payment · 59=Received voucher. bookOfAccounts[].debitCredit: 1=Debit · 3=Credit — total debits must equal total credits.

AI-agent tool

The node sets usableAsTool: true, so n8n AI Agents can call any operation (e.g. "create a tax invoice with payment for this customer"). On self-hosted n8n set N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true. Every operation carries a natural-language action and description so the agent picks the right one.

Notes & scope

  • The FlowAccount sandbox rate-limits bursts — space out high-volume runs.
  • Editing documents: master records (Contact, Product, Product Master, Withholding Tax, Company) support Update. Sales/purchase documents do not expose Update in this release (the gateway PUT rejects the document body); to correct a document, void it and create a new one.
  • Not in this release (documented, planned follow-up): receive-payment-on-an-existing-document, file attachments, email-a-document, share-link, batch import, payroll/employee, and Receivable Invoice (returns 500 on the current gateway). Create-With-Payment already covers recording a payment at document creation.

Compatibility

Built against n8n-workflow ≥ 1.82 (n8n 2.x, 2026). Declarative node style; every operation E2E-tested against the FlowAccount API before release.

License

Proprietary — see LICENSE.md. © 2026 AutoNinja FZ-LLC, published under exclusive licence by Panya Technologies Co., Ltd.

Discussion