Hoe integreer ik Peppol met RetailVista?

Prev Next
This content is currently unavailable in German. You are viewing the default (Dutch) version.

Peppol is een nieuw Europees netwerk voor uitwisseling van facturen tussen bedrijven (B2B). In de komende jaren wordt het gebruik van Peppol fiscaal verplicht. Het is dan niet langer toegestaan om facturen rechtstreeks aan bedrijven te sturen, dat moet via het Peppol netwerk. Om toegang te kunnen krijgen tot het Peppol netwerk heeft NedFox contracten afgesloten met StoreCove en zijn er software aanpassingen gemaakt in RetailVista om met hen te kunnen communiceren. Voor wat betreft RetailVista gaat het alleen over het versturen van facturen naar het Peppol netwerk, niet de ontvangst van facturen. Inkoopfacturen van Peppol moeten vanuit de boekhouding software worden opgehaald, RetailVista speelt daar geen rol in.

Vereisten

Om de integratie met Peppol te kunnen realiseren is het hebben van een API key essentieel. Deze kan via NedFox worden verkregen bij het aanvragen van een Peppol integratie licentie voor RetailVista. Daarmee is ook direct aan de vereiste voldaan om een Peppol integratie licentie actief te hebben binnen RetailVista.

Configuratie

De Peppol integratie met via 'Connector onderhoud' aan RetailVista worden toegekend. In onderstaand schermvoorbeeld is een configuratie voorbeeld voor een Peppol integratie zichtbaar. 

VestigingDe vestiging waarop de Peppol integratie actief moet zijn
Connector typeKies hier voor de 'Peppol privder'
Connector bronKies voor 'StoreCove'
URLDe te gebruiken URL is https://api.storecove.com/api/v2
Let op: Gebruik hier geen hoofdletters!
API tokenGeef hier het API token op wat NedFox heeft verstrekt bij de uitgifte van de Peppol integratie licentie
Geavanceerde instellingen
LegalEntityIdAls hier een waarde opgegeven is, dan wordt die waarde gebruikt bij het versturen van facturen naar Storecove. Tenzijn er een goede reden bestaat om af te wijken van de standaard LegalEntityId is het niet nodig om deze insteling te gebruiken.
ReceiverHiermee kan worden aangegeven dat de licentiehouder facturen kan ontvangen.
Als deze instelling niet opgegeven wordt dan wordt er vanuit gegaan dat de licentiehouder facturen kan ontvangen.
SenderHiermee kan worden aangegeven dat de licentiehouder facturen kan versturen.
Als deze instelling niet opgegeven wordt dan wordt er vanuit gegaan dat de licentiehouder facturen kan versturen.

Nadat deze connector aangemaakt is moet deze bij 'Instellingen, Facturering' worden opgegeven als 'Peppol integratie connector'.

Peppol integratie connector
In RetailVista 25.4 is deze instelling nog niet aanwezig. In die versie wordt de eerst gevonden connector (van het type 'PeppolProvider') toegepast.

Bij 'vestiging onderhoud' moet een relatie ingesteld zijn. Dat zal vaak al het geval zijn maar advies is om dat wel te controleren. Deze relatie wordt gebruikt als afzender van de Peppol facturen. Bij deze relatie moeten de volgende gegevens minimaal opgegeven zjin:

Geldig BTW nummer
Standaard adres met een postcode en straatnaam
Email adres

Optionele gegevens:
Telefoon nummer (van het type 'Telefoon')

Om een factuur naar een debiteur te kunnen sturen moet deze aan de volgende voorwaarden voldoen:

Debiteur met geldige BTW code
Standaard adres
Email adres

Optionele gegevens:
Telefoonnummer (van het type 'Telefoon')

Afwijkingen in RetailVista 25.4

Omdat deze integratie tussentijds is toegevoegd aan RetailVista 25.4 (in plaats van wachten op de 2026 update) kan er niet bepaald worden op basis van instellingen of een factuur naar Peppol verstuurd moet worden. Om Peppol in RetailVista 25.4 goed te laten werken zijn de volgende aandachtspunten:

  • Laatste bugfixes van RetailVista en Retail3000 backoffice plaatsen (nieuwer of gelijk aan versie 25092025)
  • Appsetting in de web.config van Retail3000 backoffice met key 'EServicesCustomerNumbersWithPeppolLicense’. De value van deze key bevat een lijst van eServices klantnummers van de vestigingen die gebruik mogen maken van de Peppol verzending.
    Voorbeeld: <add key="EServicesCustomerNumbersWithPeppolLicense" value="16677" />
  • De verzendwijze van de factuur moet ingesteld zijn op 'Email'. 

Bij het verzenden van facturen worden een aantal controles gedaan om te bepalen of een factuur in aanmerking komt voor verzending via het Peppol netwerk.

  • Het eServices klantnummer van de RetailVista vestiging moet voorkomen in de Web.Config instelling als eServicesCustomerNumbersWithPeppolLicense (dit is de licentie check)
  • De RetailVista vestiging waar de factuur bij hoort moet zich in Belgie bevinden. Hiervoor wordt gekeken naar het opgegeven land in de vestiging definitie.
  • De debiteur (ontvanger van de factuur) moet zich ook in Belgie bevinden. Hiervoor wordt gekeken naar het land van het standaard adres van de debiteur.
  • De debiteur moet een bedrijf zijn (B2B) facturatie. Hiervoor wordt gekeken of er een BTW nummer opgegeven is.
  • Voor het bepalen van de te gebruiken connector wordt de eerstgevonden connector gebruikt van het type 'Peppol'.
  • Bij het bijwerken van de verzonden factuur wordt er nog geen Storecove kenmerk in de factuur opgeslagen. Het kenmerk is wel terug te vinden in de export log van de factuur. In de Januari 2026 update van RetailVista is een nieuw veld 'Extern ID' toegevoegd en vanaf dat moment worden de Storecove ID's daarin weggeschreven na een succesvolle verzending.