Description

n8n-nodes-nokfi

This is an n8n community node for Nokfi: the AI for small-business documents and finance.

• Issue invoices in your name: gap-free numbering, VAT, IRPF withholding and equivalence surcharge computed by Nokfi, added to your books, with PDF, e-invoice (UBL 2.5, Facturae, Factur-X) and the VERI*FACTU record. Rectify, cancel, mark as paid or rejected, and download them.
• Extract invoices from PDFs, images or text and get the same JSON every time, with validation done by Nokfi, not by the AI: totals (base + VAT − withholding = total), Spanish NIF/CIF/NIE check digits, dates and usual VAT rates.
• Run financial analyses (sales, cash, stock, purchases, profit, two-period comparison, document folders) and get a structured report: summary, key figures, priorities and an action plan.
• Spanish tax tools without AI (no quota): validate NIF/NIE/CIF, VAT with the equivalence surcharge, IRPF withholding, Modelo 130 and the tax calendar.
• Nokfi Trigger: start a workflow when an analysis or a background job finishes, when your quota reaches 80 % or 100 %, or 7 days and 1 day before each tax deadline. Signed webhooks, registered automatically.
• Check your usage (plan, daily credits, credits used today and credit pack balance; 1 credit = 1 AI analysis or invoice reading).

Data is processed by AI providers that do not train on it. Invoices sent through the API are not stored.

Installation · Credentials · Operations · Examples · Resources

Installation

Follow the installation guide in the n8n community nodes documentation and install n8n-nodes-nokfi.

Credentials

1. Sign in to Nokfi and open Developers → Keys.
2. Create a key. Name it after the client or workflow: Nokfi shows the usage of each key separately.
– Live keys (nklive…, Pro and Max plans) work with your data and use your quota.
– Test keys (nktest…, every plan) validate input the same way and return realistic sample data, without using quota. Test mode is separate from live: a test key never sees your real analyses, customers, books or webhooks. Build and test with them, then switch.
3. In n8n, create a Nokfi API credential and paste the key. Leave the base URL as https://nokfi.app.

The credential test calls GET /api/v1/usage.

Operations

| Resource | Operation | What it does |
|—|—|—|
| Invoice | Issue | Issues an invoice: customer from your address book (ID), typed in (saved to the address book) or none (simplified invoice, up to 400 € VAT included); one or more lines; optional withholding, equivalence surcharge, exemption, dates, series and language. Returns the invoice with its number and totals. |
| Invoice | Rectify | Corrective invoice for the difference (lines usually with a negative quantity) and a reason. |
| Invoice | Cancel | Cancels an invoice issued by mistake: kept as cancelled, out of your books, with its VERI*FACTU cancellation record. |
| Invoice | Set Status | Rejected (with reason) or accepted again; paid (with date) or unpaid. |
| Invoice | Get / Get Many | An invoice with lines, events and VERI*FACTU record; or the list, with date, status and search filters. |
| Invoice | Download | PDF or e-invoice (UBL 2.5, Facturae 3.2.2, Factur-X, CII) into a binary field, ready to attach to an email. |
| Invoice | Extract | Reads up to 5 documents per request (PDF, JPG, PNG, WebP or text). Use * as the binary field to send every attachment of the item. Outputs one item per invoice (or one item with all of them). |
| Analysis | Create | Runs an analysis. For spreadsheets, “All Input Items as Rows” sends the whole input (e.g. a Google Sheets node) as one table. |
| Analysis | Get / Get Many | Reads reports you already have. |
| Analysis | Rename / Delete | Changes the title of a saved report, or deletes it with its action plan (the credit is not returned). With a test key they return “not found”. |
| Customer | Get Many / Create | Lists or searches your address book, or adds a customer (with a test key the list is empty and a new customer is only validated). |
| Job | Get | Status and result of a background job (Run in Background), kept 24 h. |
| Tax | Validate Tax ID | NIF, NIE or CIF check digit, entity type and EU VAT number. |
| Tax | Calculate VAT | VAT with or without VAT included, plus the equivalence surcharge. |
| Tax | Calculate Withholding | IRPF withholding (professional 15 %, new professional 7 %, rental 19 %…) and the invoice total. |
| Tax | Estimate Modelo 130 | From your year-to-date figures or from your Nokfi ledger. |
| Tax | Get Quarter Summary | VAT (303) and IRPF (130) of a quarter from your Nokfi ledger. |
| Tax | Get Fiscal Calendar | Upcoming deadlines (303, 130, 111, 115, 390…) with days left, one item each. |
| Usage | Get | Plan, daily quota and analyses used today. |

