Vérification du document d'identité

Avant de créer un processus de signature ou de lancer une vérification d'antécédents, Auco vérifie auprès du registre officiel que le document d'identité existe et que son titulaire n'est pas enregistré comme décédé. Dans les processus de signature, il compare aussi le nom du signataire avec celui du registre.

Si la vérification échoue, Auco ne crée pas le processus et répond 400 avec un code qui indique ce qui a échoué. Ainsi, aucun document n'est envoyé à la signature et aucune vérification n'est payée au nom d'une identité qui n'existe pas.

La couverture dépend du pays et du type de document

Lorsqu'un pays ou un type de document n'est pas couvert, la vérification n'a pas lieu et le processus continue. Il en va de même si le registre officiel ne répond pas : une panne du fournisseur n'empêche jamais la création du processus.

🧩 Où cela s'applique

Service	Ce qui est vérifié	Ce qu'il faut
`POST /document/upload`	Validité et nom de chaque signataire.	`signProfile[x].identification` et `signProfile[x].identificationType`. Voir Données du signataire.
`POST /document/save`	Validité et nom de chaque signataire.	Le `signatureProfile` du modèle doit définir l'identification et le type de document du signataire.
`POST /validate/background`	Validité du document. Pas de nom.	`type` à `CC`, `CE` ou `PPT`. Avec `NIT`, Auco vérifie que l'entreprise existe dans le RUES.

Dans les processus de signature, seuls les signataires qui envoient identification sont vérifiés. Dans la vérification d'antécédents, les types PP et INT ne sont pas vérifiés.

Données du signataire

Ces champs vont dans chaque élément de signProfile de POST /document/upload :

Nom	Type	Description
`signProfile[x].identification`	String facultatif	Numéro d'identification du signataire.
`signProfile[x].identificationType`	String conditionnel	Type de document, par exemple `CC` ou `CE`. Sans lui, le signataire n'est pas vérifié et son `status` vaut `NOT_SUPPORTED`.
`signProfile[x].country`	String facultatif	Pays du document en code ISO à deux lettres. Par défaut `CO`.

📥 Exemples de réponse

Lorsqu'un signataire envoie identification, la réponse de POST /document/upload et de POST /document/save inclut identityValidation, avec un élément par signataire vérifié :

{
  "document": "ABCDEF1234",
  "identityValidation": [
    {
      "identification": "123456789",
      "name": "Firmante 1",
      "validated": true,
      "status": "ALIVE",
      "nameStatus": "MATCH"
    }
  ]
}

📋 Champs de la réponse

Champ	Type	Description
`identityValidation`	Array<Object>	Optionnel. Renvoyé uniquement si un signataire a envoyé `identification`.
`identityValidation[].identification`	String	Numéro d'identification vérifié.
`identityValidation[].name`	String	Nom du signataire comparé au registre.
`identityValidation[].validated`	Boolean	`true` uniquement lorsque `status` vaut `ALIVE`.
`identityValidation[].status`	String	État du document. Voir États du document.
`identityValidation[].nameStatus`	String	Résultat de la comparaison du nom : `MATCH`, `NO_MATCH`, `NOT_FOUND`, `UNSUPPORTED` ou `ERROR`. Vaut `null` s'il n'a pas été comparé.

Le résultat n'est pas enregistré avec le processus

identityValidation n'arrive que dans la réponse de création. Si tu en as besoin plus tard, conserve-le dans ton intégration.

🔄 États du document (`identityValidation[].status`)

État	Description
`ALIVE`	Le document existe et son titulaire est en vie.
`DECEASED`	Le titulaire du document est enregistré comme décédé. Rejette le processus.
`NOT_FOUND`	Le document n'existe pas dans le registre officiel. Rejette le processus.
`UNKNOWN`	Le registre a répondu sans état concluant.
`UNSUPPORTED`	Le pays ou le type de document n'est pas couvert par la vérification.
`ERROR`	Le fournisseur de la vérification a échoué.
`UNAVAILABLE`	Auco n'a pas pu effectuer la vérification.
`NOT_SUPPORTED`	Le signataire n'a pas de `identificationType`, il n'a donc pas été vérifié.

Seuls DECEASED, NOT_FOUND et un nom en NO_MATCH rejettent le processus ; avec tout autre état, le processus est créé.

Le catalogue d'états n'est pas fermé

De nouvelles valeurs peuvent apparaître. Traite une valeur inconnue comme un résultat non validé, sans faire échouer ton intégration.

🚫 Codes de rejet

Tous répondent 400. Le code arrive dans message.

Code	Description
`SIGNER_IDENTITY_DECEASED`	Processus de signature. Un signataire est enregistré comme décédé.
`SIGNER_IDENTITY_NOT_FOUND`	Processus de signature. Le document d'un signataire n'existe pas dans le registre officiel.
`SIGNER_NAME_MISMATCH`	Processus de signature. Le nom d'un signataire ne correspond pas à celui du registre.
`IDENTITY_DECEASED`	Vérification d'antécédents. Le titulaire du document est enregistré comme décédé.
`IDENTITY_NOT_FOUND`	Vérification d'antécédents. Le document n'existe pas dans le registre officiel.
`COMPANY_NOT_FOUND`	Vérification d'antécédents avec `type: NIT`. L'entreprise n'existe pas dans le RUES.

Dans les processus de signature, le corps de l'erreur identifie le signataire en cause. SIGNER_NAME_MISMATCH contient aussi name :

{
  "message": "SIGNER_IDENTITY_NOT_FOUND",
  "identification": "123456789"
}

🧩 Où cela s'applique​

Données du signataire​

📥 Exemples de réponse​

📋 Champs de la réponse​

🔄 États du document (identityValidation[].status)​

🚫 Codes de rejet​