Die All-in-One Lösung.
API-Schnittstelle für XRechnung-zu-PDF-Konvertierung
API-Schnittstelle für XRechnung-zu-PDF-Konvertierung
Beschreibung für Anwender
Zweck:
Diese API-Schnittstelle ermöglicht es Ihnen, eine XRechnung im XML-Format hochzuladen, die automatisch in ein PDF-Dokument umgewandelt wird. Die API gibt Ihnen anschließend das PDF-Dokument als Antwort zurück. So können Sie schnell und unkompliziert Ihre XRechnung als PDF anzeigen oder speichern.
Vorgehensweise:
- Sie senden Ihre XRechnung im XML-Format über die API.
- Die API prüft die Datei auf das richtige Format und die Richtigkeit der Daten.
- Bei erfolgreicher Prüfung wird das XML-Dokument in ein PDF umgewandelt.
- Sie erhalten als Antwort das PDF-Dokument, das die Inhalte der XRechnung übersichtlich darstellt.
Vorteile:
- Schnell und automatisiert: Keine manuelle Bearbeitung erforderlich.
- Sicher: Alle Daten werden verschlüsselt übermittelt.
- Effizient: Sie erhalten das PDF sofort als Antwort und können es sofort weiterverarbeiten.
Alternative Lösung
Sollte Ihr CRM System keine API Anbindung unterstützen, können Sie auch auf unser Windows basiertes Tool zurückgreifen oder auf unsere E-Mail Konverter Lösung.
Hierbei senden Sie die XML-Datei an eine von uns vorgegebene E-Mail-Adresse und erhalten innerhalb kurzer Zeit eine PDF zurückgemailt.
Weitere Informationen finden Sie hier.
Technische Beschreibung für Entwickler
Endpunkt: /api/xrechnung/convert
Methode: POST
Authentifizierung:
- Jeder API-Aufruf erfordert ein gültiges API-Token für die Authentifizierung.
- Das Token wird zusammen mit der Anfrage gesendet, um den Zugriff zu autorisieren.
Anfrageparameter:
Header | Typ | Beschreibung |
---|---|---|
x-api-key |
String | API-Token zur Authentifizierung. |
Parameter | Typ | Beschreibung |
xrechnung_file |
File | XRechnung-Datei (im XML-Format) als Anhang. |
Anfrage-Beispiel
curl –location ‚https://app.xrechnung2pdf.de/api/xrechnung/convert‘ \
–header ‚x-api-key: ••••••‘ \
–form ‚xrechnung_file=“xrechnungsdatei.xml“‚
200 OK
{
„status“: „success“,
„message“: „XRechnung erfolgreich in PDF konvertiert.“,
„pdf_file“: „<pdf_binary_data>“
}
400 Bad Request
{
„status“: „error“,
„message“: „Ungültiges Format der XRechnung. Bitte überprüfen Sie das XML-Dokument.“
}
403 Forbidden
{
„status“: „error“,
„message“: „Ungültiges API-Token. Zugriff verweigert.“
}
Sind Sie auf der Suche nach einer individuellen Lösung, die hier nicht aufgeführt ist, kontaktieren Sie uns bitte.