UAE onboarding prerequisites
Before the UAE onboarding POST can succeed, the company's TIN needs an ASP/TIN linkage created through the approved FTA-authorized flow, and the associated Peppol participant must exist for the same environment.
This is a prerequisite to UAE company onboarding, not work performed by POST /v3/connect/companies.
Publication dependency: Product must confirm the responsible party, official flow name, approved portal or process URL, exact readiness label, and support path. Those values are intentionally not guessed here. This page must not be presented as a complete self-service prerequisite guide until they are supplied.
Required action and readiness
Before calling the endpoint:
- The confirmed responsible party completes the approved ASP/TIN authorization for the company's UAE TIN through the confirmed approved process.
- They choose the same
sandbox,simulation, orproductionenvironment that the onboarding request will use. - They wait until the confirmed readiness signal shows that the ASP/TIN linkage and associated participant are ready.
- The ISV backend then calls the onboarding endpoint with company and source information only.
Readiness is environment-specific. A prerequisite completed in one environment does not establish readiness in another.
Peppol participant ownership
Complyance manages and verifies the participant associated with the prerequisite. For UAE TIN addressing, the electronic-address scheme is 0235, so the value is formatted as 0235:<TIN>. Formatting the value yourself does not prove that the participant exists or is active.
Do not create or send peppolParticipantId in the onboarding request. The API returns the verified, system-managed value after successful onboarding.
The public guide does not expose internal registration, record-linkage, access-point, or participant-provisioning mechanics.
Prerequisite errors and recovery
| Error | Meaning | What to do |
|---|---|---|
409 ASP_LINKAGE_NOT_FOUND | The approved ASP/TIN prerequisite was not found for the same TIN and environment. | Complete or verify the prerequisite through the confirmed process, then check the Company List API before submitting the corrected onboarding request. |
409 PEPPOL_PARTICIPANT_UNAVAILABLE | The system cannot safely verify or link the required participant. | Verify the prerequisite, then contact the confirmed support path with meta.requestId. The response will not disclose another workspace, owner, access point, or registration. Check the Company List API before retrying. |
Related pages
- Authentication and environments
- Onboard a UAE company
- List onboarded companies
- Errors and troubleshooting
Next step: After the confirmed readiness signal appears, onboard the UAE company.