Falco API Overview

⚠️

PRODUCTION MODE WILL BE AVAILABLE VERY SOON.

FOR NOW, PLEASE USE SANDBOX MODE.

🚀 Overview

The Falco API lets you integrate e-invoicing and Peppol delivery capabilities directly into your own application. It’s designed for developers who want to automate invoice creation, delivery, and status tracking within their ecosystem.

⚙️ Typical use cases

🧾 1. Generate and send invoices via Peppol

Falco supports multiple ways to send invoices on the Peppol network, depending on how you generate your invoices.

⏳ COMING SOON : Create and send invoices directly from Falco

Falco includes a complete invoicing module that lets you create invoices compliant with the UBL standard required by Peppol, and send them with a single API call.

👉 Learn more: Sending documents via Peppol (FAQ)

✅ Upload and send existing PDF invoices

If you already use another invoicing software and simply need a service provider to send your invoices through Peppol, Falco allows you to do so.

You can:

• Upload your sales invoices in PDF format
• Provide all required metadata in the API request (customer details, invoice lines, totals, tax information, etc.)

Falco will then generate a valid UBL file from the provided data and send it automatically on the Peppol network.

⚠️

Falco does not extract data from the PDF — all mandatory fields must be provided in the request.

✅ Upload and send existing UBL invoices

If your software already generates invoices in UBL format, you can upload and send them directly through Falco on the Peppol network.

Each UBL file is:

• Validated before delivery
• Rejected if it contains validation errors (which must be corrected before sending)

📡 2. Track delivery status

Retrieve the Peppol delivery status of any invoice — Pending, Accepted, Rejected, or Failed — using a simple API call.

🔄 3. Synchronize your data

Keep your customers, items, and invoices synchronized between Falco and your ERP, accounting system, or SaaS platform.

💡 4. Embed Falco billing capabilities

Integrate Falco’s electronic invoicing and Peppol delivery features directly inside your own product or platform.

🌐 Developer platform

Before using the API, you need a developer account at: 👉 https://dev.falco-app.be

From this portal you can:

• Create your Applications
• Manage App Secrets and API Keys
• Access your sandbox environment and view logs

📚 Glossary

💬 Need help?

If you have any questions about the Falco API, authentication, or integration best practices,
feel free to reach out to our developer support team at [email protected].
We’re always happy to help you get your integration up and running smoothly.