Facturen: verkoopfactuur verwerken via Peppol
Peppol-verkoopfacturen configureren en verzenden in Qargo: module-instelling, profielconfiguratie, selectie van documentbijlagen, factuurworkflow en probleemoplossing.
Inhoudsopgave
- Inleiding
- Moduleconfiguratie (alleen Qargo admin)
- Taak configureren
- Documentbijlagen voor Peppol configureren
- Stappen om te controleren of de CMR-bijlage is meegestuurd
- Een bedrijfsprofiel configureren om facturen te verzenden
- Aanbevelingen voor ontvangers
- Probleemoplossing
- Problemen met het bekijken van bijlagen bij Peppol-facturen
- Fout: de ontvanger aanvaardt geen Peppol-facturen
Inleiding
Dit artikel legt uit hoe de Peppol-integratie in Qargo wordt geconfigureerd en gebruikt: van de eerste module-instelling en de profielconfiguratie tot het verwerken en verzenden van facturen en het oplossen van problemen met e-facturen. Het is bedoeld voor Qargo admin- en super admin-gebruikers en biedt stapsgewijze instructies om ervoor te zorgen dat facturen correct worden verwerkt en verzonden.
Moduleconfiguratie (alleen Qargo admin)
De integratie inschakelen onder Configuratie > Integraties
- De optie ‘Inkomende facturen synchroniseren’ aanzetten met de toggle.
- De optie ‘Peppol-informatie van klanten synchroniseren’ aanzetten met de toggle. Qargo doorzoekt dan automatisch de Peppol-database en werkt de velden in het profiel bij.
- B2BRouter: het automatisch aanmaken en bijwerken van facturen en het automatisch doorsturen in- of uitschakelen. Als dit is uitgeschakeld, moet de gebruiker de factuur nog steeds goedkeuren, ook als de routeringsmapping een ander resultaat dan ‘manuele controle’ gaf.

-
Na het inschakelen verschijnen nieuwe velden in de profielen van bedrijven en onderaannemers:
- Peppol-identificatie overschrijven (nummer)
- Peppol-identificatie gevonden (toggle)
- Peppol ontvangen (keuzelijst)
- Peppol verzenden (keuzelijst)
-
Als de nieuwe velden niet meteen verschijnen, naar Configuratie > Extra velden gaan en de Peppol-instellingen inschakelen bij de opties voor Klant/onderaannemer.
Taak configureren
Zodra de Peppol-integratie is ingeschakeld, zou de taak ‘Verzenden naar Peppol’ automatisch moeten zijn toegevoegd.

Documentbijlagen voor Peppol configureren
Configureren welke documenttypes automatisch worden bijgevoegd bij het verzenden van facturen via Peppol, rechtstreeks vanuit de interface voor taakconfiguratie, zonder parameters manueel te moeten bewerken.
Ondersteunde types bijlagen zijn:
- bewijs van levering
- factuur
- creditnota
- andere orderdocumenten. CMR-documenten moeten voor Peppol-facturatie in PDF-formaat zijn om te kunnen worden meegestuurd. Documenten die zijn opgeslagen in de sectie Communicatie van de factuur worden niet als Peppol-bijlage meegestuurd, ook niet als ze het label “CMR” hebben.
Documentbijlagen configureren op taakniveau (super admin)
- Navigeren naar Configuratie > Taken.
- Selecteren van Verzenden naar Peppol in de takenlijst Facturen.
- Openen van het paneel Contact in de taakconfiguratie.
- Selecteren van de bij te voegen documenttypes in de velden voor de configuratie van bijlagen. Qargo stelt automatisch relevante documenttypes voor op basis van de types die al voor de taak zijn geconfigureerd.
- Opslaan van de configuratie.

Na de configuratie worden de geselecteerde documenttypes automatisch meegestuurd telkens wanneer de taak wordt uitgevoerd. Parameters manueel invoeren is niet nodig.
Documentbijlagen per bedrijf overschrijven
Als een specifieke klant bepaalde documenttypes niet hoeft te ontvangen (bijvoorbeeld een klant die geen bewijs van levering nodig heeft), kan de configuratie van bijlagen op bedrijfsniveau worden overschreven.
Bijlagen op bedrijfsniveau overschrijven
- Navigeren naar het bedrijfsprofiel.
- Scrollen naar de sectie Taken en de taken Factuur aanmaken openklappen.
- Selecteren van de taak Verzenden naar Peppol.
- Aanzetten van de toggle Overschrijven voor dit bedrijf.
- Selecteren van de documenttypes die voor dit bedrijf moeten worden mee- of uitgesloten, via de velden voor de configuratie van bijlagen.
- Opslaan van de overschrijving.

