Aller au contenu

Soumettre un lot d'identités déclarées et recevoir un sort par ligne

POST
/rapprochements-identite
curl --request POST \
--url https://example.com/rapprochements-identite \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '[ { "cle_rapprochement_rh": "example", "nom": "example", "nom_usage": "example", "prenoms": "example", "date_naissance": "2026-04-15", "commune_naissance_code": "example" } ]'

Le corps est un TABLEAU de lignes déclarées ; la réponse un tableau de sorts, un par ligne, corrélés par cle_rapprochement_rh.

Le lot d’identités déclarées — au moins une ligne.

Media typeapplication/json

Le tableau des lignes déclarées. La borne supérieure de taille du lot n’est pas encore tranchée (à caler sur le volume réel d’une signalétique) : elle se fixera avec le premier chargement réel de l’Entreprise.

Array<object>
>= 1 items

Une identité déclarée par l’Entreprise, avec sa clé de corrélation. Les deux critères déterministes du rapprochement sont date_naissance et commune_naissance_code.

object
cle_rapprochement_rh
required

La clé de rapprochement du système de ressources humaines du client. Corrèle la réponse à la ligne et rend l’appel idempotent, dans le tenant de l’installation. Non stockée par le domaine — elle transite pour la corrélation et l’idempotence.

string
>= 1 characters
nom
required

Le nom de naissance déclaré.

string
>= 1 characters
nom_usage

Le nom d’usage déclaré, s’il diffère du nom de naissance.

string
prenoms
required

Les prénoms déclarés.

string
>= 1 characters
date_naissance
required

La date de naissance déclarée — premier critère déterministe.

string format: date
commune_naissance_code
required

Le code de la commune de naissance déclarée — second critère déterministe.

string
>= 1 characters
Examplegenerated
[
{
"cle_rapprochement_rh": "example",
"nom": "example",
"nom_usage": "example",
"prenoms": "example",
"date_naissance": "2026-04-15",
"commune_naissance_code": "example"
}
]

Le sort du lot — un tableau de sorts, un par ligne soumise, corrélés par cle_rapprochement_rh. Sort partiel admis.

Media typeapplication/json
Array<object>

Le sort d’une ligne, corrélé à la ligne soumise par cle_rapprochement_rh. Une issue et, au plus, un identifiant publié — jamais de liste de personnes candidates.

object
cle_rapprochement_rh
required

La clé de la ligne soumise — corrélation, sans réordonnancement.

string
>= 1 characters
issue
required

Resolu-existant — une personne correspond sans ambiguïté ; resolu-cree — aucune ne correspond, le domaine a créé la personne ; rejete — plusieurs personnes candidates, aucune création ni choix par approximation.

string
Allowed values: resolu-existant resolu-cree rejete
epargnant_id

L’identifiant publié de l’épargnant — présent en cas de résolution (resolu-existant ou resolu-cree), absent en cas de rejet.

string
>= 1 characters
motif

Le motif du rejet — présent en cas de rejet (issue rejete), absent sinon. L’issue dit qu’il y a ambiguïté, jamais qui la compose.

string
Allowed values: ambiguite
Example
[
{
"issue": "resolu-existant",
"motif": "ambiguite"
}
]

La demande est irrecevable (corps mal formé, critère déterministe manquant, date mal formée…) — le motif nomme le champ. Un rejet de forme porte sur le lot entier, distinct du rejet métier d’une ligne (issue rejete).

Media typeapplication/json
object
motif
required

Le motif, qui nomme le champ ou l’identifiant en cause.

string
Examplegenerated
{
"motif": "example"
}

Aucune identité présentée (l’exigence est du contrat, le mécanisme de l’assemblage).

L’identité présentée n’a pas la famille d’accès epargnant:rapprochement — la seule qui autorise une écriture. Les 403 croisés sont prouvés : ni epargnant:consultation, ni epargnant:recherche, ni epargnant:dossier-identification n’ouvrent le rapprochement.

Le tenant du jeton n’est pas celui de l’installation — la muraille ne révèle jamais l’existence d’une donnée d’un autre tenant (INV-EP-12).

Media typeapplication/json
object
motif
required

Le motif, qui nomme le champ ou l’identifiant en cause.

string
Examplegenerated
{
"motif": "example"
}