Faktoora API

Name: Faktoora API
Brand: Faktoora API
Availability: InStock

✓ Official Vendor SpecFinanceAccountingapiKey5 EndpointsREST

For Agents

Create, validate, and download XRechnung and ZUGFeRD electronic invoices. Useful for German B2G e-invoicing automation and compliance flows.

Install Jentic One Beta

Connect the Faktoora API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Faktoora API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Faktoora API.

Create an XRechnung or ZUGFeRD invoice from structured fields

List previously issued invoices on the workspace

Validate an invoice against XRechnung and ZUGFeRD format rules

Download a rendered invoice file in the chosen e-invoice format

GET STARTED

Start building with Faktoora API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Faktoora API for, with concrete tasks.

★ German B2G E-Invoicing

A business invoicing a German public-sector customer must deliver an XRechnung-compliant invoice. The agent creates the invoice via POST /invoices, calls /invoices/{id}/validate to confirm format compliance, and pulls the rendered file with /invoices/{id}/download. End-to-end the flow takes three calls and avoids any in-house XRechnung tooling.

POST the invoice payload to /invoices, call POST /invoices/{id}/validate to confirm compliance, and download the rendered XML via GET /invoices/{id}/download.

Validation Pre-Check Before Sending

Before an accounting system emails an invoice to a German government customer, it pre-validates the payload through Faktoora. The /invoices/{id}/validate endpoint surfaces XRechnung rule violations so the issuer can correct fields before the invoice leaves their system. Useful as a guard in monthly invoicing batch runs.

POST the candidate invoice to /invoices, call /invoices/{id}/validate, and surface any rule violations in the response back to the accounting system before delivery.

Invoice Download for Archival

After issuance, a finance system pulls the rendered invoice file and archives it for the statutory retention period. The flow uses GET /invoices to enumerate invoices, GET /invoices/{id} for metadata, and GET /invoices/{id}/download to fetch the file. Suited to nightly archival jobs that mirror invoices into a long-term store.

Call GET /invoices to list issued invoices for the day, then for each call GET /invoices/{id}/download and write the binary response to the archive store.

AI Agent Compliance Helper

An AI agent helping a small business comply with German e-invoicing rules uses Jentic to discover Faktoora's five operations and walk through invoice creation, validation, and delivery. Jentic exposes the schemas with example payloads, so the agent can prompt the user for the missing fields and submit a valid invoice without reading the API docs.

Call jentic.search with 'create XRechnung invoice', load the /invoices and /invoices/{id}/validate operations, prompt the user for the missing required fields, and execute create-then-validate.

Key Endpoints

5 endpoints — faktoora is an e-invoicing platform focused on the german xrechnung and zugferd electronic invoice formats.

METHOD

PATH

DESCRIPTION

GET

/invoices

List invoices on the workspace

POST

/invoices

Create an XRechnung or ZUGFeRD invoice

GET

/invoices/{id}

Fetch a single invoice by id

POST

/invoices/{id}/validate

Validate an invoice against format rules

GET

/invoices/{id}/download

Download the rendered invoice file

GET

/invoices

List invoices on the workspace

POST

/invoices

Create an XRechnung or ZUGFeRD invoice

GET

/invoices/{id}

Fetch a single invoice by id

POST

/invoices/{id}/validate

Validate an invoice against format rules

GET

/invoices/{id}/download

Download the rendered invoice file

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The X-API-Key header is stored encrypted in the Jentic vault and attached at execution time. Agents call Faktoora through scoped execution permissions and never see the raw key value.

Intent-based discovery

Agents search Jentic for 'create XRechnung invoice' or 'validate e-invoice' and Jentic returns the matching Faktoora operations with their input schemas, so the agent can chain create-validate-download without browsing developer docs.

Time to first call

Direct integration: 1-2 days to wire create, validate, download, and error handling. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Faktoora API through Jentic.

What authentication does the Faktoora API use?

Faktoora uses an X-API-Key header on every request. Through Jentic the key is stored encrypted in the vault and attached to outgoing /invoices calls so the raw value never enters the agent's context.

Can I create an XRechnung invoice with the Faktoora API?

Yes. POST the invoice payload to /invoices and Faktoora returns the new invoice id. Follow up with /invoices/{id}/validate to confirm XRechnung compliance and /invoices/{id}/download to fetch the rendered XML file.

What are the rate limits for the Faktoora API?

Rate limits are not declared in the spec. Faktoora applies fair-use throttling on the production endpoint — keep the create, validate, and download chain sequential per invoice rather than pushing all three calls in parallel.

How do I validate an invoice through Jentic?

Run pip install jentic, call jentic.search with 'validate XRechnung invoice', load the /invoices/{id}/validate operation, and execute it with the invoice id returned from the create call. The X-API-Key is replayed from the vault.

Does Faktoora support ZUGFeRD as well as XRechnung?

Yes. The API description covers both XRechnung and ZUGFeRD formats. The format selection is part of the create-invoice payload, and the validate endpoint runs the format-specific rule set against the invoice.

Where can I download the rendered invoice file?

Call GET /invoices/{id}/download with the invoice id. The endpoint returns the rendered file in the chosen e-invoice format, suitable for archival or for sending to the recipient through a separate delivery channel.

Faktoora API

Connect the Faktoora API to your agent

Capabilities

Start building with Faktoora API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs