---
title: "Rechnungen – Peppol-Vorlage für Verkaufsrechnungen und Gutschriften"
description: "Peppol-fähige Vorlagen für Rechnungen und Gutschriften erfordern ein korrektes Mapping der Standard- und benutzerdefinierten Felder auf die Peppol-Datenfelder, mit Live-Vorschau, Anpassung und Prüfung vor dem Versand."
url: https://help.qargo.com/de/articles/551288-rechnungen-peppol-vorlage-fuer-verkaufsrechnungen-und-gutschriften
locale: de
updated: 2026-04-08
---

# Rechnungen – Peppol-Vorlage für Verkaufsrechnungen und Gutschriften

Diese Anleitung beschreibt, wie eine Vorlage für Verkaufsrechnungen oder Verkaufsgutschriften erstellt wird, die den Peppol-Feldanforderungen entspricht, wenn benutzerdefinierte Daten gesendet werden. Damit Rechnungen und Gutschriften verarbeitet werden können, müssen Standard- und benutzerdefinierte Felder korrekt den Feldern zugeordnet werden, die der Peppol-Zugangspunkt unterstützt. Das Mapping auf diese Felder ist entscheidend, um sicherzustellen, dass Rechnungen korrekt übermittelt und mit den erwarteten Daten verarbeitet werden.

Die Standard-Rechnungsvorlage ist bereits so zugeordnet, dass sie die Peppol-Anforderungen an Rechnungen erfüllt. Gibt es keine zusätzlichen Anforderungen, wird die Standard-Rechnungsvorlage verwendet. Sollen Daten auch in der Standard-Rechnungsvorlage erscheinen, muss die Hauptvorlage für Rechnungen bzw. Gutschriften aktualisiert werden.

:::callout{tone="info"}
**📚 Dies gilt sowohl für Verkaufsrechnungen als auch für Verkaufsgutschriften.**

Für Unterstützung bei der Konfiguration einer Rechnung oder Gutschrift steht der zuständige Qargo Account Manager zur Verfügung.
:::

## Vorlage konfigurieren {#h_8d3b7917c0}

Es gibt 2 Wege, die **Integrationsvorlagen** aufzurufen:

1.  **Konfiguration > Aufgaben**

    1.  Das Menü für Rechnungen bzw. Gutschriften auswählen
    2.  Die Aufgabe **Senden** öffnen
    3.  Zum Abschnitt „Kontakt“ scrollen und auf **Integrationsvorlage** klicken
2.  **Konfiguration > Vorlagen**

    1.  Im Seitenmenü **Integrationsvorlagen** auswählen
    2.  Die Aufgabe **Senden** öffnen (Verkaufsrechnung bzw. Gutschrift)
    3.  Auf die Integrationsvorlage klicken und sie aktualisieren

::video{src="/media/video/15d84bc2ee4c-2026-02-12_18-57-20-1-.mp4"}

Der Bildschirm zur Vorlagenkonfiguration ist in 2 Bereiche unterteilt.

-   **Vorlagen-Strings konfigurieren** (links): Hier werden die Kopf- oder Positionsfelder ausgewählt, die aktualisiert und in der Vorlage verwendet werden sollen.
-   **Daten visualisieren** (rechts): Hier werden Daten anhand von Live-Beispielen in der Vorschau angezeigt, um zu validieren, dass die Datenfelder korrekt sind.

