MIDbridge
Einrichtungsanleitung

E-Invoicing in Chargebee
mit MIDbridgeX einrichten

Schritt für Schritt: MIDbridgeX als E-Rechnungs-Anbieter in Chargebee verbinden, Land und Format aktivieren und die E-Rechnung an den Rechnungsversand anhängen.

Inhalt

1Überblick und Voraussetzungen
2MIDbridgeX vorbereiten
3App in Chargebee verbinden
4Land und Format aktivieren
5Bedingung festlegen
6Einstellungen je Format
7E-Rechnung an den Belegversand
8Test und Kontrolle
DokumentVersion 1.0 · November 2026
ZielgruppeAdministratorinnen und Administratoren von Chargebee und MIDbridgeX
HerausgeberMID Technologien GmbH
mid-tech.de

1Überblick und Voraussetzungen

Mit der App „MIDbridgeX E-Invoicing“ lagert Chargebee die Erzeugung Ihrer E-Rechnungen an MIDbridgeX aus. Chargebee übergibt jeden abrechnungsreifen Beleg, MIDbridgeX erzeugt die E-Rechnung, und Chargebee holt sie ab und verschickt sie mit der Rechnungs-E-Mail.

Die Einrichtung findet zum größten Teil in Chargebee statt; in MIDbridgeX werden ein Zugangsschlüssel erzeugt und einige Schalter gesetzt – diese Schritte in MIDbridgeX führen wir als Administratoren gemeinsam mit Ihnen durch; selbst haben Sie darauf keinen Zugriff. Rechnen Sie mit 15 bis 30 Minuten. Diese Anleitung zeigt die Einrichtung am Beispiel Deutschland mit dem Format Factur-X/ZUGFeRD.

Sie brauchen

  • Administratorrechte in Ihrer Chargebee-Site
  • einen Chargebee-API-Schlüssel Ihrer Site (für die Verbindung in MIDbridgeX)
  • vollständige Firmendaten in MIDbridgeX: Name, Anschrift, Telefon, E-Mail, Steuernummer bzw. USt-IdNr, IBAN

Gut zu wissen

  • Richten Sie alles zuerst auf Ihrer Chargebee-Test-Site ein und erst danach auf der Live-Site.
  • Die Bezeichnungen in Chargebee sind englisch und können sich mit neuen Chargebee-Versionen leicht ändern.
  • Fehlen Pflichtangaben, entsteht keine E-Rechnung – der Grund steht dann direkt an der Rechnung in Chargebee.

2MIDbridgeX vorbereiten

Kann nur gemeinsam mit einem MIDbridgeX-Administrator durchgeführt werden. Die Einstellungen in MIDbridgeX sind ausschließlich mit Administratorzugang erreichbar. Diese Schritte können Sie nicht selbst durchführen – sie werden zusammen mit uns, den Administratoren von MID Technologien, vorgenommen.

Die Einstellungen liegen in MIDbridgeX unter Einstellungen → Allgemeine Einstellungen → E-Rechnung.

  1. Stellen Sie Weg der E-Rechnung auf Chargebee E-Invoice. Erst dann erscheinen die übrigen Felder dieses Abschnitts.
  2. Klicken Sie unter Zugang fuer Chargebee auf Schluessel erzeugen und kopieren Sie den angezeigten Schlüssel sofort. Er wird nur dieses eine Mal angezeigt; geht er verloren, erzeugen Sie einen neuen. Eine Adresse müssen Sie nirgends eintragen – welche Instanz antwortet, ergibt sich allein aus dem Schlüssel.
  3. Wählen Sie unter Rueckweg zu Chargebee die Chargebee-Verbindung – eine gewöhnliche REST-Verbindung mit dem API-Schlüssel Ihrer Site. Gibt es sie noch nicht, legen Sie sie zuerst unter Verbindungen an.
  4. Schalten Sie Status an Chargebee melden ein. Ohne diese Meldung holt Chargebee die fertige E-Rechnung nicht ab, und die Rechnung bleibt dort „in Bearbeitung“.
  5. Prüfen Sie Angebotene Formate und Laender (Komma-getrennt): Das Land, das Sie in Chargebee aktivieren (hier DE), muss in der Liste stehen.

3App in Chargebee verbinden

Öffnen Sie in Chargebee links im Menü Apps. Ist die App noch nicht verbunden, finden Sie sie über Go to Marketplace; beim Verbinden fragt Chargebee nach dem API-Schlüssel – tragen Sie dort den Schlüssel aus Schritt 2 ein.

  1. Klicken Sie unter Apps connected auf die App MIDbridgeX E-Invoicing (auf der Test-Site mit dem Zusatz „Sandbox“).
    Chargebee: Apps mit verbundener App MIDbridgeX E-Invoicing
    Abbildung 1 – Die verbundene App unter „Apps connected“.
  2. Chargebee bestätigt, dass die Integration aktiv ist. Klicken Sie auf Go to E-invoicing.
    Chargebee: Integration aktiviert, Schaltfläche Go to E-invoicing
    Abbildung 2 – Integration aktiv; weiter zu den E-Invoicing-Einstellungen.

4Land und Format aktivieren

