Skip to main content
Each month, Spirii issues a self-billing invoice covering the charging revenue it collected on your behalf during the billing period. Alongside it comes a specification file listing every CDR, included and excluded alike, so you can verify the payout in full.

​
What a self-billing invoice is

A self-billing invoice is created by Spirii on your behalf. Instead of you invoicing Spirii for the sessions it collected on, Spirii tracks the consumption, calculates the revenue, generates the invoice, and processes the payout from validated session data. The invoice is legally equivalent to one you would send yourself, so you do not need to issue a separate invoice to Spirii. Each supplier receives one document per country and currency, and the invoice carries a single consolidated line for total consumption in that period and currency — a deliberate simplification that keeps it 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. A session that completes late in a period, or arrives late because a charger was offline, lands in the earliest billing period still open. App, terminal, and charge key revenue pays out the following month. Roaming is the exception: it pays in the same month Spirii invoices the roaming partner, so a given month’s income can reach you in two parts.

​
The specification file

Alongside the invoice PDF comes a specification file containing all CDRs for the billing period. It covers both included and excluded sessions, so you can see what was counted and what was not. Key columns: Filtering on isIncluded = true also gives you a basis for revenue reports by location, country, city, or customer.

​
Reconciling the invoice

To verify that the self-billing invoice matches the specification file:
1

Open the specification file

Filter the rows where isIncluded = true.
2

Sum the priceExVat column

Add up priceExVat across those rows.
3

Compare against the invoice

The total should match the invoice amount. The line total carries no VAT, because these invoices use reverse charge, where the recipient rather than the supplier accounts for the VAT.
4

Cross-check against Connect

Export CDRs from Spirii Connect for the same billing period and compare session counts and total kWh. Small differences are normal where sessions ended just after the period closed and were held for the next cycle.
For questions about specific entries in the specification file, contact finance@spirii.com.

​
Exclusion reasons

The excludedReason 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, but the fees are not deducted line by line on the self-billing invoice. They arrive on a separate platform invoice. Neither document is the full financial picture for the period on its own; you need both.

Billing and payout flows

Who collects, who invoices, and who pays out across every channel.

Revenue sharing

How payouts are distributed when site owners or subsidiaries are involved.

Sessions and CDRs

The session and CDR records the specification file is built from.

Billing automation

How CDRs are processed into invoices and payouts.