Valider des documents XML sans stockage : smart detection, assertions multilingues et règles personnalisées.
La Validate API vous permet de valider un document XML sans le stocker ni l'envoyer via la PSB. Elle est donc idéale comme pre-flight check avant d'envoyer un document, ou pour tester des documents pendant le développement de votre intégration.
POST /api/v1/generic/validate
Envoyez le document XML dans le body avec le content-type application/xml. La PSB analyse le document et retourne un résultat de validation.
La Validate API détecte automatiquement le format de votre document en se basant sur le contenu XML. Vous n'avez pas besoin d'indiquer s'il s'agit d'une facture NLCIUS, d'une facture Peppol BIS Billing V3, d'un UBL Order ou d'un autre format. L'API le détecte elle-même et applique les règles de validation appropriées.
Cela fonctionne pour tous les types de documents pris en charge par la PSB : factures, notes de crédit, commandes, réponses aux commandes et plus encore.
La réponse contient un booléen isValid et une liste d'assertions :
{
"isValid": false,
"assertions": [
{
"artifact": "schema",
"flag": "error",
"text": "Element 'cbc:InvoiceTypeCode' is missing."
},
{
"artifact": "business-rules",
"flag": "warning",
"text": "BR-NL-10: TaxTotal should contain at least one TaxSubtotal."
}
]
}
Chaque assertion possède un flag avec l'une des valeurs suivantes :
successwarningerrorLa validation porte à la fois sur le schéma XSD (structure) et sur les business rules (règles métier telles que les champs obligatoires et les plages de valeurs).
La PSB valide par défaut contre la version la plus récente des artefacts de validation. Si le document n'est pas valide contre la dernière version mais qu'il l'est contre la version précédente encore acceptée sur le réseau, les deux résultats sont renvoyés. Vous savez ainsi si votre document peut encore être envoyé maintenant et si vous devez effectuer une mise à niveau pour la compatibilité future.
Pour des besoins de validation spécifiques, vous pouvez inclure un optionId comme paramètre de requête :
POST /api/v1/generic/validate?optionId=jouw-optie-id
Cela active un ensemble prédéfini de règles de validation, par exemple des exigences spécifiques à un client ou des normes sectorielles. Pour connaître les options disponibles, utilisez :
GET /api/v1/generic/validate/options
Par défaut, les assertions sont en anglais. Si vous souhaitez recevoir les messages de validation en néerlandais, envoyez le header X-EConnect-Language :
X-EConnect-Language: nl
Les langues prises en charge sont notamment nl (néerlandais) et en (anglais).
La Validate API est particulièrement utile dans les scénarios suivants :
Technique : La Validate API ne stocke pas le document dans la PSB. Le document est validé et le résultat est retourné immédiatement. Aucun webhook n'est déclenché et aucun frais n'est facturé.
Consultez la spécification API complète sur psb.econnect.eu pour tous les paramètres et exemples de payloads.
Valider un document