Zum Inhalt

Umzug aus FastBill

Haben übernimmt deinen Bestand aus FastBill, damit du das Abo kündigen kannst, ohne Daten zu verlieren. Der Umzug läuft auf der Seite Archiv unter „Umzug“: Wähle oben „Umzug aus FastBill“. Die Schritte sind dieselben wie beim Umzug aus Lexoffice.

Für eine GmbH oder UG gilt dasselbe wie beim Umzug aus Lexoffice: Die Bestände über die offenen Posten hinaus übernimmst du mit einer Eröffnungsbuchung.

Abgerufene Belege landen im selben unveränderlichen Archiv wie die aus Lexoffice und sevDesk. Abgleich je Jahr, offene Posten, die Ansicht Belege, die Kontaktseite und der Jahresexport behandeln alle Quellen gleich.

Warnung

Der Abruf ist gegen die API-Dokumentation von FastBill gebaut, mit nachgestellten Antworten getestet und einmal vollständig gegen ein echtes Konto gelaufen (November 2026). Prüfe nach dem Abruf den Abgleich je Jahr und kündige erst, wenn er für jedes Jahr aufgeht.

Voraussetzungen

  • Die Login-E-Mail deines FastBill-Kontos und den API-Schlüssel aus den Einstellungen deines Kontos in FastBill. Die API meldet sich mit beiden an (Basic Auth).
  • Deinen Tarif: FastBill erlaubt je Konto und Stunde nur eine bestimmte Zahl von Anfragen, Solo 50, Solo-Plus 100, Pro 500 und Premium 1000 (Grundlagen der API).
  • Firmendaten, Kontenrahmen und Versteuerungsart (Ist oder Soll) sind in Haben eingerichtet, wie in FastBill (Einrichtung).
  • Der Server braucht Zugriff auf https://my.fastbill.com.

Wichtig

Mit E-Mail und API-Schlüssel lassen sich die Daten deines FastBill-Kontos lesen und ändern. Entferne den Zugang nach dem Umzug in Haben (siehe Vor der Kündigung); das löscht ihn nur in Haben, nicht in FastBill.

Schritt 1: Verbindung zu FastBill

Trag Login-E-Mail, Tarif und API-Schlüssel ein und klicke „Prüfen und speichern“. Haben ruft damit einen Kunden ab; klappt das, stimmen die Angaben. Der Schlüssel wird wie bei Lexoffice mit AES-256-GCM verschlüsselt gespeichert und taucht weder im Änderungsprotokoll noch im Jahresexport auf. Stimmt der Tarif nicht, wartet der Abruf zu kurz oder unnötig lange.

Schritt 2: Kontakte, Rechnungen und Belege abrufen

„Alles abrufen“ startet den Abruf im Hintergrund, mit Fortschritt, Abbrechen und Fortsetzen wie bei Lexoffice. Es läuft immer nur ein Abruf, gleich aus welcher Quelle.

  1. Kunden: Name (Firma oder Person), Adresse, Land, E-Mail, USt-IdNr. und Kundennummer, als Kontakte mit der Rolle Kunde. Gibt es in Haben schon einen Kontakt mit demselben Namen und ohne FastBill-Herkunft, verknüpft Haben ihn. FastBill führt Lieferanten nicht als Kontakte; sie stehen in den Ausgaben nur als Name.
  2. Belegliste: Ausgangsrechnungen, Gutschriften und stornierte Rechnungen, je Art ein eigener Abruf, dazu die Ausgaben. Entwürfe bleiben draußen.
  3. Dateien: je Rechnung und Gutschrift das PDF, je Ausgabe der hochgeladene Beleg. Gibt FastBill den Beleg einer Ausgabe nur im angemeldeten Browser heraus, wartet die Ausgabe, siehe Belege, die FastBill nur im Browser herausgibt.

Die Antwort der API wird je Beleg gespeichert, zum Nachweis; ohne die Download-Adresse (DOCUMENT_URL), denn wer sie kennt, lädt den Beleg ohne Anmeldung.

Dauer und Stundengrenze

Jede Seite mit bis zu 100 Einträgen ist eine Anfrage, die PDFs zählen nicht dazu. Ist die Grenze deines Tarifs erreicht, wartet der Abruf, bis wieder Anfragen frei sind, und zeigt bis wann. Ein neuer Abruf nach einem Abbruch rechnet die Anfragen der letzten Stunde an und überspringt alles, was schon im Archiv liegt.

Belege, die FastBill nur im Browser herausgibt

