Skip to main content
POST
/
expedientes
/
informacion-complementaria
solicitar información complementaria
curl --request POST \
  --url https://nufi.azure-api.net/kyb/expedientes/informacion-complementaria \
  --header 'Content-Type: application/json' \
  --header 'NUFI-API-KEY: <nufi-api-key>' \
  --header 'X-Workspace: <x-workspace>' \
  --data '
{
  "documentId": "550e8400-e29b-41d4-a716-446655440000",
  "flowId": "FLOW-002",
  "notificarUsuario": true,
  "mensajeAdicional": "Se requiere información fiscal adicional para completar la revisión de su expediente"
}
'
{
  "Code": 200,
  "Status": "success",
  "Message": "Operación exitosa",
  "Data": {
    "documentId": "ec30e1d9-b052-4479-a4a5-3414dce78d07",
    "sectionsAdded": [
      "TaxInformations",
      "PersonaFisica"
    ],
    "message": "Se agregaron 2 secciones nuevas al documento"
  }
}
Endpoint para solicitar información complementaria en un expediente KYB existente. Permite agregar nuevas secciones basándose en un flujo diferente y notificar al usuario sobre la documentación adicional requerida.

​
Funcionalidad

  • Compara las secciones actuales del documento con las del nuevo flujo y agrega solo las faltantes.
  • Maneja formularios dinámicos identificados por un GUID único.
  • Actualiza FlowSections con las nuevas secciones y crea reglas de validación cruzada.
  • Puede notificar al usuario por email y SMS (opcional).

​
Secciones soportadas

  • Información Fiscal (CSF, Opinión de Cumplimiento)
  • Comprobante de Domicilio
  • Representante Legal
  • Persona Física
  • Acta Constitutiva (solo Persona Moral)
  • Estado de Cuenta Bancario
  • Sucursales
  • Carta de Condiciones
  • Formularios Dinámicos (identificados por GUID)
  • Listas Negras
  • Información Crediticia
  • Términos y Condiciones

​
Restricciones

  • El tipo de persona del documento debe coincidir con el del flujo.
  • Persona Física no puede tener secciones de Persona Moral (Acta, Poderes) y viceversa.
  • No se permite agregar formularios que ya existen (mismo GUID).
  • No se eliminan ni modifican secciones existentes.

​
Request

  • Headers requeridos: NUFI-API-KEY, X-Workspace
  • Body (application/json):
{
  "documentId": "550e8400-e29b-41d4-a716-446655440000",
  "flowId": "FLOW-002",
  "notificarUsuario": true,
  "mensajeAdicional": "Se requiere información fiscal adicional para completar la revisión de su expediente"
}

​
Respuesta 200

{
  "Code": 200,
  "Status": "success",
  "Message": "Operación exitosa",
  "Data": {
    "documentId": "ec30e1d9-b052-4479-a4a5-3414dce78d07",
    "sectionsAdded": [
      "TaxInformations",
      "PersonaFisica"
    ],
    "message": "Se agregaron 2 secciones nuevas al documento"
  }
}

Headers

​
NUFI-API-KEY
string
required
​
X-Workspace
string
required

Body

application/json
​
documentId
string<uuid>
required

ID único del documento/expediente existente.

​
flowId
string
required

Identificador del CustomerFlow que contiene las secciones a agregar.

​
notificarUsuario
boolean
default:true

Enviar notificación al usuario (email/SMS) si hay datos de contacto configurados.

​
mensajeAdicional
string

Mensaje adicional para explicar por qué se solicita información complementaria.

Maximum string length: 1000

Response

OK

​
Code
integer
Example:

200

​
Status
string
Example:

"success"

​
Message
string
Example:

"Operación exitosa"

​
Data