search

martinsam16 / consulta-peru

API centralizada y open-source de consultas de datos del Perú
https://consulta-peru-demo.herokuapp.com
22 stars 8 forks source link

readme

Consulta Perú

API version Python version supported Docker image size Sonarcloud Status Open Source Love svg2

API centralizada y open-source de consultas de datos del Perú

Deploy

Heroku

Deploy

Correr

Python

pip install -r requirements.txt
py app.py

Docker

docker build -t consulta-peru .
docker run -p 5000:5000 -dit --name="consulta-peru" "consulta-peru"

ó

docker run -p 5000:5000 -dit malditoidealismo/consulta-peru:latest

Endpoints

  1. Ciudadano
  2. Empresa
  3. Tipo de Cambio
  4. Bolsa de Valores de Lima
  5. Comisiones y Primas de Seguro del SPP
  6. SUNARP

Nota: Crear issues en caso haya errores o los endpoints a los que se conecta o hayan dejado de funcionar :D

Ciudadano

Obtiene la información de una persona natural a partir de su DNI

Puedes sacar su ruc por: 10{dni}{ultimo_digito} y realizar la consulta al endpoint de empresa.

URI Metodo Ejemplo
/dni_sunat/{numero_dni} GET /dni_sunat/72720455 🟢
/dni_reniec/{numero_dni} GET /dni_reniec/72720455 🟢
/dni_essalud/{numero_dni} GET /dni_essalud/72720455 🟢

Respuesta

{
  "apellido_materno": "ARATA",
  "apellido_paterno": "SAMAN",
  "dni": "72720455",
  "domicilio": "XXX YYY ZZZ",
  "fecha_nacimiento": "16/10/2000",
  "nombres": "MARTIN ALEXIS",
  "sexo": "-",
  "telefono": "-",
  "ultimo_digito": 1
}

Empresa

Obtiene la información de una persona jurídica o empresa a partir de su RUC

URI Metodo Ejemplo
/ruc/{numero_ruc} GET /ruc/20305354563

Respuesta

{
    "actividad_de_comercio_exterior": "SIN ACTIVIDAD",
    "afecto_nuevo_rus": "NO",
    "agente_de_percepcion_comliq": "-",
    "agente_de_percepcion_vtaint": "-",
    "agente_de_retencion": "NO, Excluido del Régimen de Agentes de Retención de IGV a partir del 01/09/2016",
    "buen_contribuyente": "-",
    "condicion_del_contribuyente": "HABIDO",
    "departamento": "LIMA",
    "direccion": "CAL. VICTOR ALZAMORA NRO. 147 URB. SANTA CATALINA",
    "distrito": "LA VICTORIA",
    "estado_del_contribuyente": "BAJA DEFINITIVA",
    "fax": "-",
    "fecha_de_inicio_de_actividades": "01/05/1996",
    "fecha_de_inscripcion": "15/05/1996",
    "nombre__razonsocial": "FARMACIAS PERUANAS S.A.",
    "nombre_comercial": "BOTICAS FASA, MIFARMA, JUSTO",
    "numeroruc": "20305354563",
    "principal_ciiu": "VTA.  MIN. PROD. FARMAC. Y ART. TOCADOR.",
    "profesion_u_oficio": "-",
    "provincia": "LIMA",
    "secundario_1_ciiu": "-",
    "secundario_2_ciiu": "-",
    "telefono": "-",
    "tipo_de_contribuyente": "SOCIEDAD ANONIMA"
}

Tipo de Cambio

Obtiene el tipo de cambio desde la SUNAT

URI Metodo Ejemplo Descripción
/cambio GET /cambio Obtiene el tipo de cambio actual
/cambio/periodo/{anio}/{mes} GET /cambio/periodo/2020/6 Obtiene el tipo de cambio dependiendo del año y mes solicitado
/cambio/dia/{anio}/{mes}/{dia} GET /cambio/dia/2020/2/4 Obtiene el tipo de cambio dependiendo del año, mes y día solicitado

Respuestas

Bolsa de Valores de Lima

Obtiene la información de la bvl

formato fecha = YYYYMMDD

