Skip to main content
Qargo

Facturen - Peppol-sjabloon voor verkoopfacturen en creditnota's

Peppol-klare sjablonen voor facturen en creditnota's vereisen een correcte mapping van velden (standaard + aangepast) naar Peppol-gegevensvelden, met live preview, personalisatie en verificatie vóór verzending.

Inhoudsopgave
  1. Sjabloon configureren
  2. Probleemoplossing

Deze handleiding helpt bij het aanmaken van een sjabloon voor verkoopfacturen of verkoopcreditnota’s dat voldoet aan de Peppol-veldvereisten bij het verzenden van aangepaste gegevens. Om facturen en creditnota’s te verwerken, moeten standaard- en aangepaste velden correct gemapt worden naar de velden die het Peppol-toegangspunt ondersteunt. Deze mapping is cruciaal om ervoor te zorgen dat facturen correct worden verzonden en met de verwachte gegevens kunnen worden verwerkt.

Het standaard factuursjabloon is al gemapt volgens de Peppol-factuurvereisten. Als er geen extra vereisten zijn, wordt het standaard factuursjabloon gebruikt. Als gegevens ook in het standaard factuursjabloon moeten verschijnen, moet het hoofdsjabloon voor facturen/creditnota’s worden bijgewerkt.

Sjabloon configureren

Er zijn 2 manieren om de integratiesjablonen te openen

  1. Configuratie > Taken

    1. Het menu voor facturen/creditnota’s selecteren
    2. De taak “Verzenden” openen
    3. Naar de sectie Contact scrollen en op “Integratiesjabloon” klikken
  2. Configuratie > Sjablonen

    1. “Integratiesjablonen” selecteren in het zijmenu
    2. De taak “Verzenden” openen (verkoopfactuur/creditnota)
    3. Op het integratiesjabloon klikken en het bijwerken

Het configuratiescherm van het sjabloon bestaat uit 2 panelen.

  • “Sjabloonstrings configureren” (links) om de header- of regelvelden te selecteren die moeten worden bijgewerkt en in het sjabloon gebruikt
  • “Gegevens visualiseren” (rechts) om gegevens in een preview te bekijken met live voorbeelden, om te valideren dat de gegevensvelden correct zijn.
  1. Extra velden mappen

    1. Extra veldsleutels opgeven voor aangepaste referenties of omschrijvingen.
    2. Personaliseren of deze als regelitems, in headers of elders verschijnen.

  2. Tekst overschrijven of gegevens uit specifieke velden ophalen

    1. Bij het overschrijven van tekst verschijnt de tekst in het xml-bestand, maar niet in de factuuropmaak als die tekst niet aan het standaard factuursjabloon is toegevoegd
    2. Gegevens uit specifieke velden ophalen met de expressiebouwer.

  3. Preview van de resultaten bekijken

    1. Een preview van de factuur of creditnota genereren met de sjabloonvisualisatie.
    2. Een factuur of creditnota selecteren voor de preview
    3. Bevestigen dat alle vereiste gegevens, inclusief aangepaste velden, zoals verwacht verschijnen.

  4. Factuur/creditnota verzenden en controleren

    1. De workflow uitvoeren om de factuur of creditnota via Peppol te verzenden.
    2. Het verzonden document en de bijbehorende XML controleren op correcte gegevens.

  5. Veldmapping raadplegen indien nodig - De Peppol-mappingdocumentatie raadplegen om te valideren dat de Qargo-gegevensvelden correct overeenkomen met de Peppol-vereisten.

    1. Zie de tabel hieronder voor de mappingdetails.

Extra voorbeelden van use cases

  • Een verkoopfactuur verzenden met een door de klant opgegeven PO-nummer, dat automatisch vanuit het referentieveld van het order naar de Peppol-headergegevens wordt gemapt.
  • Een creditnota aanmaken met een aangepast veld voor “reden van creditering”, dat als header- of regelnotitie in zowel de PDF als de XML wordt opgenomen.
  • Standaard regelomschrijvingen overschrijven om per kost een meer gedetailleerde omschrijving te geven, zodat het detail zowel in de printbare factuur als in de Peppol-XML staat die naar de klant wordt verzonden.
  • Het Buyer Order Number (BT-10) opnemen in Peppol-facturen door de referentie van de inkooporder te mappen naar het veld Buyer Order Number.

Deze opzet maakt een flexibele aanmaak van facturen en creditnota’s mogelijk, afgestemd op de behoeften van partners, regelgeving en operaties bij gebruik van de Peppol-integratie van Qargo. Velden kunnen dynamisch uit ordergegevens worden gehaald of manueel in het sjabloon worden gepersonaliseerd. De mappingtabellen regelmatig nakijken om te blijven voldoen aan de actuele vereisten van het Peppol-schema.
Voor een optimale personalisatie van Peppol-facturen altijd de naleving van de standaarden controleren, de visualisatie gebruiken om wijzigingen in een preview te bekijken en duidelijke naamgevingsconventies voor aangepaste velden toepassen.


