Billomat PHP SDKTyped access to the Billomat API

Invoices, offers, clients, payments, PDFs and webhooks for PHP 8.5, on top of any PSR-18 client.

Typed end to end

final readonly models, enums for every fixed value set, exact Money amounts instead of float. Unknown fields are kept in $extra.

Immutable options and typed filters

Named arguments, with*() withers, Clear::Field to empty a field, InvoiceFilter & co. with OrderBy and auto-pagination.

Any PSR-18 client

Symfony, Guzzle or whatever you use. Runtime dependencies are PSR interfaces only.

Resilient and observable

Retries for 429 and transient errors, classified exceptions, optional PSR-3 logging and PSR-14 events.

Webhooks

Parse incoming Billomat webhooks into the matching model, all 83 events included.

Unofficial

Independently developed and maintained; not affiliated with Billomat GmbH.

bash

composer require justpilot/billomat-php-api

php

$billomat = BillomatClient::create(billomatId: 'mycompany', apiKey: getenv('BILLOMAT_API_KEY'));

$invoice = $billomat->invoices->getOrFail(42);
echo $invoice->totalGross?->format(2, ',', '.');