Per E-Mail versenden
Diese Anleitung beschreibt, wie Sie ein Dokument (Rechnung oder Gutschrift) per E-Mail aus xTool versenden.
Voraussetzungen
- In xTool erstelltes oder hochgeladenes Dokument. Siehe Dokumente erstellen.
- E-Mail-Adresse des Empfängers — Sie geben sie beim Versand an (Web oder API).
Web
- Dokument in der Dokumente-Liste öffnen.
- Dokument per E-Mail senden klicken.
- Empfänger-E-Mail eingeben.
- Wenn Ihre Organisation E-Mail-Vorlagen hat, eine E-Mail-Vorlage wählen (die Vorlage Standard ist vorausgewählt). Sonst die Sprache der Standardnachricht wählen.
- Wählen, ob das Originaldokument und/oder die PDF-Visualisierung angehängt werden. Mindestens ein Anhang ist erforderlich.
- Senden klicken.
Text, Betreff, CC oder BCC der Nachricht legen Sie unter E-Mail-Vorlagen fest. Versand über den eigenen Mailserver und die eigene From-Adresse: Custom SMTP.
API
POST-Request an den Dokument-Versand-Endpoint senden:
- Endpoint:
POST /api/v2/documents/{document_id}/send(oder gleichwertig). - Body: z. B.
{"transaction_type": "send.email", "email": "recipient@example.com", "lang": "de"}. Optional:lang(Sprache der Standardnachricht),template_id(eine in der Web-App erstellte E-Mail-Vorlage),attach_original_document,attach_pdf_visualisation.
Die Antwort bestätigt den Versand; der Dokumentstatus kann aktualisiert werden (z. B. gesendet).
Siehe API-Referenz für exakten Endpoint und Parameter.
Nächste Schritte
- Nachricht anpassen — E-Mail-Vorlagen.
- Eigener Mailserver — Custom SMTP.
- Per Peppol versenden — Per Peppol versenden.
- Empfang per E-Mail — Empfang per E-Mail.
- Empfang per Peppol — Empfang per Peppol.