recupererDonneesOE
DESCRIPTION
The calling party wishes to retrieve an economic operator's public or private data.
ENVIRONMENTS
Production URL | https://api.aife.economie.gouv.fr/dume/donnees/donnees |
Qualification URL | https://sandbox-api.aife.economie.gouv.fr/dume/donnees |
PARAMETERS
Header parameters
Data | Format | Optional / mandatory |
---|---|---|
Certificate | Varchar | Mandatory |
Content - Type | Varchar | Mandatory |
Header example:
curl -v -X POST --insecure --cert xxxxx.pem https://api.aife.economie.gouv.fr/dume/donnees-d "{}"
The braces frame the JSON.
Complete description of the API’s input and output parameters
Input parameter | Mandatory (M) / Optional (O) | Management rule |
---|---|---|
operation | M | Constant =recupererDonneesOE |
siretOE | M | Alphanumeric (14 characters) and If the functional identifier sollicited by the third party API is a SIREN, the 5 last numbers of the Economic Operator SIRET communicated by the marketplace are truncated |
typeDonnees | M | 1: published Economic Operator data 2: published and non published Economic Operator data IF this parameter is not completed, it is deemed "1". |
platform | ||
typeIdPlateforme | M | The values for « type d’ID plateforme demandeuse » (which means "requesting platform ID type") are: - « 1 » (Third party with SIRET number) - « 2 » (European structure outside of France) – intracommunity VAT - « 3 » (Structure outside of the EU) – Country code + first 16 corporate name characters - « 4 » (RIDET) - « 5 » (Tahiti Number) |
idPlateforme | M | 1/ Functional Id of the buyer profile which requested the connection 2/ The ID format of the platform is controled: - If « identification type » is « 1 » : 14 characters - If « identification type » is « 2 » : 18 characters maximum (1 to 18 characters) - If « identification type » is « 3 » : 3 to 18 characters - If « identification type » is « 4 » : 9 ou 10 characters - If « identification type » is « 5 » : « 9 » characters - If « identification type » is not provided, it is deemed to be a SIRET: 14 characters 3/ The platform's technical ID and the platform's ID must exist in database and be positioned on the same line as this database |
idTechniquePlateforme | M | 1/ ID available on the Chorus Pro "connection" space. The technical ID corresponds to the partner application code contained in the connection form. 2/ The platform's technical ID and the platform's ID must exist in database and be postioned on the same line as this database |
Nom API Entreprise | M | The APIs that can be consumed are the following: - Companies - Establishments - Exercises - RNAassociations |
{ "operation": "recupererDonneesOE", "siretId": "13001977100018", "service": "Entreprises", "typeDonnees": "1", "plateforme": { "typeIdPlateforme": "1", "idPlateforme": "12345678901011", "idTechniquePlateforme": "AAA001" } }
{ "entreprise": { "code_effectif_entreprise": "NN", "numero_tva_intracommunautaire": "FR15130019771", "siren": "130019771", "date_radiation": null, "tranche_effectif_salarie_entreprise": { "de": null, "a": null, "code": "NN", "date_reference": null, "intitule": "Non employeur" }, "nom": null, "forme_juridique": "Service central d'un ministère ", "date_creation": 1396389600, "forme_juridique_code": "7120", "enseigne": "AIFE", "categorie_entreprise": "PME", "mandataires_sociaux": [], "siret_siege_social": "13001977100018", "capital_social": null, "nom_commercial": "", "procedure_collective": false, "raison_sociale": "AGENCE POUR L'INFORMATIQUE FINANCIERE DE L'ETAT", "prenom": null }, "etablissement_siege": { "pays_implantation": { "code": null, "value": null }, "siret": "13001977100018", "date_mise_a_jour": 1461621600, "naf": "8411Z", "enseigne": null, "diffusable_commercialement": true, "siege_social": true, "libelle_naf": "Administration publique générale", "tranche_effectif_salarie_etablissement": { "de": null, "a": null, "code": "NN", "date_reference": null, "intitule": "Non employeur" }, "date_creation_etablissement": 1396389600, "commune_implantation": { "code": "93051", "value": "NOISY LE GRAND" }, "adresse": { "code_postal": "93160", "localite": "NOISY LE GRAND", "l1": "AGENCE INFORMATIQUE FINANCIERE ETAT", "l2": "MINEFI", "l3": "IMMEUBLE", "l4": "10 RUE DU CENTRE", "l5": null, "numero_voie": "10", "l6": "93160 NOISY LE GRAND", "l7": "FRANCE", "type_voie": "RUE", "nom_voie": "DU CENTRE", "complement_adresse": null, "cedex": null, "code_insee_localite": "93051" }, "region_implantation": { "code": "11", "value": "Île-de-France" } }, "gateway_error": false }