1.  **Zusätzliche Felder zuordnen**

    1.  Zusätzliche Feldschlüssel für benutzerdefinierte Referenzen oder Beschreibungen festlegen.
    2.  Anpassen, ob diese als Positionen, im Kopfbereich oder an anderer Stelle erscheinen.

    ![](https://help.qargo.com/media/43d651bfc0fe-image.png)

2.  Text überschreiben oder Daten aus bestimmten Feldern übernehmen

    1.  Bei einer Textüberschreibung erscheint der Text in der XML-Datei, wird aber nicht in das Rechnungsformat übernommen, wenn er nicht zur Standard-Rechnungsvorlage hinzugefügt wird.
    2.  Daten aus bestimmten Feldern über den Ausdruckseditor übernehmen.

    ![](https://help.qargo.com/media/a6f979da3d83-image.png)

3.  **Ergebnisse in der Vorschau prüfen**

    1.  Mit dem Vorlagen-Visualisierer eine Vorschau der Rechnung oder Gutschrift erzeugen.
    2.  Eine Rechnung oder Gutschrift für die Vorschau auswählen
    3.  Prüfen, ob alle erforderlichen Daten, einschließlich der benutzerdefinierten Felder, wie erwartet erscheinen.

    ![](https://help.qargo.com/media/a72daf475400-image.png)

4.  **Rechnung/Gutschrift senden und prüfen**

    1.  Den Workflow ausführen, um die Rechnung oder Gutschrift über Peppol zu senden.
    2.  Das gesendete Dokument und die zugehörige XML-Datei auf korrekt übernommene Daten prüfen.

    ![](https://help.qargo.com/media/8fdb00ed4bbc-image.png)

5.  **Bei Bedarf das Feld-Mapping heranziehen** - Die Peppol-Mapping-Dokumentation heranziehen, um zu validieren, dass die Qargo-Datenfelder korrekt auf die Peppol-Anforderungen abgestimmt sind.

    1.  Details zum Mapping enthält die Tabelle unten.


### Weitere Anwendungsbeispiele {#h_67045016fc}

-   Senden einer Verkaufsrechnung mit einer vom Kunden vorgegebenen Bestellnummer (PO), die automatisch aus dem Referenzfeld des Auftrags in die Peppol-Kopfdaten übernommen wird.
-   Erstellen einer Gutschrift mit einem benutzerdefinierten Feld für den „Grund der Gutschrift“, das sowohl im PDF als auch in der XML-Datei als Kopf- oder Positionsnotiz enthalten ist.
-   Überschreiben der Standard-Positionsbeschreibungen, um für jede Gebühr einen ausführlicheren Text bereitzustellen. So ist das Detail sowohl in der druckbaren Rechnung als auch in der an den Kunden übermittelten Peppol-XML-Datei enthalten.
-   Aufnahme der Bestellnummer des Käufers (BT-10) in Peppol-Rechnungen, indem die Bestellreferenz (Purchase Order) dem Feld für die Bestellnummer des Käufers zugeordnet wird.

Mit dieser Einrichtung lassen sich Rechnungen und Gutschriften flexibel erstellen, um die Anforderungen von Partnern, Behörden und dem operativen Betrieb bei der Nutzung der Peppol-Integration von Qargo zu erfüllen. Felder können dynamisch aus den Auftragsdaten bezogen oder manuell in der Vorlage angepasst werden. Die Mapping-Tabellen sollten regelmäßig geprüft werden, um die Einhaltung der aktuellen Anforderungen des Peppol-Schemas sicherzustellen.\
Für eine optimale Anpassung von Peppol-Rechnungen empfiehlt es sich, stets die Einhaltung der Standards zu prüfen, Änderungen mit dem Visualisierer in der Vorschau anzuzeigen und klare Namenskonventionen für benutzerdefinierte Felder zu verwenden.

:::callout{tone="info"}
🎥 Das kurze Übersichtsvideo unten👇 zeigt, wie sowohl die Standard-Rechnungsvorlage als auch Integrationsvorlagen aktualisiert werden.
:::

[![](https://help.qargo.com/media/a36e553a7c35-image.png)](https://rousing-seal.clueso.site/share/d0e650e3-cd81-4dd0-8d0d-3b457e01057d)

* * *

### Strukturierte Zahlungsreferenz (OGM) für belgische Kunden {#h_99de3a3564}

Belgische Kunden verlangen auf ihren Rechnungen in der Regel eine strukturierte Zahlungsreferenz, bekannt als **_OGM (Overschrijving Met Gestructureerde Mededeling oder gestructureerde mededeling_**). Dabei handelt es sich um eine standardisierte 12-stellige Referenz im Format \`+++000/3000/00081+++\`, die Banken und Buchhaltungssysteme nutzen, um Zahlungen automatisch Rechnungen zuzuordnen. Qargo kann diese Referenz automatisch erzeugen und in das **Feld \`header\_payment\_reference\` der Peppol-Rechnung** aufnehmen, passend zum Wert, der auf dem PDF gedruckt wird.

### OGM im Feld für die Zahlungsreferenz konfigurieren {#h_bb111feed8}

1\. Die Peppol-Integrationsvorlage **öffnen** (siehe _Vorlage konfigurieren_ oben).\
2\. Das Feld _\`header\_payment\_reference\`_ im Bereich _Vorlagen-Strings konfigurieren_ **suchen**.\
3\. Eine bedingte Logik **anwenden**, damit die OGM nur für belgische Kunden erzeugt wird:

:::callout{tone="info"}
🧰 **Wenn** \`root > Customer > Billing location > Country Code\` **ist gleich** \`BE\` **dann**: \`#{{generateOgm root.name}}\`\
**Sonst:** \`root > Name\` _(für nicht belgische Kunden wird der Rechnungsname als Fallback verwendet)_
:::

4\. Das Ergebnis im Bereich _Daten visualisieren_ in der **Vorschau** prüfen.

-   Eine belgische Rechnung auswählen, um zu prüfen, ob die OGM-Referenz erscheint (z. B. \`+++260/3410/00000+++\`), und eine nicht belgische Rechnung, um den Fallback zu prüfen.

5\. Die Vorlage **speichern**.

![](https://help.qargo.com/media/d80b759cb5ea-image.png)

:::callout{tone="info"}
📚 Dieselbe Variable \`#{{generateOgm name}}\` kann auch in die Standard-PDF-Rechnungsvorlage eingefügt werden, um die OGM direkt auf dem Rechnungsdokument zu drucken.
:::

## Fehlerbehebung {#h_ca5cb2d5ca}

**F. Die Kundenrechnung zeigt nach dem Übermitteln falsche Datenfelder an.**\
A. Vorlagen für Verkaufsrechnungen und Gutschriften lassen sich so ändern, dass sie bestimmte Daten enthalten. Kommen die Rechnungsdaten falsch an, müssen Nutzer die XML-Datei prüfen und feststellen, in welchem Feld die Daten in der XML-Datei gesendet werden. In diesen Fällen müssen die Felder den anerkannten Peppol-Feldern zugeordnet werden.

**F. Wie lassen sich Fehler wegen ungültiger Datenformate beheben?**\
A. Die Peppol-Konformitätsstandards für Feldtypen erneut prüfen, z. B. ob die Bestellnummern des Käufers ausschließlich numerische Daten enthalten.

**F. Die strukturierte OGM-Referenz erscheint bei belgischen Kunden nicht in der Peppol-Rechnung.**\
**A. Prüfen, ob _\`#{{generateOgm root.name}}\`_ im Feld \`_header\_payment\_reference\`_ der Integrationsvorlage konfiguriert ist, mit einer Bedingung, die prüft, ob der Ländercode der Rechnungsadresse \`BE\` ist.** Die XML-Datei einer gesendeten Rechnung prüfen, um sicherzustellen, dass der Wert im Feld \`header\_payment\_reference\` vorhanden ist.

**F. Warum erscheinen Felder aus der Vorlage nicht in der Vorschau?**\
A. Sicherstellen, dass das Feld in der Vorlage korrekt zugeordnet ist und zum Datensatz der Beispielrechnung passt. Die Tabelle unten zeigt den Qargo-Feldnamen und die entsprechende Peppol-Referenz. Die **über die Originalrechnung (XML) gesendeten Daten lassen sich validieren**.

:::callout{tone="note"}
‼️ Rechnungen müssen erzeugt und an Peppol gesendet worden sein, damit die XML-Datei zur Prüfung verfügbar ist.
:::

1.  **Rechnungen > Rechnungen** aufrufen und die Rechnung auswählen
2.  Die XML-Datei prüfen, um die betreffenden Daten zu finden

    ![](https://help.qargo.com/media/90a7e17d4e9f-image.png)

3.  Die Datenbezeichnung prüfen, die dem gesendeten Feld zugeordnet ist.

    1.  Anhand der **Tabelle unten** das zu aktualisierende Feld bestätigen
4.  Muss das Feld aktualisiert werden, den obigen Schritten folgen, um die Integrationsvorlage in der Aufgabe _**An Peppol senden**_ zu konfigurieren.

:::callout{tone="info"}
**📚 Diese Funktion gilt sowohl für Verkaufsrechnungen als auch für Gutschriften.**

Für Unterstützung bei der Konfiguration einer Rechnung oder Gutschrift steht der zuständige Qargo Account Manager zur Verfügung.
:::

**Mapping der Vorlageninformationen auf das B2B-Format**

| **Ebene** | **Feldname** | **Peppol-Referenz** | **Pfad der Peppol-XML-Referenz** |
| --- | --- | --- | --- |
| Kopf | Header\_Customer\_Reference | BT-10 | cbc:BuyerReference |
| Kopf | Header\_PO\_Reference | BT-13 | cac:OrderReference |
| Kopf | Header\_Payment\_Reference | BT-14 | cac:OrderReference > cbc:SalesOrderID |
| Kopf | Header\_Note | BT-22 | cbc:Note |
| Position | Line\_Description | BT-153 | cac:InvoiceLine > cac:Item > cbc:Name |
| Position | Line\_Additional\_Field\_\<n>\_Key | BT-160 | cac:InvoiceLine > cac:Item > cac:AdditionalItemProperty > cbc:Name |
| Position | Line\_Additional\_Field\_\<n>\_Value | BT-161 | cac:InvoiceLine > cac:Item > cac:AdditionalItemProperty > cbc:Value |
| Position | Line\_Additional\_Field\_\<n>\_Key\_Without\_Order | BT-160 | cac:InvoiceLine > cac:Item > cac:AdditionalItemProperty > cbc:Name |
| Position | Line\_Additional\_Field\_\<n>\_Value\_Without\_Order | BT-161 | cac:InvoiceLine > cac:Item > cac:AdditionalItemProperty > cbc:Value |
| Position | Line\_Description\_Without\_Order | BT-153 | cac:InvoiceLine > cac:Item > cbc:Name |


## Verwandte Artikel

- [Rechnungen – Ausgangsrechnung über Peppol verarbeiten](https://help.qargo.com/de/articles/526693-rechnungen-ausgangsrechnung-ueber-peppol-verarbeiten.md)
- [Rechnungen – Einkaufsrechnung über Peppol verarbeiten](https://help.qargo.com/de/articles/523845-rechnungen-einkaufsrechnung-ueber-peppol-verarbeiten.md)
- [Integrationen – E-Rechnungsstellung](https://help.qargo.com/de/articles/430047-integrationen-e-rechnungsstellung.md)
- [Dokumentvorlagen: was, warum und wie](https://help.qargo.com/de/articles/246339-dokumentvorlagen-was-warum-und-wie.md)
- [FAQ – Fragen zu Peppol](https://help.qargo.com/de/articles/430054-faq-fragen-zu-peppol.md)
