Intégrer les API Urssaf
dans votre logiciel PHP/Symfony
Une famille de SDK PHP open source (licence MIT), un par API Urssaf, construits sur la même architecture et la même exigence qualité. Je vous accompagne de l’habilitation à la production, puis dans la durée.
Un SDK par API Urssaf
8 API couvertes, 2 SDK déjà publiés sur Packagist sous licence MIT. Les autres suivent, sur la même architecture.
- API Tiers de prestationsPublié sur PackagistL’avance immédiate du crédit d’impôt pour les services à la personneVoir le SDK
- API Attestations Vérification Code SécuritéPublié sur PackagistVérifier une attestation Urssaf à partir de son code de sécuritéVoir le SDK
- API Tierce Déclaration CESUEn développementDéclarer les salaires Cesu pour le compte d’un particulier employeurVoir le SDK
- API Tierce Déclaration PAJEBientôt disponibleDéclarer les salaires Pajemploi pour le compte des parents employeursVoir le SDK
- API Tierce Déclaration auto-entrepreneurBientôt disponibleDéclarer le chiffre d’affaires et payer les cotisations d’un auto-entrepreneurVoir le SDK
- API portail Plateforme numériqueBientôt disponibleLe précompte des cotisations des auto-entrepreneurs par les plateformesVoir le SDK
- API DPAEBientôt disponibleDéposer les déclarations préalables à l’embauche en volumeVoir le SDK
- API Mobilité internationaleBientôt disponibleDéclarer les détachements de salariés dans l’Espace économique européenVoir le SDK
Le même standard pour chaque SDK
Appliqué à chaque SDK dès sa publication. Pour les 2 SDK publiés, les rapports sont publics : couverture, mutation, qualité, OpenSSF Scorecard.
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.
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 UrssafComment se passe une intégration
- 1
Cadrage
Quelle API, pour quel usage, dans quelle application : on fixe le périmètre et le mode d’intégration en un appel.
- 2
Habilitation
Demande d’accès auprès de l’Urssaf (formulaire du portail API ou DataPass selon l’API), puis réception des identifiants.
- 3
Intégration et bac à sable
Le SDK est branché dans votre code, testé sur la passerelle simulée puis contre le bac à sable Urssaf.
- 4
Production
Bascule en production, supervision des premiers envois, crons et reprises en place.
- 5
Support
Suivi des évolutions des API, montées de version du SDK et réponses dans le délai convenu.
Questions fréquentes
Non. Ce sont des implémentations open source indépendantes des API publiques de l’Urssaf, sans lien avec elle. La documentation Urssaf reste la référence, et l’habilitation se demande auprès de l’Urssaf.
Oui, sous licence MIT : vous pouvez les utiliser, les modifier et les intégrer dans un logiciel commercial. L’accompagnement (habilitation, intégration, support) est facturé sur devis.
Non. Chaque SDK fournit un bundle Symfony, mais aussi un builder autonome utilisable dans n’importe quelle application PHP 8.2+, avec le client HTTP PSR-18 de votre choix.
Il dépend de l’API, de votre application et de ce que vous déléguez (dossier d’habilitation, intégration complète, support). Le devis suit un appel de cadrage gratuit.
Ils sont développés l’un après l’autre, sur la même architecture que les SDK publiés. Si votre projet dépend de l’un d’eux, dites-le-moi : cela peut avancer son calendrier.
Une API Urssaf à brancher ?
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