Bijlagen manueel selecteren bij starten vanuit de interface
Wanneer een Peppol-integratieactie rechtstreeks vanuit de interface wordt gestart (in plaats van via de automatische uitvoering van taken), verschijnt een venster om bijlagen te selecteren, vergelijkbaar met de bestaande werkwijze van de e-mailcontacttaak.
Bijlagen manueel selecteren
- Starten van de integratieactie vanuit de betreffende factuur of het betreffende document.
- Controleren van de bijlage-interface die verschijnt, met de documenttypes die op basis van de taakconfiguratie worden voorgesteld.
- Selecteren of deselecteren van documenttypes, naar wens voor deze specifieke verzending.
- Bevestigen om te verzenden.
Beperkingen
| Beperking | Details |
|---|---|
| Alleen PDF | Het Peppol-toegangspunt van Qargo ondersteunt alleen PDF-bijlagen. Andere bestanden dan PDF, zoals afbeeldingen, worden niet verzonden, ook niet als ze zijn geselecteerd. |
| Bestandsgrootte | De totale bestandsgrootte (factuur + alle bijlagen) mag niet meer dan 100 MB bedragen. Te grote verzendingen mislukken. |
| Opt-in van de ontvanger vereist | Ontvangers moeten zich hebben aangemeld (opt-in) om de specifieke bijgevoegde documenttypes te ontvangen. Als de ontvanger een documenttype niet ondersteunt, mislukt de factuur. Contact opnemen met de Peppol-provider van de ontvanger om de opt-in-instellingen voor documenten te laten controleren. |
!!️ Als er bij de taak ‘Verzenden naar Peppol’ een ‘Vereist document’ (CMR/POD) is opgenomen, is minstens één document (CMR/POD of een ander orderdocument) per order vereist. Facturen met meerdere orders mislukken als bij een van de orders een vereist document ontbreekt.
Stappen om te controleren of de CMR-bijlage is meegestuurd
Om na te gaan of een CMR-document met een Peppol-factuur is meegestuurd, de volgende stappen volgen:
- Het UBL XML-bestand van de factuur openen.
- Naar de sectie
Invoice/cac:AdditionalDocumentReferencegaan. - In het element
cbc:IDcontroleren of de bestandsnaam van de CMR (documentnaam) vermeld staat. Als de bestandsnaam van de CMR in de sectieAdditionalDocumentReferencevoorkomt, is de bijlage meegestuurd. Als er geen bijlagen vermeld staan, is het CMR-document niet verzonden.
Een bedrijfsprofiel configureren om facturen te verzenden
Om facturen succesvol via het Peppol-netwerk te verzenden, moeten in de bedrijfsprofielen die aan de verkoopfactuur of verkoopcreditnota zijn gekoppeld, enkele velden zijn geconfigureerd.
-
Ervoor zorgen dat bij het bedrijf dat aan de verkoopfactuur of verkoopcreditnota is gekoppeld, een van de relevante velden is ingevuld.

