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

# Chargebee

> Import and process invoices and credit notes from Chargebee

<Tabs>
  <Tab title="Description">
    <Columns cols="2">
      <div class="flex flex-col grow items-center justify-center">
        <Card title="Chargebee Guide" icon="https://assets.invopop.com/apps/chargebee/icon.svg" href="/guides/chargebee" horizontal>
          View implementation guide ›
        </Card>
      </div>

      |           |                                |
      | --------- | ------------------------------ |
      | Developer | [Invopop](https://invopop.com) |
      | Category  | Integrations                   |
    </Columns>

    [Chargebee](https://www.chargebee.com/) is a subscription management and billing platform designed for businesses that rely on recurring revenue. It automates tasks like subscription billing, invoicing, payment processing, and revenue recognition.

    Invopop's Chargebee app lets you issue locally compliant electronic invoices and credit notes from Chargebee. The app subscribes to new incoming invoices and credit notes from Chargebee. When a new document is received, it'll be converted into GOBL and stored in your Invopop workspace. Once an invoice or credit note is stored, the app will create a job on the configured workflow.

    Any updates and, importantly, error messages will be posted to Chargebee automatically, in the comment section of the invoice or credit note. We also recommend configuring workflows to send notifications via Slack or email to ensure any issues can be addressed quickly.

    **Key Features**

    * **Automatic Import:** New invoices and credit notes from Chargebee are automatically imported into Invopop and converted to GOBL format.
    * **Workflow Automation:** Process imported invoices through your configured workflows to generate compliant invoices, PDFs, and submit to tax authorities.
    * **Real-Time Processing:** Track invoice status directly in Chargebee with automatic status updates posted as comments.
    * **Multi-Format Support:** Convert Chargebee invoices to any e-invoice format supported by Invopop, including country-specific formats like ZUGFeRD (Germany), XRechnung (Germany), and more.
    * **Custom Data Mapping:** Support for custom fields and metadata to map country-specific tax requirements and extensions.
    * **Error Handling:** Automatic error reporting back to Chargebee with detailed messages in invoice comments.

    Make sure to check out our [Chargebee Guide](/guides/chargebee) for instructions on how to connect the app, configure workflows, and set up webhooks.
  </Tab>

  <Tab title="Actions">
    The following workflow actions will be available once you install and enable this app:

    <Card title="Import document from Chargebee" icon="https://assets.invopop.com/apps/chargebee/icon.svg" horizontal>
      Import invoice and credit note data from Chargebee into Invopop.
    </Card>

    <Card title="Update Chargebee" icon="https://assets.invopop.com/apps/chargebee/icon.svg" horizontal>
      Update Chargebee with processing status and error messages.
    </Card>
  </Tab>

  <Tab title="Workflows">
    The following workflows are available to make your integration easier. Use them as templates to build upon.

    <AccordionGroup>
      <Accordion title="Chargebee PDF invoice workflow">
        This workflow syncs with Chargebee and generates a basic PDF.

        ```json Example Chargebee PDF invoice workflow theme={"system"}
        {
          "name": "Chargebee PDF invoice",
          "description": "Sync from Chargebee and generate a PDF",
          "schema": "bill/invoice",
          "steps": [
            {
              "id": "1b23a850-ff46-11ef-bc8b-49a3f98ea471",
              "name": "Import document from Chargebee",
              "provider": "chargebee.import"
            },
            {
              "id": "c9d569f0-ab1e-11ef-a0aa-f554af0a2b6c",
              "name": "Set state",
              "config": {
                "state": "processing"
              },
              "summary": "Set state to `processing`{.state .processing}",
              "provider": "silo.state"
            },
            {
              "id": "c7a347b0-ab1e-11ef-a0aa-f554af0a2b6c",
              "name": "Sign envelope",
              "provider": "silo.close"
            },
            {
              "id": "d1f2e5e0-ab1e-11ef-a0aa-f554af0a2b6c",
              "name": "Generate PDF",
              "config": {
                "logo_height": 40,
                "locale": "en",
                "date_format": "%Y-%m-%d"
              },
              "summary": "English · A4",
              "provider": "pdf"
            },
            {
              "id": "6277f270-abd0-11ef-a013-91c68ca9f44b",
              "name": "Set state",
              "config": {
                "state": "sent"
              },
              "summary": "Set state to `sent`{.state .sent}",
              "provider": "silo.state"
            },
            {
              "id": "02487016-0959-475c-9bc4-aa237313fefa",
              "name": "Update Chargebee",
              "provider": "chargebee"
            }
          ],
          "rescue": [
            {
              "id": "5504a610-abd0-11ef-a013-91c68ca9f44b",
              "name": "Set state",
              "config": {
                "state": "error"
              },
              "summary": "Set state to `error`{.state .error}",
              "provider": "silo.state"
            },
            {
              "id": "d8166690-ab1e-11ef-a0aa-f554af0a2b6c",
              "name": "Update Chargebee",
              "provider": "chargebee"
            }
          ]
        }

        ```

        [Add to my workspace →](https://console.invopop.com/redirect/workflows/new?template=chargebee-cb-invoice)
      </Accordion>

      <Accordion title="Chargebee ZUGFeRD workflow">
        This workflow syncs with Chargebee and generates a ZUGFeRD XML and PDF for Germany.

        <Note>
          For a full walkthrough including required apps, email delivery setup, and custom fields, see the [Germany section of the Chargebee guide](/guides/chargebee#germany).
        </Note>

        ```json Example Chargebee ZUGFeRD workflow theme={"system"}
        {
            "name": "Chargebee ZUGFeRD invoice",
            "description": "Sync from Chargebee and issue a ZUGFeRD invoice",
            "schema": "bill/invoice",
            "steps": [
                {
                    "id": "ff581030-1943-11f0-b031-c71066181289",
                    "name": "Import document from Chargebee",
                    "provider": "chargebee.import"
                },
                {
                    "id": "bd7eb640-abd0-11ef-a013-91c68ca9f44b",
                    "name": "Set state",
                    "provider": "silo.state",
                    "summary": "Set state to `processing`{.state .processing}",
                    "config": {
                        "state": "processing"
                    }
                },
                {
                    "id": "b913e860-1d43-11f1-a00f-9bd9990c5dfa",
                    "name": "Download PDF from Chargebee",
                    "provider": "chargebee.pdf.download"
                },
                {
                    "id": "18910b60-6624-11f0-9087-c716f49f1585",
                    "name": "Modify silo entry",
                    "provider": "silo.modify",
                    "summary": "Add `de-zugferd-v2` addon",
                    "config": {
                        "addons": [
                            "de-zugferd-v2"
                        ],
                        "sign": false
                    }
                },
                {
                    "id": "c37c3860-abd0-11ef-a013-91c68ca9f44b",
                    "name": "Sign envelope",
                    "provider": "silo.close"
                },
                {
                    "id": "3548d720-6623-11f0-b3db-e7255a5da07c",
                    "name": "Generate CII document",
                    "provider": "cii.generate",
                    "summary": "ZUGFeRD v2",
                    "config": {
                        "attach_invoice_pdf": false,
                        "doc_type": "zugferd-v2",
                        "validate_cii": true
                    }
                },
                {
                    "id": "8e665990-81a3-11f0-82cb-9160968ac068",
                    "name": "Embed FacturX/ZUGFeRD",
                    "provider": "cii.pdf.embed"
                },
                {
                    "id": "c6192a60-abd0-11ef-a013-91c68ca9f44b",
                    "name": "Set state",
                    "provider": "silo.state",
                    "summary": "Set state to `sent`{.state .sent}",
                    "config": {
                        "state": "sent"
                    }
                },
                {
                    "id": "553f8c03-c0ff-4de5-9a66-33685b8f9c65",
                    "name": "Update Chargebee",
                    "provider": "chargebee"
                }
            ],
            "rescue": [
                {
                    "id": "c94982c0-abd0-11ef-a013-91c68ca9f44b",
                    "name": "Set state",
                    "provider": "silo.state",
                    "summary": "Set state to `error`{.state .error}",
                    "config": {
                        "state": "error"
                    }
                },
                {
                    "id": "c35d34c0-b7af-11ef-86a5-99a247862412",
                    "name": "Update Chargebee",
                    "provider": "chargebee"
                }
            ]
        }

        ```

        [Add to my workspace →](https://console.invopop.com/redirect/workflows/new?template=chargebee-cb-zugferd)
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

***

<Card title="Participate in our community" icon="square-question" href="https://community.invopop.com" arrow="true" horizontal>
  Ask and answer questions about Chargebee App →
</Card>
