Documents
This process lets you request, collect, and validate the candidate's documentation in a centralized way through BTapp.
- You must define which documents are mandatory to request from the candidate
Understanding Results
The following describes the information this process returns in its two query modes.
- Default View (Summary)
- Extended View (Full Detail)
Process Summary
Shows the overall status of the upload and validation of the mandatory documents.
{
"isSuccess": true,
"statusCode": 200,
"message": "Success",
"data": {
"processId": "BGRgx6JHpDAFDszrQUGQ",
"processName": "Documentos",
"detail": {
"documents": [
{
"name": "Identificación Oficial (INE/Pasaporte)",
"isRequired": true,
"status": "Finalizado",
"uploadedBy": "Norma Leticia Villegas",
"result": "Válido",
"comment": ""
},
{
"name": "Acta de Nacimiento",
"isRequired": true,
"status": "Finalizado",
"uploadedBy": "Norma Leticia Villegas",
"result": "Válido",
"comment": ""
},
{
"name": "CURP",
"isRequired": true,
"status": "Finalizado",
"uploadedBy": "Norma Leticia Villegas",
"result": "Válido",
"comment": ""
},
{
"name": "Carta de Recomendación 1",
"isRequired": true,
"status": "Finalizado",
"uploadedBy": "Norma Leticia Villegas",
"result": "Válido",
"comment": ""
},
{
"name": "Carta de Recomendación 2",
"isRequired": true,
"status": "Finalizado",
"uploadedBy": "Norma Leticia Villegas",
"result": "Válido",
"comment": ""
},
{
"name": "Carta de Recomendación 3",
"isRequired": true,
"status": "Finalizado",
"uploadedBy": "Norma Leticia Villegas",
"result": "Válido",
"comment": ""
}
]
},
"status": "Finalizado",
"result": "Aprobado",
"start": 1778264647288,
"end": 1778531767202,
"time": ""
}
}
Extended Technical Data
Enabled with the ?detail=true parameter, provides secure URLs to view the documents and validation timestamps.
{
"processId": "documents",
"rawDetails": {
"files": [
{
"documentType": "ID_FRONT",
"secureUrl": "https://api.blacktrust.net/v1/storage/view/id_front_123.jpg",
"uploadedAt": "2024-05-10T10:00:00Z",
"isVerified": true
},
{
"documentType": "PROOF_OF_ADDRESS",
"secureUrl": "https://api.blacktrust.net/v1/storage/view/address_proof_456.pdf",
"uploadedAt": "2024-05-10T10:05:00Z",
"isVerified": true
}
]
}
}