-
Ondernemingsnummer als het bedrijf met deze identificatie op het Peppol-netwerk is geregistreerd
-
Btw-nummer als het bedrijf met deze identificatie op het Peppol-netwerk is geregistreerd
-
Peppol-identificatie overschrijven kan worden gebruikt als de Peppol-identificatie niet op het btw-nummer of ondernemingsnummer is gebaseerd, of als het om een niet-Belgische identificatie gaat.
- De identificatie heeft het formaat
<scheme>:<identifier; dit moeten een geldig Peppol-schema en een geldige Peppol-identificatie zijn.
Meer informatie via deze link
- De identificatie heeft het formaat
-
-
Zodra de integratie actief is, doorzoekt Qargo automatisch de Peppol-database en werkt het de gegevensvelden bij:
-
Peppol-identificatie gevonden (toggle)
-
Peppol-instellingen = Toegestaan/Niet toegestaan
- Toegestaan - Het bedrijf kan documenten verzenden en ontvangen via de Peppol-integratie. Het systeem gebruikt de Peppol-ID en stuurt facturen en creditnota’s via het Peppol-netwerk. Een geldige Peppol-ontvangers-ID is vereist.
- Niet toegestaan - Het bedrijf wordt niet als ‘Peppol-enabled’ beschouwd. Het systeem blokkeert levering via Peppol en valt terug op de standaardmethode (e-mail, portaal of een ander e-facturatieformaat). Verhindert verzending via Peppol, ook als er een ID aanwezig is
-
-
Zodra de hoofdsynchronisatie voltooid is, worden nieuwe bedrijven bijgewerkt bij de volgende dagelijkse synchronisatie met de Peppol-database.
-
Om facturen meteen te verwerken, kunnen gebruikers de velden manueel bijwerken.
- Peppol-identificatie gevonden: toggle op aan zetten.
- Instelling ‘Peppol ontvangen’ = Toegestaan
- Peppol-identificatie (nummer): dit veld is een overschrijvingsveld en moet leeg blijven, tenzij het bedrijf een alternatieve identificatie gebruikt, bijvoorbeeld een DUNS-nummer. Qargo doorzoekt de Peppol-database automatisch op de bijbehorende identificatie.
- Peppol-identificatie gevonden (toggle): de toggle op aan zetten zodat facturen worden ontvangen. Qargo stelt dit automatisch in bij de synchronisatie en bevestigt daarmee dat de Peppol-registratie van het bedrijf geldig en actief is.
- Instellingen Peppol verzenden (keuzelijst): instellen op Toegestaan; hiermee mag dit bedrijf facturen verzenden naar Qargo. Qargo stelt dit automatisch in bij de synchronisatie.
- Peppol ontvangen (keuzelijst): instellen op Toegestaan; hiermee mag dit bedrijf facturen ontvangen die via Qargo worden verzonden. Qargo stelt dit automatisch in bij de synchronisatie.
Aangepaste opties
-
Aanpassingsmogelijkheden zijn onder meer het toevoegen van:
- Klantreferentienummers (extra veld, activering vereist)
- Inkoopordernummers (extra veld, activering vereist)
- Documentbijlagen (bewijs van levering, CMR, creditnota en andere documenttypes)
Aanbevelingen voor ontvangers
Om Peppol-facturen vlot te verwerken en veelvoorkomende problemen te vermijden:
- Peppol-ontvangst activeren: bevestigen dat de Peppol-provider van de ontvanger de ontvangst van facturen heeft ingeschakeld.
- Correct configureren: de Peppol-instellingen in zowel de eigen tool als in Qargo regelmatig controleren om de compatibiliteit te garanderen.
- Tools valideren: een actuele en volledig werkende Peppol-oplossing gebruiken om facturen en bijlagen correct weer te geven. Met deze goede praktijken nemen fouten en verstoringen bij de uitwisseling van facturen sterk af.
Workflow voor verkoopfacturen
Met de workflow voor verkoopfacturen kunnen facturen via het Peppol-netwerk worden verzonden met de volgende stappen:
-
Factuur aanmaken: de verkoopfactuur in Qargo aanmaken volgens het bestaande bedrijfsproces.
- Pdf van de factuur genereren
-
Factuur boeken: taak Factuur boeken als onderdeel van de factuurworkflow
- Opmerking: de taak ‘Verzenden naar boekhouding’ moet voltooid zijn voordat de factuur of creditnota naar Peppol kan worden verzonden.
- De factuur moet de status Geboekt hebben in de boekhouding voordat ze naar Peppol wordt verzonden.
- Een vaste controle in het systeem gaat na of dit gebeurt.
-
Indienen bij Peppol: de factuur bij Peppol indienen met de taak ‘Verzenden naar Peppol’

• De gewone taak ‘Factuur verzenden’ gebruiken om een proformafactuur te genereren en ter goedkeuring te verzenden, voordat de taak ‘Verzenden naar Peppol’ wordt voltooid.

Probleemoplossing
Qargo gebruikt dezelfde verwerking van foutmeldingen voor Peppol-facturen.
-
Naar het overzicht Fouten gaan door op het pictogram rechtsboven te klikken
-
De filter op de kolom Naam gebruiken om specifiek op een taaktype te filteren
- Tip: ‘peppol’ in het zoekveld typen om de bijbehorende taken te zien

- De fout corrigeren op basis van de melding en de taak opnieuw uitvoeren
Algemene eerste stap bij elke probleemoplossing:
Controleren of alle juiste Peppol-velden in het bedrijfsprofiel zijn ingeschakeld:
- Peppol-identificatie gevonden: toggle staat aan
- Instellingen Peppol verzenden/ontvangen: ingesteld op Toegestaan