E-Invoicing wird in Chargebee je Steuerland eingeschaltet. Für jedes Land wählen Sie anschließend den Anbieter und das Format („Model“).

  1. Klicken Sie auf Add Country, suchen Sie Ihr Land (hier Germany), haken Sie es an und bestätigen Sie mit Continue.
    Chargebee: Select Countries mit Germany ausgewählt
    Abbildung 3 – Land hinzufügen.
  2. Klicken Sie beim hinzugefügten Land auf Manage. Ein Land mit dem Hinweis Setup pending hat noch keinen Anbieter und kein Format; ein fertig eingerichtetes Land trägt das Kennzeichen Active.
    Chargebee: Länderliste mit Manage-Links
    Abbildung 4 – Länderübersicht: Germany ist aktiv, Austria und Italy warten noch auf die Einrichtung.
  3. Unter Models erscheint das Format Zugferd mit den Dokumenten zugferd-invoice (Rechnung) und zugferd-creditnote (Gutschrift). Klicken Sie bei zugferd-invoice rechts auf die drei Punkte und wählen Sie Manage.
    Chargebee: Models für Germany mit zugferd-invoice und zugferd-creditnote
    Abbildung 5 – Format Zugferd für B2B-Kunden mit den Dokumenten Rechnung und Gutschrift.

5Bedingung festlegen

Die Bedingung bestimmt, für welche Belege Chargebee dieses Dokument bei MIDbridgeX anfordert.

  1. Stellen Sie die Bedingung wie abgebildet ein und klicken Sie auf Save and exit:
    FeldOperatorWert
    WHENTaxable Address CountryequalsDE
    ANDDocument TypeequalsInvoice
    Chargebee: Bedingung Taxable Address Country equals DE AND Document Type equals Invoice
    Abbildung 6 – Bedingung für zugferd-invoice: Steuerland Deutschland und Belegart Rechnung.
Gutschriften. Richten Sie zugferd-creditnote auf dieselbe Weise ein; als Document Type wählen Sie dort die Gutschrift (Credit Note). Sind beide Dokumente eingerichtet, tragen sie in der Übersicht ein grünes Häkchen (Abbildung 5).

6Einstellungen je Format in MIDbridgeX

Kann nur gemeinsam mit einem MIDbridgeX-Administrator durchgeführt werden. Auch diese Einstellungen erfordern Administratorzugang zu MIDbridgeX und werden zusammen mit uns vorgenommen – Sie können sie nicht selbst ändern.

Zurück in MIDbridgeX unter Einstellungen → Allgemeine Einstellungen → E-Rechnung legen Sie im Block Je Format fest, was nach der Erzeugung geschieht. Für diese Einrichtung gilt:

Je FormatFactur-X / ZUGFeRDXRechnungPeppol BIS Billing 3.0
PDF aus Chargebee als Basisausausaus
Chargebee-PDF zusaetzlich an DATEVausausaus
Versand in Chargebee ausloesenananan
MIDbridgeX: Je-Format-Einstellungen mit Versand in Chargebee auslösen
Abbildung 7 – So sieht der Block in MIDbridgeX aus.

7E-Rechnung an den Belegversand anhängen

Damit Ihre Kunden die E-Rechnung mit der Rechnungs-E-Mail erhalten, muss Chargebee sie anhängen.

  1. Öffnen Sie in Chargebee Settings → Configure Chargebee → Email notifications → Invoice receipt.
  2. Klicken Sie bei Invoice is generated auf EDIT.
  3. Haken Sie unter Email Options die Option Attach invoice or e-invoice if available an und speichern Sie.
    Chargebee: Email Options mit Attach invoice or e-invoice if available
    Abbildung 8 – Die E-Rechnung wird angehängt, sobald sie vorliegt; sonst die gewöhnliche Rechnung.
Empfänger. Die übrigen Optionen (z. B. Send to billing email) bleiben, wie Sie sie bisher genutzt haben. Diese Einstellung ändert nur den Anhang, nicht den Empfängerkreis.

8Test und Kontrolle

Erzeugen Sie auf der Test-Site eine Rechnung an einen Kunden mit deutscher Rechnungsadresse und prüfen Sie:

WoWas Sie sehen sollten
Chargebee, an der RechnungStatus der E-Rechnung wechselt von „in Bearbeitung“ auf erfolgreich; die E-Rechnung ist abrufbar.
Rechnungs-E-MailAnhang ist die E-Rechnung (PDF mit eingebettetem factur-x.xml).
MIDbridgeX, Protokoll Chargebee E-RechnungEinreichung, Statusmeldung und Abholung des Belegs.
MIDbridgeX, BelegbaumDie E-Rechnung hängt am Beleg (nach dem nächsten Belegimport).

Wenn es nicht klappt

Vor dem Produktivstart: dieselben Schritte auf der Live-Site wiederholen – mit dem Schlüssel der MIDbridgeX-Instanz, die Ihre Live-Site bedienen soll. Die Schritte in MIDbridgeX nehmen wir dabei wieder gemeinsam mit Ihnen vor.

Kontakt: MID Technologien GmbH · +49 7551 989 63 64 · info@mid-tech.de · mid-tech.de