Aller au contenu principal
SDK PHP open source · MITPublié sur Packagist

SDK PHP de l’API Attestations Vérification Code Sécurité

Vérifier une attestation Urssaf à partir de son code de sécurité

Le SDK vérifie qu’une attestation Urssaf est authentique et valide à partir du code de sécurité imprimé dessus. Il renvoie soit une attestation vérifiée et typée selon sa nature, soit le motif du refus.

thebeardedbear/urssaf-attestations-verification-code-securite

Parler de mon intégration Urssaf
Pour qui

À qui sert cette API

Donneurs d’ordre, plateformes de gestion des sous-traitants et éditeurs qui contrôlent les attestations de vigilance, CSG/CRDS ou de chiffre d’affaires de leurs fournisseurs.

Authentification
OAuth2 client credentials, scope attn.codes_securite
Accès à l’API
Souscription par formulaire sur le portail API Urssaf, accès validé par l’Acoss.

Fiche de l’API sur le portail Urssaf

Périmètre

Ce que couvre le SDK

  • GETVérifier un code de sécurité
  • POSTVérifier jusqu’à 100 codes en un appel

Fonctionnalités

  • Natures couvertes : attestation de vigilance (Urssaf et ISU), part déductible CSG/CRDS, formation professionnelle, employeur de personnel de maison, frontalier suisse, chiffre d’affaires des micro-entrepreneurs, AGESSA.
  • Résultat typé : VerifiedCertificate (nature, organisme, date, données propres à la nature) ou RejectedCode (périmée, inconnue, donnée manquante).
  • Erreurs mappées (FUNC013, FUNC015, FUNC201 à FUNC203) ; erreurs temporaires 429/500/503 réessayables en respectant Retry-After.
  • SDK sans état : aucune persistance à prévoir.
  • Bundle Symfony avec recette Flex et commande urssaf:certificate:verify, builder autonome, passerelle simulée.
  • Tests de contrat contre le bac à sable Urssaf, 10 décisions d’architecture documentées.
Installation

Installer le SDK

composer require thebeardedbear/urssaf-attestations-verification-code-securite

Version v0.1.1, documentation Urssaf 1.2.1 implémentée. PHP 8.2+, bundle Symfony optionnel, client HTTP PSR-18 au choix.

Preuves de qualité publiques

Qualité

Le même standard pour chaque SDK

Rapports publics accessibles depuis les liens ci-dessus.

Architecture hexagonale

Domaine, application, infrastructure et bridges séparés, règles de dépendance vérifiées par Deptrac. Le domaine reste du PHP pur.

Avec ou sans Symfony

Bundle Symfony (6.4 LTS ou 7.4) et builder autonome sans framework. À l’exécution, le SDK ne dépend que d’interfaces PSR (HTTP, cache, logs).

100 % de couverture et de mutants tués

PHPUnit à 100 % de couverture et Infection à 100 % de MSI, bloquants en CI, comme PHPStan au niveau max, Mago, PHP-CS-Fixer et Rector.

Testable sans réseau

Une passerelle Urssaf simulée pour tester votre application de bout en bout, et des tests de contrat contre le bac à sable Urssaf.

Secrets jamais persistés

Identifiants OAuth2 lus depuis l’environnement ou un fournisseur dédié, jamais sérialisés. Les logs ne contiennent ni jeton ni corps de requête.

PHP 8.2 à 8.4 testés

CI sur PHP 8.2, 8.3 et 8.4 avec les dépendances minimales et maximales. SemVer, changelog et politique de sécurité dans chaque dépôt.

Accompagnement

De l’habilitation à la production

Habilitation et homologation

Demande d’accès à l’API, souscription, tests en bac à sable et passage en production : je prépare le dossier et les échanges avec l’Urssaf.

Intégration dans votre application

Branchement du SDK dans votre code : bundle Symfony, persistance Doctrine ou PHP sans framework, crons et workers, reprise d’une intégration maison.

Support avec délai de réponse garanti

Un interlocuteur qui connaît le SDK et l’API, avec un délai de réponse contractuel, et le suivi des évolutions des API Urssaf.

Développements sur mesure

Ce qui est propre à votre métier, construit au-dessus du SDK : écrans, rapprochements, exports, règles spécifiques.

Sur devis, après un appel de cadrage de 30 min.

Parler de mon intégration Urssaf
FAQ

Questions fréquentes

Intégrer l’API Attestations Vérification Code Sécurité ?

Un appel de 30 min pour cadrer l’API, votre application et ce que vous souhaitez déléguer. Devis ensuite, sans engagement.

Parler de mon intégration Urssaf