🇵🇪 Resumen

En esta sección, encontrarás información sobre los datos de entrada requeridos para el perfil de una persona en Perú, los reportes disponibles, la configuración de reportes y cómo realizar consultas para crear una persona, obtener el estado de una persona y los detalles de sus reportes.

¿Has leído nuestra introducción?

Esta sección contiene los detalles específicos sobre el perfil de entrada y los reportes disponibles en Perú. Para entenderlo mejor, te recomendamos que también eches un vistazo a nuestra sección de Primeros Pasos. 😊

Perfil

Campo de entrada	Descripción	Ejemplo
document_id	El Número de ID del Documento para Perú (consulta el campo document_id_type a continuación).	123456789
document_id_type	Los valores aceptados son national_id para el Documento Nacional de Identidad (DNI) o Tarjeta de Identidad y foreigner_card para Carné de Extranjería, Carné de Solicitante o Permiso Temporal de Permanencia. La opción encontrada se devuelve en los detalles como document_id_type_name. Por defecto es national_id.	national_id
city_locode	El UN LOCODE de la ciudad donde se encuentra la persona (u otra ciudad según tus necesidades para dirigir el proceso de BGC). Siempre requerido.	PE LIM
dob	Representación ISO 8601 de la fecha en que nació la persona.	1990-05-03
full_name	Nombre completo de la persona a verificar. Requerido para los reportes most_wanted, police_arrest, boletin_judicial y sanctions.	JUAN MIGUEL DOE
labor_certificate_id	Número del Certificado Laboral (Número del Certificado Único Laboral). Requerido solo para el reporte labor_certificate.	0123456789123
labor_certificate_type	Tipo de Certificado Laboral. Los valores aceptados son certiadulto y certijoven. Requerido solo para el reporte labor_certificate.	certiadulto
ruc	El RUC (Registro Único de Contribuyentes) para la empresa que solicita la información del Certificado Laboral. Requerido solo para el reporte labor_certificate.	9999999999
ptp	Para el reporte foreigner_card_status, indica si el valor de entrada es un Permiso Temporal de Permanencia. Ya sea True o False. Requerido solo para el reporte foreigner_card_status.	False
request_code	El código de solicitud para un Certificado de Antecedentes Penales (Código de Consulta del Certificado de Antecedentes Penales). Requerido solo para el reporte justice_certificate.	VOED83219812K

Reportes disponibles

Nombre del reporte	Descripción	Fuente/base de datos
dni_status	Valida un DNI (Documento Nacional de Identidad) y recupera los datos personales asociados a él.	Registro Nacional de Identificación y Estado Civil (RENIEC)
foreigner_card_status	Valida un foreigner_card (Carné de Extranjería o Permiso Temporal de Permanencia) y recupera los datos personales asociados a él.	Superintendencia Nacional de Migraciones del Perú
license_status	Verifica el estado de una Licencia de Conducir y recupera los datos asociados a ella.	Ministerio de Transporte y Comunicaciones
drunk_driving	Verifica el historial de manejo de una persona por ocurrencias de conducir en estado de embriaguez.	Ministerio de Transporte y Comunicaciones
dangerous_driver	Verifica el historial de manejo de una persona por ocurrencias de conducción peligrosa.	Ministerio de Transporte y Comunicaciones
labor_certificate	Dado solo un DNI y un número de certificado, recupera todos los datos del certificado (dirección, antecedentes penales, historial laboral y educativo, etc.) y construye la toma de decisiones sobre los datos encontrados.	Ministerio de Trabajo y Promoción del Empleo
justice_certificate	Dado un request_code de un certificado previamente emitido, recupera los datos del certificado.	Poder Judicial del Perú
most_wanted	Verifica ocurrencias en la base de datos de los más buscados del gobierno peruano.	Programa de Recompensas - Ministerio del Interior del Perú
police_arrest	Verifica la base de datos con reportes policiales de arrestos para coincidencias con los datos de la persona.	Base de Datos de Arrestos Policiales (interna)
boletin_judicial	Verifica los boletines judiciales (Boletín Judicial) del Sistema de Justicia de Perú (Poder Judicial del Perú).	Poder Judicial del Perú
sanctions	Verifica reportes de sanciones de ONU, OFAC, EEAS y Banco Mundial.	ONU, OFAC, EEAS, y Banco Mundial.

¿Quieres entrar en acción?

¡Consulta nuestra sección de Referencia de API y comienza a usarla de inmediato! 😄

Solicitudes de ejemplo

Crear una Persona

Para crear una persona, copia y pega el siguiente comando o código, reemplazando los datos ficticios con los datos de la persona que quieres usar y la cadena YOUR_API_KEY con tu Clave 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)

Obtener el estado de la persona

Para obtener el estado de una persona, necesitarás el person_id devuelto por nuestra API en el paso Crear una Persona. Úsalo con tu Clave de API dentro del siguiente comando o código (en el ejemplo a continuación, el person_id es 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)

Obtener detalles de reportes

Para obtener los detalles de los reportes de la persona, necesitarás el person_id devuelto en el paso Crear una Persona. Úsalo con tu Clave de API dentro del siguiente comando o código (en el ejemplo a continuación, el person_id es 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)

Cómo obtener una Clave de API

La Clave de API es el token que necesitarás para autenticarte en nuestros sistemas. Si aún necesitas obtener una, por favor contáctanos.