Integrations-API: Senden Sie die Verkäufe Ihres Programms an TicketBAI und an Vectura
Ihre Software —ein Kassensystem einer anderen Marke, ein Kiosk, ein Onlineshop, ein ERP oder das Programm eines Hotels— sendet jeden Verkauf per JSON-Aufruf an Vectura. Vectura stellt den Bon oder die Rechnung aus, signiert sie mit TicketBAI oder Veri*Factu, übermittelt sie an die Steuerbehörde und gibt Ihnen den QR-Code zum Drucken zurück. Ohne Bibliotheken, ohne Installation und mit einem Schlüssel pro Programm.
Demokonto
Fiktive Daten, kein Versand an das Finanzamt oder per E-Mail. Wird jede Nacht zurückgesetzt.
{
"seriefactura": "KIOSKO1",
"numfactura": "105",
"fechaexpedicionfactura": "2026-11-06",
"importetotalfactura": "3,50",
"baseimponible": "2,89",
"tipoimpositivo": "21",
"cuotaimpuesto": "0,61"
}
{
"error": "0",
"leyenda": "TicketBAI",
"fiscal_estado": "aceptado",
"qr_url": "https://batuz.eus/QRTBAI/?id=…"
}
So einfach ist die Integration
Schlüssel erzeugen
In Ihrem Benutzerbereich erstellen Sie unter Konfiguration → API und Integrationen für jedes Programm einen Schlüssel. Er kann jederzeit gelöscht werden.
Verkauf senden
Ihr Programm sendet einen POST mit dem JSON des Verkaufs. Ohne Steuernummer entsteht ein vereinfachter Bon, mit Steuernummer eine vollständige Rechnung.
QR-Code drucken
Vectura signiert und übermittelt an die Steuerbehörde und antwortet mit dem QR-Code und dem Hinweistext zum Drucken auf dem Bon.
Was ist enthalten
Ein Aufruf pro Verkauf
Ihr Programm sendet ein JSON mit der Steuernummer (optional), dem Betrag und der MwSt. Ohne Steuernummer wird ein vereinfachter Bon ausgestellt, mit Steuernummer eine vollständige Rechnung an diesen Kunden.
Signatur und Übermittlung an die Steuerbehörde
Vectura signiert mit Ihrem Zertifikat und übermittelt an die Hacienda Foral (TicketBAI in Bizkaia, Gipuzkoa und Álava) oder an die spanische Steuerbehörde (Veri*Factu im restlichen Spanien).
Der QR-Code, druckfertig
Die Antwort enthält die Adresse des QR-Codes und seinen Hinweistext (TicketBAI oder VERI*FACTU); das QR-Bild können Sie bei Vectura anfordern.
Sichere Wiederholungen und Ihre Nummerierung
Wir übernehmen Serie und Nummer Ihres Programms. Wenn Sie einen Verkauf mit derselben Serie und Nummer wiederholen, gibt Vectura den ursprünglichen zurück, ohne einen weiteren anzulegen: Eine Netzunterbrechung dupliziert nie eine Rechnung.
Stornieren, abfragen und berichtigen
Stornieren Sie einen Bon, fragen Sie den steuerlichen Status eines Verkaufs ab oder berichtigen Sie eine Rechnung mit einer Korrekturrechnung, alles über dieselbe API.
Vollständige Rechnungen, Zahlungen und Angebote
Mit Positionen, mehreren MwSt.-Sätzen, Kunde, Zahlung und PDF-Versand per E-Mail; offene Rechnungen, Angebote und Dokumentenabfrage.
Für Programme, die nur Dateien ablegen
Wenn Ihre Software keine Webaufrufe machen kann, lädt ein PowerShell-Skript die JSON-Dateien eines Ordners selbstständig hoch und schreibt die Antwort mit dem QR-Code. Ohne Programmieren.
Handbuch und Schlüssel in Ihrem Benutzerbereich
Erzeugen Sie einen Schlüssel pro Programm und lesen Sie das API-Handbuch mit Beispielen in curl, PHP, C#, JavaScript und Python sowie der Liste der Fehler.
Häufig gestellte Fragen
Was brauche ich für den Start?
Ein Vectura-Suite-Konto und die steuerlichen Daten Ihres Unternehmens. Zum echten Signieren benötigen Sie Ihr elektronisches Zertifikat (und bei TicketBAI die Softwarelizenz, die unser Support einrichtet). Solange Sie testen, befindet sich das Unternehmen im Testmodus.
Funktioniert es mit TicketBAI und Veri*Factu?
Ja. Je nach Regelung Ihres Unternehmens signiert Vectura mit TicketBAI (Bizkaia, Gipuzkoa und Álava) oder erzeugt den Veri*Factu-Eintrag; das aufrufende Programm muss sie nicht unterscheiden.
Kann ich testen, ohne etwas an die Steuerbehörde zu senden?
Ja. Solange sich das Unternehmen im Testmodus befindet, wird alles signiert und an die Testumgebung der Steuerbehörde gesendet, und die QR-Codes haben keine Rechtsgültigkeit. Wenn alles funktioniert, wechseln Sie in den Echtbetrieb.
Was passiert, wenn die Verbindung mitten in einem Verkauf abbricht?
Sie wiederholen den Aufruf mit derselben Serie und Nummer (oder derselben Referenz): Vectura gibt den ursprünglichen Verkauf zurück, ohne ihn zu duplizieren.
Gibt es ein Limit für Aufrufe?
Ja: 120 Anfragen pro Minute, mehr als genug für ein Geschäft. Wenn Sie das überschreiten, antwortet die API mit 429, und Sie versuchen es nach einem Moment erneut.
Wo finde ich die Dokumentation?
In Vectura Suite, in Ihrem Benutzerbereich: Hilfe → API-Handbuch. Es enthält eine Einstiegsanleitung, jeden API-Endpunkt mit Beispielen in curl, PHP, C#, JavaScript und Python sowie die Liste der Fehler. Sie können es mit der kostenlosen Testversion einsehen.
Wer sieht meinen Schlüssel?
Niemand: Er wird nur einmal beim Erstellen angezeigt, und Vectura speichert nur einen Fingerabdruck. Wenn Sie ihn verlieren, löschen Sie ihn und erstellen einen neuen; das Löschen eines Schlüssels betrifft die anderen nicht.
Kann ich das Programm eines Hotels anbinden?
Ja: Neben den Verkäufen gibt es API-Endpunkte für belegte Zimmer und Zimmerbelastungen, die das Hotelprogramm abfragt und abrechnet.
Testen wir es mit Ihrem Unternehmen?
Erstellen Sie Ihr Konto und testen Sie es mit Ihren eigenen Daten, ohne Kreditkarte und ohne Verpflichtung.