Como usar el token

Como funciona consulta RUC

• Te conectas con nuestra aplicación vía WEB SERVICE REST, enviando a la RUTA el TOKEN y un RUC en formato
• Las consultar a nuestra aplicación se hace vía POST.
• Recibirás una respuesta en .JSON que puedes leer y usar inmediatamente en tu aplicación.
• La RUTA a la que debes enviar las consultas es: http://tu-dominio.com/api/v1/ruc/{ruc a consultar} (Sin corchetes)

Ejemplo de consulta RUC

Ruta para la solicitud:

http://tu-dominio.com/api/v1/ruc/

Tipo de consulta:

POST

Cabecera de la solititud:

Authorization: 'Bearer token'
ejemplo:
Authorization: 'Bearer 47399a40-055a-4e07-bf76-aedd694e9a8e'

Ejemplo de respuesta

Recibirás la respuesta en JSON.

Formato JSON:

{
    "codigo_de_zona": "URB.",
    "condicion_de_domicilio": "HABIDO",
    "direccion_completa": "AV. EL DERBY NRO. 555 INT. 402 URB. LIMA POLO AND HUNT CLUB - LIMA LIMA SANTIAGO DE SURCO",
    "dpto": "-",
    "error": false,
    "estado_del_contribuyente": "BAJA DEFINITIVA",
    "id": 71,
    "interior": "402",
    "kilometro": "-",
    "lote": "-",
    "manzana": "-",
    "nombre_de_via": "EL DERBY",
    "numero": "055",
    "razon_social": "BPZ MARINE PERU SRL",
    "ruc": "XXXXXXXXXXX",
    "tipo_de_via": "AV.",
    "tipo_de_zona": "LIMA POLO AND HUNT CLUB",
    "tipo_documento": "6",
    "ubigeo": "150140"
}

Ejemplos de código

A continuación le mostramos algunos ejemplos en otros lenguajes

Python POST:

import requests

data = {"ruc": "xxxxxxxxxxx"}

headers = {'Authorization': 'Bearer %s' % 'a39a7dd6-debe-4838-8e42-90c5695aa79a'}
request = requests.post("http://tu-dominio.com/api/v1/ruc", data=data, headers=headers)
print(request.json())

http(https://httpie.org):

$ http -f POST http://tu-dominio.com/api/v1/ruc ruc="xxxxxxxxxxx" Authorization:"Bearer a39a7dd6-debe-4838-8e42-90c5695aa79a"

curl:

$ curl -X POST -H "Authorization: Bearer a39a7dd6-debe-4838-8e42-90c5695aa79a" -d ruc=xxxxxxxxxxx "http://tu-dominio.com/api/v1/ruc"

Como funciona consulta DNI (ojo: se concluyo con la implementación pero la ruta del sercicio a RENIEC ya la deshabilitarón

• Te conectas con nuestra aplicación vía WEB SERVICE REST, enviando a la RUTA el TOKEN y el nro. de DNI
• Las consultar a nuestra aplicación se hace vía POST.
• Recibirás una respuesta en formato JSON.
• La RUTA a la que debes enviar las consultas es: http://tu-dominio.com/api/v1/dni

Ejemplo de consulta DNI

Ruta para la solicitud:

http://tu-dominio.com/api/v1/dni

Tipo de solicitud:

POST

Cabecera de la solititud:

Authorization: 'Bearer token'
ejemplo:
Authorization: 'Bearer 47399a40-055a-4e07-bf76-aedd694e9a8e'

Cuerpo de la solititud:

{
    "dni": "xxxxxxxx"
}

Ejemplo de respuesta

Recibirás la respuesta en JSON.

Formato JSON:

{
    "cod_verificacion": "x-x",
    "materno": "xxx",
    "nombres": "xxx xxx",
    "paterno": "xxx"
}

Ejemplos de código

A continuación le mostramos algunos ejemplos en otros lenguajes

Python POST:

import requests

data = {"dni": "xxxxxxxx"}

headers = {'Authorization': 'Bearer %s' % 'a39a7dd6-debe-4838-8e42-90c5695aa79a'}
request = requests.post("http://tu-dominio.com/api/v1/dni", data=data, headers=headers)
print(request.json())

http(https://httpie.org):

$ http -f POST http://tu-dominio.com/api/v1/dni dni="xxxxxxxx" Authorization:"Bearer tu-token"

curl

$ curl -X POST -H "Authorization: Bearer tu-token" -d dni=xxxxxxxx "http://tu-dominio.com/api/v1/dni"