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: [email protected] · 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.