Zum Inhalt

Dokumente erstellen

Diese Anleitung beschreibt, wie Sie Rechnungen und Gutschriften in xTool erstellen oder hochladen — über die Weboberfläche oder die API.

Methoden

Methode Web API
Formular (Modell) Dokumente → Erstellen → Format und Richtung wählen → Formular ausfüllen. POST Upload Modell (JSON-Body).
XML Dokumente → Hochladen → Datei wählen; Format kann angegeben oder automatisch erkannt werden. POST Upload XML mit Datei oder Body.
PDF Dokumente → Hochladen → PDF wählen. Siehe PDF hochladen. —
CSV-Import Dokumente → Importieren → xTool-CSV-Datei wählen. POST CSV-Import mit Datei oder Body. Siehe Dokumente importieren.
Aus Vorlage Dokumente → Erstellen → Aus Vorlage erstellen. —

Ergebnis ist ein Dokument mit einer id. Danach können Sie es versenden (Peppol, E-Mail), anzeigen oder Validierungs-/Konvertierungs-Endpoints nutzen. Siehe Dokumentenmodell und Formate.

Web: Aus Formular erstellen

  1. Dokumente → Erstellen.
  2. Format (z. B. XRechnung UBL, Peppol BIS Billing) und Richtung (ausgehend/eingehend) wählen.
  3. Pflichtfelder ausfüllen (Verkäufer, Käufer, Positionen, Beträge usw.). Die Pflichtfelder hängen vom Format ab.
  4. Speichern. Das Dokument wird erstellt und erscheint in der Liste. Danach können Sie es versenden oder bearbeiten.

Wenn Ihre Organisation Rechnungsvorlagen hat, zeigt die Seite Erstellen zusätzlich Aus Vorlage erstellen. Vorlage wählen und Ausgewählte Vorlage verwenden klicken. xTool öffnet das neue Dokument zum Bearbeiten, damit Sie Nummer, Daten und Beträge anpassen können.

Wenn Ihre Organisation Partner hat, wählen Sie im Abschnitt Käufer einen Kunden, um Name, Adresse, Kennungen, Peppol-Endpoint und Zahlungsdaten in das Formular zu kopieren.

Web: XML hochladen

  1. Dokumente → Hochladen.
  2. XML-Datei wählen (oder Inhalt einfügen, falls die Oberfläche das anbietet).
  3. Optional Format angeben; sonst wird es aus der Datei erkannt.
  4. Bestätigen. Das Dokument wird aus dem XML erstellt.

Web: PDF hochladen

  1. Dokumente → Hochladen.
  2. PDF-Datei wählen.
  3. Bestätigen. Bei ZUGFeRD / Factur-X werden die Rechnungsdaten aus der Datei übernommen. Bei einem Scan oder gewöhnlichen PDF konvertieren Sie später — siehe PDF hochladen.

API: Modell hochladen (JSON)

POST-Request an den Upload-Modell-Endpoint mit JSON-Body senden, der dem Formatmodell des gewählten Formats entspricht.

Endpoint: POST /api/v2/documents/upload/model

Header: x-api-key, Content-Type: application/json

Body: JSON gemäß Format (z. B. Basis- oder Minimalmodell). Siehe Formatmodelle und Basis-Modell-Beispiel.

Die Antwort enthält das erstellte Dokument (inkl. id). Diese id können Sie für Versand, Abruf oder Liste nutzen.

API: XML hochladen

POST-Request an den Upload-XML-Endpoint mit der XML-Datei oder dem rohen XML-Body senden.

Endpoint: POST /api/v2/documents/upload/xml

Header: x-api-key, Content-Type: application/xml (oder multipart, wenn Ihr Client eine Datei sendet).

Body: XML-Rechnung oder -Gutschrift in einem unterstützten Format (z. B. XRechnung UBL, Peppol BIS).

Die Antwort enthält das erstellte Dokument (inkl. id). Das Format wird in der Regel aus dem XML erkannt; manche APIs erlauben die explizite Angabe.

Nächste Schritte