Issuing and managing invoices uses no AI and no quota; your issuer details (legal name, tax ID, address) are filled in once in the Nokfi app. Issued invoices are never edited: rectify or cancel them. With a test key, invoices are test documents (TEST- numbering) that never reach your books or the tax agency. Every Issue and Rectify request carries an Idempotency-Key (set your own, e.g. the order ID, in Additional Fields): for 30 days the same key returns the same invoice instead of issuing a new one; after that it can be used again.

Every invoice extraction and every analysis uses 1 analysis from your daily quota (the same quota as the web app); the tax tools use none. Maximum 30 requests per minute per key. Requests carry an Idempotency-Key, so n8n’s Retry On Fail never charges twice (keys last 24 h; errors are not stored, so a retry after an error really runs). Rate-limited responses (429) carry a Retry-After header.

Run in Background: Invoice › Extract and Analysis › Create can return a job right away (?async=true). Pair it with the Nokfi Trigger (Job Completed) or Job › Get to get the result.

Nokfi Trigger

Choose the events and activate the workflow: the trigger registers its webhook in Nokfi (you’ll see it in Developers → Webhooks) and deletes it when you deactivate the workflow. Every request is checked against the Nokfi-Signature HMAC; unsigned or old requests get a 401. Your n8n instance must be reachable on a public https URL. If Nokfi disabled the webhook after too many failed deliveries, or you changed the events, the trigger reactivates and updates it the next time the workflow is activated. Only Live Events is on by default; a webhook created with a test key only receives test events, so turn it off while you build with a test key.

| Event | When |
|—|—|
| Analysis Completed | A report finished (API or web app). Includes the report. |
| Job Completed / Job Failed | A background job finished. Includes the result or the error. |
| Quota Threshold | You reached 80 % or 100 % of today’s quota. |
| Fiscal Deadline | A tax deadline is 7 days or 1 day away (according to your legal form). |
| Invoice Issued / Cancelled / Paid / Unpaid / Rejected / Rejection Undone | Something happened to an invoice (from the API, the MCP or the web app). Includes a summary: id, number, totals, customer, status. |
| VERI*FACTU Record Accepted / Rejected | The Spanish tax agency answered an invoice record (with the error code when rejected). |

Invoice output

{
  "file_name": "invoice.pdf",
  "issuername": "Talleres Ruiz SL", "issuernif": "B12345674",
  "invoicenumber": "F-2026-017", "invoicedate": "2026-09-14",
  "base": 1000, "vatrate": 21, "vatamount": 210, "irpf_amount": 0, "total": 1210,
  "checks": { "totalsok": true, "nifvalid": true, "recipientnifvalid": null, "datevalid": true, "vatrate_valid": true },
  "warnings": []
}

Documents that cannot be read come out as items with isinvoice: false and an error code (pdfscanned, unsupportedtype, filetoo_large…). Scanned PDFs must be sent as images.

Examples

• Invoices from email to a spreadsheet: Gmail Trigger (download attachments) → Nokfi (Invoice › Extract, binary field *) → IF checks.totals_ok → Google Sheets (append row).
• Weekly sales report: Schedule Trigger → Google Sheets (read) → Nokfi (Analysis › Create, Sales, All Input Items as Rows) → Send Email with {{ $json.report.summary }}.
• Tax deadline reminder to Slack: Nokfi Trigger (Fiscal Deadline) → Slack with {{ $json.data.models.join(', ') }} due on {{ $json.data.date }}.
• Background invoice batch: Nokfi (Invoice › Extract, Run in Background) in one workflow, Nokfi Trigger (Job Completed) → Google Sheets in another.
• Invoice every paid order: Shopify/WooCommerce Trigger (order paid) → Nokfi (Invoice › Issue, Idempotency Key {{ $json.id }}) → Nokfi (Invoice › Download, PDF) → Gmail (send with the attachment).
• Chase rejected invoices: Nokfi Trigger (Invoice Rejected) → Slack with {{ $json.data.number }}: {{ $json.data.reason }}.
• AI Agent tool: the node can be used as a tool by n8n’s AI Agent.

Resources

• Nokfi API documentation
• OpenAPI specification
• n8n community nodes documentation

Source and publishing

The source of truth for this node is the Nokfi repository, folder integrations/n8n/:
every change is made and reviewed there first, together with the API change it needs.
The n8n-nodes-nokfi repository is the
copy that gets published (n8n requires publishing from GitHub Actions with npm provenance).
To sync it, copy everything from integrations/n8n/ into that repository except
node_modules/, dist/, .git/, .github/, .gitignore and .prettierrc.js (those only
exist there), run npm run lint and npm run build, and commit. Pushing a vX.Y.Z tag
there publishes that version to npm. Never edit the published copy directly.

Compatibility

Built with @n8n/node-cli and tested with n8n 1.x. No runtime dependencies.

License

MIT