Troubleshooting
Use this page to diagnose and resolve common errors when setting up and sending invoices through the Belgium PEPPOL integration.
Participant ID not found
- Symptom
- Error message indicates participant ID is not registered in PEPPOL network.
- Solution
- Confirm your PEPPOL registration is complete and active. Contact your Sovos account manager to confirm registration status.
Recipient not available
- Symptom
- Cannot send invoice to buyer. Recipient not found in PEPPOL network.
- Solution
- Confirm the buyer's participant ID is correct and they are registered in PEPPOL. The buyer must have an active access point to receive invoices.
Authentication failures
- Symptom
- HTTP 401 errors when calling Sovos API.
- Solution
- Confirm your API credentials are correct and you are using the proper authentication flow. Regenerate credentials if needed.
Invalid character in identifier (CodeInvalid 05)
- Symptom
-
Document submission fails with error code
CodeInvalid (05)referencingSender.IdentifierorReceiver.Identifier. - Solution
- Check that identifiers in the SBDH has only allowed characters: letters (a-z, A-Z), numbers (0-9), and symbols period (.), hyphen (-), underscore (_), tilde (~). Remove any spaces or special characters. See PEPPOL participant identifiers for complete rules.
Invalid Belgian enterprise number (PEPPOL-COMMON-R043)
- Symptom
-
Document submission fails with error code
PEPPOL-COMMON-R043referencing theEndpointIDwithschemeID="0208". - Solution
-
Verify the enterprise number format:
- Must be exactly 10 digits (numbers only).
- Must not include "BE" prefix.
- Must not include "0208:" prefix.
- Must not include spaces, hyphens, or other characters.
- Must be a valid Belgian enterprise number (modulo 97 checksum).
Example: Use
<cbc:EndpointID schemeID="0208">0123456789</cbc:EndpointID>not<cbc:EndpointID schemeID="0208">BE0123456789</cbc:EndpointID>.
