What a self-billing invoice is
A self-billing invoice is created by Spirii on your behalf. Rather than you manually invoicing Spirii for sessions collected, Spirii automatically tracks consumption, calculates revenue, generates the invoice, and processes the payout based on validated data. The invoice is legally equivalent to an invoice you would send yourself. You do not need to issue a separate invoice to Spirii. Each supplier receives one document per country and currency. The invoice contains a single consolidated line representing total consumption for that period and currency — a deliberate simplification to keep the invoice clean and auditable.What the payout covers
Your payout covers revenue Spirii collected for sessions on your chargers during the billing period. Self-billing is based on when charging sessions end, not when they start. Sessions that complete late in a period — or that arrive late because a charger was offline — are included in the earliest available open billing period.The specification file
Alongside the invoice PDF, you receive a specification file containing all CDRs for the billing period. It covers both included and excluded sessions, so you have a complete picture of what was counted and what was not. Key columns:
You can use the specification file to generate revenue reports by location, country, city, or customer by filtering on
isIncluded = true.
Reconciling the invoice
To verify that the self-billing invoice amount matches the specification file:- Open the specification file
- Filter rows where
isIncluded = true - Sum the
priceExVatcolumn for those rows - The total should match the invoice amount (reverse charge VAT billing — VAT is not included in the line total)
Exclusion reasons
TheexcludedReason column explains why a CDR was not included in the payout. The possible values are:
Fees
The payout is net of Spirii’s platform and payment fees. Fees are not deducted line by line on the self-billing invoice — they appear on a separate platform invoice Spirii sends to you. The self-billing invoice and the platform invoice together reflect the full financial picture for the period.Related
Revenue sharing
How payouts are distributed when site owners or subsidiaries are involved.
Billing automation
How CDRs are processed into invoices and payouts.
Billing as a service
Let Spirii invoice your customers for recurring charging services.