Back to Templates

Manage invoices and contacts via chat with the Fakturoid AI agent

Created by

Created by: Václav Čikl || venca
Václav Čikl

Last update

Last update 3 days ago

Categories

Share

Overview

Fakturoid AI Agent is an AI-powered invoicing assistant for Czech freelancers and small businesses. It connects to Fakturoid — the most popular Czech invoicing platform — and lets you manage invoices and contacts through natural conversation. No switching tabs, no filling forms. Just chat in Czech and the agent handles the rest.

The agent understands context across the conversation. Tell it to create an invoice for a client you just looked up and it won't ask for their ID again — it already has it.

Key Features

  • Full invoice lifecycle: Create, search, update, delete, and mark invoices as paid
  • Contact management: Search, create, update and delete Fakturoid contacts
  • ARES integration: Auto-fill company details from the Czech business registry by IČO or name
  • Conversation context: Agent remembers entities across the conversation — no repeated lookups
  • Confirmation flow: Always confirms before creating, deleting or marking as paid
  • Lean interaction: Infers item names, quantities and prices from natural input — no unnecessary questions
  • Modular architecture: 10 independent sub-workflows as tools, easy to extend or swap

Use Cases

  • Create invoices by describing what you did: "Faktura pro Alzu za 3h konzultace po 2500 Kč"
  • Look up unpaid invoices for a specific client
  • Update due dates or notes on existing invoices
  • Register new clients directly from ARES with one confirmation
  • Mark invoices as paid after receiving payment
  • Delete draft or duplicate invoices

Perfect For

  • Czech freelancers managing invoicing without an accountant
  • Small businesses looking to reduce time spent in Fakturoid UI
  • Developers building invoicing bots for Czech clients
  • Anyone already using Fakturoid who wants a conversational interface

What You'll Need

Tools - subflows

Required Credentials

  • Fakturoid API token — found in Fakturoid Settings → API
  • Fakturoid account slug — the subdomain part of your Fakturoid URL (e.g. yourname from app.fakturoid.cz/yourname)
  • LLM API key — OpenAI, Anthropic, or any provider supported by n8n AI Agent node

Requirements

  • Active Fakturoid account (any plan)
  • n8n instance with AI Agent node support

Technical Details

Architecture

  • 1 main agent workflow + 10 sub-workflows connected as tools
  • Each sub-workflow handles one Fakturoid API operation
  • Sub-workflows normalize API responses — only relevant fields are passed back to the agent
  • Response processing uses a consistent JS pattern across all tools

Tools

Tool Operation
ares_lookup Search Czech business registry
fakturoid_get_subject Search contacts
fakturoid_create_subject Create contact
fakturoid_update_subject Update contact
fakturoid_delete_subject Delete contact
fakturoid_get_invoice Search / list invoices
fakturoid_create_invoice Create invoice
fakturoid_update_invoice Update invoice
fakturoid_delete_invoice Delete invoice
fakturoid_invoice_payment Mark invoice as paid

Agent Behavior

  • System prompt written in English, agent communicates in Czech
  • Uses <thinking> blocks before write operations to verify correct entity IDs
  • Explicit rules to distinguish subject_id, invoice_id, and IČO — prevents cross-contamination
  • Confirmation required before: invoice creation, deletion, marking as paid

API

  • Fakturoid API v3
  • ARES API (Czech business registry, no key required)

Template Author

Questions or need help with setup?
📧 Email: xciklv@gmail.com
💼 LinkedIn:
https://www.linkedin.com/in/vaclavcikl/