> ## 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.

# Polícia Nacional da Colômbia

> Verificação de antecedentes.

<Update label="Versão: 2.0">
  Esta ferramenta permite consultar antecedentes disciplinares na Colômbia através da Procuradoria-Geral da Nação. Usando o tipo e número do documento, recupera o nome completo e possíveis sanções, inabilitações e processos associados à pessoa consultada.

  **Países disponíveis:** 🇨🇴 Colômbia
</Update>

## Configuração

<Tabs>
  <Tab title="Entradas">
    <AccordionGroup>
      <Accordion title="Tipo de identificação" icon="id-card">
        <ParamField body="Tipo de identificação" type="string" required>
          Variável: `documentType`. Tipo de documento de identidade.

          **Valores disponíveis:**

          * `CC`: Cédula de Ciudadanía (cidadãos colombianos)
          * `PEP`: Permiso Especial de Permanencia (estrangeiros, principalmente venezuelanos)
          * `CE`: Cédula de Extranjería (residentes estrangeiros na Colômbia)
        </ParamField>
      </Accordion>

      <Accordion title="Número de identificação" icon="hashtag">
        <ParamField body="Número de identificação" type="string" required>
          Variável: `documentNumber`. Número do documento de identidade da pessoa a consultar.
        </ParamField>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Saídas">
    #### ✅ Sucesso

    <AccordionGroup>
      <Accordion title="Sem antecedentes disciplinares" icon="circle-check">
        Indica que a pessoa consultada **não possui antecedentes disciplinares** na Procuradoria-Geral da Nação.

        <Tip>
          A resposta entregue corresponde à resposta completa do provedor Verifik.
        </Tip>

        **Exemplo de resposta:**

        ```json theme={null}
        {
          "data": {
            "documentType": "CC",
            "documentNumber": "XXXXXXXXXX",
            "fullName": "FIRST_NAME LAST_NAME",
            "firstName": "FIRST_NAME",
            "lastName": "LAST_NAME",
            "arrayName": [
              "FIRST_NAME",
              "LAST_NAME"
            ],
            "antecedentes": [],
            "isRequired": false,
            "legend": "Online query of Disciplinary Records, The Attorney General's Office certifies that at 15 hours on 31/08/2022 Mr./Ms. FIRST_NAME LAST_NAME identified with Citizenship Card Number XXXXXXXXXX The citizen has no criminal record.",
            "expeditionDate": "This information has been classified as semi-private and is not available for delivery on a temporary basis. - RNEC 2686",
            "expeditionPlace": "This information has been classified as semi-private and is not available for delivery on a temporary basis. - RNEC 2686",
            "dateOfBirth": "This information has been classified as semi-private and is not available for delivery on a temporary basis. - RNEC 2686"
          },
          "signature": {
            "dateTime": "August 31, 2022 3:53 PM",
            "message": "Certified by Verifik.co"
          }
        }
        ```

        **Campos-chave:**

        * `antecedentes`: Array vazio indica ausência de antecedentes
        * `isRequired`: Indica se há um requisito pendente
        * `legend`: Certificação oficial da Procuradoria-Geral da Nação
      </Accordion>
    </AccordionGroup>

    #### 🔴 Erros

    <AccordionGroup>
      <Accordion title="Possui antecedentes disciplinares" icon="triangle-exclamation">
        Indica que a pessoa **possui antecedentes disciplinares** na Procuradoria-Geral da Nação.

        <Warning>
          As informações retornadas incluem detalhes de sanções, inabilitações, crimes e processos.
        </Warning>

        **Exemplo de resposta:**

        ```json theme={null}
        {
          "data": {
            "documentType": "CC",
            "documentNumber": "XXXXXXXXXX",
            "citizen": "FIRST_NAME LAST_NAME",
            "hasRecord": true,
            "isRequired": false,
            "legend": "Online query of Disciplinary Records, The Attorney General's Office certifies that at 9:46:41 PM on 2/8/2022 Mr./Ms. FIRST_NAME LAST_NAME identified with Citizenship Card Number XXXXXXXXXX The citizen does have a criminal record.",
            "antecedentes": [
              {
                "sanciones": [
                  {
                    "Sancion": "PRISON",
                    "Termino": "78 MONTHS",
                    "Clase": "PRINCIPAL",
                    "Suspendida": ""
                  },
                  {
                    "Sancion": "DISQUALIFICATION FROM EXERCISING RIGHTS AND PUBLIC FUNCTIONS",
                    "Termino": "78 MONTHS",
                    "Clase": "ACCESSORY",
                    "Suspendida": ""
                  }
                ],
                "instancias": [
                  {
                    "Nombre": "FIRST",
                    "Autoridad": "CRIMINAL CIRCUIT COURT - CITY (DEPARTMENT)",
                    "Fecha providencia": "30/06/2015",
                    "fecha efecto Juridicos": "13/06/2016"
                  }
                ],
                "delitos": [
                  {
                    "Descripcion del Delito": "CRIME DESCRIPTION (LAW 599 OF 2000)"
                  }
                ],
                "inhabilidades": [
                  {
                    "Módulo": "CRIMINAL",
                    "Inhabilidad legal": "DISQUALIFICATION FROM HOLDING PUBLIC OFFICE LAW 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 a pessoa possui antecedentes
        * `antecedentes[]`: Array com informações detalhadas sobre:
          * **sanciones**: Tipo de sanção, prazo e classe
          * **instancias**: Autoridade que emitiu a sanção e datas
          * **delitos**: Descrição dos crimes
          * **inhabilidades**: Período de inabilitação para cargo público
      </Accordion>

      <Accordion title="Dados ausentes" icon="circle-xmark">
        Ocorre quando nem todos os parâmetros necessários são enviados para realizar a consulta.

        **Exemplo de resposta:**

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

        O campo `message` indica quais parâmetros específicos estão faltando na solicitação.
      </Accordion>

      <Accordion title="Sem registro" icon="magnifying-glass">
        Ocorre quando o provedor indica que nenhum registro associado à identificação consultada foi encontrado (Not Found).

        **Exemplo de resposta:**

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

        <Note>
          Há uma diferença entre "sem antecedentes disciplinares" e "sem registro". O primeiro indica que a pessoa foi encontrada e não possui antecedentes, enquanto o segundo indica que nenhum registro dessa pessoa foi encontrado no sistema.
        </Note>
      </Accordion>

      <Accordion title="Serviço indisponível" icon="server">
        O servidor do provedor não respondeu. Também ocorre em casos onde a identificação enviada não é válida.

        **Exemplo de resposta:**

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

        <Warning>
          Este erro pode indicar problemas de conectividade com o provedor ou que o documento consultado tem formato inválido.
        </Warning>
      </Accordion>

      <Accordion title="Erro inesperado" icon="bug">
        Ocorre quando um evento imprevisto acontece durante o processo de consulta.
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

## Integração

<Steps>
  <Step title="Capture os dados do usuário">
    Colete o tipo de documento e o número de identificação do usuário no seu fluxo.

    <Tip>
      Use o [nó de Pergunta](/pt/guias/nodos/pergunta) ou [variáveis de usuário](/pt/guias/variaveis/user) para capturar essas informações.
    </Tip>
  </Step>

  <Step title="Configure os parâmetros">
    Atribua os valores capturados aos parâmetros obrigatórios da ferramenta:

    * `documentType`: Tipo de documento (CC, PEP, CE)
    * `documentNumber`: Número de identificação
  </Step>

  <Step title="Trate as saídas">
    Implemente diferentes fluxos com base no resultado:

    * **✅ Sem antecedentes:** Continue o processo normal
    * **🔴 Erros:** Implemente novas tentativas, validações ou notifique o usuário de acordo com o tipo de erro (dados ausentes, sem registro, serviço indisponível, etc.)
  </Step>

  <Step title="Armazene e processe os resultados">
    Salve a resposta em [variáveis de memória](/pt/guias/variaveis/memory) para usar em decisões subsequentes do fluxo.

    ```javascript theme={null}
    // Example: Check whether the person has a criminal record
    if (response.data.hasRecord === true) {
      // Flow for persons with criminal record
      // You can access details: sanctions, disqualifications, crimes
    } else {
      // Flow for persons without criminal record
    }
    ```
  </Step>
</Steps>

<CardGroup cols={2}>
  <Card title="Resposta do provedor" icon="server">
    O resultado da consulta depende diretamente das informações retornadas pelo provedor Verifik e pela Procuradoria-Geral da Nação.
  </Card>

  <Card title="Interpretação do resultado" icon="circle-info">
    É importante distinguir entre "sem antecedentes disciplinares" (pessoa verificada sem antecedentes) e "sem registro" (pessoa não encontrada no sistema).
  </Card>

  <Card title="Informações sensíveis" icon="shield-halved">
    Dados sobre data de expedição, local de expedição e data de nascimento são classificados como informações semiprivadas e não estão temporariamente disponíveis de acordo com o RNEC.
  </Card>
</CardGroup>