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"
}
'import requests
url = "https://nufi.azure-api.net/kyb/expedientes/informacion-complementaria"
payload = {
"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"
}
headers = {
"NUFI-API-KEY": "<nufi-api-key>",
"X-Workspace": "<x-workspace>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'NUFI-API-KEY': '<nufi-api-key>',
'X-Workspace': '<x-workspace>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
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'
})
};
fetch('https://nufi.azure-api.net/kyb/expedientes/informacion-complementaria', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://nufi.azure-api.net/kyb/expedientes/informacion-complementaria",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"NUFI-API-KEY: <nufi-api-key>",
"X-Workspace: <x-workspace>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://nufi.azure-api.net/kyb/expedientes/informacion-complementaria"
payload := strings.NewReader("{\n \"documentId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"flowId\": \"FLOW-002\",\n \"notificarUsuario\": true,\n \"mensajeAdicional\": \"Se requiere información fiscal adicional para completar la revisión de su expediente\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("NUFI-API-KEY", "<nufi-api-key>")
req.Header.Add("X-Workspace", "<x-workspace>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://nufi.azure-api.net/kyb/expedientes/informacion-complementaria")
.header("NUFI-API-KEY", "<nufi-api-key>")
.header("X-Workspace", "<x-workspace>")
.header("Content-Type", "application/json")
.body("{\n \"documentId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"flowId\": \"FLOW-002\",\n \"notificarUsuario\": true,\n \"mensajeAdicional\": \"Se requiere información fiscal adicional para completar la revisión de su expediente\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://nufi.azure-api.net/kyb/expedientes/informacion-complementaria")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["NUFI-API-KEY"] = '<nufi-api-key>'
request["X-Workspace"] = '<x-workspace>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"documentId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"flowId\": \"FLOW-002\",\n \"notificarUsuario\": true,\n \"mensajeAdicional\": \"Se requiere información fiscal adicional para completar la revisión de su expediente\"\n}"
response = http.request(request)
puts response.read_body{
"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"
}
}{
"Code": 400,
"Status": "bad_request",
"Message": "Error de validacion",
"Data": [
"El campo documentId es obligatorio",
"El campo flowId es obligatorio"
]
}{
"Code": 401,
"Status": "forbidden",
"Message": "No autorizado - Workspace inválido o API Key incorrecta",
"Data": null
}{
"Code": 500,
"Status": "error",
"Message": "Error interno del servidor",
"Data": null
}Endpoints
Informacion complementaria
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"
}
'import requests
url = "https://nufi.azure-api.net/kyb/expedientes/informacion-complementaria"
payload = {
"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"
}
headers = {
"NUFI-API-KEY": "<nufi-api-key>",
"X-Workspace": "<x-workspace>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'NUFI-API-KEY': '<nufi-api-key>',
'X-Workspace': '<x-workspace>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
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'
})
};
fetch('https://nufi.azure-api.net/kyb/expedientes/informacion-complementaria', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://nufi.azure-api.net/kyb/expedientes/informacion-complementaria",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"NUFI-API-KEY: <nufi-api-key>",
"X-Workspace: <x-workspace>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://nufi.azure-api.net/kyb/expedientes/informacion-complementaria"
payload := strings.NewReader("{\n \"documentId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"flowId\": \"FLOW-002\",\n \"notificarUsuario\": true,\n \"mensajeAdicional\": \"Se requiere información fiscal adicional para completar la revisión de su expediente\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("NUFI-API-KEY", "<nufi-api-key>")
req.Header.Add("X-Workspace", "<x-workspace>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://nufi.azure-api.net/kyb/expedientes/informacion-complementaria")
.header("NUFI-API-KEY", "<nufi-api-key>")
.header("X-Workspace", "<x-workspace>")
.header("Content-Type", "application/json")
.body("{\n \"documentId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"flowId\": \"FLOW-002\",\n \"notificarUsuario\": true,\n \"mensajeAdicional\": \"Se requiere información fiscal adicional para completar la revisión de su expediente\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://nufi.azure-api.net/kyb/expedientes/informacion-complementaria")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["NUFI-API-KEY"] = '<nufi-api-key>'
request["X-Workspace"] = '<x-workspace>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"documentId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"flowId\": \"FLOW-002\",\n \"notificarUsuario\": true,\n \"mensajeAdicional\": \"Se requiere información fiscal adicional para completar la revisión de su expediente\"\n}"
response = http.request(request)
puts response.read_body{
"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"
}
}{
"Code": 400,
"Status": "bad_request",
"Message": "Error de validacion",
"Data": [
"El campo documentId es obligatorio",
"El campo flowId es obligatorio"
]
}{
"Code": 401,
"Status": "forbidden",
"Message": "No autorizado - Workspace inválido o API Key incorrecta",
"Data": null
}{
"Code": 500,
"Status": "error",
"Message": "Error interno del servidor",
"Data": null
}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
FlowSectionscon 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"
}
}
Body
application/json
ID único del documento/expediente existente.
Identificador del CustomerFlow que contiene las secciones a agregar.
Enviar notificación al usuario (email/SMS) si hay datos de contacto configurados.
Mensaje adicional para explicar por qué se solicita información complementaria.
Maximum string length:
1000Was this page helpful?
.png?fit=max&auto=format&n=SrFWYqQUIKuRmdvu&q=85&s=29a9d6074794b17ba1b2d2cd5d208849)