SDK PHP de l’API Tierce Déclaration CESU
Déclarer les salaires Cesu pour le compte d’un particulier employeur
L’API permet à une plateforme d’agir en tiers déclarant pour un particulier employeur : adhésion au Cesu, activation de Cesu+ et de l’avance immédiate (AICI), estimation des cotisations, déclaration du salaire avec prélèvement à la source et gestion des mandats.
thebeardedbear/urssaf-tierce-declaration-cesu
Parler de mon intégration UrssafÀ qui sert cette API
Plateformes et éditeurs qui déclarent, en tiers déclarant, les salaires versés par des particuliers employeurs à leurs salariés à domicile.
- Authentification
- OAuth2 client credentials, scope tiersdecl.cesu
- Accès à l’API
- Accès restreint : souscription via DataPass, demande validée par l’Acoss.
Ce que couvrira le SDK
SDK en cours de développement, pas encore publié. Les méthodes ci-dessous sont celles de l’API, que le SDK couvrira.
CESU010Inscrire un employeurCESU020Vérifier un compte employeurCESU021Vérifier un compte salariéCESU030Enregistrer un mandat de tierce déclarationCESU031Révoquer un mandatCESU040Estimer les cotisationsCESU050Déclarer un salaire (Cesu ou Cesu+ avec AICI)CESU060Activer Cesu+CESU070Activer l’AICI
Points d’attention de l’API
- Cycles de vie employeur, mandat et déclaration modélisés et persistés, avec reprise quand l’issue d’un envoi est inconnue.
- Déclarations standard ou Cesu+ typées séparément, montants exacts au centime.
- Événements d’intégration publics (urssaf.cesu.*) relayés par une outbox.
- Bundle Symfony (commandes, Messenger, Lock, Scheduler) et bridge Doctrine.
Le même standard pour chaque SDK
Le standard que ce SDK respectera à sa publication, comme les SDK déjà publiés.
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 UrssafQuestions fréquentes
Avec Cesu+, l’Urssaf prélève le salaire chez l’employeur et le verse au salarié. Combiné à l’AICI, l’employeur ne paie que le reste à charge après crédit d’impôt. Le SDK sépare les deux types de déclaration pour éviter les mélanges.
Le domaine, les ports et la passerelle OAuth2 sont écrits ; le SDK n’est pas encore publié. Si votre projet en dépend, parlons-en : c’est le prochain de la suite.
Les autres SDK Urssaf
- 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 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
Intégrer l’API Tierce Déclaration CESU ?
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