🇵🇪 Peru

Nesta seção, você encontrará informações sobre os dados de entrada necessários para o perfil de uma pessoa no Peru, os relatórios disponíveis, as configurações de relatórios e como realizar consultas para criar uma pessoa, obter o status de uma pessoa e os detalhes de seus relatórios.

Você leu nossa introdução?

Esta seção contém os detalhes específicos sobre o perfil de entrada e os relatórios disponíveis no Peru. Para entendê-la melhor, recomendamos que você também dê uma olhada em nossa seção Primeiros Passos. 😊

Perfil

Campo de entrada	Descrição	Exemplo
document_id	O Número de ID do Documento para o Peru (consulte o campo document_id_type abaixo).	123456789
document_id_type	Os valores aceitos são national_id para o Documento Nacional de Identidad (DNI) ou Tarjeta de Identidad e foreigner_card para Carné de Extranjería, Carné de Solicitante ou Permiso Temporal de Permanencia. A opção encontrada é retornada nos detalhes como document_id_type_name. O padrão é national_id.	national_id
city_locode	O UN LOCODE da cidade onde a pessoa está localizada (ou outra cidade de acordo com suas necessidades para direcionar o processo de BGC). Sempre obrigatório.	PE LIM
dob	Representação ISO 8601 da data em que a pessoa nasceu.	1990-05-03
full_name	Nome completo da pessoa a ser verificada. Obrigatório para os relatórios most_wanted, police_arrest, boletin_judicial e sanctions.	JUAN MIGUEL DOE
labor_certificate_id	Número do Certificado Trabalhista (Número del Certificado Único Laboral). Obrigatório apenas para o relatório labor_certificate.	0123456789123
labor_certificate_type	Tipo de Certificado Trabalhista. Os valores aceitos são certiadulto e certijoven. Obrigatório apenas para o relatório labor_certificate.	certiadulto
ruc	O RUC (Registro Único de Contribuyentes) para a empresa que solicita as informações do Certificado Trabalhista. Obrigatório apenas para o relatório labor_certificate.	9999999999
ptp	Para o relatório foreigner_card_status, indica se o valor de entrada é um Permiso Temporal de Permanencia. Seja True ou False. Obrigatório apenas para o relatório foreigner_card_status.	False
request_code	O código de solicitação para um Certificado de Antecedentes Criminais (Código de Consulta del Certificado de Antecedentes Penales). Obrigatório apenas para o relatório justice_certificate.	VOED83219812K

Relatórios disponíveis

Nome do relatório	Descrição	Fonte/base de dados
dni_status	Valida um DNI (Documento Nacional de Identidad) e recupera os dados pessoais associados a ele.	Registro Nacional de Identificación y Estado Civil (RENIEC)
foreigner_card_status	Valida um foreigner_card (Carné de Extranjería ou Permiso Temporal de Permanencia) e recupera os dados pessoais associados a ele.	Superintendencia Nacional de Migraciones del Perú
license_status	Verifica o status de uma Carteira de Motorista e recupera os dados associados a ela.	Ministerio de Transporte y Comunicaciones
drunk_driving	Verifica o histórico de direção de uma pessoa por ocorrências de direção sob influência de álcool.	Ministerio de Transporte y Comunicaciones
dangerous_driver	Verifica o histórico de direção de uma pessoa por ocorrências de direção perigosa.	Ministerio de Transporte y Comunicaciones
labor_certificate	Dado apenas um DNI e um número de certificado, recupera todos os dados do certificado (endereço, antecedentes criminais, histórico trabalhista e educacional, etc.) e constrói a tomada de decisão sobre os dados encontrados.	Ministerio de Trabajo y Promoción del Empleo
justice_certificate	Dado um request_code de um certificado previamente emitido, recupera os dados do certificado.	Poder Judicial del Perú
most_wanted	Verifica ocorrências na base de dados dos mais procurados do governo peruano.	Programa de Recompensas - Ministerio del Interior del Perú
police_arrest	Verifica a base de dados com relatórios policiais de prisões para correspondências com os dados da pessoa.	Base de Dados de Prisões Policiais (interna)
boletin_judicial	Verifica os boletins judiciais (Boletín Judicial) do Sistema de Justiça do Peru (Poder Judicial del Perú).	Poder Judicial del Perú
sanctions	Verifica relatórios de sanções da ONU, OFAC, EEAS e Banco Mundial.	ONU, OFAC, EEAS, e Banco Mundial.

Quer entrar em ação?

Confira nossa seção de Referência da API e comece a usá-la imediatamente! 😄

Exemplos de solicitações

Criar uma Pessoa

Para criar uma pessoa, copie e cole o seguinte comando ou código, substituindo os dados fictícios pelos dados da pessoa que você quer usar e a string YOUR_API_KEY pela sua Chave de API, respectivamente:

curl --request POST \
  --url https://api.emptor.io/v3/pe/persons/ \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --data '{"reports":{"dni_status":"enabled","license_status":"enabled","drunk_driving":"enabled","dangerous_driver":"enabled","labor_certificate":"enabled","justice_certificate":"enabled","most_wanted":"enabled","police_arrest":"enabled","boletin_judicial":"enabled","sanctions":"enabled"},"city_locode":"PE LIM","document_id":"123456789","document_id_type":"national_id","dob":"1990-05-03","full_name":"JUAN MIGUEL DOE","labor_certificate_id":"0123456789123","labor_certificate_type":"certiadulto","request_code":"VOED83219812K","ruc":"9999999999"}'

const fetch = require('node-fetch');

let url = 'https://api.emptor.io/v3/pe/persons/';

