> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Policía Nacional de Colombia

> Verificación de antecedentes.

<Update label="Versión: 2.0">
  Esta herramienta permite consultar antecedentes disciplinarios en Colombia a través de la Procuraduría General de la Nación. Utilizando el tipo y número de documento, obtiene el nombre completo y posibles sanciones, inhabilidades y procesos asociados a la persona consultada.

  **Países disponibles:** 🇨🇴 Colombia
</Update>

## Configuración

<Tabs>
  <Tab title="Inputs">
    <AccordionGroup>
      <Accordion title="Tipo de identificación" icon="id-card">
        <ParamField body="Tipo de identificación" type="string" required>
          Variable: `documentType`. Tipo de documento de identidad.

          **Valores disponibles:**

          * `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)
        </ParamField>
      </Accordion>

      <Accordion title="Número de identificación" icon="hashtag">
        <ParamField body="Número de identificación" type="string" required>
          Variable: `documentNumber`. Número del documento de identidad de la persona a consultar.
        </ParamField>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Outputs">
    #### ✅ Éxito

    <AccordionGroup>
      <Accordion title="No tiene antecedentes" icon="circle-check">
        Indica que la persona consultada **no presenta antecedentes disciplinarios** en la Procuraduría.

        <Tip>
          La respuesta entregada corresponde al response completo del proveedor Verifik.
        </Tip>

        **Ejemplo de respuesta:**

        ```json theme={null}
        {
          "data": {
            "documentType": "CC",
            "documentNumber": "XXXXXXXXXX",
            "fullName": "NOMBRE APELLIDO",
            "firstName": "NOMBRE",
            "lastName": "APELLIDO",
            "arrayName": [
              "NOMBRE",
              "APELLIDO"
            ],
            "antecedentes": [],
            "isRequired": false,
            "legend": "Consulta en línea de Antecedentes Disiplinarios, La Procuraduria General de la Nacion certifica Que siendo las 15 horas del 31/08/2022 el Señor(a) NOMBRE APELLIDO identificado(a) con Cédula de ciudadanía Número XXXXXXXXXX El ciudadano no presenta antecedentes.",
            "expeditionDate": "Esta información ha sido catalogada como semi privada y no está disponible para su entrega de forma temporal. - RNEC 2686",
            "expeditionPlace": "Esta información ha sido catalogada como semi privada y no está disponible para su entrega de forma temporal. - RNEC 2686",
            "dateOfBirth": "Esta información ha sido catalogada como semi privada y no está disponible para su entrega de forma temporal. - RNEC 2686"
          },
          "signature": {
            "dateTime": "August 31, 2022 3:53 PM",
            "message": "Certified by Verifik.co"
          }
        }
        ```

        **Campos clave:**

        * `antecedentes`: Array vacío indica que no hay antecedentes
        * `isRequired`: Indica si hay algún requerimiento pendiente
        * `legend`: Certificación oficial de la Procuraduría
      </Accordion>
    </AccordionGroup>

    #### 🔴 Errores

    <AccordionGroup>
      <Accordion title="Tiene antecedentes" icon="triangle-exclamation">
        Indica que la persona **sí presenta antecedentes disciplinarios** en la Procuraduría.

        <Warning>
          La información devuelta incluye detalles de sanciones, inhabilidades, delitos y procesos.
        </Warning>

        **Ejemplo de respuesta:**

        ```json theme={null}
        {
          "data": {
            "documentType": "CC",
            "documentNumber": "XXXXXXXXXX",
            "citizen": "NOMBRE APELLIDO",
            "hasRecord": true,
            "isRequired": false,
            "legend": "Consulta en línea de Antecedentes Disiplinarios, La Procuraduria General de la Nacion certifica Que siendo las 9:46:41 PM horas del 2/8/2022 el Señor(a) NOMBRE APELLIDO identificado(a) con Cédula de ciudadanía Número XXXXXXXXXX El ciudadano si presenta antecedentes.",
            "antecedentes": [
              {
                "sanciones": [
                  {
                    "Sancion": "PRISION",
                    "Termino": "78 MESES",
                    "Clase": "PRINCIPAL",
                    "Suspendida": ""
                  },
                  {
                    "Sancion": "INHABILIDAD PARA EL EJERCICIO DE DERECHOS Y FUNCIONES PUBLICAS",
                    "Termino": "78 MESES",
                    "Clase": "ACCESORIA",
                    "Suspendida": ""
                  }
                ],
                "instancias": [
                  {
                    "Nombre": "PRIMERA",
                    "Autoridad": "JUZGADO PENAL DEL CIRCUITO - CIUDAD (DEPARTAMENTO)",
                    "Fecha providencia": "30/06/2015",
                    "fecha efecto Juridicos": "13/06/2016"
                  }
                ],
                "delitos": [
                  {
                    "Descripcion del Delito": "DESCRIPCIÓN DEL DELITO (LEY 599 DE 2000)"
                  }
                ],
                "inhabilidades": [
                  {
                    "Módulo": "PENAL",
                    "Inhabilidad legal": "INHABILIDAD PARA DESEMPEÑAR CARGOS PÚBLICO LEY 734 ART 38 NUM 1",
                    "Fecha de inicio": "13/06/2016",
                    "Fecha fin": "12/06/2026"
                  }
                ]
              }
            ]
          },
          "signature": {
            "dateTime": "August 2, 2022 4:46 PM",
            "message": "Certified by Verifik.co"
          }
        }
        ```

        **Campos importantes:**

        * `hasRecord`: `true` indica que la persona tiene antecedentes
        * `antecedentes[]`: Array con información detallada de:
          * **sanciones**: Tipo de sanción, término y clase
          * **instancias**: Autoridad que emitió la sanción y fechas
          * **delitos**: Descripción de los delitos
          * **inhabilidades**: Periodo de inhabilidad para ejercer cargos públicos
      </Accordion>

      <Accordion title="Datos faltantes" icon="circle-xmark">
        Se presenta cuando no se envían todos los parámetros requeridos para realizar la consulta.

        **Ejemplo de respuesta:**

        ```json theme={null}
        {
          "code": "MissingParameter",
          "message": "missing documentType\n. missing documentNumber\n"
        }
        ```

        El campo `message` indica qué parámetros específicos están faltando en la solicitud.
      </Accordion>

      <Accordion title="Sin registro" icon="magnifying-glass">
        Ocurre cuando el proveedor indica que no se encontró ningún registro asociado a la identificación consultada (Not Found).

        **Ejemplo de respuesta:**

        ```json theme={null}
        {
          "code": "NotFound",
          "message": "Record not found."
        }
        ```

        <Note>
          Existe una diferencia entre "no tiene antecedentes" y "sin registro". 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.
        </Note>
      </Accordion>

      <Accordion title="Servicio caído" icon="server">
        El servidor del proveedor no respondió. También ocurre en casos donde la identificación enviada no es válida.

        **Ejemplo de respuesta:**

        ```json theme={null}
        {
          "code": "Conflict",
          "message": "Server_Not_Response_From_Procuraduria"
        }
        ```

        <Warning>
          Este error puede indicar problemas de conectividad con el proveedor o que el documento consultado tiene un formato inválido.
        </Warning>
      </Accordion>

      <Accordion title="Error inesperado" icon="bug">
        Se produce cuando ocurre una novedad no prevista durante el proceso de consulta.
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

## Integración

<Steps>
  <Step title="Captura los datos del usuario">
    Recolecta el tipo de documento y número de identificación del usuario en tu flujo.

    <Tip>
      Usa el [nodo Pregunta](/guides/nodos/pregunta) o [variables de usuario](/guides/variables/user) para capturar esta información.
    </Tip>
  </Step>

  <Step title="Configura los parámetros">
    Asigna los valores capturados a los parámetros requeridos de la herramienta:

    * `documentType`: Tipo de documento (CC, PEP, CE)
    * `documentNumber`: Número de identificación
  </Step>

  <Step title="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 según el tipo de error (datos faltantes, sin registro, servicio caído, etc.)
  </Step>

  <Step title="Almacena y procesa los resultados">
    Guarda la respuesta en [variables de memoria](/guides/variables/memory) para usarla en decisiones posteriores del flujo.

    ```javascript theme={null}
    // Ejemplo: Verificar si tiene antecedentes
    if (response.data.hasRecord === true) {
      // Flujo para personas con antecedentes
      // Puedes acceder a detalles: sanciones, inhabilidades, delitos
    } else {
      // Flujo para personas sin antecedentes
    }
    ```
  </Step>
</Steps>

<CardGroup cols={2}>
  <Card title="Respuesta del proveedor" icon="server">
    El resultado de la consulta depende directamente de la información retornada por el proveedor Verifik y la Procuraduría General de la Nación.
  </Card>

  <Card title="Interpretación de resultados" icon="circle-info">
    Es importante distinguir entre "no tiene antecedentes" (persona verificada sin antecedentes) y "sin registro" (persona no encontrada en el sistema).
  </Card>

  <Card title="Información sensible" icon="shield-halved">
    Los datos de fecha de expedición, lugar de expedición y fecha de nacimiento están catalogados como información semi-privada y no están disponibles temporalmente según la RNEC.
  </Card>
</CardGroup>