Schnellstart

In wenigen Minuten erstellen oder laden Sie ein Dokument hoch und versenden es per Peppol oder E-Mail. Wählen Sie: Weboberfläche oder API.

Option A: Weboberfläche

1. Anmelden

Öffnen Sie die xTool-Web-App (URL von Ihrem Administrator) und melden Sie sich mit Benutzername und Passwort an.

2. Organisation wählen

Wählen Sie im Umschalter eine Organisation oder legen Sie eine an (wenn Sie Administrator sind). Dokumente und Einstellungen hängen an der aktiven Organisation. Siehe Organisation und Benutzer.

3. Dokument erstellen oder hochladen

Siehe Dokumente erstellen.

4. Dokument versenden

Dokument öffnen und klicken:

• „Per Peppol versenden“ — das Dokument muss eine gültige Peppol-ID des Empfängers haben. Siehe Per Peppol versenden.
• „Per E-Mail versenden“ — E-Mail des Empfängers und optional Sprache eingeben. Siehe Per E-Mail versenden.

Option B: API

1. API-Schlüssel besorgen

In der Web-App: API (unter Ihrer Organisation) → Schlüssel anlegen → Rechte vergeben (z. B. Dokument hochladen und versenden) → Geheimnis einmal kopieren. Siehe API-Schlüssel und Logs und Setup.

2. Authentifizierung

Schlüssel bei jedem Request im Header mitsenden:

1

x-api-key: YOUR_API_KEY

3. Dokument hochladen

XML:

1
2
3
4

curl -X POST "https://xtool.invoice-portal.de/api/v2/documents/upload/xml" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/xml" \
  -d @invoice.xml

Modell (JSON):

1
2
3
4

curl -X POST "https://xtool.invoice-portal.de/api/v2/documents/upload/model" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @invoice-model.json

Die Antwort enthält die Dokument-id. Siehe Dokumente erstellen.

4. Dokument versenden

Peppol:

1
2
3
4

curl -X POST "https://xtool.invoice-portal.de/api/v2/documents/DOCUMENT_ID/send" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"transaction_type": "send.peppol"}'

E-Mail — im Body "transaction_type": "send.email" sowie "email" und optional "lang" setzen. Siehe Per E-Mail versenden.

Wenn etwas schiefgeht