Récupération du nom de facturation

Cet endpoint permet de vérifier si une structure existe dans Chorus Pro à partir de son numéro SIRET, et de récupérer son nom de facturation officiel (designationStructure).

Exemple de requête :

var myHeaders = new Headers();

myHeaders.append("Authorization", "Bearer <token>");

var formdata = new FormData();
formdata.append("national_id", "13001727000010"); // SIRET

var requestOptions = {
		method: 'POST',
		headers: myHeaders,
		body: formdata,
		redirect: 'follow'
};

fetch("https://api.sinao.app/v1/apps/:appId/organizations/chorus-search", requestOptions)
		.then(response => response.text())
		.then(result => console.log(result))
		.catch(error => console.log('error', error));

{
    "code": 200,
    "type": "success",
    "billing_name": "MINISTERE DE L'ECONOMIE, ..."
}

Cas particuliers : retour null

L’API peut renvoyer null dans les cas suivants :

1. Erreur de communication avec Chorus Pro : champ error_translate_key présent.
2. Plusieurs structures correspondent au critère de recherche : typiquement lorsqu’un SIREN (9 chiffres) est fourni à la place d’un SIRET (14 chiffres).
   → Chorus Pro retourne alors plusieurs établissements possibles, et l’API ne peut pas déterminer un seul nom de facturation unique.
3. Aucune structure trouvée pour le SIRET fourni.

💡 Conseil : veillez à toujours envoyer un SIRET complet à 14 chiffres afin d’obtenir un résultat unique et précis.