Bei einem Teil der Ausgaben liefert die Download-Adresse aus der API (DOCUMENT_URL) die Datei nur, wenn man im Browser bei FastBill angemeldet ist; der API liefert sie nur eine leere Seite. Rechnungen und Gutschriften betrifft das nicht. Damit solche Ausgaben nicht ohne Beleg im unveränderlichen Archiv landen, archiviert Haben sie erst, wenn der Beleg da ist, und zeigt unter Schritt 2 den Kasten „Belege, die FastBill nur im Browser herausgibt“:

  1. In my.fastbill.com anmelden und die Entwicklerwerkzeuge öffnen (F12), dort die Konsole.
  2. In Haben „Skript kopieren“, in der Konsole einfügen und mit Enter starten. Haben setzt beim Kopieren die Liste der wartenden Ausgaben ein; das Skript lädt mit deiner Anmeldung genau diese Belege und gibt sie als ZIP-Dateien zurück, jede Datei benannt nach der ID der Ausgabe in FastBill. Es liest nur.
  3. Die ZIP-Dateien in Haben hochladen. Haben ordnet jede Datei über die ID ihrer Ausgabe zu und nimmt nur PDFs und Bilder an. Manche Belege speichert FastBill samt der Hülle des Formulars, mit dem sie hochgeladen wurden; dann übernimmt Haben die Datei darin unverändert, ohne die Hülle.
  4. In Schritt 2 „Erneut abrufen“: Haben übernimmt die Ausgaben jetzt mit ihrem Beleg.

Warum das Skript zulässig ist, steht beim Umzug aus Lexoffice unter Darf ich das?.

Solange Ausgaben warten, zeigt der Abgleich je Jahr den offenen Punkt „Keine Ausgabe wartet auf ihren Beleg“.

Gibt es zu einer Ausgabe in FastBill wirklich keinen Beleg, übernimmt „Rest ohne Beleg übernehmen“ die übrigen wartenden Ausgaben beim nächsten Abruf ohne Datei. Im Abgleich bleibt „Jeder Beleg hat eine Datei“ für dieses Jahr dann offen; an einen archivierten Beleg lässt sich später keine Datei mehr hängen.

Ohne Skript in der Konsole: „Rest ohne Beleg übernehmen“, dann die Belege in FastBill selbst herunterladen (einzeln oder über den Sammeldownload unter Finanzen › Ausgaben) und in Schritt 4 je Jahr als „Sonstiges“ ablegen. Einer einzelnen Ausgabe ordnet Haben diese Dateien nicht zu.

Wie FastBill-Belege abgebildet werden

In FastBill In Haben
Rechnung (TYPE outgoing) Rechnung; Abschlagsrechnung (SUBTYPE progress_invoice) als Abschlagsrechnung
Gutschrift (TYPE credit) Gutschrift, immer negativ
Stornierte Rechnung (STATE canceled) und ihre Stornogutschrift beide storniert und ausgeglichen; sie heben sich im Umsatz auf
Ausgabe Eingangsrechnung; mit negativem Betrag Gutschrift des Lieferanten

Eine Gutschrift gilt nur als Storno, wenn sie auf eine stornierte Rechnung verweist (REFERENCED_INVOICE_ID) und deren Betrag voll aufhebt. Eine Teilgutschrift bleibt eine Gutschrift mit eigenem Zahlungsstand.

Ob FastBill nach einem Teilstorno die Rechnung als storniert führt, ist nicht belegt. Ist eine Rechnung storniert, aber hebt keine Gutschrift sie voll auf, übernimmt Haben sie mit vollem Betrag als „teilstorniert“, und der Abgleich des Jahres zeigt den offenen Punkt „Keine Rechnung mit Teilstorno zu prüfen“. Gleiche sie dann mit FastBill ab.

Die Aufteilung nach Steuersatz kommt aus der Steueraufstellung des Belegs (VAT_ITEMS), sonst aus den Positionen.

Steuerarten im Abgleich

Die Steuerart einer Rechnung liest Haben aus VAT_CASE. FastBill liefert dort entweder 0 oder 1 (innergemeinschaftlich nein oder ja) oder einen Fall aus der Rechnungs-API:

VAT_CASE Im Abgleich
0, standard Kz 81, Kz 86
b2b_eu_goods innergemeinschaftliche Lieferung (Kz 41)
b2b_eu_services sonstige Leistung im übrigen Gemeinschaftsgebiet (Kz 21)
b2b_noneu_goods, b2c_noneu_goods Ausfuhrlieferung (Kz 43)
b2b_noneu_services sonstige Leistung im Drittland (Kz 45)
small_business_regulation Steuerfrei (Kleinunternehmer)
b2c_eu_goods Andere Sätze: ob der Fernverkauf über OSS lief, steht nicht in der Antwort
1 Andere Sätze: innergemeinschaftlich, aber ob Lieferung (Kz 41) oder sonstige Leistung (Kz 21), sagt die Antwort nicht

Bei Ausgaben zählt im Abgleich nur die Vorsteuer (Kz 66), im Monat des Belegs; VAT_CASE spielt dort keine Rolle.

Zahlungen

