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

# Interpol

> Verificação de antecedentes em listas internacionais.

<Update label="Versão: 2.0">
  Consulte registros internacionais na Interpol através do provedor Verifik, usando dados de identificação pessoal do usuário a ser verificado.

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

## Configuração

<Tabs>
  <Tab title="Entradas">
    <AccordionGroup>
      <Accordion title="País" icon="globe">
        <ParamField body="País" type="string" required>
          Variável: `country`. País em que a consulta é realizada.

          **Valores disponíveis:** `Colombia`
        </ParamField>

        <Note>
          Atualmente o seletor de país está habilitado apenas para a Colômbia.
        </Note>
      </Accordion>

      <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, habilitado de acordo com o país selecionado.

          **Valores disponíveis para Colômbia:**

          * `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 criminais" icon="circle-check">
        Indica que a pessoa consultada **não possui antecedentes criminais** na Interpol.

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

        **Exemplo de resposta:**

        ```json theme={null}
        {
          "data": {
            "documentType": "CC",
            "documentNumber": "XXXXXXXXXX",
            "firstName": "FIRST_NAME",
            "lastName": "LAST_NAME",
            "fullName": "FIRST_NAME LAST_NAME",
            "arrayName": [
              "FIRST_NAME",
              "SECOND_NAME",
              "LAST_NAME_1",
              "LAST_NAME_2"
            ],
            "foundInInterpol": false,
            "details": null
          },
          "signature": {
            "dateTime": "June 16, 2025 4:31 PM",
            "message": "Certified by Verifik.co"
          },
          "id": "XXXXX"
        }
        ```

        **Campos-chave:**

        * `foundInInterpol`: `false` indica que a pessoa não possui antecedentes criminais na Interpol
        * `details`: `null` quando não há antecedentes criminais
      </Accordion>
    </AccordionGroup>

    #### 🔴 Erros

    <AccordionGroup>
      <Accordion title="Possui antecedentes criminais" icon="triangle-exclamation">
        Indica que a pessoa **possui antecedentes criminais** na Interpol.

        <Warning>
          As informações retornadas correspondem à resposta do provedor.
        </Warning>

        **Exemplo de resposta:**

        ```json theme={null}
        {
          "data": {
            "documentType": "CC",
            "documentNumber": "XXXXXXXXXX",
            "firstName": "FIRST_NAME",
            "lastName": "LAST_NAMES",
            "fullName": "FIRST_NAME LAST_NAMES",
            "arrayName": [
              "FIRST_NAME",
              "LAST_NAME"
            ],
            "foundInInterpol": true,
            "details": {
              "totalCards": "2",
              "cards": [
                {
                  "arrestWarrants": [
                    {
                      "issuingCountryId": "CO",
                      "charge": "Description of the charges"
                    }
                  ],
                  "weight": "0",
                  "languagesSpokenIds": [
                    "SPA"
                  ],
                  "height": "1.75",
                  "sexId": "M",
                  "countryOfBirthId": "CO",
                  "distinguishingMarks": null,
                  "eyesColorsId": null,
                  "hairsId": null,
                  "placeOfBirth": "CITY - DEPARTMENT"
                }
              ]
            }
          },
          "signature": {
            "dateTime": "June 16, 2025 4:31 PM",
            "message": "Certified by Verifik.co"
          },
          "id": "XXXXX"
        }
        ```

        **Campos importantes:**

        * `foundInInterpol`: `true` indica que a pessoa foi encontrada com antecedentes criminais
        * `details.totalCards`: Número de registros encontrados
        * `details.cards[].arrestWarrants`: Lista de mandados de prisão com acusações específicas
        * `signature`: Certificação do provedor Verifik com data e hora da consulta
      </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 registros" 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 criminais" e "sem registros". O primeiro indica que a pessoa foi encontrada e não possui antecedentes criminais, enquanto o segundo indica que nenhum registro dessa pessoa foi encontrado no sistema.
        </Note>
      </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 país, tipo de documento e 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:

    * `country`: País da consulta
    * `documentType`: Tipo de documento de acordo com o país
    * `documentNumber`: Número de identificação
  </Step>

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

    * **✅ Sem antecedentes criminais:** Continue o processo normal
    * **🔴 Erros:** Implemente novas tentativas, validações ou notifique o usuário
  </Step>

  <Step title="Armazene 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.foundInInterpol === true) {
      // Flow for persons with criminal record
    } else {
      // Flow for persons without criminal record
    }
    ```
  </Step>
</Steps>

## Informações adicionais

**Dependência de país:** o tipo de identificação disponível depende do país que você seleciona na consulta.

**Resposta do provedor:** o resultado da consulta depende diretamente das informações retornadas pelo provedor Verifik.

**Interpretação do resultado:** distinga entre sem antecedentes criminais (pessoa verificada sem antecedentes criminais) e sem registros (pessoa não encontrada no sistema).