[Interpol] Verificación de antecedentes

Versión: 2.0

Consulta antecedentes internacionales en Interpol a través del proveedor Verifik, utilizando datos de identificación personal del usuario a verificar.Países disponibles: 🇨🇴 Colombia

Configuración

Inputs
Outputs

País

string

required

Variable: country. País en el que se realiza la consulta.Valores disponibles: Colombia

Actualmente el selector de país solo está habilitado para Colombia.

Tipo de identificación

string

required

Variable: documentType. Tipo de documento de identidad, habilitado según el país seleccionado.Valores disponibles para Colombia:

CC: Cédula de Ciudadanía (colombianos)
PEP: Permiso Especial de Permanencia (extranjeros, principalmente venezolanos)
CE: Cédula de Extranjería (extranjeros residentes en Colombia)

Número de identificación

string

required

Variable: documentNumber. Número del documento de identidad de la persona a consultar.

✅ Éxito

No tiene antecedentes

Indica que la persona consultada no presenta antecedentes en Interpol.

La respuesta entregada corresponde al response completo del proveedor Verifik.

Ejemplo de respuesta:

{
  "data": {
    "documentType": "CC",
    "documentNumber": "XXXXXXXXXX",
    "firstName": "NOMBRE",
    "lastName": "APELLIDO",
    "fullName": "NOMBRE APELLIDO",
    "arrayName": [
      "NOMBRE",
      "SEGUNDO",
      "APELLIDO1",
      "APELLIDO2"
    ],
    "foundInInterpol": false,
    "details": null
  },
  "signature": {
    "dateTime": "June 16, 2025 4:31 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "XXXXX"
}

Campos clave:

foundInInterpol: false indica que la persona no tiene antecedentes en Interpol
details: null cuando no hay antecedentes

🔴 Errores

Tiene antecedentes

Indica que la persona sí presenta antecedentes penales en Interpol.

La información devuelta corresponde a la respuesta del proveedor.

Ejemplo de respuesta:

{
  "data": {
    "documentType": "CC",
    "documentNumber": "XXXXXXXXXX",
    "firstName": "NOMBRE",
    "lastName": "APELLIDOS",
    "fullName": "NOMBRE APELLIDOS",
    "arrayName": [
      "NOMBRE",
      "APELLIDO"
    ],
    "foundInInterpol": true,
    "details": {
      "totalCards": "2",
      "cards": [
        {
          "arrestWarrants": [
            {
              "issuingCountryId": "CO",
              "charge": "Descripción de los cargos"
            }
          ],
          "weight": "0",
          "languagesSpokenIds": [
            "SPA"
          ],
          "height": "1.75",
          "sexId": "M",
          "countryOfBirthId": "CO",
          "distinguishingMarks": null,
          "eyesColorsId": null,
          "hairsId": null,
          "placeOfBirth": "CIUDAD - DEPARTAMENTO"
        }
      ]
    }
  },
  "signature": {
    "dateTime": "June 16, 2025 4:31 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "XXXXX"
}

Campos importantes:

foundInInterpol: true indica que la persona fue encontrada con antecedentes
details.totalCards: Cantidad de registros encontrados
details.cards[].arrestWarrants: Lista de órdenes de arresto con los cargos específicos
signature: Certificación del proveedor Verifik con fecha y hora de la consulta

Datos faltantes

Se presenta cuando no se envían todos los parámetros requeridos para realizar la consulta.Ejemplo de respuesta:

{
  "code": "MissingParameter",
  "message": "missing documentType\n. missing documentNumber\n"
}

El campo message indica qué parámetros específicos están faltando en la solicitud.

Sin registros

Ocurre cuando el proveedor indica que no se encontró ningún registro asociado a la identificación consultada (Not Found).Ejemplo de respuesta:

{
  "code": "NotFound",
  "message": "Record not found."
}

Existe una diferencia entre “no tiene antecedentes” y “sin registros”. El primero indica que la persona fue encontrada y no tiene antecedentes, mientras que el segundo indica que no se encontró registro de esa persona en el sistema.

Error inesperado

Se produce cuando ocurre una novedad no prevista durante el proceso de consulta.

Integración

Captura los datos del usuario

Recolecta el país, tipo de documento y número de identificación del usuario en tu flujo.

Usa el nodo Pregunta o variables de usuario para capturar esta información.

Configura los parámetros

Asigna los valores capturados a los parámetros requeridos de la herramienta:

country: País de consulta
documentType: Tipo de documento según el país
documentNumber: Número de identificación

Maneja las salidas

Implementa flujos diferentes según el resultado:

✅ Sin antecedentes: Continúa el proceso normal
🔴 Errores: Implementa reintentos, validaciones o notifica al usuario

Almacena los resultados

Guarda la respuesta en variables de memoria para usarla en decisiones posteriores del flujo.

// Ejemplo: Verificar si tiene antecedentes
if (response.data.foundInInterpol === true) {
  // Flujo para personas con antecedentes
} else {
  // Flujo para personas sin antecedentes
}

Dependencia del país

El tipo de identificación disponible depende del país seleccionado en la consulta.

Respuesta del proveedor

El resultado de la consulta depende directamente de la información retornada por el proveedor Verifik.

Interpretación de resultados

Es importante distinguir entre “sin antecedentes” (persona verificada sin antecedentes) y “sin registros” (persona no encontrada en el sistema).

Empezando

Agentes IA

Nodos

Variables

Tools

Configuración

Marketplace

Identidad y firma

Enterprise

Facturación

[Interpol] Verificación de antecedentes

Configuración

✅ Éxito

🔴 Errores

Integración

Dependencia del país

Respuesta del proveedor

Interpretación de resultados

Empezando

Agentes IA

Nodos

Variables

Tools

Configuración

Marketplace

Identidad y firma

Enterprise

Facturación

​Configuración

​✅ Éxito

​🔴 Errores

​Integración

Dependencia del país

Respuesta del proveedor

Interpretación de resultados

Configuración

✅ Éxito

🔴 Errores

Integración