Gestructureerde betalingsreferentie (OGM) voor Belgische klanten

Belgische klanten vereisen op hun facturen doorgaans een gestructureerde betalingsreferentie, de zogenaamde OGM (Overschrijving Met Gestructureerde Mededeling, of gestructureerde mededeling). Dit is een gestandaardiseerde referentie van 12 cijfers in het formaat `+++000/3000/00081+++`, die banken en boekhoudsystemen gebruiken om betalingen automatisch aan facturen te koppelen. Qargo kan deze referentie automatisch genereren en opnemen in het veld `header_payment_reference` van de Peppol-factuur, met dezelfde waarde als op de PDF.

OGM configureren in het veld voor de betalingsreferentie

1. Het Peppol-integratiesjabloon openen (zie Sjabloon configureren hierboven).
2. Het veld `header_payment_reference` zoeken in het paneel Sjabloonstrings configureren.
3. Voorwaardelijke logica toepassen, zodat de OGM alleen voor Belgische klanten wordt gegenereerd:

4. Het resultaat in een preview bekijken via het paneel Gegevens visualiseren.

  • Een Belgische factuur selecteren om te bevestigen dat de OGM-referentie verschijnt (bv. `+++260/3410/00000+++`), en een niet-Belgische factuur om de terugvalwaarde te bevestigen.

5. Het sjabloon opslaan.

Probleemoplossing

V. De klantfactuur toont na verzending de verkeerde gegevensvelden.
A. Sjablonen voor verkoopfacturen en creditnota’s kunnen worden aangepast om specifieke gegevens op te nemen. Als de factuurgegevens verkeerd worden ontvangen, moeten gebruikers het xml-bestand controleren en nagaan in welk veld van het xml-bestand de gegevens worden verzonden. In dat geval moeten de velden naar de herkende Peppol-velden worden gemapt.

V. Hoe worden fouten door een ongeldig gegevensformaat opgelost?
A. De Peppol-nalevingsstandaarden voor veldtypes opnieuw nakijken, bijvoorbeeld om te controleren dat Buyer Order Numbers alleen numerieke gegevens bevatten.

V. De gestructureerde OGM-referentie verschijnt niet in de Peppol-factuur voor Belgische klanten.
A. Controleren of `#{{generateOgm root.name}}` is geconfigureerd in het veld `header_payment_reference` van het integratiesjabloon, met een voorwaarde die controleert of de landcode van de facturatie gelijk is aan `BE`. Het XML-bestand van een verzonden factuur nakijken om te verifiëren dat de waarde in het veld `header_payment_reference` staat.

V. Waarom verschijnen velden uit het sjabloon niet in de preview?
A. Controleren of het veld correct in het sjabloon is gemapt en overeenkomt met de dataset van de voorbeeldfactuur. De tabel hieronder toont de Qargo-veldnaam en de bijbehorende Peppol-referentie. Het is mogelijk om de verzonden gegevens te valideren via de originele factuur (xml).

  1. Naar Facturen > Facturen gaan en de factuur selecteren

  2. Het xml-bestand nakijken om de specifieke gegevens te vinden

  3. Het gegevenslabel verifiëren dat bij het verzonden veld hoort.

    1. De tabel hieronder raadplegen om te bevestigen welk veld moet worden bijgewerkt
  4. Als het veld moet worden bijgewerkt, de stappen hierboven volgen om het integratiesjabloon in de taak “Verzenden naar Peppol” te configureren.

Sjablooninfo mappen naar B2B-formaat

Niveau Veldnaam Peppol-referentie Pad van de Peppol-XML-referentie
Header Header_Customer_Reference BT-10 cbc:BuyerReference
Header Header_PO_Reference BT-13 cac:OrderReference
Header Header_Payment_Reference BT-14 cac:OrderReference > cbc:SalesOrderID
Header Header_Note BT-22 cbc:Note
Regel Line_Description BT-153 cac:InvoiceLine > cac:Item > cbc:Name
Regel Line_Additional_Field_<n>_Key BT-160 cac:InvoiceLine > cac:Item > cac:AdditionalItemProperty > cbc:Name
Regel Line_Additional_Field_<n>_Value BT-161 cac:InvoiceLine > cac:Item > cac:AdditionalItemProperty > cbc:Value
Regel Line_Additional_Field_<n>_Key_Without_Order BT-160 cac:InvoiceLine > cac:Item > cac:AdditionalItemProperty > cbc:Name
Regel Line_Additional_Field_<n>_Value_Without_Order BT-161 cac:InvoiceLine > cac:Item > cac:AdditionalItemProperty > cbc:Value
Regel Line_Description_Without_Order BT-153 cac:InvoiceLine > cac:Item > cbc:Name