Vérification Peppol
Vérifiez si une entreprise belge est enregistrée sur le réseau Peppol pour la facturation électronique. La vérification est effectuée via le SML (Service Metadata Locator) du réseau Peppol.
GET
/api/peppol/checkHeaders
| Header | Value | Description |
|---|---|---|
X-API-Key | pk_live_... | Clé API (obligatoire) |
Paramètres
| Name | Type | Description |
|---|---|---|
vatNumberrequis | string | Numéro de TVA belge. Formats: 1033022383 ou BE1033022383Exemple: 1033022383 |
Exemple de requête
cURL
curl -X GET \ "https://companybelgium.be/api/peppol/check?vatNumber=1033022383" \ -H "X-API-Key: pk_live_votre_cle"
JavaScript / Node.js
const vatNumber = '1033022383';
const response = await fetch(
`https://companybelgium.be/api/peppol/check?vatNumber=${vatNumber}`,
{
headers: { 'X-API-Key': process.env.API_KEY },
}
);
const data = await response.json();
if (data.success) {
if (data.data.isRegistered) {
console.log(`✅ ${data.data.entityName} est enregistré sur Peppol`);
console.log(`Types de documents: ${data.data.documentTypes.join(', ')}`);
} else {
console.log('❌ Entreprise non enregistrée sur Peppol');
}
}Python
import requests
response = requests.get(
'https://companybelgium.be/api/peppol/check',
params={'vatNumber': '1033022383'},
headers={'X-API-Key': 'pk_live_votre_cle'}
)
data = response.json()
if data['success']:
if data['data']['isRegistered']:
print(f"✅ {data['data']['entityName']} est enregistré sur Peppol")
for doc_type in data['data']['documentTypes']:
print(f" - {doc_type}")
else:
print("❌ Non enregistré sur Peppol")Exemple de réponse
200 OK
{
"success": true,
"data": {
"isRegistered": true,
"entityName": "Espero-Soft Informatiques",
"country": "Belgium",
"countryCode": "BE",
"registrationDate": "Jan 16, 2026",
"identifiers": [
{
"scheme": "iso6523-actorid-upis",
"value": "0208:1033022383"
},
{
"scheme": "iso6523-actorid-upis",
"value": "9925:be1033022383"
}
],
"documentTypes": [
"Peppol Invoice Response transaction 3.0",
"Peppol Message Level Response transaction 3.0",
"Peppol BIS Billing UBL Credit Note V3",
"UBL.BE Credit Note 3.0",
"Peppol BIS Billing UBL Invoice V3",
"UBL.BE Invoice 3.0"
],
"smpUrl": "https://smp.codabox.com",
"endpointUrl": "https://peppol.codabox.com/peppol/as4"
},
"timestamp": "2026-02-11T22:00:00.000Z",
"meta": {
"responseTime": 1250
}
}Codes d'erreur
400 Bad Request
Numéro de TVA manquant400 Bad Request
{
"success": false,
"error": "vatNumber parameter is required",
"timestamp": "2026-02-11T22:00:00.000Z"
}Mise en cache
Durée du cache: 1 heure (stale-while-revalidate: 2 heures)
Notes
- Le numéro de TVA peut être fourni avec ou sans le préfixe 'BE'.
- Si l'entreprise n'est pas enregistrée, le champ isRegistered sera false et les autres champs seront absents.
- Les types de documents indiquent quels formats de factures électroniques sont supportés.
- Le réseau Peppol est utilisé pour la facturation électronique B2B en Europe.