Attestation de vigilance Déprécié
Attestation sociale délivrée à une entreprise acquittée de ses obligations de cotisations et contributions sociales auprès de l'URSSAF Caisse nationale.
URSSAF Caisse nationale
Cette API est dépréciée
Cette API est une ancienne version, nous vous invitons à utiliser ces API les plus récentes :
Plus d'informations sur la gestion de version API Entreprise dans cette documentation.
Périmètre
Entreprises ou associations concernées :
- ✅ les entreprises du régime général ;
- ✅ les associations du régime général, inscrites au répertoire Sirene et ayant donc un SIREN ;
- ✅ les très grandes entreprises ;
- ✅ les professions libérales (certaines n’ont pas de SIREN et ne seront donc pas trouvées par l’API) ;
- ✅ les micro-entrepreneurs de type “profession libérale” ;
- ✅ les firmes étrangères ;
- ✅ les administrations et collectivités territoriales.
Ne sont pas concernées par l’API :
- ❌ les micro-entrepreneurs qui ne sont pas en profession libérale et ❌ les artisans-commerçants. Ces deux catégories ne sont pas appelables avec un numéro de SIREN ;
- ❌ les artistes-auteurs ;
- ❌ les entreprises utilisant le titre-emploi-service (TESE) et ❌ les associations et fondations utilisant le chèque-emploi associatif (CEA). Ces deux catégories ne sont pas appelables car elles ont des déclarations apériodiques.
- ❌ les entreprises qui ne sont pas soumises à cotisations, comme ❌ les entreprises n’employant aucun salarié ou les entreprises radiées.
Périmètre géographique :
- ✅ France métropolitaine ;
- ✅ DROM COM ;
- ✅ Firmes étrangères établies en France.
Actualisation de la donnée :
Les données sont mises à jour chaque nuit, directement auprès du système d’information de l’Urssaf. Il peut donc exister un décalage de 24h au maximum entre les données de l’API et le SI de l’Urssaf.
Cas d'usages
Fiches pratiques et cas d'usages pour lesquels l'API est utile :
Détails de l'API
Format de l'information
- Payload JSON
Identifiant d'appel
- Numéro de SIREN de l'entreprise
Disponibilité
Limite d'appels
Les données
Cette API permet de savoir si l’attestation de vigilance est délivrée par l’Urssaf ou refusée. En cas de délivrance de l’attestation l’API transmet une URL de téléchargement de l’attestation, au format PDF.
L’attestation de vigilance est délivrée sous certaines conditions ; entre autres, si l’entreprise s’est acquitée de ses cotisations et contributions.
Elle a une durée de validité légale de 6 mois à compter de la date d’analyse indiquée sur le document et qui est différente de la date de délivrance du document. En savoir plus.
- Des informations sur l’entreprise :
- Nom de l’unité légale ;
- adresse du siège social ;
- numéro de SIREN ;
- La date de début de la centralisation des obligations sociales de l’entreprise par l’organisme émetteur.
-
La liste des établissements concernés par l’attestation de vigilance et leur numéro de SIRET. S’ils sont tous concernés, une mention l’indique.
- Pour les entreprises ayant des salariés :
- l’effectif moyen mensuel calculé par l’Urssaf à partir des données issues de la déclaration sociale nominative (DSN) ;
- la masse salariale, c’est à dire le total des rémunérations déclarées sur le dernier bordereau récapitulatif des cotisations Urssaf.
-
Un paragraphe listant les obligations sociales en règle, qui peuvent être différentes selon l’entité analysée ;
- Des informations relatives à l’attestation :
- date et lieu de délivrance ;
- code sécurité - 💡 Grâce à API Entreprise vous n’avez pas besoin d’utiliser ce code pour vérifier l’authenticité des documents car toutes nos attestations sont issues directement à l’Urssaf et donc certifiées !
- adresse, courriel et téléphone du service gestionnaire de l’Urssaf.
Exemple d’attestation PDF :
Informations renvoyées en JSON :
Plus d'informations sur le site de l'URSSAF : https://www.urssaf.fr/portail/home/employeur/declarer-et-payer/obtenir-une-attestation/attestation-de-vigilance.html(nouvelle fenêtre)
Erreurs
Lorsque cette API ne peut pas retourner les informations demandées, elle renvoie un code erreur. Les erreurs communes à toutes les API (jeton, paramètres obligatoires, quotas) sont décrites dans la nomenclature des codes erreurs ; celles qui suivent sont celles que cet endpoint peut renvoyer, y compris les erreurs génériques de son fournisseur de données.
Cette liste est aussi servie au format JSON, sans jeton, sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_acoss_attestations_sociales.
| Code | Signification |
|---|---|
00301 |
Entité non traitable
Le numéro de siren n'est pas correctement formatté |
00308 |
Entité non traitable
Le user_id n'est pas correctement formaté |
| Code | Signification |
|---|---|
04003 |
Entité non trouvée
Le ou les paramètre(s) d'entrée n'existent pas, ne sont pas connus, ou ne comportent aucune information pour cet appel. Veuillez vérifier que votre recherche est couverte par le périmètre de l'API. |
| Code | Signification |
|---|---|
00502 |
Erreur réseau du service d'hébergement de données
Problème de connexion au serveur d'hébergement de données. L'erreur peut venir soit du fournisseur, soit de API Entreprise Réessayez dans 10 secondes. |
04000 |
Erreur interne du fournisseur de données
La réponse retournée par le fournisseur de données est invalide et a été identifié comme étant une erreur interne. Si le problème persiste, consultez la page de status ou contactez nous sur le support. |
04001 |
Service non disponible
Service du fournisseur de données temporairement indisponible ou en maintenance. |
04004 |
Erreur de résolution DNS
Problème de résolution DNS de l'adresse du serveur |
04008 |
Erreur auprès du fournisseur de données : trop de requêtes
Erreur de fournisseur de donnée : Trop de requêtes effectuées, veuillez réessayer plus tard. |
04009 |
Erreur de connexion sécurisée (TLS) avec le fournisseur de données
La connexion sécurisée avec le fournisseur de données n'a pas pu être établie : certificat invalide ou expiré, ou échec de la négociation TLS. L'équipe technique a été notifiée de cette erreur pour investigation. |
04011 |
Erreur temporaire du fournisseur de données
Merci de réessayer dans quelques instants |
04051 |
Fichier renvoyé par le fournisseur de données non valide
Erreur lors du décodage : la chaîne de caractères en base64 est invalide |
04055 |
Fichier renvoyé par le fournisseur de données non valide
Le fichier n'est pas au format attendu |
04501 |
Analyse manuelle de la situation du compte en cours
Une analyse humaine par un agent des URSSAF est requise. Le temps de traitement est très variable selon de la complexité de situation, la demande de pièces justificatives complémentaires ou la charge de travail des agents. Réessayez dans 172800 secondes. |
04502 |
Demande de traitement logiciel en cours
Une erreur informatique a eu lieu, une demande de traitement par le logiciel est en cours. |
04503 |
La situation du compte ne permet pas de délivrer l'attestation demandée
Il n'est pas possible de renvoyer l'attestation. Cela peut être dû au fait qu'un des établissements d'une entreprise n'a pas retourné les informations. |
04999 |
Erreur inconnue du fournisseur de données
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. |
| Code | Signification |
|---|---|
04020 |
Maintenance du fournisseur de données
Le fournisseur de données semble être en maintenance |
| Code | Signification |
|---|---|
04002 |
Intermédiaire hors-délai
Temps d’attente d’une réponse du fournisseur de données écoulé. |
Questions & réponses
L’attestation est délivrée si l’entreprise :
- s’est acquitée des cotisations et contributions dues à leur date normale d’exigibilité ;
- a souscrit un plan d’apurement (planification des remboursements) des cotisations et contributions restant dues, qu’elle respecte ;
- s’est acquitée des cotisations et contributions dues, mais n’est pas à jour dans le paiement des majorations et pénalités ;
- ne s’est pas acquittée des cotisations et contributions dues mais en conteste le montant par recours contentieux.
Le cadre précis de délivrance de l’attestation est expliqué sur le site de l’Urssaf.
Depuis 2021, la contribution annuelle de l’OETH (Obligation d’Emploi de Travailleur Handicapé), fait partie des contribution dues pour obtenir l’attestation.
Cette compétence était auparavant attribuée à l’AGEFIPH.
Non, dans certain cas, l’API ne peut pas délivrer l’attestation, cela ne signifie pas que l’entreprise n’est pas à jour.
Conditions d'utilisation des données
Utilisation possible de la donnée :
Conditions générales :
Cette API et l'utilisation de ses données est soumise aux CGU générales d'API Entreprise, dont voici les principaux éléments auxquels vous vous engagez :
- ne demander que les données strictement nécessaires ;
- ne pas utiliser votre jeton d'accès pour une démarche différente de celle indiquée lors de votre demande (le cas échéant le jeton sera révoqué) ;
- présenter les données obtenues uniquement aux seuls agents habilités et à tracer l'accès de ces agents aux données ;
- ne pas commercialiser les données reçues et à ne pas les communiquer à des tiers en dehors des cas prévus par la loi.
L'ensemble des conditions sont consultables et téléchargeables ci-dessous :
CGU API EntrepriseCas d'usages
Fiches pratiques et cas d'usages pour lesquels l'API est utile :
Détails de l'API
Format de l'information
- Payload JSON
Identifiant d'appel
- Numéro de SIREN de l'entreprise