Die Einzelzahlungen einer Rechnung (PAYMENTS) übernimmt Haben mit Datum, Betrag und Zahlungsweg; bei Ist-Versteuerung zählt der Umsatz im Monat der Zahlung. Nennt FastBill nur ein Zahlungsdatum (PAID_DATE) ohne Einzelzahlungen, wie bei Ausgaben, gilt der Beleg an diesem Tag als voll bezahlt. Ist eine Rechnung nur zum Teil bezahlt, steht sie als teilweise bezahlt mit dem Rest offen. Eine bezahlte und danach stornierte Rechnung zeigt ihre Zahlung weiter an, sie zählt aber nicht als Umsatz: Die Erstattung führt FastBill nicht als Zahlung.

Artikel

Artikel sind keine Belege und kommen nicht ins Archiv, sondern in den Artikelkatalog. Steht der API-Schlüssel, zeigt die Seite unter dem Abruf den Kasten Artikel. Artikel aus FastBill übernehmen öffnet den CSV-Import, dort holt Aus FastBill holen den Artikelkatalog mit je einer Anfrage für 100 Artikel. Die Vorschau ist dieselbe wie bei einer CSV-Datei, mit denselben Dubletten und Fehlern; angelegt wird erst mit dem Knopf darunter.

  • Preis: FastBill liefert den Preis immer netto, auch wenn du ihn brutto eingegeben hast. Solche Artikel legt Haben mit Endpreis an, den Bruttopreis aus Nettopreis und Steuersatz auf den Cent gerundet. Nettopreise mit mehr als zwei Nachkommastellen rundet Haben auf den Cent.
  • Einheit und Steuersatz: Einheiten wie im Artikel-Import, Steuersätze 0, 7 und 19 %. Andere zeigt die Vorschau als Fehler; ändere sie in FastBill und hol die Artikel noch einmal.
  • Währung: Einen Preis in anderer Währung als Euro übernimmt Haben nicht; die Vorschau zeigt ihn als Fehler.
  • Stundengrenze: Der Abruf zählt auf dieselbe Grenze wie der Abruf der Belege, und umgekehrt. Ist sie erreicht oder antwortet FastBill gerade nicht, sagt Haben, in wie vielen Minuten es wieder geht. Während eines laufenden Abrufs holt Haben keine Artikel.

Grenzen des aktuellen Imports

Angebote, wiederkehrende Rechnungen, Projekte, Zeiten und die Dokumentenablage von FastBill übernimmt Haben nicht.

Schritt 3 bis 5

Offene Posten, Exporte ablegen und Abgleich je Jahr funktionieren wie beim Umzug aus Lexoffice. Unterschiede:

  • Die API liefert keine Buchungen und keine Bankumsätze. Die Exporte stehen in FastBill unter Import & Export (Stand November 2026). Lege je Geschäftsjahr „Buchungen im DATEV-Format“ als DATEV-Buchungsstapel ab und „DATEV XML-Schnittstelle online“ (ZIP mit Rechnungsdaten und Belegbildern) als Sonstiges, dazu die ELSTER-Protokolle und die Kontoauszüge.
  • Einen Export für die Betriebsprüfung (GoBD, IDEA-Format) bietet FastBill dort nicht an; die Prüfung „IDEA-Export archiviert“ bleibt deshalb offen.
  • Eine offene Rechnung ohne Nummer bekommt in Haben die Nummer FB- plus die ID aus FastBill.
  • Im Jahresexport stehen die Belege aus FastBill ebenfalls unter lexoffice/; die Spalte „Quelle“ in belege.csv sagt, woher ein Beleg stammt.

Andere API-Adresse

Haben spricht standardmäßig mit https://my.fastbill.com/api/1.0/api.php. Mit der Umgebungsvariable FASTBILL_API_URL setzt du eine andere Adresse, etwa zum Testen gegen einen nachgestellten Server.

Vor der Kündigung

  • [ ] Abruf ist fertig, die Liste der fehlgeschlagenen Belege ist leer
  • [ ] Keine Ausgabe wartet mehr auf ihren Beleg aus dem Browser-Skript
  • [ ] Jeder Beleg hat eine Datei (Abgleich je Jahr); Ausgaben ohne Beleg in FastBill geklärt
  • [ ] Für jedes Geschäftsjahr: DATEV-Buchungsstapel, DATEV-XML-Export, ELSTER-Protokolle und Kontoauszüge abgelegt, jeweils mit Jahr
  • [ ] Einnahmen, Ausgaben, Umsatz- und Vorsteuer je Jahr mit FastBill verglichen
  • [ ] Umsatzsteuer je Monat mit den übermittelten Voranmeldungen verglichen
  • [ ] Offene Posten übernommen oder die Gründe geklärt
  • [ ] Nächste Rechnungsnummer in Haben gesetzt
  • [ ] Jahresexport für jedes übernommene Jahr heruntergeladen
  • [ ] Zugang zu FastBill in Haben entfernt (das löscht ihn nur in Haben, nicht in FastBill)

Letztes Update: