diff --git a/app/assets/images/providers/api_entreprise/cibtp.png b/app/assets/images/providers/api_entreprise/cibtp.png new file mode 100644 index 000000000..c4651dba0 Binary files /dev/null and b/app/assets/images/providers/api_entreprise/cibtp.png differ diff --git a/app/models/api_entreprise/endpoint.rb b/app/models/api_entreprise/endpoint.rb index 78f381005..cbc8a537c 100644 --- a/app/models/api_entreprise/endpoint.rb +++ b/app/models/api_entreprise/endpoint.rb @@ -44,6 +44,8 @@ def load_dummy_definition! @open_api_definition = missing_endpoints_definition.stringify_keys @dummy_definition = true + rescue I18n::MissingTranslationData + raise "There is no #{path} definition in OpenAPI file. Make sure path is valid or add the temporary data in config/locales/*/missing_endpoints.fr.yml" end def dummy? diff --git a/config/api-entreprise-v3-openapi.yml b/config/api-entreprise-v3-openapi.yml index ae0e21afc..21acc6e38 100644 --- a/config/api-entreprise-v3-openapi.yml +++ b/config/api-entreprise-v3-openapi.yml @@ -533,6 +533,23 @@ paths: description: Entreprise non trouvée content: application/json: + examples: + entite_non_trouvee_04003: + value: + errors: + - code: '04003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: ACOSS + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '504': @@ -1059,6 +1076,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_19003: + value: + errors: + - code: '19003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: ADEME + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -1721,6 +1755,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_17003: + value: + errors: + - code: '17003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: Banque de France + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -2350,6 +2401,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_33003: + value: + errors: + - code: '33003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: CARIF-OREF + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -2388,20 +2456,367 @@ paths: écoulé. source: meta: - provider: CARIF-OREF + provider: CARIF-OREF + summary: Intermédiaire hors-délai + description: Temps d’attente d’une réponse du fournisseur de données + écoulé. + provider_unavailable_error: + value: + errors: + - code: '33001' + title: Service non disponible + detail: Service du fournisseur de données temporairement indisponible + ou en maintenance. + source: + meta: + provider: CARIF-OREF + summary: Service non disponible + description: Service du fournisseur de données temporairement indisponible + ou en maintenance. + network_error: + value: + errors: + - code: '00501' + title: Erreur réseau + detail: Problème de connexion au serveur distant. L'erreur peut + venir soit du fournisseur, soit de API Entreprise. Il s'agit + souvent d'une erreur temporaire. + source: + meta: + retry_in: 10 + summary: Erreur réseau + description: Problème de connexion au serveur distant. L'erreur + peut venir soit du fournisseur, soit de API Entreprise. Il s'agit + souvent d'une erreur temporaire. + dns_resolution_error: + value: + errors: + - code: '33004' + title: Erreur de résolution DNS + detail: Problème de résolution DNS de l'adresse du serveur + source: + meta: + provider: CARIF-OREF + summary: Erreur de résolution DNS + description: Problème de résolution DNS de l'adresse du serveur + schema: + "$ref": "#/components/schemas/Error" + x-codeSamples: + - lang: cURL + label: Ligne de commande + source: |- + curl -X GET \ + -H "Authorization: Bearer $token" \ + --url "https://entreprise.api.gouv.fr/v3/carif_oref/etablissements/13002526500013/certifications_qualiopi_france_competences?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010" + "/v3/cibtp/etablissements/{siret}/attestation_cotisations_conges_payes_chomage_intemperies": + get: + summary: Certificat cotisations CIBTP + tags: + - Attestations sociales et fiscales + parameters: + - name: context + in: query + description: |- + "**Cadre de la requête** + + Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application." + example: Context de test + required: true + schema: + type: string + - name: recipient + in: query + description: |- + "**Bénéficiaire de l’appel** + + SIRET de l’administration destinatrice des données." + example: '13002526500013' + required: true + schema: + type: string + - name: object + in: query + description: |- + "**La raison de l’appel ou l’identifiant de la procédure.** + + L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )." + example: marché numéro 127 + required: true + schema: + type: string + - name: siret + in: path + required: true + schema: + type: string + security: + - jwt_bearer_token: [] + description: Certificat indiquant qu'une entreprise du BTP affiliée à la caisse + CIBTP est en règle de ses cotisations congés payés et au chômage-intempéries. + responses: + '401': + description: Non autorisé + content: + application/json: + examples: + invalid_token_error: + value: + errors: + - code: '00101' + title: Interdit + detail: Votre token n'est pas valide ou n'est pas renseigné + source: + parameter: token + meta: {} + summary: Interdit + description: Votre token n'est pas valide ou n'est pas renseigné + old_token_error: + value: + errors: + - code: '00102' + title: Format de jeton plus supporté + detail: Vous avez utilisé un token à l'ancien format. Ce format + n'est plus supporté depuis avril 2019. Vous devez refaire + une demande à API Entreprise, un guide est disponible sur + https://entreprise.api.gouv.fr/demander_un_acces/ + source: + parameter: token + meta: {} + summary: Format de jeton plus supporté + description: Vous avez utilisé un token à l'ancien format. Ce format + n'est plus supporté depuis avril 2019. Vous devez refaire une + demande à API Entreprise, un guide est disponible sur https://entreprise.api.gouv.fr/demander_un_acces/ + expired_token_error: + value: + errors: + - code: '00103' + title: Jeton expiré + detail: Votre token est expiré. Vous devez refaire une demande + à API Entreprise, un guide est disponible sur https://entreprise.api.gouv.fr/faq#comment-renouveler-mon-jeton-arrivant-a-expiration + source: + parameter: token + meta: {} + summary: Jeton expiré + description: Votre token est expiré. Vous devez refaire une demande + à API Entreprise, un guide est disponible sur https://entreprise.api.gouv.fr/faq#comment-renouveler-mon-jeton-arrivant-a-expiration + blacklisted_token_error: + value: + errors: + - code: '00105' + title: Jeton sur liste noire + detail: 'Votre jeton est sur liste noire, celui-ci a certainement + été divulgué sur un canal non-sécurisé. Vous pouvez trouver + un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte' + source: + parameter: token + meta: {} + summary: Jeton sur liste noire + description: 'Votre jeton est sur liste noire, celui-ci a certainement + été divulgué sur un canal non-sécurisé. Vous pouvez trouver un + jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte' + schema: + "$ref": "#/components/schemas/Error" + '403': + description: Accès interdit + content: + application/json: + examples: + insufficient_privileges_error: + value: + errors: + - code: '00100' + title: Privilèges insuffisants + detail: Votre token est valide mais vos privilèges sont insuffisants. + Listez vos privilèges sur /v2/privileges + source: + parameter: token + meta: {} + summary: Privilèges insuffisants + description: Votre token est valide mais vos privilèges sont insuffisants. + Listez vos privilèges sur /v2/privileges + schema: + "$ref": "#/components/schemas/Error" + '429': + description: Trop de requêtes + content: + application/json: + examples: + too_many_requests_error: + value: + errors: + - code: '00429' + title: Trop de requêtes + detail: Vous avez effectué trop de requêtes + source: + meta: {} + summary: Trop de requêtes + description: Vous avez effectué trop de requêtes + schema: + "$ref": "#/components/schemas/Error" + '200': + description: Entreprise trouvée + headers: + RateLimit-Limit: + schema: + type: integer + description: La limite concernant l’endpoint appelé, soit le nombre + de requête/minute. + example: 50 + RateLimit-Remaining: + schema: + type: integer + description: Le nombre d’appels restants durant la période courante + d’une minute. + example: 47 + RateLimit-Reset: + schema: + type: integer + description: La fin de la période courante (en format timestamp) + example: 1637223155 + x-operationId: api_entreprise_v3_cibtp_attestation_cotisations_conges_payes_chomage_intemperies + content: + application/json: + schema: + type: object + properties: + data: + type: object + properties: + document_url: + title: Lien vers le certificat CIBTP + type: string + nullable: true + description: Ce lien délivre l'attestation au format PDF. + Ce document est automatiquement supprimé après 24h. + example: https://storage.entreprise.api.gouv.fr/siade/1569139162-b99824d9c764aae19a862a0af-attestation_cotisations_conges_payes_chomage_intemperies_cibtp.pdf + expires_in: + title: Expiration du lien + description: Nombre de secondes avant expiration du document + référencé dans 'document_url'. Il s'agit d'une expiration + technique. Ce champ n'est pas une date de fin de validité + de l'attestation + type: integer + nullable: true + example: 3600 + required: + - document_url + - expires_in + additionalProperties: false + links: + type: object + meta: + type: object + required: + - data + - links + - meta + '422': + description: Paramètre(s) invalide(s) + content: + application/json: + examples: + unprocessable_entity_error_siret_error: + value: + errors: + - code: '00302' + title: Entité non traitable + detail: Le numéro de siret n'est pas correctement formatté + source: + parameter: siret + meta: {} + summary: Entité non traitable + description: Le numéro de siret n'est pas correctement formatté + missing_mandatory_params_context_error: + value: + errors: + - code: '00201' + title: Entité non traitable + detail: Le paramètre context est obligatoire + source: + parameter: context + meta: {} + summary: Entité non traitable + description: Le paramètre context est obligatoire + missing_mandatory_params_object_error: + value: + errors: + - code: '00202' + title: Entité non traitable + detail: Le paramètre object est obligatoire + source: + parameter: object + meta: {} + summary: Entité non traitable + description: Le paramètre object est obligatoire + missing_mandatory_params_recipient_error: + value: + errors: + - code: '00203' + title: Entité non traitable + detail: Le paramètre recipient est obligatoire + source: + parameter: recipient + meta: {} + summary: Entité non traitable + description: Le paramètre recipient est obligatoire + schema: + "$ref": "#/components/schemas/Error" + '404': + description: Missing payments + content: + application/json: + schema: + "$ref": "#/components/schemas/Error" + '502': + description: Erreur du fournisseur + content: + application/json: + schema: + "$ref": "#/components/schemas/Error" + examples: + provider_unknown_error: + value: + errors: + - code: '38999' + title: Erreur inconnue du fournisseur de données + detail: La réponse retournée par le fournisseur de données est + invalide et inconnue de notre service. L'équipe technique + a été notifiée de cette erreur pour investigation. + source: + meta: + provider: CIBTP + summary: Erreur inconnue du fournisseur de données + description: La réponse retournée par le fournisseur de données + est invalide et inconnue de notre service. L'équipe technique + a été notifiée de cette erreur pour investigation. + '504': + description: Erreur d'intermédiaire + content: + application/json: + examples: + timeout_error: + value: + errors: + - code: '38002' + title: Intermédiaire hors-délai + detail: Temps d’attente d’une réponse du fournisseur de données + écoulé. + source: + meta: + provider: CIBTP summary: Intermédiaire hors-délai description: Temps d’attente d’une réponse du fournisseur de données écoulé. provider_unavailable_error: value: errors: - - code: '33001' + - code: '38001' title: Service non disponible detail: Service du fournisseur de données temporairement indisponible ou en maintenance. source: meta: - provider: CARIF-OREF + provider: CIBTP summary: Service non disponible description: Service du fournisseur de données temporairement indisponible ou en maintenance. @@ -2423,12 +2838,12 @@ paths: dns_resolution_error: value: errors: - - code: '33004' + - code: '38004' title: Erreur de résolution DNS detail: Problème de résolution DNS de l'adresse du serveur source: meta: - provider: CARIF-OREF + provider: CIBTP summary: Erreur de résolution DNS description: Problème de résolution DNS de l'adresse du serveur schema: @@ -2439,10 +2854,10 @@ paths: source: |- curl -X GET \ -H "Authorization: Bearer $token" \ - --url "https://entreprise.api.gouv.fr/v3/carif_oref/etablissements/13002526500013/certifications_qualiopi_france_competences?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010" + --url "https://entreprise.api.gouv.fr/v3/cibtp/etablissements/13002526500013/attestation_cotisations_conges_payes_chomage_intemperies?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010" "/v3/cnetp/unites_legales/{siren}/attestation_cotisations_conges_payes_chomage_intemperies": get: - summary: Attestation de cotisations congés payés & chômage-intempéries + summary: Certificat cotisations CNETP tags: - Attestations sociales et fiscales parameters: @@ -2483,9 +2898,8 @@ paths: type: string security: - jwt_bearer_token: [] - description: Attestation de cotisations, délivrée par la Caisse nationale des - entrepreneurs de travaux publics (CNETP), attestant le respect des obligations - relatives aux congés payés et au chômage-intempéries. + description: Certificat indiquant qu'une entreprise du BTP affiliée à la caisse + CNETP est en règle de ses cotisations congés payés et au chômage-intempéries. responses: '401': description: Non autorisé @@ -2617,10 +3031,10 @@ paths: properties: document_url: type: string - title: Lien vers l'attestation de cotisation retraite ProBTP - description: Ce document est automatiquement supprimé au bout - de 3 mois. - example: https://storage.entreprise.api.gouv.fr/siade/1569139162-b99824d9c764aae19a862a0af-attestation_cotisation_retraite_probtp.pdf + title: Lien vers l'attestation de cotisations + description: Ce lien délivre l'attestation au format PDF. + Ce document est automatiquement supprimé au bout de 24h. + example: https://storage.entreprise.api.gouv.fr/siade/1569139162-b99824d9c764aae19a862a0af-certificat_cnetp.pdf expires_in: type: integer example: 7889238 @@ -2769,6 +3183,23 @@ paths: description: Non trouvé content: application/json: + examples: + entite_non_trouvee_08003: + value: + errors: + - code: '08003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: CNETP + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '504': @@ -3133,6 +3564,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_16003: + value: + errors: + - code: '16003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: DGDDI + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -3477,6 +3925,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_03003: + value: + errors: + - code: '03003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: DGFIP - Adélie + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '422': @@ -3946,6 +4411,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_03003: + value: + errors: + - code: '03003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: DGFIP - Adélie + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '422': @@ -4400,6 +4882,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_03003: + value: + errors: + - code: '03003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: DGFIP - Adélie + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '422': @@ -5001,6 +5500,23 @@ paths: description: Pas de liasses fiscales pour cette unité légale content: application/json: + examples: + entite_non_trouvee_03003: + value: + errors: + - code: '03003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: DGFIP - Adélie + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '422': @@ -6880,6 +7396,23 @@ paths: description: Association non trouvée content: application/json: + examples: + entite_non_trouvee_29003: + value: + errors: + - code: '29003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: DJEPVA + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '504': @@ -8292,6 +8825,23 @@ paths: description: Association non trouvée content: application/json: + examples: + entite_non_trouvee_29003: + value: + errors: + - code: '29003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: DJEPVA + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '504': @@ -8559,6 +9109,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_28003: + value: + errors: + - code: '28003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: Commission Européenne + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '422': @@ -9043,6 +9610,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_14003: + value: + errors: + - code: '14003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: Fabrique numérique des Ministères Sociaux + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -9462,6 +10046,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_12003: + value: + errors: + - code: '12003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: FNTP + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '504': @@ -9848,6 +10449,23 @@ paths: description: Effectifs non trouvés content: application/json: + examples: + entite_non_trouvee_31003: + value: + errors: + - code: '31003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: GIP-MDS + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -10295,6 +10913,23 @@ paths: description: Effectifs non trouvés content: application/json: + examples: + entite_non_trouvee_31003: + value: + errors: + - code: '31003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: GIP-MDS + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -10749,7 +11384,11 @@ paths: se voir affecter la valeur '00.00Z' de manière provisoire. \n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de l'Insee - : https://www.insee.fr/fr/information/2120875" + : https://www.insee.fr/fr/information/2120875. \n \n + ⚠️ À partir de janvier 2026, le code APE utilisera la + nouvelle nomenclature NAF 2025, tel qu'explicité dans + ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. + Des tables de correspondance seront fournies par l'Insee." example: 6420Z required: - activite @@ -11099,6 +11738,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_02003: + value: + errors: + - code: '02003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: Infogreffe + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -11631,6 +12287,23 @@ paths: description: Entreprise non trouvée content: application/json: + examples: + entite_non_trouvee_02003: + value: + errors: + - code: '02003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: Infogreffe + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -12005,6 +12678,23 @@ paths: description: Actes non trouvés content: application/json: + examples: + entite_non_trouvee_05003: + value: + errors: + - code: '05003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INPI + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -12505,6 +13195,23 @@ paths: description: Brevets non trouvés content: application/json: + examples: + entite_non_trouvee_05003: + value: + errors: + - code: '05003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INPI + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -12905,6 +13612,23 @@ paths: description: Marques non trouvées content: application/json: + examples: + entite_non_trouvee_05003: + value: + errors: + - code: '05003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INPI + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -13327,6 +14051,23 @@ paths: description: Modèles non trouvés content: application/json: + examples: + entite_non_trouvee_05003: + value: + errors: + - code: '05003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INPI + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -13756,6 +14497,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_34003: + value: + errors: + - code: '34003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INPI - RNE + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -13846,7 +14604,7 @@ paths: curl -X GET \ -H "Authorization: Bearer $token" \ --url "https://entreprise.api.gouv.fr/v3/inpi/rne/unites_legales/open_data/130025265/actes_bilans?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010" - "/v3/inpi/rne/unites_legales/open_data/{siren}/beneficiaires_effectifs": + "/v3/inpi/rne/unites_legales/{siren}/beneficiaires_effectifs": get: summary: Bénéficiaires effectifs tags: @@ -14785,6 +15543,23 @@ paths: description: Bénéficiaires effectifs non trouvés content: application/json: + examples: + entite_non_trouvee_34003: + value: + errors: + - code: '34003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INPI - RNE + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '422': @@ -14925,7 +15700,7 @@ paths: source: |- curl -X GET \ -H "Authorization: Bearer $token" \ - --url "https://entreprise.api.gouv.fr/v3/inpi/rne/unites_legales/open_data/130025265/beneficiaires_effectifs?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010" + --url "https://entreprise.api.gouv.fr/v3/inpi/rne/unites_legales/130025265/beneficiaires_effectifs?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010" "/v3/insee/sirene/etablissements/{siret}/adresse": get: summary: Adresse établissement @@ -15443,6 +16218,23 @@ paths: description: Non trouvé content: application/json: + examples: + entite_non_trouvee_01003: + value: + errors: + - code: '01003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INSEE + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -16080,6 +16872,23 @@ paths: description: Non trouvé content: application/json: + examples: + entite_non_trouvee_01003: + value: + errors: + - code: '01003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INSEE + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -16430,7 +17239,11 @@ paths: voir affecter la valeur '00.00Z' de manière provisoire. \n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de l'Insee - : https://www.insee.fr/fr/information/2120875" + : https://www.insee.fr/fr/information/2120875. \n \n + ⚠️ À partir de janvier 2026, le code APE utilisera la + nouvelle nomenclature NAF 2025, tel qu'explicité dans + ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. + Des tables de correspondance seront fournies par l'Insee." libelle: title: Libellé associé au code APE type: string @@ -16842,7 +17655,12 @@ paths: valeur '00.00Z' de manière provisoire. \n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de - l'Insee : https://www.insee.fr/fr/information/2120875" + l'Insee : https://www.insee.fr/fr/information/2120875. + \n \n ⚠️ À partir de janvier 2026, le code APE utilisera + la nouvelle nomenclature NAF 2025, tel qu'explicité + dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. + Des tables de correspondance seront fournies par + l'Insee." libelle: title: Libellé associé au code APE type: string @@ -17412,6 +18230,23 @@ paths: description: Non trouvé content: application/json: + examples: + entite_non_trouvee_01003: + value: + errors: + - code: '01003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INSEE + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '451': @@ -17768,7 +18603,11 @@ paths: voir affecter la valeur '00.00Z' de manière provisoire. \n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de l'Insee - : https://www.insee.fr/fr/information/2120875" + : https://www.insee.fr/fr/information/2120875. \n \n + ⚠️ À partir de janvier 2026, le code APE utilisera la + nouvelle nomenclature NAF 2025, tel qu'explicité dans + ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. + Des tables de correspondance seront fournies par l'Insee." libelle: title: Libellé associé au code APE type: string @@ -18200,7 +19039,12 @@ paths: valeur '00.00Z' de manière provisoire. \n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de - l'Insee : https://www.insee.fr/fr/information/2120875" + l'Insee : https://www.insee.fr/fr/information/2120875. + \n \n ⚠️ À partir de janvier 2026, le code APE utilisera + la nouvelle nomenclature NAF 2025, tel qu'explicité + dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. + Des tables de correspondance seront fournies par + l'Insee." libelle: title: Libellé associé au code APE type: string @@ -18798,6 +19642,23 @@ paths: description: Non trouvé content: application/json: + examples: + entite_non_trouvee_01003: + value: + errors: + - code: '01003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INSEE + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -19146,7 +20007,11 @@ paths: voir affecter la valeur '00.00Z' de manière provisoire. \n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de l'Insee - : https://www.insee.fr/fr/information/2120875" + : https://www.insee.fr/fr/information/2120875. \n \n + ⚠️ À partir de janvier 2026, le code APE utilisera la + nouvelle nomenclature NAF 2025, tel qu'explicité dans + ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. + Des tables de correspondance seront fournies par l'Insee." libelle: title: Libellé associé au code APE type: string @@ -19578,7 +20443,12 @@ paths: valeur '00.00Z' de manière provisoire. \n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de - l'Insee : https://www.insee.fr/fr/information/2120875" + l'Insee : https://www.insee.fr/fr/information/2120875. + \n \n ⚠️ À partir de janvier 2026, le code APE utilisera + la nouvelle nomenclature NAF 2025, tel qu'explicité + dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. + Des tables de correspondance seront fournies par + l'Insee." libelle: title: Libellé associé au code APE type: string @@ -20176,6 +21046,23 @@ paths: description: Non trouvé content: application/json: + examples: + entite_non_trouvee_01003: + value: + errors: + - code: '01003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INSEE + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -20525,7 +21412,11 @@ paths: voir affecter la valeur '00.00Z' de manière provisoire. \n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de l'Insee - : https://www.insee.fr/fr/information/2120875" + : https://www.insee.fr/fr/information/2120875. \n \n + ⚠️ À partir de janvier 2026, le code APE utilisera la + nouvelle nomenclature NAF 2025, tel qu'explicité dans + ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. + Des tables de correspondance seront fournies par l'Insee." libelle: title: Libellé associé au code APE type: string @@ -20937,7 +21828,12 @@ paths: valeur '00.00Z' de manière provisoire. \n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de - l'Insee : https://www.insee.fr/fr/information/2120875" + l'Insee : https://www.insee.fr/fr/information/2120875. + \n \n ⚠️ À partir de janvier 2026, le code APE utilisera + la nouvelle nomenclature NAF 2025, tel qu'explicité + dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. + Des tables de correspondance seront fournies par + l'Insee." libelle: title: Libellé associé au code APE type: string @@ -21507,6 +22403,23 @@ paths: description: Non trouvé content: application/json: + examples: + entite_non_trouvee_01003: + value: + errors: + - code: '01003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INSEE + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -21879,6 +22792,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_01003: + value: + errors: + - code: '01003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INSEE + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '422': @@ -22469,7 +23399,11 @@ paths: affecter la valeur '00.00Z' de manière provisoire. \n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de l'Insee - : https://www.insee.fr/fr/information/2120875" + : https://www.insee.fr/fr/information/2120875. \n \n + ⚠️ À partir de janvier 2026, le code APE utilisera la + nouvelle nomenclature NAF 2025, tel qu'explicité dans + ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. + Des tables de correspondance seront fournies par l'Insee." libelle: title: Libellé associé au code APE type: string @@ -22761,6 +23695,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_01003: + value: + errors: + - code: '01003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INSEE + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -23324,7 +24275,11 @@ paths: affecter la valeur '00.00Z' de manière provisoire. \n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050 Nomemclature d'activité française - NAF rév.2 de l'Insee - : https://www.insee.fr/fr/information/2120875" + : https://www.insee.fr/fr/information/2120875. \n \n + ⚠️ À partir de janvier 2026, le code APE utilisera la + nouvelle nomenclature NAF 2025, tel qu'explicité dans + ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067. + Des tables de correspondance seront fournies par l'Insee." libelle: title: Libellé associé au code APE type: string @@ -23616,6 +24571,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_01003: + value: + errors: + - code: '01003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: INSEE + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -24117,6 +25089,23 @@ paths: description: Association not found content: application/json: + examples: + entite_non_trouvee_21003: + value: + errors: + - code: '21003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: MI + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '504': @@ -24583,6 +25572,23 @@ paths: description: Association not found content: application/json: + examples: + entite_non_trouvee_21003: + value: + errors: + - code: '21003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: MI + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '504': @@ -24954,6 +25960,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_10003: + value: + errors: + - code: '10003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: MSA + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -25403,6 +26426,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_11003: + value: + errors: + - code: '11003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: OPQIBI + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -25850,6 +26890,23 @@ paths: description: Attestation non trouvée content: application/json: + examples: + entite_non_trouvee_09003: + value: + errors: + - code: '09003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: ProBTP + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '504': @@ -26166,6 +27223,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_09003: + value: + errors: + - code: '09003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: ProBTP + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -26614,6 +27688,23 @@ paths: description: Certification non trouvée content: application/json: + examples: + entite_non_trouvee_06003: + value: + errors: + - code: '06003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: Qualibat + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '504': @@ -27161,6 +28252,23 @@ paths: description: Certification non trouvée content: application/json: + examples: + entite_non_trouvee_06003: + value: + errors: + - code: '06003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: Qualibat + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '504': @@ -27743,6 +28851,23 @@ paths: description: Non trouvée content: application/json: + examples: + entite_non_trouvee_32003: + value: + errors: + - code: '32003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: Qualifelec + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -28124,6 +29249,23 @@ paths: description: Entreprise non trouvée content: application/json: + examples: + entite_non_trouvee_22003: + value: + errors: + - code: '22003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: RNM + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '502': @@ -28694,6 +29836,23 @@ paths: description: Entreprise non trouvée content: application/json: + examples: + entite_non_trouvee_04003: + value: + errors: + - code: '04003' + title: Entité non trouvée + detail: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez + vérifier que l'identifiant correspond au périmètre couvert + par l'API. + source: + meta: + provider: ACOSS + summary: Entité non trouvée + description: Le siret ou siren indiqué n'existe pas, n'est pas connu + ou ne comporte aucune information pour cet appel. Veuillez vérifier + que l'identifiant correspond au périmètre couvert par l'API. schema: "$ref": "#/components/schemas/Error" '504': diff --git a/config/endpoints/api_entreprise/19_cnetp_attestations_cotisations_conges_payes_chomage_intemperies.yml b/config/endpoints/api_entreprise/19_cnetp_attestations_cotisations_conges_payes_chomage_intemperies.yml index 7b499f28a..7e11532a0 100644 --- a/config/endpoints/api_entreprise/19_cnetp_attestations_cotisations_conges_payes_chomage_intemperies.yml +++ b/config/endpoints/api_entreprise/19_cnetp_attestations_cotisations_conges_payes_chomage_intemperies.yml @@ -5,16 +5,18 @@ position: 300 perimeter: entity_type_description: |+ - Cette API couvre les **entreprises exerçant une ou plusieurs activités entrant dans le champ d'application des conventions collectives nationales étendues des Travaux Publics et du Bâtiment** : - - ✅ Convention collective nationale des ouvriers des travaux publics du 15 décembre 1992 (étendue par arrêté du 27 mai 1993) ; - - ✅ Convention collective nationale des ETAM des travaux publics du 12 juillet 2006 (étendue par arrêté du 28 juin 2007) ; - - ✅ Convention collective nationale des cadres des travaux publics du 20 novembre 2015 (étendue par arrêté du 5 juin 2020). + Cette API couvre les **✅ entreprises cotisant à la caisse nationale pour les entrepreneurs de travaux publics (CNETP)** appartenant au réseau CIBTP France. Ces entreprises entrent dans le champ d'application des conventions collectives nationales du bâtiment et des travaux publics. Consulter les conventions concernées. - Toutes les attestations sont disponibles pour les **entreprises en situation régulière** ❌ sauf pour celles qui règlent les cotisations dues à la CNETP au travers de l’URSSAF dans le cadre du Titre Emploi Service Entreprise (TESE). + **Ne sont pas concernées par cette API :** + - ❌ les entreprises relevant des [autres caisses du réseau CIBTP France](#caisses-cibtp). Il est difficile d'anticiper si une entreprise du BTP cotise à la CNETP ou aux autres caisses de la CIBTP. Il est donc recommandé de faire un appel aux deux API systématiquement. Pour accéder aux certificats CIBTP, veuillez consulter [cette API](<%= endpoint_path(uid: 'cibtp/attestations_cotisations_conges_payes_chomage_intemperies') %>) ; + - ❌ les entreprises qui règlent les cotisations dues à la CNETP au travers de l’URSSAF dans le cadre du Titre Emploi Service Entreprise (TESE) et dont le système d'information de la CNETP n'a pas l'attestation. + geographical_scope_description: |+ + La caisse CNETP couvre les entreprises de : + - ✅ Métropole + - ✅ Guadeloupe, Guyane, Martinique, la Réunion. know_more_description: |+ - - le [site de la CNETP](https://www.cnetp.org/category/affiliation/){:target="_blank"} est une source d'information ; - - l'[article D.3141-12 du code du travail](https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000020572124/){:target="_blank"} définit les entreprises qui sont tenues d’adhérer auprès d'une Caisse de Congés Payés du BTP ; - Dans les entreprises exerçant une ou plusieurs activités entrant dans le champ d'application des conventions collectives nationales étendues du bâtiment et des travaux publics, le service des congés est assuré, sur la base de celles-ci, par des caisses constituées à cet effet. + - le [site de la CNETP](https://www.cnetp.org/category/affiliation/){:target="_blank"} ; + - l'[article D.3141-12 du code du travail](https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000020572124/){:target="_blank"} qui définit les entreprises qui sont tenues d’adhérer auprès d'une caisse de congés payés du BTP. entities: - entreprises call_id: "SIREN" @@ -33,7 +35,7 @@ - 'fraude' data: description: |+ - Cette API permet d'obtenir au format PDF une attestation délivrée à l'entreprise sous réserve que celle-ci soit à jour de ses déclarations et du paiement de cotisations congés payés et chômage-intempéries. + Cette API permet d'obtenir, au format PDF, le certificat délivré à l'entreprise sous réserve que son unité légale soit à jour de ses déclarations et du paiement de cotisations congés payés et chômage-intempéries. {:.fr-h6 .fr-mt-4w} ### Exemple d'attestation PDF : @@ -50,10 +52,36 @@ opening: protected format: - - URL vers l'attestation en PDF + - URL vers le certificat en PDF parameters: - Numéro de SIREN de l'entreprise faq: + - q: Caisses de la CIBTP et distinction avec la CNETP + a: |+ + **D'un point de vue du réseau**, l’Union des caisses de France CIBTP est composée de l’ensemble des caisses Congés Intempéries BTP, c'est-à-dire : + - deux caisses nationales : la caisse nationale pour les entrepreneurs de travaux publics (CNETP) et la caisse nationale pour les sociétés coopératives de production du BTP ; + - **des caisses métropolitaines** pour les entreprises du Bâtiment (une par région) ; + - **de quatre caisses dans les départements d'Outremer** : Guadeloupe, Guyane, Martinique, la Réunion. + + L'ensemble des entreprises du BTP, environ 200 000, sont affiliées à une de ces caisses. + + **D'un point de vue informatique**, toutes les caisses, à l'exception de la CNETP, transmettent leurs certificats à CIBTP France qui les redistribue au travers de [cette autre API](<%= endpoint_path(uid: 'cibtp/attestations_cotisations_conges_payes_chomage_intemperies') %>). Pour des raisons historiques, la CNETP gère elle-même ses certificats et propose donc cette API. + + - q: Conventions collectives des entreprises concernées par cette API + a: |+ + Cette API, comme [celle de la CIBTP](<%= endpoint_path(uid: 'cibtp/attestations_cotisations_conges_payes_chomage_intemperies') %>) couvre des **entreprises dont la particularité est d'exercer une ou plusieurs activités entrant dans le champ d'application des conventions collectives nationales du Bâtiment et des Travaux Publics** : + + - **Bâtiment :** + - ✅ [Convention collective nationale des ouvriers employés par les entreprises du bâtiment](https://www.legifrance.gouv.fr/conv_coll/id/KALICONT000005635221) visées par le décret du 1er mars 1962 (c’est-à-dire occupant jusqu’à 10 salariés) du 8 octobre 1990, étendue par arrêté du 12 février 1991 ; + - ✅ [Convention collective nationale des ouvriers employés par les entreprises du bâtiment](https://www.legifrance.gouv.fr/conv_coll/id/KALICONT000005635220) non visées par le décret du 1er mars 1962 (c’est-à-dire occupant plus de 10 salariés) du 8 octobre 1990, étendue par arrêté du 8 février 1991 ; + - ✅ [Convention collective nationale des employés, techniciens et agents de maîtrise du bâtiment](https://www.legifrance.gouv.fr/conv_coll/id/KALICONT000018773893) du 12 juillet 2006 ; + - ✅ [Convention collective des cadres du bâtiment](https://www.legifrance.gouv.fr/conv_coll/id/KALICONT000017941839) du 1er juin 2004. + + - **Travaux publics :** + - ✅ [Convention collective nationale des ouvriers des travaux publics](https://www.legifrance.gouv.fr/conv_coll/id/KALICONT000005635467) du 15 décembre 1992, étendue par arrêté du 27 mai 1993 ; + - ✅ [Convention collective nationale des employés, techniciens et agents de maîtrise des travaux publics](https://www.legifrance.gouv.fr/conv_coll/id/KALICONT000018926209) du 12 juillet 2006 + - ✅ [Convention collective nationale des cadres des travaux publics](https://www.legifrance.gouv.fr/conv_coll/id/KALISCTA000032426777/?idConteneur=KALICONT000032437525) du 20 novembre 2015. + - q: L'API ne renvoie pas de pièce, peut-on considérer que l'entreprise n'est pas à jour ? a: |+ Non, dans certains cas nous ne pouvons pas récupérer l’attestation. Notamment, cette API ne permet de récupérer les attestations des entreprises réglant leurs cotisations à la CNETP au travers de l'URSSAF (dans le cadre du TESE). diff --git a/config/endpoints/api_entreprise/31_cibtp_attestations_cotisations_chomage_intemperies.yml b/config/endpoints/api_entreprise/31_cibtp_attestations_cotisations_chomage_intemperies.yml new file mode 100644 index 000000000..17df8678b --- /dev/null +++ b/config/endpoints/api_entreprise/31_cibtp_attestations_cotisations_chomage_intemperies.yml @@ -0,0 +1,97 @@ +--- +- uid: 'cibtp/attestations_cotisations_conges_payes_chomage_intemperies' + path: '/v3/cibtp/etablissements/{siret}/attestation_cotisations_conges_payes_chomage_intemperies' + ping_url: '' + position: 299 + perimeter: + entity_type_description: |+ + Cette API couvre les **✅ entreprises cotisant aux [différentes caisses de la CIBTP, sauf celle de la CNETP](#caisses-cibtp)**. Ces entreprises entrent dans le champ d'application des conventions collectives nationales du bâtiment et des travaux publics. Consulter les conventions concernées. + + **❌ Ne sont pas concernées par cette API, les entreprises qui dépendent de la caisse CNETP**. Il est difficile d'anticiper si une entreprise du BTP cotise à la CNETP ou aux autres caisses de la CIBTP. Il est donc recommandé de faire un appel aux deux API systématiquement. Pour accéder aux certificats CNETP, veuillez consulter [cette API](<%= endpoint_path(uid: 'cnetp/attestations_cotisations_conges_payes_chomage_intemperies') %>). + geographical_scope_description: |+ + La caisse CIBTP couvre les entreprises de : + - ✅ Métropole + - ✅ Guadeloupe, Guyane, Martinique, la Réunion. + updating_rules_description: |+ + Les certificats transmis par cette API sont **mis à jour en temps réel**, directement depuis le système d’information de la CIBTP qui interroge les SI des différentes caisses régionales. Les certificats correspondent donc à la situation de l'entreprise telle que connue par CIBTP France. + know_more_description: |+ + - le [site de la CIBTP](https://www.cnetp.org/category/affiliation/){:target="_blank"} est une source d'information ; + - l'[article D.3141-12 du code du travail](https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000020572124/){:target="_blank"} définit les entreprises sont tenues d’adhérer auprès d'une caisse de congés payés du BTP. + entities: + - entreprises + call_id: "SIRET" + provider_uids: + - 'cibtp' + keywords: + - 'conformité' + - 'conforme' + - 'obligations' + - 'cotisations' + - 'btp' + - 'bâtiment' + - 'travaux' + - 'marchés publics' + - 'Aides publiques' + - 'fraude' + data: + description: |+ + Cette API permet : + - d'obtenir, au format PDF, le certificat délivré à l'entreprise sous réserve que l'unité légale soit à jour de ses déclarations et du paiement de cotisations congés payés et chômage-intempéries. + - de savoir si une entreprise n'est pas à jour de ses cotisations, avec l'envoi d'une réponse spécifique (`code 422`). + + + {:.fr-highlight} + > ⏳ La durée de validité du certificat est d'un mois à compter de la date figurant sur le certificat + + {:.fr-highlight} + > 💡 Cette API est appelable avec le SIRET d'un établissement, mais **c'est bien l'unité légale qui est certifiée par la CIBTP**. + + {:.fr-h6 .fr-mt-4w} + ### Exemple d'attestation PDF : + +
+ + opening: protected + parameters: + - Numéro de SIRET de l'établissement + format: + - URL vers le certificat en PDF + faq: + - q: Caisses de la CIBTP et distinction avec la CNETP + a: |+ + **D'un point de vue du réseau**, l’Union des caisses de France CIBTP est composée de l’ensemble des caisses Congés Intempéries BTP, c'est-à-dire : + - deux caisses nationales : la caisse nationale pour les entrepreneurs de travaux publics (CNETP) et la caisse nationale pour les sociétés coopératives de production du BTP ; + - **des caisses métropolitaines** pour les entreprises du Bâtiment (une par région) ; + - **de quatre caisses dans les départements d'Outremer** : Guadeloupe, Guyane, Martinique, la Réunion. + + L'ensemble des entreprises du BTP, environ 200 000, sont affiliées à une de ces caisses. + + **D'un point de vue informatique**, toutes les caisses, à l'exception de la CNETP, transmettent leurs certificats à CIBTP France qui les redistribue au travers de cette API. Pour des raisons historiques, la CNETP gère elle-même ses certificats et propose donc une API différente, disponible [ici](<%= endpoint_path(uid: 'cnetp/attestations_cotisations_conges_payes_chomage_intemperies') %>). + + - q: Conventions collectives des entreprises concernées par cette API + a: |+ + Cette API, comme [celle de la CNETP](<%= endpoint_path(uid: 'cnetp/attestations_cotisations_conges_payes_chomage_intemperies') %>) couvre des **entreprises dont la particularité est d'exercer une ou plusieurs activités entrant dans le champ d'application des conventions collectives nationales du Bâtiment et des Travaux Publics** : + + - **Bâtiment :** + - ✅ [Convention collective nationale des ouvriers employés par les entreprises du bâtiment](https://www.legifrance.gouv.fr/conv_coll/id/KALICONT000005635221) visées par le décret du 1er mars 1962 (c’est-à-dire occupant jusqu’à 10 salariés) du 8 octobre 1990, étendue par arrêté du 12 février 1991 ; + - ✅ [Convention collective nationale des ouvriers employés par les entreprises du bâtiment](https://www.legifrance.gouv.fr/conv_coll/id/KALICONT000005635220) non visées par le décret du 1er mars 1962 (c’est-à-dire occupant plus de 10 salariés) du 8 octobre 1990, étendue par arrêté du 8 février 1991 ; + - ✅ [Convention collective nationale des employés, techniciens et agents de maîtrise du bâtiment](https://www.legifrance.gouv.fr/conv_coll/id/KALICONT000018773893) du 12 juillet 2006 ; + - ✅ [Convention collective des cadres du bâtiment](https://www.legifrance.gouv.fr/conv_coll/id/KALICONT000017941839) du 1er juin 2004. + + - **Travaux publics :** + - ✅ [Convention collective nationale des ouvriers des travaux publics](https://www.legifrance.gouv.fr/conv_coll/id/KALICONT000005635467) du 15 décembre 1992, étendue par arrêté du 27 mai 1993 ; + - ✅ [Convention collective nationale des employés, techniciens et agents de maîtrise des travaux publics](https://www.legifrance.gouv.fr/conv_coll/id/KALICONT000018926209) du 12 juillet 2006 + - ✅ [Convention collective nationale des cadres des travaux publics](https://www.legifrance.gouv.fr/conv_coll/id/KALISCTA000032426777/?idConteneur=KALICONT000032437525) du 20 novembre 2015. + + - q: L'API ne renvoie pas de pièce, peut-on considérer que l'entreprise n'est pas à jour ? + a: |+ + Vous pouvez considérer que l'entreprise n'est pas à jour si l'API renvoie la réponse spécifique dédiée (`code 422`). diff --git a/config/locales/api_entreprise/cas_usages_entries.fr.yml b/config/locales/api_entreprise/cas_usages_entries.fr.yml index 598aa90bf..18120abfb 100644 --- a/config/locales/api_entreprise/cas_usages_entries.fr.yml +++ b/config/locales/api_entreprise/cas_usages_entries.fr.yml @@ -30,6 +30,7 @@ fr: - probtp/conformites_cotisations_retraite - fntp/carte_professionnelle_travaux_public - cnetp/attestations_cotisations_conges_payes_chomage_intemperies + - cibtp/attestation-cotisations-conges-payes-chomage-intemperies - qualifelec/certificats - inpi/brevets - carif_oref/certifications_qualiopi_france_competences @@ -118,7 +119,9 @@ fr: "fntp/carte_professionnelle_travaux_public": "Instruction **Justificatif d'absence de motif d'exclusion** : vérifier la régularité sociale, des candidats soumis à cotisations congés payés, en vertu de l'[article L2141-2 du Code de la commande publique](https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000037703593){:target='_blank'}. La **carte professionnelle par la FNTP** est délivrée seulement si l'entreprise est à jour de ses cotisations.