1. Fiduciary process
Maat.ai API
  • v4
    • Authentication
      • Get AccessToken by Email
    • BlackLists
      • OFAC Generate Report
      • PEPS Generate Report
      • SAT69
      • SAT69-B
    • Dextract
      • Extract information
    • Files
      • Upload file
      • Get file
    • SocialEconomic
      • Generate Report
      • Download PDF
    • SAT
      • Validate RFC
    • Quizes
      • Import answers from API
    • Fiduciary process
      • Download file
        GET
      • Generate/update fiduciary requests
        POST
      • Get business data with participants
        GET
      • Get participant personal information
        GET
      • Notification business complete from external (delete all information)
        POST
      • Notification of person with matches resolved
        POST
  1. Fiduciary process

Notification of person with matches resolved

POST
/api/v4/fiduciary/{business_id}/new-registrant

Notificación de resolución de coincidencia de participante#

Este endpoint realiza una solicitud POST para notificar a MAAT que un participante con una resolución de coincidencia (match resolution) pendiente ya fue atendido por un proveedor externo.
Al recibir la notificación, MAAT localiza al participante dentro del negocio indicado y marca la resolución de coincidencia como completada.
⚠️ IMPORTANTE: El participante debe pertenecer al business_id indicado y tener una resolución de coincidencia pendiente. De lo contrario, la solicitud devolverá un error.#

Ejemplo de Solicitud#

Params#

NombreTipoDescripción
business_idIntegerID del negocio al que pertenece el participante.

Body#

{
    "external_person_id": 0
    //"participant_id": 0
    //"request_id": 0
}
Se debe enviar al menos uno de los siguientes identificadores, en donde cada uno signiifca lo siguiente:
NombreTipoDescripción
external_person_idIntegerID externo del participante a resolver.
participant_idIntegerID interno del participante a resolver.
request_idIntegerID de la solicitud asociada al participante.
Es posible enviar más de uno de estos campos. Cuando se proporcionan múltiples identificadores, todos se utilizan como filtros para localizar al participante dentro del negocio.

Ejemplo de Respuesta#

{
    "data": {
        "code_message": "data_saved"
    },
    "message": "Match resolution notification received and processed successfully",
    "success": true
}
IMPORTANTE:
Si todos los identificadores se envían vacíos o con valor 0, la respuesta será invalid_request (400).
El participante debe existir dentro del negocio indicado; de lo contrario, se devolverá participant not found.
Si el cliente tiene configurado un proveedor de documentos, el participante deberá contar con un external_person_id; de lo contrario, el proceso fallará.
Es necesario enviar los headers x-api-key y user-id válidos para evitar errores de autorización.
En caso de error general, la respuesta incluirá el campo code_message, el cual puede variar dependiendo del tipo de error (por ejemplo: invalid_request, unauthorized o server_error).

Solicitud

Parámetros de ruta

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200Success processing match resolution
application/json
Bodyapplication/json

🟠422Match resolution not pending
🟠400Invalid request
🔴500Error processing match resolution
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location '/api/v4/fiduciary//new-registrant' \
--header 'x-api-key: {{api-key}}' \
--header 'service: {{service}}' \
--header 'Content-Type: application/json' \
--data '{
    "external_person_id": 0 // ID externo del participante a resolver
    //"participant_id": 0 // ID interno del participante a resolver
    //"request_id": 0 // ID de la solicitud asociada al participante 
}'
Respuesta Ejemplo de Respuesta
200 - Success processing match resolution
{
    "data": {
        "code_message": "data_saved"
    },
    "message": "Match resolution notification received and processed successfully",
    "success": true
}
Modificado en 2026-07-10 19:37:37
Anterior
Notification business complete from external (delete all information)
Built with