Om de onderneming te registreren op het Peppol netwerk moet er een KYC worden uitgevoerd. Tijdens deze KYC worden de bedrijfsgegevens van de onderneming geverifiëerd en wordt er een scan van de identiteitskaart van de wettelijke vertegenwoordiger van de onderneming opgeladen.
Deze registratie kan ook via de API worden uitgevoerd. Hierbij worden alle bedrijfsgegevens en de scan van de identiteitskaart via één enkele aanroep doorgestuurd.
Stuur alle nodige gegevens door via: POST /integrations/peppol
Opgelet! De URL bevat geen "/api/v1" zoals bij andere API aanroepen.
De nodige gegevens worden niet als JSON doorgegeven maar als formdata. Geef daarom als header op "Content-Type: multipart/form-data".
Door te geven:
Veldnaam | Omschrijving | Voorbeeld |
| peppol_type | Verzenden en ontvangen van facturen via Peppol (sendreceive) of enkel verzenden van facturen via Peppol (send). Standaard "send". | sendreceive |
| name | Bedrijfsnaam (verplicht) | MyCompany BV |
| company_id | Ondernemingsnummer of gelijkaardig nummer bij niet-Belgische onderneming. Niet van toepassing voor Duitse ondernemingen. | 0693727271 |
| vat_number | BTW-nummer (verplicht indien de onderneming beschikt over een BTW-nummer). Niet van toepassing voor Zweedse ondernemingen. | BE0693727271 |
| street | Straat (verplicht) | Straat |
| housenumber | Huisnummer (verplicht) | 1 |
| postal_code | Postcode (verplicht) | 1000 |
| city | Stad (verplicht) | Brussel |
| country | ISO landcode (verplicht). Mogelijke landen: BE, NL, LU, DE, SE, IE) | BE |
| iban | IBAN (verplicht) | BE123456789123 |
| E-mailadres (verplicht) | my@company.be | |
| phone | Telefoonnummer (verplicht) | +32123456789 |
| website | Website van de onderneming (verplicht) | https://eenvoudigfactureren.be |
| remarks | Opmerkingen die de KYC kunnen staven | |
| mandate | Naam van de wettelijke vertegenwoordiger van de onderneming waarvan de identiteitskaart wordt doorgegeven | Jan Desmet |
| file | Scan identiteitskaart wettelijke vertegenwoordiger (verplicht) | |
| businessregisterfile | Bestand documenten oprichting bedrijf. Enkel van toepassing voor niet-Belgische ondernemingen. |
Als resultaat ontvang je een bevestiging van de aanvraag door in JSON.
Bij succes:
{
"success": "Registratie succesvol uitgevoerd",
"action": "kyc_requested"
}Bij gefaalde aanvraag:
{
"error": "Land ongeldig"
}