Technische Specificaties Koppelvlak - Complete Peppol Implementatiegids - Peppol.nu

Technische Specificaties Koppelvlak

Complete technische documentatie voor het implementeren van Peppol-koppelingen, van architectuur tot praktische implementatie en API-integratie

Peppol Architectuur & Componenten

Het Peppol-netwerk bestaat uit verschillende technische componenten die samenwerken om veilige en betrouwbare documentuitwisseling mogelijk te maken. De architectuur is gebaseerd op een vier-hoeks model met gestandaardiseerde interfaces en protocollen.

Kerncomponenten

Access Point (AP)

  • AS4 protocol implementatie
  • PKI certificaat beheer
  • Message Level Response (MLR)
  • Berichtvalidatie en routering
  • Start-AP en C2-C3 connectivity

Service Metadata Publisher (SMP)

  • Endpoint discovery service
  • Participant capabilities registratie
  • Document type ondersteuning
  • REST API interface
  • DNS-based of SML lookup

Service Metadata Locator (SML)

  • Centraal DNS-based register
  • SMP lookup service
  • Participant registratie
  • NAPTR DNS records
  • High availability setup

Beveiliging & Certificaten

Peppol gebruikt een robuust PKI-framework voor end-to-end beveiliging van alle berichten en verbindingen binnen het netwerk. Alle communicatie wordt beveiligd met industriestandaard cryptografie.

PKI Certificaat Vereisten • Peppol AP certificaten uitgegeven door OpenPeppol CA
• X.509v3 certificaten met specifieke extensions
• Minimaal SHA-256 signing algoritme
• Certificaat validatie via OCSP
• Jaarlijkse certificaat vernieuwing verplicht

Hulp nodig bij complexe certificaat implementatie? Gebruik ons certificaat beheer expertise voor veilige PKI setup.
// Voorbeeld AS4 message header structuur <eb:Messaging xmlns:eb="http://docs.oasis-open.org/ebxml-msg/ebms/v3.0/ns/core/200704/"> <eb:UserMessage> <eb:MessageInfo> <eb:Timestamp>2024-01-15T10:30:00Z</eb:Timestamp> <eb:MessageId>uuid:12345678-1234-5678-1234-567812345678</eb:MessageId> </eb:MessageInfo> <eb:PartyInfo> <eb:From> <eb:PartyId type="urn:oasis:names:tc:ebcore:partyid-type:unregistered"> POP000001 </eb:PartyId> </eb:From> <eb:To> <eb:PartyId type="urn:oasis:names:tc:ebcore:partyid-type:unregistered"> POP000002 </eb:PartyId> </eb:To> </eb:PartyInfo> </eb:UserMessage> </eb:Messaging>

API Specificaties & Endpoints

REST API Implementatie

Voor integratie met het Peppol-netwerk zijn verschillende API endpoints beschikbaar. Deze volgen RESTful principes en gebruiken standaard HTTP methods voor optimale interoperabiliteit.

SMP API Endpoints

GET/iso6523-actorid-upis::{id}
GET/services/{doctype}
PUT/servicegroup
DELETE/participant
GET/complete/info

Business Document API

POST/as4/send
GET/as4/status/{msgid}
GET/as4/mdn/{msgid}
POST/validate/document
GET/document/metadata
// Voorbeeld SMP lookup request GET https://smp.provider.com/iso6523-actorid-upis::0106:12345678 Accept: application/xml // Response <?xml version="1.0" encoding="UTF-8"?> <ServiceGroup> <ParticipantIdentifier scheme="iso6523-actorid-upis"> 0106:12345678 </ParticipantIdentifier> <ServiceMetadataReferenceCollection> <ServiceMetadataReference href="https://smp.provider.com/..."/> </ServiceMetadataReferenceCollection> </ServiceGroup>

Transport Protocollen

AS4 Profile Specificaties • OASIS AS4 Profile of ebMS 3.0 Version 1.0
• SOAP 1.2 met WS-Security authenticatie
• Synchrone en asynchrone message exchange patterns
• Compression via AS4 compression feature
• Maximum message size: 100 MB (configureerbaar per provider)

AS4 protocol implementatie ondersteuning nodig? Profiteer van ons technische expertise voor complexe integraties.

Implementatie Vereisten

Technische Vereisten

Minimale Systeemeisen

  • Java 11+ of .NET Core 3.1+
  • TLS 1.2 of hoger verplicht
  • 4 GB RAM minimum
  • 10 GB disk space
  • 99.5% uptime SLA

Netwerk Configuratie

  • Publiek IP adres vereist
  • Port 443 (HTTPS) open
  • DNS A/AAAA records
  • Firewall configuratie
  • Load balancer support

Monitoring & Logging

  • Transaction logging (7 jaar)
  • Performance metrics
  • Error tracking & alerting
  • Audit trail compliance
  • GDPR compliant opslag

Integratie Stappen

De technische implementatie van een Peppol-koppeling volgt een gestructureerd proces met duidelijke mijlpalen en testfases voor optimale resultaten.

1
Analyse Fase
Technische requirements en architectuur design opstellen met stakeholder alignment.
2
Development
API integratie implementeren en message mapping configureren volgens Peppol standaarden.
3
Testing
Conformance testing via Peppol testbed en uitgebreide kwaliteitscontrole.
4
Certificering
OpenPeppol compliance verificatie en officiele goedkeuring verkrijgen.
5
Productie
Go-live uitvoering met real-time monitoring en 24/7 support activatie.
Implementatie Roadmap De volledige implementatie duurt gemiddeld 8-12 weken, afhankelijk van de complexiteit van uw huidige systemen en de gewenste integratiediepte. Tijdens elke fase wordt nauw samengewerkt met uw technische team om kennis over te dragen en continuïteit te waarborgen.

Wilt u uw implementatie timeline optimaliseren? Plan uw strategische implementatie voor minimale downtime en risico's.

Hulp nodig bij technische implementatie?

Onze technische experts helpen u graag met alle aspecten van uw Peppol-integratie, van architectuur design tot productie deployment en ongoing support.

Technisch Advies Aanvragen Vergelijk Peppol Serviceproviders

Peppol.nu - Jouw gids in de wereld van elektronische facturatie