Vom Sandbox-Key zur ersten geprüften Rechnung
Kein Trial, keine Karte, kein Vertriebstermin. Du registrierst dich, erzeugst einen Test-Key und schickst denselben Request, der später live läuft.
Fünf Schritte, nichts dazwischen
So läuft eine Integration bei Factora ab — jeder Schritt steht so im Code, nicht nur im Prospekt.
-
Sandbox-Key sofort
In der Console registrieren und einen Test-Key erzeugen. Es gibt keinen zeitlich begrenzten Trial: Sandbox-Keys bleiben kostenlos, eine Zahlungsmethode ist dafür nicht nötig.
-
Ein Request: der Atomic-Endpoint
POST /api/v1/invoices/atomic/ nimmt Kopfdaten, Verkäufer, Käufer, Positionen und die von dir berechneten Summen in einem Aufruf entgegen. Die Rechnungsnummer vergibst du; Factora prüft sie auf Eindeutigkeit je Mandant und antwortet bei einem Doppel mit 409.
-
Prüfurteil mit Feldreferenz
Fehler kommen als strukturierte Befunde zurück: Code, Schwere, Meldung und das betroffene Feld, etwa items[2]. Die Steuerprüfung blockiert mit HTTP 400 bei 15 Codes und warnt bei 2 — ein nicht erreichbares VIES blockiert nie.
-
Was die Sandbox liefert
Das Prüfurteil und ein sichtbar entwertetes PDF mit Wasserzeichen auf jeder Seite. Das Feld xml_base64 ist in der Sandbox null: ein maschinenlesbares Dokument gibt es erst mit einem Live-Key.
-
Live mit Abo und Zahlungsmethode
Abo abschließen, Zahlungsmethode hinterlegen, Live-Key erzeugen. Basis-URL und Request bleiben gleich. Abgerechnet wird erst ab aktivem Abo, und nur die finalisierte Live-Rechnung.
Belegt im Code, nicht im Prospekt
-
KoSIT vor jeder Finalisierung
Validator 1.6.3 mit der KoSIT-Konfiguration 2026-08-31, XRechnung 3.0.2 als UBL und CII. Ohne Antwort des Validators gibt es kein Dokument.
-
Idempotency-Keys, 48 Stunden
Ein wiederholter Aufruf mit demselben Schlüssel innerhalb von 48 Stunden erzeugt keine zweite Rechnung und keine zweite Position auf der Abrechnung.
-
Mandanten als Objekt
Stammdaten, Logo und Briefpapier je Mandant, Bulk-Anlage bis 200 je Request, Rechnungsnummer eindeutig je Mandant. Abgerechnet wird über dein Konto, nicht je Mandant.
-
VIES bei Kategorie K
Bei innergemeinschaftlichen Lieferungen prüft die API die USt-IdNr. live gegen VIES: ungültig blockiert, nicht erreichbar warnt und wird automatisch nachgeprüft. Das Ergebnis wird 24 Stunden zwischengespeichert.
-
DATEV und Export
Buchungsstapel mit 118 Spalten in CP1252 über GET /api/v1/exports/datev/, Rechnungs-Export als ZIP mit SHA-256 über GET /api/v1/exports/invoices/.
-
Rate-Limit statt Preisstufe
50.000 Calls pro Tag und Schlüssel als Anti-Abuse-Grenze. Abgerechnet wird nicht der Call, sondern die finalisierte Live-Rechnung.
Sandbox-Key holen
Registrieren, Test-Key erzeugen, ersten Request schicken. Kostenlos, ohne Kreditkarte.