URI Metodo Ejemplo Descripción
/bvl/resumen_mercado GET /bvl/resumen_mercado Obtiene el resumen del mercado
/bvl/cotizaciones GET /bvl/cotizaciones Obtiene todas las cotizaciones
/bvl/empresas GET /bvl/empresas Obtiene las empresas que cotizan en bolsa
/bvl/empresa/tree/{nemonico} GET / Proximamente..
/bvl/{nemonico} GET /bvl/NVDA Obtiene todo el historial en bolsa de un nemonico solicitado
/bvl/{nemonico}/{fecha_inicio} GET /bvl/NVDA/20200603 Obtiene el historial de un nemonico en bolsa desde la fecha solicitada hasta ahora
/bvl/{nemonico}/{fecha_inicio}/{fecha_fin} GET /bvl/NVDA/20200501/20200603 Obtiene el historial de un nemonico de un periodo determinado

Respuestas

[
    {
        "acciones": "",
        "anterior": "331.50",
        "apertura": "",
        "compra": "",
        "empresa": "Apple Inc.",
        "fecha_anterior": "05/06/2020",
        "moneda": "US$",
        "monto_negativo": "",
        "nemonico": "AAPL",
        "operaciones": "",
        "porcentaje_variacion": "",
        "sector": "",
        "segm": "RV3",
        "ultima": "",
        "venta": ""
    },
    {
        "acciones": "",
        "anterior": "23.30",
        "apertura": "",
        "compra": "",
        "empresa": "Barrick Gold Corporation",
        "fecha_anterior": "08/06/2020",
        "moneda": "US$",
        "monto_negativo": "",
        "nemonico": "ABX",
        "operaciones": "",
        "porcentaje_variacion": "",
        "sector": "",
        "segm": "RV3",
        "ultima": "",
        "venta": ""
    },
    {
        "acciones": "",
        "anterior": "76.50",
        "apertura": "",
        "compra": "",
        "empresa": "iShares MSCI ACWI ETF",
        "fecha_anterior": "08/06/2020",
        "moneda": "US$",
        "monto_negativo": "",
        "nemonico": "ACWI",
        "operaciones": "",
        "porcentaje_variacion": "",
        "sector": "",
        "segm": "RV3",
        "ultima": "",
        "venta": ""
    },
    ...
]

Comisiones y Primas de Seguro del SPP

Obtiene informacion de la Superintendencia de Banca, seguros y AFP

URI Metodo Ejemplo Descripción
/spp GET /spp Obtiene información actual (comisión fija ignorada)
/spp/periodo GET / Proximamente..

Respuesta

[
    {
        "afp": "HABITAT",
        "aporte_obligatorio_fondo_pensiones": "10.00%",
        "comision_mixta": {
            "comision_anual_sobre_saldo": "1.25%",
            "comision_sobre_flujo": "0.38%"
        },
        "comision_sobre_flujo": "1.47%",
        "prima_seguros": "1.35%",
        "remuneracion_maxima_asegurable": "9,788.95"
    },
    {
        "afp": "INTEGRA",
        "aporte_obligatorio_fondo_pensiones": "10.00%",
        "comision_mixta": {
            "comision_anual_sobre_saldo": "0.82%",
            "comision_sobre_flujo": "0.00%"
        },
        "comision_sobre_flujo": "1.55%",
        "prima_seguros": "1.35%",
        "remuneracion_maxima_asegurable": "9,788.95"
    },
    {
        "afp": "PRIMA",
        "aporte_obligatorio_fondo_pensiones": "10.00%",
        "comision_mixta": {
            "comision_anual_sobre_saldo": "1.25%",
            "comision_sobre_flujo": "0.18%"
        },
        "comision_sobre_flujo": "1.60%",
        "prima_seguros": "1.35%",
        "remuneracion_maxima_asegurable": "9,788.95"
    },
    {
        "afp": "PROFUTURO",
        "aporte_obligatorio_fondo_pensiones": "10.00%",
        "comision_mixta": {
            "comision_anual_sobre_saldo": "1.20%",
            "comision_sobre_flujo": "0.67%"
        },
        "comision_sobre_flujo": "1.69%",
        "prima_seguros": "1.35%",
        "remuneracion_maxima_asegurable": "9,788.95"
    }
]

SUNARP

URI Metodo Ejemplo Descripción
/sunarp/titulo GET /sunarp/titulo Obtiene el trámite por titulo