thebeardedbear / urssaf-plateforme-numerique
Client and domain model for the URSSAF "API portail Plateforme numérique" (digital platforms: identification and declaration files for auto-entrepreneurs)
Package info
github.com/TheBeardedBearSAS/urssaf-plateforme-numerique
Type:symfony-bundle
pkg:composer/thebeardedbear/urssaf-plateforme-numerique
Requires
- php: >=8.2
- ext-filter: *
- ext-json: *
- ext-mbstring: *
- psr/cache: ^2.0 || ^3.0
- psr/clock: ^1.0
- psr/event-dispatcher: ^1.0
- psr/http-client: ^1.0
- psr/http-factory: ^1.1
- psr/http-message: ^1.1 || ^2.0
- psr/log: ^2.0 || ^3.0
- psr/simple-cache: ^2.0 || ^3.0
Requires (Dev)
- carthage-software/mago: ^1.59
- deptrac/deptrac: ^4.7
- doctrine/dbal: ^4.5
- doctrine/doctrine-bundle: ^2.19
- doctrine/orm: ^3.5.3
- doctrine/persistence: ^3.4.1 || ^4.0
- ergebnis/composer-normalize: ^2.56
- ergebnis/phpstan-rules: ^2.17
- friendsofphp/php-cs-fixer: ^3.95
- icanhazstring/composer-unused: ^0.9
- infection/infection: ^0.32
- maglnet/composer-require-checker: ^4.17
- nyholm/psr7: ^1.8.2
- php-http/client-common: ^2.7.2
- php-http/discovery: ^1.19.3
- php-http/httplug: ^2.4.1
- php-http/message: ^1.16.1
- php-http/mock-client: ^1.6.1
- php-http/promise: ^1.2.2
- phpstan/extension-installer: ^1.4
- phpstan/phpdoc-parser: ^2.0
- phpstan/phpstan: ^2.0
- phpstan/phpstan-deprecation-rules: ^2.0
- phpstan/phpstan-doctrine: ^2.1
- phpstan/phpstan-phpunit: ^2.1
- phpstan/phpstan-strict-rules: ^2.1
- phpstan/phpstan-symfony: ^2.1
- phpunit/phpunit: ^11.0
- rector/rector: ^2.8
- roave/security-advisories: dev-latest
- shipmonk/phpstan-rules: ^4.4
- symfony/cache: ^6.4 || ^7.4
- symfony/cache-contracts: ^2.5.3 || ^3.4.2
- symfony/clock: ^6.4.3 || ^7.4
- symfony/console: ^6.4 || ^7.4
- symfony/dependency-injection: ^6.4.26 || ^7.4
- symfony/error-handler: ^6.4.3 || ^7.4
- symfony/event-dispatcher-contracts: ^2.5.3 || ^3.4.2
- symfony/framework-bundle: ^6.4.3 || ^7.4
- symfony/http-client: ^6.4 || ^7.4
- symfony/lock: ^6.4.3 || ^7.4
- symfony/messenger: ^6.4.3 || ^7.4
- symfony/polyfill-php83: ^1.31
- symfony/process: ^6.4.3 || ^7.4
- symfony/property-access: ^6.4.3 || ^7.4
- symfony/property-info: ^6.4.3 || ^7.4
- symfony/scheduler: ^6.4.3 || ^7.4
- symfony/serializer: ^6.4.3 || ^7.4
- symfony/string: ^6.4.3 || ^7.4
- symfony/translation: ^6.4.3 || ^7.4
- symfony/translation-contracts: ^2.5.3 || ^3.4.2
- symfony/uid: ^6.4.3 || ^7.4
- symfony/validator: ^6.4.3 || ^7.4
- symfony/var-dumper: ^6.4.3 || ^7.4
- symfony/var-exporter: ^6.4.3 || ^7.4
- symfony/yaml: ^6.4 || ^7.4
- tomasvotruba/type-coverage: ^2.5
Suggests
- doctrine/dbal: Required by the Doctrine bridge (custom types)
- doctrine/doctrine-bundle: Required for the Doctrine bridge
- doctrine/orm: Required for the Doctrine bridge
- nyholm/psr7: PSR-17 factories for the HTTP gateway and the Symfony bundle (any PSR-17 / PSR-18 implementation works)
- symfony/cache: PSR-6 / PSR-16 pool for the OAuth2 token cache (Psr6TokenStore, Psr16TokenStore)
- symfony/config: Required by the Symfony bridge (bundle configuration)
- symfony/console: Provides the console commands of the Symfony bundle (urssaf:pn:*)
- symfony/dependency-injection: Required by the Symfony bridge
- symfony/framework-bundle: Required to use the Symfony bundle
- symfony/http-client: PSR-18 compatible HTTP client of the Symfony bundle (default client)
- symfony/http-kernel: Required by the Symfony bridge (bundle)
- symfony/lock: Prevents overlapping uploads, synchronisations and reconciliations per tenant (see the "lock" bundle option)
- symfony/messenger: Runs the tenant synchronisation and reconciliation asynchronously (see the "messenger" bundle option)
- symfony/scheduler: Runs the synchronisation and the reconciliation as a Symfony Scheduler schedule (see the "scheduler" bundle option)
- symfony/translation: Translates the violation codes (English and French shipped)
- symfony/validator: Converts the violations of the package into a ConstraintViolationList (ViolationListConverter)
Provides
None
Conflicts
- doctrine/dbal: <4.0
- doctrine/doctrine-bundle: <2.19
- doctrine/orm: <3.5.3
- nyholm/psr7: <1.8.2
- symfony/clock: <6.4.3
- symfony/console: <6.4
- symfony/dependency-injection: <6.4.26
- symfony/framework-bundle: <6.4.3
- symfony/http-client: <6.4
- symfony/http-kernel: <6.4
- symfony/lock: <6.4.3
- symfony/messenger: <6.4.3
- symfony/scheduler: <6.4.3
Replaces
None
This package is auto-updated.
Last update: 2026-11-18 20:13:27 UTC
README
thebeardedbear/urssaf-plateforme-numerique — client, domain model and Symfony integration for the URSSAF "portail
Plateforme numérique" APIs, used by digital platforms for the withholding at source of the social contributions of
auto-entrepreneurs: monthly identification files, declaration / regularisation files, processing and payment status,
report downloads and notification feed. One package covers two catalogue entries sharing the same resources:
Échanges réels and Bac à sable (technical test API).
Namespace: TheBeardedBear\UrssafPlateformeNumerique.
Developed and maintained by The Bearded Bear.
Important
Unofficial package. This project is an independent open-source implementation of a public API. It is not developed, endorsed, certified or supported by URSSAF, and it is not affiliated with URSSAF in any way. "URSSAF" is used only to name the API this package talks to. Using this package does not replace the URSSAF habilitation process; the URSSAF documentation remains the authority on the API, and you remain responsible for the data your application sends to URSSAF.
Status: 0.1.0 released; sandbox contract run still to do (see docs/roadmap.md). The nine operations, the submission workflow, the standalone builder, the Symfony bundle and the Doctrine bridge are in place; the open points of the API reference stay open until URSSAF publishes them or the sandbox contract run settles them. See the architecture decision records in docs/adr/.
Scope
| Operation | Endpoint | Échanges réels | Bac à sable |
|---|---|---|---|
| Upload an identification file | POST /platforms/{platformId}/identifications/upload |
yes | yes |
| Get an identification submission | GET /platforms/{platformId}/identifications/{urssafRef} |
yes | yes |
| Search identification submissions | GET /platforms/{platformId}/identifications |
yes | yes |
| Download an identification result file | GET /platforms/{platformId}/identifications/{urssafRef}/file/{fileRef} |
yes | yes |
| Upload a declaration / regularisation file | POST /platforms/{platformId}/declarations/upload?type=… |
yes | yes |
| Get a declaration submission | GET /platforms/{platformId}/declarations/{urssafRef} |
yes | yes |
| Search declaration submissions | GET /platforms/{platformId}/declarations |
yes | yes |
| Download a declaration report file | GET /platforms/{platformId}/declarations/{urssafRef}/file/{fileRef} |
yes | yes |
| Notification feed | GET /platforms/{platformId}/news-feed |
yes | no |
OAuth2 client credentials (prior registration on the "portail Plateforme numérique" required):
| Target | Base URL | Scope |
|---|---|---|
| Échanges réels, production | https://api.urssaf.fr/api-odspn-be-platforms/v1 |
ods.pn.platforms |
| Échanges réels, sandbox | https://api-edi.urssaf.fr/api-odspn-be-platforms/v1 |
ods.pn.platforms |
| Bac à sable (test API) | https://api.urssaf.fr/api-odspn-be-platforms-sandbox/v1 |
ods.pn.platforms.sandbox |
Documentation
- docs/api-reference.md — technical reference (single source of truth for the package).
- docs/roadmap.md — implementation status and what remains; ROADMAP.md — intended direction for the next twelve months.
- docs/security/ — security assurance case and security review.
- docs/workflow.md — submission lifecycle, re-entry, polling, reconciliation of unknown uploads, declaration guard.
- docs/integration-events.md — public integration events (
urssaf.pn.*) and the outbox. - docs/doctrine.md — Doctrine persistence: tables, dedicated entity manager, concurrency, migrations.
- docs/standalone.md — wiring without the Symfony bundle: builder options, scheduling, manual wiring.
- docs/symfony.md — Symfony bundle: configuration reference, console commands, Messenger, Scheduler, locks, translations.
- docs/testing.md — testing a host application with the in-memory simulated gateway.
- docs/adr/ — architecture decision records.
- docs/openapi/ — official OpenAPI contract(s) from the URSSAF API portal.
docs/reference/— official URSSAF documentation: not versioned (URSSAF documents), download it from the links in docs/api-reference.md into this local, git-ignored folder.- Catalogue pages: https://portailapi.urssaf.fr/fr/catalogue-api/prd/portail-pn-echanges-reels and https://portailapi.urssaf.fr/fr/catalogue-api/prd/portail-pn-bac-a-sable
Installation
composer require thebeardedbear/urssaf-plateforme-numerique
The package depends on PSR interfaces only: install a PSR-18 HTTP client and PSR-17 factories, for instance
composer require nyholm/psr7 guzzlehttp/guzzle (or symfony/http-client and nyholm/psr7; with the Symfony bundle
the default client is a dedicated Symfony HttpClient). With Symfony Flex, the recipe of the package registers the
bundle, copies a commented config/packages/urssaf_plateforme_numerique.yaml (the simulated URSSAF platform in the
test environment) and adds URSSAF_PN_ENV, URSSAF_PN_CLIENT_ID, URSSAF_PN_CLIENT_SECRET and
URSSAF_PN_PLATFORM_ID to .env. The recipe is submitted to
symfony/recipes-contrib (symfony/recipes-contrib#2123) and not merged yet: until then, do these
steps by hand (Quick start B below), or serve the recipe from your own Flex endpoint built by bin/build-flex-endpoint (see
docs/symfony.md).
With Doctrine, generate the tables of the package (it ships no migration, see docs/doctrine.md) and check the installation:
php bin/console doctrine:migrations:diff --em=urssaf_pn && php bin/console doctrine:migrations:migrate
php bin/console urssaf:pn:check
Architecture
Hexagonal / DDD, the same as thebeardedbear/urssaf-tiers-prestations (ADR 0000).
Layers are enforced by Deptrac (deptrac.yaml): the Domain depends on nothing, the Application on the Domain and the
Contract, the Infrastructure on the Application and PSR only.
+-----------------------------------------------+
| Bridge (Symfony, Doctrine) - framework glue |
+----------------------+------------------------+
|
+----------------------v------------------------+
| Infrastructure - HTTP gateway, OAuth2, wire |
| encoding, token stores, clock, ids, in-memory |
+----------------------+------------------------+
| implements ports
+----------------------v------------------------+
| Application - commands, queries, handlers, |
| ports (PlatformGateway, repositories...), DTOs|
+----------------------+------------------------+
|
+----------------------v------------------------+
| Domain - Submission aggregate, value objects, |
| rules (pure PHP, no PSR, no framework) |
+-----------------------------------------------+
- Domain: the
Submissionaggregate and its lifecycle, value objects (periods, references, file names, fingerprints), the live read models of identifications, declarations and news items, search criteria, domain events. - Contract: public, versioned integration events (
urssaf.pn.*) relayed through the outbox. - Application: one
final readonlyhandler per use case, ports implemented by the outer layers. - Infrastructure:
UrssafHttpGateway(implementsPlatformGateway), OAuth2 token provider, multipart and download handling, adapters. - Standalone / Testing: framework-free builder and an in-memory simulated platform for host test suites.
- Bridge:
Bridge\Symfony(bundle, commands, Messenger, Lock, Scheduler) andBridge\Doctrine(XML mapping, DBAL types, repository with an atomic claim, optimistic locking, outbox, statistics; nouserId/userEmailcolumn).
Decisions: docs/adr/.
Quick start A: Standalone (framework-agnostic)
The package sends the files you give it (it never generates, compresses nor validates the XML) and follows their
asynchronous processing. This example needs a PSR-18 client and PSR-17 factories (here nyholm/psr7 and Guzzle).
Credentials come from environment variables, the platform identifier of each tenant from your own data.
use GuzzleHttp\Client; use Nyholm\Psr7\Factory\Psr17Factory; use TheBeardedBear\UrssafPlateformeNumerique\Application\Command\SyncSubmissionStatuses; use TheBeardedBear\UrssafPlateformeNumerique\Application\Command\UploadIdentification; use TheBeardedBear\UrssafPlateformeNumerique\Application\Port\Credentials; use TheBeardedBear\UrssafPlateformeNumerique\Application\Query\DownloadReportFile; use TheBeardedBear\UrssafPlateformeNumerique\Application\Query\GetIdentification; use TheBeardedBear\UrssafPlateformeNumerique\Application\Query\GetSubmission; use TheBeardedBear\UrssafPlateformeNumerique\Domain\Platform\PlatformId; use TheBeardedBear\UrssafPlateformeNumerique\Domain\Shared\ExternalReference; use TheBeardedBear\UrssafPlateformeNumerique\Domain\Shared\TenantId; use TheBeardedBear\UrssafPlateformeNumerique\Domain\Submission\UrssafReference; use TheBeardedBear\UrssafPlateformeNumerique\Infrastructure\Credentials\InMemoryCredentialsProvider; use TheBeardedBear\UrssafPlateformeNumerique\Infrastructure\File\LocalFileSource; use TheBeardedBear\UrssafPlateformeNumerique\Infrastructure\Platform\InMemoryPlatformResolver; use TheBeardedBear\UrssafPlateformeNumerique\Infrastructure\Urssaf\ApiConfiguration; use TheBeardedBear\UrssafPlateformeNumerique\Infrastructure\Urssaf\Environment; use TheBeardedBear\UrssafPlateformeNumerique\Infrastructure\Urssaf\HttpTransport; use TheBeardedBear\UrssafPlateformeNumerique\Standalone\UrssafPlateformeNumeriqueBuilder; $factory = new Psr17Factory(); $tenant = TenantId::fromString('tenant-1'); $package = UrssafPlateformeNumeriqueBuilder::create( new HttpTransport(new Client(), $factory, $factory), new InMemoryCredentialsProvider([ 'tenant-1' => Credentials::of((string) getenv('URSSAF_CLIENT_ID'), (string) getenv('URSSAF_CLIENT_SECRET')), ]), new InMemoryPlatformResolver(['tenant-1' => PlatformId::fromString('platform-1')]), ApiConfiguration::forEnvironment(Environment::Sandbox), )->build(); // 1. Upload: the submission is recorded locally ("uploading"), sent, then "in_process". $report = $package->uploadIdentification()(UploadIdentification::of( $tenant, ExternalReference::fromString('host-ref-1'), LocalFileSource::fromPath('/path/to/DPID_202505_24001_000_20250428150823.xml.gz'), )); // 2. Poll (from a cron job): every submission still in process is read at URSSAF. $package->syncSubmissionStatuses()(SyncSubmissionStatuses::forTenant($tenant, null)); // 3. Read the local record, then download a report once it is accepted. $submission = $package->getSubmission()(new GetSubmission($tenant, $report->submissionId)); if ($submission->state === 'accepted' && $submission->urssaf->urssafRef !== null) { $reference = UrssafReference::fromString($submission->urssaf->urssafRef); $identification = $package->getIdentification()(new GetIdentification($tenant, $reference)); $globalReport = $identification->reportFiles()->globalReport(); if ($globalReport !== null) { $file = $package->downloadReportFile()(DownloadReportFile::identification($tenant, $reference, $globalReport)); $destination = fopen('report.bin', 'wb'); if ($destination !== false) { $file->stream()->copyTo($destination); // an open resource; the caller closes it fclose($destination); } $file->stream()->close(); } }
The other use cases are one accessor away (uploadDeclaration(), searchDeclarations(), getNewsFeed(),
reconcileUnknownSubmissions()...). Every option of the builder, the scheduling and the manual wiring are described in
docs/standalone.md; the lifecycle of a submission is in docs/workflow.md; test
your integration with the simulator (docs/testing.md).
Quick start B: Symfony
Once the recipe is merged in symfony/recipes-contrib (symfony/recipes-contrib#2123) and the application allows contrib recipes
(composer config extra.symfony.allow-contrib true), Symfony Flex will register the bundle, copy the configuration
and add the variables to .env:
composer require thebeardedbear/urssaf-plateforme-numerique
Without the recipe, register the bundle in config/bundles.php:
return [ // ... TheBeardedBear\UrssafPlateformeNumerique\Bridge\Symfony\UrssafPlateformeNumeriqueBundle::class => ['all' => true], ];
Configure it in config/packages/urssaf_plateforme_numerique.yaml (every option is described in
docs/symfony.md):
framework: cache: pools: urssaf_pn.token_cache: # the access tokens, shared by every process (web, workers, cron) adapter: cache.adapter.redis provider: '%env(REDIS_DSN)%' urssaf_plateforme_numerique: environment: '%env(URSSAF_PN_ENV)%' # sandbox | test_api | production credentials: default: # one entry per tenant (platform account) client_id: '%env(URSSAF_PN_CLIENT_ID)%' client_secret: '%env(URSSAF_PN_CLIENT_SECRET)%' platform_id: '%env(URSSAF_PN_PLATFORM_ID)%' token_store: { cache_pool: urssaf_pn.token_cache } persistence: { driver: doctrine, entity_manager: urssaf_pn } # a dedicated entity manager (docs/doctrine.md) when@test: urssaf_plateforme_numerique: gateway: { simulated: true } # the in-memory URSSAF platform: nothing is sent to URSSAF
and set the variables in .env.local (never commit the secret):
URSSAF_PN_ENV=sandbox URSSAF_PN_CLIENT_ID= URSSAF_PN_CLIENT_SECRET= URSSAF_PN_PLATFORM_ID=
The use case handlers are public services, ready to be injected:
use Symfony\Component\HttpFoundation\JsonResponse; use Symfony\Component\Routing\Attribute\Route; use TheBeardedBear\UrssafPlateformeNumerique\Application\Command\UploadIdentification; use TheBeardedBear\UrssafPlateformeNumerique\Application\Command\UploadIdentificationHandler; use TheBeardedBear\UrssafPlateformeNumerique\Domain\Shared\ExternalReference; use TheBeardedBear\UrssafPlateformeNumerique\Domain\Shared\TenantId; use TheBeardedBear\UrssafPlateformeNumerique\Infrastructure\File\LocalFileSource; final class IdentificationController { public function __construct(private readonly UploadIdentificationHandler $uploadIdentification) {} #[Route('/identifications/{reference}', methods: ['PUT'])] public function upload(string $reference): JsonResponse { $report = ($this->uploadIdentification)(UploadIdentification::of( TenantId::fromString('default'), ExternalReference::fromString($reference), LocalFileSource::fromPath('/path/to/DPID_202505_24001_000_20250428150823.xml.gz'), )); return new JsonResponse(['outcome' => $report->outcome->value, 'state' => $report->state->value]); } }
Check the installation, then run the polling and recovery commands from cron, or let the Symfony Scheduler do it
(scheduler: { enabled: true }, then messenger:consume scheduler_urssaf_pn):
php bin/console urssaf:pn:check php bin/console urssaf:pn:identification:upload var/DPID_202505_24001_000_20250428150823.xml.gz --external-reference=host-ref-1 php bin/console urssaf:pn:submissions:sync php bin/console urssaf:pn:submissions:reconcile
Create the tables with your migrations (the package ships none): php bin/console doctrine:migrations:diff --em=urssaf_pn
(the dedicated entity manager configured above) then doctrine:migrations:migrate (docs/doctrine.md). Without Doctrine, the in_memory persistence
loses every record when the process ends: give your own repository (custom driver), see
docs/symfony.md.
Requirements
PHP 8.2+. Symfony 6.4 / 7.x for the bundle (optional). Doctrine persistence (optional): doctrine/orm 3.5.3+ and doctrine/dbal 4.0+. Development only needs Docker: every make target runs in a container.
Development
make install # build the image, install dependencies make ci # full quality gate: cs, rector, phpstan, mago, deptrac, composer checks, hadolint, guard, coverage, infection make test # unit + functional tests make coverage-branches # branch coverage (Xdebug, slow), at least 96 % enforced make bench # benchmarks (PHPBench, tests/Benchmark) make help # every target
make ci PHP_VERSION=8.4 runs the gate on another PHP version.
Once the repository is public, main publishes its quality proofs, linked from the badges at the top of this file: the
coverage report on Codecov, the full mutation report on the Stryker Dashboard, the SonarQube Cloud quality gate and the
OpenSSF Scorecard. The benchmarks (tests/Benchmark, PHPBench in tools/phpbench, out of the package dependencies)
run on every pull request against the base commit, and the job fails on a regression of more than 20 %.
Contract tests against the sandbox
export URSSAF_SANDBOX_CLIENT_ID=... URSSAF_SANDBOX_CLIENT_SECRET=... URSSAF_SANDBOX_PLATFORM_ID=... # optional: URSSAF_SANDBOX_BASE_URI (host override), URSSAF_SANDBOX_UPLOAD=1 (opt-in upload of a fictitious file), # URSSAF_TEST_API_CLIENT_ID, URSSAF_TEST_API_CLIENT_SECRET, URSSAF_TEST_API_PLATFORM_ID (technical test API) make test-contract
These tests (tests/Contract, group contract) call the real "Echanges reels" sandbox (api-edi) and, when its
variables are set, the "Bac a sable" test API. They are skipped when the credentials are missing (a test that needs a
platform id is skipped without it), and never run by make ci. The upload test is off unless URSSAF_SANDBOX_UPLOAD=1.
The GitHub contract job is manual (Actions > CI > Run workflow, contract checked): it reads the secrets and
variables of the urssaf-sandbox environment with the same names, except the upload: it runs only when the
contract_upload box is checked for that run (the job sets URSSAF_SANDBOX_UPLOAD=1 for it; no variable of that name
is read). See docs/testing.md.
Versioning
Semantic Versioning. SpecVersion::CURRENT holds the version of the official URSSAF documentation implemented.
Other URSSAF packages
The same architecture, quality gate and conventions, one package per URSSAF API (overview: the-bearded-bear.com/open-source/urssaf):
| API | Package | Status |
|---|---|---|
| Tiers de prestations (immediate tax-credit advance) | thebeardedbear/urssaf-tiers-prestations |
Released (Packagist) |
| Attestations Vérification Code Sécurité (certificate verification) | thebeardedbear/urssaf-attestations-verification-code-securite |
Released (Packagist) |
| DPAE (pre-employment declaration) | thebeardedbear/urssaf-dpae |
Coming soon |
| Mobilité internationale (posting of workers abroad) | thebeardedbear/urssaf-mobilite-internationale |
Coming soon |
| Tierce Déclaration auto-entrepreneur | thebeardedbear/urssaf-tierce-declaration-auto-entrepreneur |
Released (Packagist) |
| Tierce Déclaration CESU | thebeardedbear/urssaf-tierce-declaration-cesu |
Released (Packagist) |
| Tierce Déclaration PAJE | thebeardedbear/urssaf-tierce-declaration-paje |
Released (Packagist) |
Professional support
This package is developed and maintained by The Bearded Bear. If you need help with an URSSAF integration, The Bearded Bear can help with:
- the URSSAF habilitation and homologation process (subscription, sandbox tests, move to production);
- integrating the package into your application (Symfony, Doctrine or framework-free);
- support with a guaranteed response time, including the follow-up of URSSAF API changes;
- custom developments on top of the package.
Project page and integration offer: the-bearded-bear.com/open-source/urssaf-plateforme-numerique.
Contributing and security
Contributions are welcome: see CONTRIBUTING.md and the Code of Conduct. The project's governance is described in GOVERNANCE.md and its direction in ROADMAP.md. Security design and review: assurance case (threat model, trust boundaries, design principles, countered weaknesses) and security review. Report vulnerabilities privately as described in SECURITY.md, never in a public issue.
License
MIT. See LICENSE. The software is provided "as is", without warranty of any kind.
The API specification summarised in docs/api-reference.md belongs to URSSAF; see the sources listed there.