Aller au contenu principal
SDK PHP open source · MITBientôt disponible

SDK PHP de l’API Tierce Déclaration PAJE

Déclarer les salaires Pajemploi pour le compte des parents employeurs

L’API permet à une plateforme mandatée par un parent employeur d’estimer les cotisations d’une activité Pajemploi, de prédéclarer puis déclarer le salaire versé et d’appliquer le prélèvement à la source.

thebeardedbear/urssaf-tierce-declaration-paje

Parler de mon intégration Urssaf
Pour qui

À qui sert cette API

Plateformes de garde d’enfants et éditeurs qui gèrent, pour des parents employeurs, la déclaration Pajemploi d’une assistante maternelle agréée ou d’une garde d’enfants à domicile.

Authentification
OAuth2 client credentials, scope tiersdecl.paje
Accès à l’API
Accès restreint : demande validée par l’Acoss, mandat requis de chaque employeur.

Fiche de l’API sur le portail Urssaf

Périmètre

Ce que couvrira le SDK

SDK pas encore développé. Les méthodes ci-dessous sont celles de l’API, que le SDK couvrira, sur la même architecture que les SDK publiés.

  • PAJE020Vérifier un compte employeur
  • PAJE021Vérifier un compte salarié
  • PAJE022Vérifier les enfants ouvrant droit
  • PAJE023Associer un salarié à un employeur
  • PAJE030Enregistrer un mandat
  • PAJE031Révoquer un mandat
  • PAJE040Estimer les cotisations (assistante maternelle)
  • PAJE041Estimer les cotisations (garde à domicile)
  • PAJE045Prédéclarer un salaire (assistante maternelle)
  • PAJE046Prédéclarer un salaire (garde à domicile)
  • PAJE050Déclarer un salaire (assistante maternelle)
  • PAJE051Déclarer un salaire (garde à domicile)

Points d’attention de l’API

  • Les deux modes de garde, assistante maternelle (AMA) et garde à domicile (GED), traités comme des flux distincts.
  • Prédéclaration avant déclaration, pour valider les montants avec l’employeur.
  • Un mandat par employeur, condition préalable à toute déclaration.
Qualité

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.

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 Tierce Déclaration PAJE ?

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