Skip to main content
The Fatorly Integration API lets your own systems — an ERP, a billing platform, or a custom back office — create and submit e-invoices on the Peppol network programmatically. It complements the web app: anything you do in the invoice editor, you can also do over the API, so you can automate high-volume or back-office workflows while still using the platform’s UI for ad-hoc work.

​
Base URL

Fatorly runs two independent environments, each with its own base URL. Build and test against sandbox with test credentials, then switch the host to production when you go live — nothing else about your integration changes. API keys are environment-specific: a sandbox key works only against the sandbox host, and a production key only against production.

​
Versioning

The current version is v1, carried in the URL path (/v1). Pinning to a version keeps your integration stable as the platform evolves.
Documents you issue (tax invoices and credit notes) are created and submitted through the API. Documents you receive over Peppol (purchase invoices and credit notes) are available read-only: pull them from the Access Point inbox with POST /purchase-invoices/pull and read them with the /purchase-invoices and /purchase-credit-notes endpoints — they cannot be created or edited through the API.

​
What you can do

  • Create tax invoices and credit notes as drafts with POST /invoices and POST /credit-notes, and edit a draft (or a failed document) with PUT /invoices/{id}.
  • Validate before you submit with POST /invoices/{id}/validate — the same PINT-AE checks the Peppol network runs, returned as actionable issues, with nothing persisted.
  • Submit for Peppol delivery with POST /invoices/{id}/submit, and track documents whose delivery failed with GET /invoices/failed — each item includes the failure reason in submissionError.
  • Receive purchase documents: POST /purchase-invoices/pull fetches everything waiting in your Peppol Access Point inbox, then read the results with GET /purchase-invoices and GET /purchase-credit-notes — full detail including lines and totals, so your ERP can book a purchase without parsing UBL. This surface is read-only: received documents can never be created or edited through the API.
  • Manage the master data you invoice against — customers and items.
  • Look up Peppol network participants.
Every write is protected by an Idempotency-Key header so retries never create duplicates — see Idempotency.

​
Guide map

Authentication

Create an API key and send it in the X-Api-Key header.

Quickstart

Go from a key to your first submitted invoice end to end.

Idempotency

Make every write safe to retry with Idempotency-Key.

Errors

The error model and the common status codes you’ll see.
For the full, interactive endpoint catalogue with live “Try it” calls, open the API Reference.

​
Start here

  1. Authentication — get a key.
  2. Quickstart — create and submit an invoice.