Troubleshoot the Connection and Setup

This article covers the errors you get while setting the app up: reaching the platform, storing credentials, and mapping each Business Central company to the entity it sends as. For errors while sending a document, see Troubleshoot Sending Documents.

The e-invoice platform did not respond at all

This is the most common problem in the first week of using the app, and the message names the cause first for that reason:

The e-invoice platform did not respond at all - no error came back, the call simply did not complete. The usual cause is that outbound calls are switched off for this extension: search for Extension Management, select E-Invoice Platform, choose Configure, and turn on Allow HttpClient Requests. A newly installed extension has it off, and reinstalling switches it off again. If it is already on, check that your firewall or tenant allows app.recommand.eu.

Cause: Outbound HTTP calls are blocked for the extension. They are blocked by default and must be approved per extension.

Solution:

Choose the Search icon, enter Extension Management, and then choose the related link.
Select E-Invoice Platform.
Choose the Configure action. Set up is a different action on the same page — it opens the app's own setup page, not the extension settings.
On the Extension Settings page, turn on Allow HttpClient Requests.
If it was already on, check that your firewall or tenant allows app.recommand.eu.

Reinstalling the extension switches this off again, so check it after any reinstall.

API Secret is not set. Open E-Invoice Platform Setup and enter the secret.

Cause: No secret is stored. The Secret Configured field on the setup page shows No.

Solution: Enter the secret on E-Invoice Platform Setup and choose Test Connection. See Set Up the Platform Connection.

The related messages API Key Id is missing in E-Invoice Platform setup., Base URL is missing in E-Invoice Platform setup. and E-Invoice Platform setup is not configured. have the same fix — fill in the missing field on the same page.

This API key cannot reach any companies on the e-invoice platform.

Cause: The credentials are valid, but no company exists on the platform under this key.

Solution: Contact the platform provider to have the company created, then choose Test Connection again.

BC company name is not mapped to a company on the e-invoice platform. Open E-Invoice Platform Companies and map it.

Cause: This Business Central company has no platform company assigned, so it cannot send.

Solution: Open E-Invoice Platform Companies, choose Refresh from Platform to auto-match by VAT number, and use Assign Platform Company for anything left unmatched.

The mapping for BC company name has never been validated. Open E-Invoice Platform Companies and run Validate All.

Cause: A mapping exists but has not passed its identity check.

Solution: On E-Invoice Platform Companies, choose Validate All.

This BC company resolves to identifier but the mapped platform company name is registered as identifier

Cause: The VAT number on Company Information does not match the one the platform holds for the mapped company. Sending would issue the invoice under the wrong legal entity.

Solution: Check you mapped the right platform company. If the mapping is right, the VAT number on one of the two sides is wrong — correct it before sending anything.

The platform company exists but is not verified yet, so Peppol delivery will be refused.

Cause: Verification is incomplete on the platform side.

Solution: Complete verification with the platform provider. Nothing in Business Central fixes this.

Sending is disabled for BC company name. Tick Enabled on the E-Invoice Platform Companies page.

Cause: The company was suspended by switching Enabled off, or its mapping has never passed a check.

Solution: Switch Enabled back on. It is set automatically the first time a mapping passes, so if it will not stay on, run Validate All and read the status reason.

BC company name cannot receive documents

The full message explains why it stops rather than returning an empty inbox:

BC company name cannot receive documents: the e-invoice platform is not the receiving access point for identifier. Its inbox will always be empty, which is why this stops rather than returning nothing.

Cause: The platform is not the SMP recipient for this company's Peppol identifier. Sending works; receiving cannot.

Solution: Ask the platform provider to register the company as the receiving access point, then run Refresh from Platform and check Can Receive.

Errors that come back from the platform

These arrive in English whatever your Business Central language, because they are produced outside the translated part of the app.

HTTP code: message wraps every error the platform returns. HTTP 401 means the API key id or secret is wrong; HTTP 403 means the key is valid but not allowed to do this. Re-enter the secret and choose Test Connection.

Could not read the company list from the e-invoice platform: reason appears on Refresh from Platform or Assign Platform Company. It is a connection problem, not a mapping problem — work through this article from the top.

Loading n documents from the platform failed: reason appears on E-Invoice Platform Documents. Same causes.

The e-invoice platform returned a response that is not valid JSON. and its siblings — …did not contain a companies list., …returned an unexpected companies list., …did not contain a document., …returned a document that is not an object. — mean the platform answered with something unexpected. Retry once; if it persists, it is a platform-side problem to raise with the provider, and the exact wording is what they will want.

This company has no Peppol identifier yet. Map it to a platform company first.

Cause: You ran a directory or identity check on a company that is not mapped yet.

Solution: Map it first, on E-Invoice Platform Companies.

No e-document service receives through the E-Invoice Platform yet.

Set Service Integration on an E-Document Service first.

Cause: You used a receiving action before creating the e-document service.

Solution: Create it. See Set Up Receiving of Supplier Documents.

BC company name cannot send: reason

Cause: The company failed its send gate. The reason after the colon is one of the mapping statuses above.

Solution: Open E-Invoice Platform Companies, read Status Reason on the row, and fix what it names.

The base URL does not start with https://

Cause: The Base URL was changed to a non-HTTPS address, which would send credentials unencrypted.

Solution: Choose Reset Base URL to Default.