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

# Overview

# E-Invoicing SPI Integration

Chargebee streamlines e-invoicing compliance across regions by supporting the following operations throughout the billing lifecycle:

### 1) Retrieve E-invoicing Activations

* Retrieves the list of country and network activations configured in the connected e-invoicing provider platform.
* Each activation corresponds to a specific country and e-invoicing network offered by the provider.
* Chargebee uses this operation during provider enablement to determine which activations can be offered to merchants.

<img src="https://mintcdn.com/cb/t_llHYxnCXjWsl_M/api-reference/einvoicing-spi/docs/images/get_activations.png?fit=max&auto=format&n=t_llHYxnCXjWsl_M&q=85&s=5ea2638aa640a9cadd804cf2fbb03e6b" alt="Activation_workflow" width="1504" height="626" data-path="api-reference/einvoicing-spi/docs/images/get_activations.png" />

### 2) Document Submission

* Submits invoices and credit notes to external e-invoicing systems for validation, compliance processing, and delivery to tax authorities or trading partners.

<img src="https://mintcdn.com/cb/t_llHYxnCXjWsl_M/api-reference/einvoicing-spi/docs/images/submit_einvoicing_document.png?fit=max&auto=format&n=t_llHYxnCXjWsl_M&q=85&s=048821666cb5a0be52446cb7a243aaa7" alt="Document_submission_workflow" width="1554" height="742" data-path="api-reference/einvoicing-spi/docs/images/submit_einvoicing_document.png" />

### 3) Status Tracking

* Supports asynchronous document lifecycle tracking through webhook notifications sent by the e-invoicing adapter. These updates reflect real-time status changes as documents move through validation, compliance, and regulatory delivery stages.
  <img src="https://mintcdn.com/cb/t_llHYxnCXjWsl_M/api-reference/einvoicing-spi/docs/images/get_document_status_via_webhook.png?fit=max&auto=format&n=t_llHYxnCXjWsl_M&q=85&s=43240d9731c1ea3a00e90e7dc808560f" alt="webhook_workflow" width="1860" height="864" data-path="api-reference/einvoicing-spi/docs/images/get_document_status_via_webhook.png" />

* Allows on-demand status checks to retrieve the latest processing state of submitted documents, ensuring continued visibility even if webhook delivery is delayed or disrupted.
  <img src="https://mintcdn.com/cb/t_llHYxnCXjWsl_M/api-reference/einvoicing-spi/docs/images/poll_document_status.png?fit=max&auto=format&n=t_llHYxnCXjWsl_M&q=85&s=bfcd28fc5ea13ae01e296e118729f988" alt="poll_document_workflow" width="1516" height="754" data-path="api-reference/einvoicing-spi/docs/images/poll_document_status.png" />

### 4) Final Document Retrieval

* Retrieves finalized, regulator-approved documents for archiving, auditing, or customer use.
  <img src="https://mintcdn.com/cb/t_llHYxnCXjWsl_M/api-reference/einvoicing-spi/docs/images/download_document.png?fit=max&auto=format&n=t_llHYxnCXjWsl_M&q=85&s=fc1f5d0245f9f43b07057c1d0a624654" alt="download_document_workflow" width="1552" height="840" data-path="api-reference/einvoicing-spi/docs/images/download_document.png" />

Chargebee leverages external e-invoicing services to execute these operations effectively. These services are certified vendors offering APIs to manage e-invoicing compliance and document exchange with tax authorities.

***

## The Role of the E-invoicing Adapter App

To communicate with external e-invoicing systems, Chargebee uses an **E-invoicing Adapter App** — a secure and standardized bridge between Chargebee and the e-invoicing system.

This integration is governed by the **E-invoicing Service Provider Interface (SPI)**.

***

## Building an E-invoicing Adapter App

To integrate your e-invoicing system with Chargebee, you must implement the E-invoicing SPI.(You can refer to the spec file for this SPI [here](https://github.com/chargebee/cb-partner-spi/blob/einvoicing_spi_phase2/spec/spi/openapi_einvoicing.yml)). You’ll need to build an adapter app in the following cases:

### As an E-invoicing Provider

Connect your compliance platform to Chargebee so that merchants can automatically submit billing documents in a regulator-approved format.

### As a System Integrator

Build a connector that bridges a third-party e-invoicing provider with Chargebee, enabling seamless integration for merchants.

By implementing the E-invoicing SPI, you enable Chargebee to support **global regulatory compliance** through a **scalable and region-agnostic architecture**.

## JSON Schema for Einvoicing Provider

Below is the Chargebee E-invoicing [JSON Schema](https://json-schema.org/docs). Use this schema to ensure that your E-invoicing data is structured

[View Full E-invoicing provider JSON Schema](https://github.com/chargebee/cb-partner-spi/blob/einvoicing_spi/spec/capabilities/einvoicing-provider.schema.json)