Skip to main content
POST
/
expedientes
/
solicitar-correccion
solicitar corrección
curl --request POST \
  --url https://nufi.azure-api.net/kyb/expedientes/solicitar-correccion \
  --header 'Content-Type: application/json' \
  --header 'NUFI-API-KEY: <nufi-api-key>' \
  --header 'X-Workspace: <x-workspace>' \
  --data '
{
  "documentId": "e735a41f-303b-4c4b-8217-ecc33c4b9e6a",
  "secciones": [
    {
      "seccion": "LegalRepresentative",
      "estatus": "Rechazada",
      "comentario": "El INE está vencido, favor de subir identificación vigente",
      "entidadReferencia": "JUAN CARLOS PEREZ LOPEZ"
    }
  ]
}
'
{
  "success": true,
  "message": "Corrección solicitada correctamente",
  "data": {
    "expedienteId": "e735a41f-303b-4c4b-8217-ecc33c4b9e6a",
    "seccionesActualizadas": 6,
    "resumen": {
      "aceptadas": 2,
      "rechazadas": 4,
      "entidadesAfectadas": {
        "representantes": 3,
        "sucursales": 1,
        "expediente": 2
      }
    },
    "secciones": [
      {
        "seccion": "LegalRepresentative",
        "estatus": "Rechazada",
        "comentario": "El documento de identificación está vencido...",
        "entidadReferencia": "JUAN CARLOS PEREZ LOPEZ",
        "entidadesResueltas": [
          {
            "id": "44ce9ddd-f5db-4684-a1e5-acf145d3e207",
            "referencia": "JUAN CARLOS PEREZ LOPEZ",
            "coincidencia": "exacta"
          }
        ],
        "fechaActualizacion": "2025-10-27T15:30:00.000Z"
      },
      {
        "seccion": "ArticleIncorporation",
        "estatus": "Aceptada",
        "entidadesResueltas": [
          {
            "id": "e735a41f-303b-4c4b-8217-ecc33c4b9e6a",
            "referencia": "Expediente",
            "coincidencia": "expediente"
          }
        ],
        "fechaActualizacion": "2025-10-27T15:30:00.000Z"
      }
    ],
    "notificacionEnviada": true,
    "linkCorreccion": "https://kyb.empresa.com/correcciones/e735a41f-303b-4c4b-8217-ecc33c4b9e6a"
  },
  "warnings": []
}
Endpoint para solicitar correcciones en un expediente KYB. Permite aprobar o rechazar secciones específicas, registrar comentarios y notificar al usuario. Si hay rechazos, el documento pasa a estado “Pendiente de Corrección”.

​
Método y ruta

  • POST /expedientes/solicitar-correccion

​
Headers requeridos

  • NUFI-API-KEY (string)
  • X-Workspace (string UUID)

​
Body

  • documentId (string UUID, requerido)
  • secciones (array[object], requerido; 1–50 items)
    • seccion (string, requerido)
    • estatus (string, requerido; Aceptada | Rechazada)
    • comentario (string, requerido si estatus = Rechazada, máx. 500)
    • entidadId (string UUID, opcional)
    • entidadReferencia (string, opcional)
  • notificarUsuario (boolean, default true)
  • mensajeGeneral (string, opcional, máx. 1000)

Headers

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

Body

application/json
​
documentId
string<uuid>
required

ID único del documento/expediente al que se solicitarán correcciones.

​
secciones
object[]
required
Required array length: 1 - 50 elements
​
notificarUsuario
boolean
default:true

Si enviar notificación al usuario cuando hay secciones rechazadas.

​
mensajeGeneral
string

Mensaje general para el usuario.

Maximum string length: 1000
Example:

"Su expediente KYB requiere algunas correcciones menores."

Response

OK

​
success
boolean
Example:

true

​
message
string
Example:

"Corrección solicitada correctamente"

​
data
object
​
warnings
object[]