Aller au contenu principal
Bear Urssaf · SDK open source

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.

Qualité

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.

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
Déroulé

Comment se passe une intégration

  1. 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. 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. 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. 4

    Production

    Bascule en production, supervision des premiers envois, crons et reprises en place.

  5. 5

    Support

    Suivi des évolutions des API, montées de version du SDK et réponses dans le délai convenu.

FAQ

Questions fréquentes

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