> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spirii.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Roaming settlement

> How Spirii handles invoicing and payment between networks when drivers charge across operators.

Roaming generates revenue when drivers from other networks use your chargers, and creates costs when your drivers use other networks. Spirii acts as the financial intermediary for both: invoicing roaming partners for inbound sessions, and receiving and reconciling invoices from partners for outbound sessions. You set the price; Spirii handles the billing.

## Two directions of roaming

<CardGroup cols={2}>
  <Card title="Inbound roaming (CPO)" icon="plug">
    A driver from another network charges on your station. You earn revenue. Spirii invoices the driver's eMSP or roaming hub and pays you.
  </Card>

  <Card title="Outbound roaming (eMSP)" icon="truck">
    Your driver charges on another network's station. You owe that network. Spirii receives their invoice and bills you on a consolidated basis.
  </Card>
</CardGroup>

## Inbound roaming: getting paid

When a driver from an external network charges at one of your stations:

1. The session is authenticated via a roaming hub or direct connection.
2. The CDR is generated and shared back to the driver's eMSP over the same protocol.
3. Spirii invoices the roaming partner for the session based on the **roaming tariff** you set for that location in Spirii Connect.
4. Spirii collects the funds from the roaming partner.
5. Spirii pays you the session revenue via self-billing invoice.

You enter the roaming tariff gross in Spirii Connect, but the net amount is what you receive per session. It does not include the platform transaction fee that Spirii charges you separately.

<Note>
  A CPO can also set up P2P agreements to handle settlement with roaming eMSPs. Reach out to your account manager to learn more.
</Note>

## Outbound roaming: consolidated billing

When your driver charges on an external network using a Spirii-issued token:

1. The external network sends Spirii an invoice for the session, based on their pre-agreed rate with Spirii.
2. Spirii invoices you for the session using the tariff configured by Spirii — this is the price your driver (or their fleet company) pays.
3. You receive one consolidated invoice from Spirii covering all outbound roaming usage by your drivers, instead of separate invoices from each external network.

## Roaming networks

Spirii connects to the roaming ecosystem through:

| Connection type       | Examples                                           |
| --------------------- | -------------------------------------------------- |
| **Roaming hubs**      | Hubject, Gireve, e-clearing.net                    |
| **Direct connection** | Bilateral OCPI connections with specific operators |

Your chargers and tokens are reachable across all of Spirii's connected networks without any additional setup beyond enabling roaming on your locations and tokens.

## Related

<CardGroup cols={2}>
  <Card title="Roaming connection" icon="globe" href="/capabilities/roaming/roaming-connection">
    Publish chargers and connect tokens across roaming networks.
  </Card>

  <Card title="Sessions and CDRs" icon="receipt" href="/components/charging/sessions-and-cdrs">
    The records that drive roaming invoicing and settlement.
  </Card>
</CardGroup>