README

One contract for transmitting and receiving electronic invoices - whoever carries them: an e-mail, an approved platform (plateforme agréée) through the standard API of XP Z12-013, Chorus Pro for the public sector.

Published as omniscient/omnibill (formerly glitchr/omnibill, which this package replaces: a composer.json that still requires the old name keeps resolving to this package and never installs both). omniscient/ is the vendor of every family's core, the providers keep omnibill/, the namespace Omnibill\ and the GitHub repositories do not change.

$gateway = $registry->get('invoices');                       // or 'platform', 'public': the same calls

$flow = $gateway->submit($invoice);                          // a conformant file: Factur-X, UBL, CII
$flow->reference;                                            // keep it
$gateway->fetchStatus($flow)->status;                        // LifecycleStatus::DEPOSITED, APPROVED, PAID...

$inbox = $gateway->receive($cursor);                         // suppliers' invoices, statuses about yours
$gateway->setStatus(new StatusChange(LifecycleStatus::PAID), $flow);
$gateway->lookup('702042755');                               // where a company receives (the directory)

This package holds the contract (GatewayInterface, the requests Submit, FetchStatus, Receive, SetStatus, Lookup, Report, Notify, GatewayFactory, Registry), the models (Invoice, Party, Flow, LifecycleStatus, StatusChange, Inbox, Addressing, EReport, Notification, Capabilities) and a bridge for Symfony. It needs no framework: PHP and symfony/http-client-contracts. Each gateway is a package of its own:

Package	Carries	Approved platform
`omnibill/email`	the invoice attached to an e-mail to the buyer (symfony/mailer); statuses kept by hand. The default, and the tests'	no
`omnibill/afnor`	any approved platform through XP Z12-013: flows (invoices, lifecycle messages, e-reporting), webhooks, the directory	yes
`omnibill/chorus-pro`	Chorus Pro through PISTE: invoices to public entities, deposited and followed	the public sector's portal

What a gateway is, and is not

The format is not here. A gateway carries a file already conformant - a Factur-X, a UBL or CII invoice, a CDAR lifecycle message, an e-reporting file - that the application produced (horstoeko/zugferd writes Factur-X). It reads nothing inside an invoice; of a lifecycle message it reads the status, the invoice's number and the reason, to hand them over.

It is not invoicing software (the application issues the invoice), nor accounting, nor payment, nor a bank. It keeps no books: the application keeps the flows' references and their statuses.

What a gateway cannot do is a NotSupportedException, and supports() says so beforehand: an e-mail has no inbox nor directory, Chorus Pro gives a supplier no inbox.

The reform, and the e-mail gateway

In France every company subject to VAT must be able to receive electronic invoices through an approved platform since 1 September 2026; issuing is mandatory then for large and mid-sized companies, on 1 September 2027 for SMEs and micro-companies (impots.gouv.fr, read on 2026-10-05). Until then a small company may still send its invoices by e-mail: omnibill/email. On that date a site changes gateway in its configuration - factory: afnor - not its code.

Documentation

Plain PHP

composer require omniscient/omnibill omnibill/email

use Omnibill\Email\EmailGatewayFactory;
use Omnibill\Registry;

$registry = new Registry([new EmailGatewayFactory($mailer)], [
    'invoices' => ['factory' => 'email', 'options' => ['from' => 'Atelier <factures@example.org>']],
]);

No bundle, no container: a factory per gateway package, the registry built by hand. docs/installation.md opens on a whole script that runs as it is.

Symfony

Omnibill\Bridge\Symfony\OmnibillBundle does that wiring in a Symfony application (docs/symfony.md); its components are not required by this package.

omnibill:
    gateways:
        invoices: { factory: email, options: { from: 'Atelier <factures@example.org>' } }

Docker

cd docker && cp .env.dist .env
docker compose run --rm omnibill gateways
docker compose run --rm omnibill bare          # plain PHP: no bundle, no container, and what PHP loaded
docker compose run --rm omnibill test

Responsibility

omniscient/omnibill and its omnibill/* providers are independent, unofficial clients: none is affiliated with, endorsed by or sponsored by the services it reaches. Each service keeps its own terms (accounts and contracts, keys, the platforms' own rules, rate limits), named with a link in the "Responsibility" section of the README of each provider that reaches one. The MIT licence covers this code only and grants no right to any service or to its data.

Whoever installs and runs these packages is responsible for complying with those terms, for obtaining whatever they require, and for any use made of what they return. The authors publish them free of charge, make no commercial use of them, and accept no liability for how they are used (see LICENSE).

License: MIT since 2026-10-09; earlier versions remain published under LGPL-3.0-or-later.

omniscient / omnibill

Package info

Security

Statistics