Tijd voor de sandbox
Openingstijden
Controleer of alles goed werkt in uw eigen systemen en op het Peppol-testnetwerk.
Tijd om te lanceren
Dagen tot weken
Voer de lancering uit volgens uw integratie- en release -proces.
Beperking van het aantal verzoeken
Overeengekomen per partner
Capaciteit toegewezen per partner.
Rol van dienstverlener
Qvalia
Qvalia beheert het Access Point, SMP en het netwerkbeheer.
Technische ondersteuning
Derde regel
Qvalia biedt technische ondersteuning op het derde niveau.
Ontworpen voor
ERP-leveranciers · Facturatie- en boekhoudsoftware · CRM-systemen · VAN -exploitanten
B2B-marktplaatsen · Accountantskantoren · IT-adviesbureaus
Uw product, onze infrastructuur
Partners ontwikkelen en beheren de gebruikerservaring. Qvalia beheert het Access Point, het SMP en de bijbehorende berichteninfrastructuur, die via één API toegankelijk zijn.
U bepaalt zelf de klantervaring, de contractvoorwaarden en de prijsstelling. Qvalia verzorgt de Peppol-dienst achter uw interface.
Wat wij beheren, wat jij bezit
Wat Qvalia aanbiedt
- Access Point en SMP in de rol van Peppol-dienstverlener van Qvalia
- Validatie van berichten, formaatconversie en verzending via het netwerk
- Deelnemersregistratie en -opzoekfunctie
- Monitoring, updates en naleving van netwerkvoorschriften
Wat je bezit
- De interface die uw klanten gebruiken, binnen uw eigen product
- De klantrelatie, het contract en de prijsstelling
- Uw eigen onboarding- en ondersteuningsproces
Workflow van de Partner-API
De Partner API omvat systeemauthenticatie, klantconfiguratie, het indienen van documenten en de verwerking van inkomende berichten. Qvalia verzorgt het Peppol-transport, de zoekfunctie, de validatie en het certificaatbeheer.
1. Inloggen
Partnersystemen verifiëren zich met een API-sleutel of wisselen deze in voor een kortstondige JWT. Eén set inloggegevens is geldig voor de Transaction-, Partner-, Account- en Enrichment-API’s.
curl --location --globoff -X POST \
'https://api.qvalia.com/token' \
--data '{
"client_id": "{partnerRegNo}",
"client_secret": "{apiKey}"
}'
# Valid for one hour. Send it on every call:
# Authorization: Bearer <token>2. Maak de klant aan
Maak het account aan en registreer de Peppol-deelnemers-ID ervan. Qvalia beheert de registratie van deelnemers en de updates van de deelnemerslijst
curl --location --globoff -X POST \
'https://api.qvalia.com/partner/{partnerRegNo}/account' \
--header 'Authorization: Bearer <token>' \
--data '{
"accountRegNo": "5567321707",
"name": "Nordkap Logistik AB",
"address": "Wallingatan 33",
"postalCode": "111 24",
"country": "SE"
}'
curl --location --globoff -X PUT \
'https://api.qvalia.com/partner/{partnerRegNo}/account/5567321707/peppol/0007:5567321707' \
--header 'Authorization: Bearer <token>'3. Berichten verzenden en ontvangen
Documenten worden vóór verzending gecontroleerd aan de hand van de geldende Peppol-specificaties. Gestructureerde validatieresponsen worden teruggestuurd naar uw systeem en inkomende berichten zijn via hetzelfde account beschikbaar.
curl --location --globoff -X POST \
'https://api.qvalia.com/partner/{partnerRegNo}/transaction/5567321707/invoices/outgoing' \
--header 'Authorization: Bearer <token>' \
--data '{ "Invoice": { } }'
# 200
# { "status": "success", "data": { "message": "invoice 12335675 sent" } }4. Schrijf je in voor evenementen
Schrijf je in om documentgebeurtenissen via webhooks te volgen. Qvalia stuurt een melding naar je eindpunt wanneer er een document binnenkomt, wanneer de bezorgstatus verandert en wanneer de bezorging mislukt.
curl --location --globoff -X PUT \
'https://api.qvalia.com/partner/{partnerRegNo}/webhook/configure' \
--header 'Authorization: Bearer <token>' \
--data '{
"url": "https://your-platform.example/qvalia/events",
"events": ["new_document", "document_delivery", "document_error"]
}'
# Delivered as HTTPS POST with a JSON body.
# Respond 2xx within 10 seconds.| Specificatie | Details |
| Vervoer | Het Peppol AS4-verkeer, de ebMS-berichtenuitwisseling en het beheer van PKI-certificaten worden verzorgd door Qvalia. |
| Reactietijd | De responstijd van de API hangt af van de grootte van de payload en de verbinding. De verzending via Peppol verloopt asynchroon en is afhankelijk van het ontvangende toegangspunt. |
| Ingrijpende wijzigingen | Ingrijpende wijzigingen worden als nieuwe API-versie uitgebracht, met een aankondigingstermijn van ten minste één maand, meestal langer |
Accountmodellen voor meerdere gebruikers
Kies voor een geconsolideerde opzet of een afzonderlijke account per klant, afhankelijk van de vereisten op het gebied van registratie, gegevensscheiding en gebruikersbeheer.
| Geconsolideerd | Account per huurder | |
| Peppol-registratie | Gedeelde configuratie die door jou wordt beheerd | Eigen rekening en Peppol ID per eindklant |
| Gegevens en gebruikers | Samen beheerd op uw platform | Gegevens, gebruikers en instellingen per tenant gescheiden houden |
| Introductieprogramma | De snelste manier om een klant toe te voegen | De registratie van deelnemers en het bijwerken van het deelnemersoverzicht worden verzorgd door Qvalia |
| Pasvorm | Veel kleine klanten die gebruikmaken van één dienst die u aanbiedt | Klanten die een eigen Peppol-identiteit en audittrail nodig hebben |
In beide modellen bepaal je zelf hoe het onboardingproces verloopt. Het accountmodel bepaalt de registratie van deelnemers en de scheiding van gegevens.
Ondersteunde bedrijfsdocumenten
Deze integratie ondersteunt de beschikbare facturatie-, bestel- en aanverwante bedrijfsprocessen.
| Document | Peppol-naam | Details |
| Factuur | Factuur | Een betalingsverzoek, met specificatie van de posten, belastingen en betalingsvoorwaarden |
| Creditnota | CreditNote | Een correctie of herziening van een reeds verzonden factuur |
| Factuur op basis van zelfdeclaratie | Zelffactuur | Een factuur die de koper namens de leverancier opstelt |
| Kredietnota op basis van zelfdeclaratie | Zelfgefactureerde creditnota | De bijbehorende creditnota voor een zelf gefactureerde factuur |
| Bestelling | Bestelling | Een inkooporder van de afnemer aan de leverancier |
| Reactie op bestelling | OrderResponse | Aanvaarding, afwijzing of wijziging van een bestelling |
| Bestelovereenkomst | Bestelovereenkomst | Een raamovereenkomst waarnaar in latere bestellingen wordt verwezen |
| Wijziging van de bestelling | Wijziging bestelling | Een wijziging van een reeds verzonden opdracht |
| Annulering van een bestelling | Bestelling annuleren | Annulering van een reeds verzonden bestelling |
| Verzendbericht | Verzendadvies | Wat is er daadwerkelijk verzonden, op basis van welke bestelling? |
| Catalogus | Catalogus | Producten, beschrijvingen en overeengekomen prijzen |
| Reactie op de catalogus | Catalogusreactie | Goedkeuring of afwijzing van een catalogus |
| Reactie op berichtniveau | MessageLevelResponse | Technische bevestiging of afwijzing van een bericht |
| Status op berichtniveau | Status op berichtniveau | Verwerkingsstatus van een bericht op het netwerk |
Punchout, PDF- en EDI-diensten kunnen gebruikmaken van dezelfde accountstructuur. Qvalia zorgt voor de validatie, routering, aflevering en foutafhandeling op netwerkniveau.
Gestructureerde transactiegegevens
Documenten zijn beschikbaar als gestructureerde transactiegegevens voor rapportage, analyse en automatisering van de boekhouding.
Factuurregel, zoals ontvangen
ART 4471-B
Printing paper A4 80G 5X500
12 pcs 489,00 SEKDezelfde regel, gerubriceerd
| UNSPSC | 14111507 Kopieerpapier |
| Categorie | Kantoorbenodigdheden |
| Eenheid | 12 × 2 500 vellen |
| Prijs per stuk | 40.75 SEK |
| Leverancier | Afgestemd op de stamgegevens |
Regelposten kunnen in realtime worden gestructureerd en geclassificeerd, waarbij de stamgegevens aan de transactiestroom zijn gekoppeld. Dit ondersteunt rapportage, uitgavenanalyse en automatisering van de boekhouding in uw product. OCR, geautomatiseerde boekhouding en verrijking van classificaties zijn beschikbaar als add-ons.
Verplichtingen inzake Peppol-naleving
Qvalia vervult de rol van Peppol-dienstverlener voor Embedded Peppol. De partner blijft verantwoordelijk voor de relatie met zijn klanten en het commerciële aanbod. Alleen actieve rechtspersonen kunnen een Peppol ID toegewezen krijgen.
| Verantwoordelijkheid | Qvalia | Jij |
| Rol van gecertificeerde Peppol-dienstverlener | Qvalia | |
| Werking van het toegangspunt en SMP | Qvalia | |
| Peppol-certificering, audits en netwerkbeheer | Qvalia | |
| ISO/IEC 27001:2022 en ISO 22301:2019-managementsystemen | Qvalia | |
| Klantenonderzoek | Partner | |
| Controleren of klanten niet zijn uitgeschreven, niet insolvent zijn en niet in strijd handelen met de AML-voorschriften | Partner | |
| Contract met de eindklant, prijsstelling en commerciële relatie | Partner |
Dit geldt zowel voor Embedded Peppol als voor het white-labelplatform. Partners die de rol van Peppol-dienstverlener in eigen naam moeten vervullen, kunnen beter kiezen voor Hosted Access Point.
Veelgestelde vragen
Wat houdt ‘Embedded Peppol’ in de praktijk in?
U biedt uw eigen klanten Peppol-connectiviteit en de normconforme uitwisseling van zakelijke berichten aan, geïntegreerd in uw product via een API. Qvalia beheert de Peppol-infrastructuur op de achtergrond. U bent verantwoordelijk voor de klantrelatie en het aanbod.
Moeten we zelf zorgen dat we aan de Peppol-normen voldoen?
Nee. Bij Embedded Peppol vervult Qvalia de rol van Peppol-dienstverlener en beheert het zowel het toegangspunt als de SMP. Qvalia zorgt voor het beheer van het Peppol-netwerk en de technische naleving van de dienst. U blijft verantwoordelijk voor contracten met eindklanten, onboarding-informatie, prijsstelling en ondersteuning. Partners die de rol van dienstverlener in eigen naam willen vervullen, kunnen het beste kiezen voor Hosted Access Point.
Hoe ondersteunt u Peppol-opstellingen met meerdere gebruikers?
Qvalia ondersteunt zowel geconsolideerde als multi-tenant-modellen. U kunt meerdere eindklanten beheren in een gedeelde omgeving, of voor elke klant afzonderlijke accounts en Peppol-ID’s aanmaken.
Welke soorten Peppol-berichten kunnen we onze gebruikers en eindklanten aanbieden?
Facturen, creditnota’s, bestellingen, orderbevestigingen, verzendberichten, catalogi en aanverwante zakelijke berichten, plus punchout. Qvalia zorgt voor de validatie, routering, bezorging en foutafhandeling binnen het netwerk. PDF- en EDI-bestanden worden via dezelfde accountstructuur verwerkt.
Hoe worden eindklanten aangemeld en beheerd?
Eindklanten krijgen tijdens de onboarding hun eigen Peppol-ID’s en routeringsregels toegewezen. Qvalia regelt achter de schermen de registratie van deelnemers, updates van de directory en de netwerkconfiguratie, terwijl u zelf de onboarding-ervaring bepaalt.
Moeten we controleren of er inkomende documenten zijn?
Nee. Schrijf je in voor webhook-gebeurtenissen en Qvalia-berichten naar je eindpunt wanneer er een Peppol-bericht of -document binnenkomt, wanneer de bezorgstatus verandert en wanneer de bezorging mislukt. Als alternatief zijn polling-eindpunten beschikbaar.
Kunnen we meer bieden dan alleen het uitwisselen van berichten?
Ja. Elke transactie is beschikbaar als gestructureerde gegevens met een classificatie per post. Hierdoor kunt u rapportages, uitgavenanalyses en geautomatiseerde boekhouding in uw eigen product integreren, in plaats van alleen maar documenten door te sturen. OCR, geautomatiseerde boekhouding en aanvullende classificatie zijn beschikbaar als add-ons.
Zijn er limieten voor het aantal verzoeken?
Ja. Partneraccounts krijgen limieten die ruim boven de standaardlimieten liggen, en de limiet wordt aangepast aan uw verwachte volume. Neem contact met ons op als u een grootschalige onboarding of een drukke maandafsluiting verwacht.
Hoe snel kunnen we aan de slag?
Toegang tot de sandbox is doorgaans binnen enkele uren beschikbaar. De lancering in de productieomgeving hangt af van de integratie, het testen en uw proces voor de goedkeuring van nieuwe functies ( release ).
Hoe is de integratie opgezet?
Het platform is geïntegreerd via REST-API’s. Voor de systeemauthenticatie wordt gebruikgemaakt van OAuth 2.0-clientreferenties. SSO voor gebruikers wordt afzonderlijk geconfigureerd via de ondersteunde identiteitsopties. Als u de interface niet in uw product nodig hebt, biedt het white-labelplatform de applicatie van Qvalia aan onder uw eigen merknaam.
Alternatieve oplossingen
Kies het white-labelplatform voor een complete applicatie, of ‘Hosted Access Point’ wanneer uw organisatie de rol van serviceprovider moet vervullen.
Je wilt het product, niet de uitvoering
Het white-labelplatform is de complete applicatie van Qvalia, onder uw merknaam, domeinnaam en met uw eigen prijsstelling. Het biedt een volledige interface zonder dat er een ontwikkelingsproject nodig is.
Je moet de aanbieder zijn, in je eigen naam
Met Hosted Access Point wordt u een gecertificeerde Peppol-dienstverlener met uw eigen Access Point-identiteit en PKI-certificaat, op de infrastructuur die door Qvalia wordt beheerd.
Neem contact op
Integreer e-facturering, e-bestellingen en gegevensverrijking in uw platform met Qvalia.
Dankzij onze partner-API, geavanceerde beheertools en white-labeloplossingen kunt u uw eindgebruikers een naadloos transactiebeheer bieden.
Werk met ons samen om de mogelijkheden van uw platform uit te breiden en de digitale transformatie te stimuleren. Neem contact met ons op voor meer informatie.
Zakelijke documenten uitwisselen via Peppol, EDI en meer
Schakel AI-gestuurde gegevensverrijking op regelniveau in
Breid uw productaanbod en gebruiksgemak uit