Peppol mislukt voor niet-Belgisch bedrijf. Bij het gebruik van snelle acties en het bijwerken van facturen in bulk worden bedrijven buiten België overgeslagen, omdat voor deze bedrijven niet dezelfde Peppol-vereisten gelden.
Oplossing: de reeks records bekijken die in bulk worden bijgewerkt en nagaan welke bedrijven of onderaannemers niet Belgisch zijn. De factuur manueel verzenden met de taak ‘Factuur verzenden’.
Factuur niet geboekt. De factuur heeft in de boekhoudsoftware nog niet de status Geboekt, waardoor de taak ‘Verzenden naar Peppol’ niet succesvol is voltooid.
Oplossing: de status van de factuur bijwerken naar Geboekt en de taak opnieuw uitvoeren.
Bedrijf aanvaardt geen facturen. Het profiel van het bedrijf of de onderaannemer is niet ingeschakeld voor Peppol, en/of de Peppol-instellingen zijn niet bijgewerkt of staan op Niet toegestaan.
Oplossing: het profiel van het bedrijf en/of de onderaannemer controleren. Bij de algemene informatie ervoor zorgen dat de Peppol-instellingen op Toegestaan staan en dat de toggle Peppol-identificatie gevonden aan staat. Fout: facturen ingesteld op ‘Peppol ontvangen – niet toegestaan’ Deze fout geeft aan dat de ontvanger is geconfigureerd om de ontvangst van Peppol-facturen te blokkeren. Om dit op te lossen:
- De Peppol-instellingen in het profiel van de ontvanger aanpassen: ‘Peppol ontvangen’ op ‘Toegestaan’ zetten.
- De facturen opnieuw verzenden met de functie ‘Verzenden naar Peppol’ in Qargo.
Factuur met bijlagen mislukt. Bij de Peppol-registratie melden bedrijven zich aan (opt-in) om specifieke documenttypes te ontvangen, bv. CMR/POD, enz. Als er een niet-ondersteund document bij de factuur zit, mislukt de factuur. Er geldt ook een beperking op de bestandsgrootte: max. 100 MB wordt aanbevolen. Als een CMR-document niet met een Peppol-factuur is meegeleverd, kan het probleem met het bestandstype te maken hebben. Peppol ondersteunt alleen PDF-bijlagen. Afbeeldingsbestanden, zoals JPEG’s, worden niet meegestuurd en niet automatisch geconverteerd. Om de levering te garanderen:
- Het CMR-document als PDF opslaan of exporteren.
- De PDF-versie vóór het verzenden aan de factuur toevoegen.
Oplossing:
- Controleren of de bestandsgrootte van de factuur en de ingesloten bijlagen samen kleiner is dan 100 MB.
- Contact opnemen met het bedrijf en een Peppol-controle vragen. Het bedrijf aanraden de Peppol-instelling ‘document opt-in’ te controleren en het specifieke documenttype in te schakelen. Na het inschakelen de taak ‘Verzenden naar Peppol’ opnieuw uitvoeren.
Als de taak eerder de JSON-parameter include_cmr gebruikte en nu onverwacht mislukt, controleren of de configuratie van bijlagen correct is gemigreerd in Configuratie > Taken > Verzenden naar Peppol. Contact opnemen met Qargo support als de configuratie na de migratie leeg of onjuist lijkt.
Problemen met het bekijken van bijlagen bij Peppol-facturen
Peppol-facturen zijn XML-bestanden die bijlagen kunnen bevatten. Als een ontvanger meldt dat de bijlagen niet zichtbaar zijn, ligt het probleem waarschijnlijk aan de kant van de ontvanger. Bijlagen bij Peppol-facturen moeten worden geopend en weergegeven met de tool of interface van de Peppol-provider van de ontvanger. Om problemen met de zichtbaarheid op te lossen:
- Ontvangers gebruiken best de functies van hun Peppol-oplossing om de bijlagen in de XML-bestanden te vinden en te bekijken.
- Als de bijlagen nog steeds niet te bekijken zijn, raadpleegt de ontvanger best de documentatie of de supportkanalen van de eigen Peppol-provider voor verdere hulp.
Fout: de ontvanger aanvaardt geen Peppol-facturen
Deze fout geeft aan dat de Peppol-deelnemersconfiguratie van de ontvanger niet is ingesteld om facturen te ontvangen, of dat de ontvangst niet is geactiveerd. Deze instelling wordt beheerd door de Peppol-provider of het toegangspunt van de ontvanger. Wat er moet gebeuren:
- De ontvanger moet de ontvangst van Peppol-facturen inschakelen in de interface van de eigen Peppol-provider. Zonder activering kan de ontvanger de factuur niet aanvaarden, ook niet als ze correct vanuit Qargo is verzonden.
