Für Entwickler

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.

Der Integrationsweg

Fünf Schritte, nichts dazwischen

So läuft eine Integration bei Factora ab — jeder Schritt steht so im Code, nicht nur im Prospekt.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

Was du außerdem bekommst

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.

Für Entwickler

Sandbox-Key holen

Registrieren, Test-Key erzeugen, ersten Request schicken. Kostenlos, ohne Kreditkarte.