let options = {
  method: 'POST',
  headers: {
    Accept: 'application/json',
    'Content-Type': 'application/json',
    'X-Api-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    reports: {
      dni_status: 'enabled',
      license_status: 'enabled',
      drunk_driving: 'enabled',
      dangerous_driver: 'enabled',
      labor_certificate: 'enabled',
      justice_certificate: 'enabled',
      most_wanted: 'enabled',
      police_arrest: 'enabled',
      boletin_judicial: 'enabled',
      sanctions: 'enabled'
    },
    city_locode: 'PE LIM',
    document_id: '123456789',
    document_id_type: 'national_id',
    dob: '1990-05-03',
    full_name: 'JUAN MIGUEL DOE',
    labor_certificate_id: '0123456789123',
    labor_certificate_type: 'certiadulto',
    request_code: 'VOED83219812K',
    ruc: '9999999999'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error('error:' + err));

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.emptor.io/v3/pe/persons/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["Accept"] = 'application/json'
request["Content-Type"] = 'application/json'
request["X-Api-Key"] = 'YOUR_API_KEY'
request.body = "{\"reports\":{\"dni_status\":\"enabled\",\"license_status\":\"enabled\",\"drunk_driving\":\"enabled\",\"dangerous_driver\":\"enabled\",\"labor_certificate\":\"enabled\",\"justice_certificate\":\"enabled\",\"most_wanted\":\"enabled\",\"police_arrest\":\"enabled\",\"boletin_judicial\":\"enabled\",\"sanctions\":\"enabled\"},\"city_locode\":\"PE LIM\",\"document_id\":\"123456789\",\"document_id_type\":\"national_id\",\"dob\":\"1990-05-03\",\"full_name\":\"JUAN MIGUEL DOE\",\"labor_certificate_id\":\"0123456789123\",\"labor_certificate_type\":\"certiadulto\",\"request_code\":\"VOED83219812K\",\"ruc\":\"9999999999\"}"

response = http.request(request)
puts response.read_body

import requests

url = "https://api.emptor.io/v3/pe/persons/"

payload = {
    "reports": {
        "dni_status": "enabled",
        "license_status": "enabled",
        "drunk_driving": "enabled",
        "dangerous_driver": "enabled",
        "labor_certificate": "enabled",
        "justice_certificate": "enabled",
        "most_wanted": "enabled",
        "police_arrest": "enabled",
        "boletin_judicial": "enabled",
        "sanctions": "enabled"
    },
    "city_locode": "PE LIM",
    "document_id": "123456789",
    "document_id_type": "national_id",
    "dob": "1990-05-03",
    "full_name": "JUAN MIGUEL DOE",
    "labor_certificate_id": "0123456789123",
    "labor_certificate_type": "certiadulto",
    "request_code": "VOED83219812K",
    "ruc": "9999999999"
}
headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
    "X-Api-Key": "YOUR_API_KEY"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Obter o status da pessoa

Para obter o status de uma pessoa, você precisará do person_id retornado pela nossa API no passo Criar uma Pessoa. Use-o com sua Chave de API dentro do seguinte comando ou código (no exemplo abaixo, o person_id é 0597f9f8-2ea5-4557-b3a1-5a590ed96ef4):

curl --request GET \
  --url https://api.emptor.io/v3/pe/persons/0597f9f8-2ea5-4557-b3a1-5a590ed96ef4/status \
  --header 'Accept: application/json' \
  --header 'X-Api-Key: YOUR_API_KEY'

const fetch = require('node-fetch');

let url = 'https://api.emptor.io/v3/pe/persons/0597f9f8-2ea5-4557-b3a1-5a590ed96ef4/status';

let options = {
  method: 'GET',
  headers: {Accept: 'application/json', 'X-Api-Key': 'YOUR_API_KEY'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error('error:' + err));

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.emptor.io/v3/pe/persons/0597f9f8-2ea5-4557-b3a1-5a590ed96ef4/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["Accept"] = 'application/json'
request["X-Api-Key"] = 'YOUR_API_KEY'

response = http.request(request)
puts response.read_body

import requests

url = "https://api.emptor.io/v3/pe/persons/0597f9f8-2ea5-4557-b3a1-5a590ed96ef4/status"

headers = {
    "Accept": "application/json",
    "X-Api-Key": "YOUR_API_KEY"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

Obter detalhes dos relatórios

Para obter os detalhes dos relatórios da pessoa, você precisará do person_id retornado no passo Criar uma Pessoa. Use-o com sua Chave de API dentro do seguinte comando ou código (no exemplo abaixo, o person_id é 0597f9f8-2ea5-4557-b3a1-5a590ed96ef4):

curl --request GET \
  --url https://api.emptor.io/v3/pe/details/0597f9f8-2ea5-4557-b3a1-5a590ed96ef4 \
  --header 'Accept: application/json' \
  --header 'X-Api-Key: YOUR_API_KEY'

const fetch = require('node-fetch');

let url = 'https://api.emptor.io/v3/pe/details/0597f9f8-2ea5-4557-b3a1-5a590ed96ef4';

let options = {
  method: 'GET',
  headers: {Accept: 'application/json', 'X-Api-Key': 'YOUR_API_KEY'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error('error:' + err));

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.emptor.io/v3/pe/details/0597f9f8-2ea5-4557-b3a1-5a590ed96ef4")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["Accept"] = 'application/json'
request["X-Api-Key"] = 'YOUR_API_KEY'

response = http.request(request)
puts response.read_body

import requests

url = "https://api.emptor.io/v3/pe/details/0597f9f8-2ea5-4557-b3a1-5a590ed96ef4"

headers = {
    "Accept": "application/json",
    "X-Api-Key": "YOUR_API_KEY"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

Como obter uma Chave de API

A Chave de API é o token que você precisará para se autenticar em nossos sistemas. Se você ainda precisa obter uma, por favor entre em contato conosco.