Consulta RUC Web Service SUNAT

CONSULTA RUC

• SOLICITUD
• RESPUESTA

1
2
3
4

{
  "token": "ef5e49a4-f461-4928-8b01-064e522a4a86-49610454-2d87-4152-bf66-2f7cd19f86c1",
  "ruc": "10178520739"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
  "success": true,
  "ruc": "20600398017",
  "nombre_o_razon_social": "NOMBRE O RAZÓN SOCIAL",
  "estado_del_contribuyente": "ESTADO_DEL_CONTRIBUYENTE",
  "condicion_de_domicilio": "CONDICION_DE_DOMICILIO",
  "ubigeo": "UBIGEO",
  "tipo_de_via": "TIPO_DE_VIA",
  "nombre_de_via": "NOMBRE_DE_VIA",
  "codigo_de_zona": "CODIGO_DE_ZONA",
  "tipo_de_zona": "TIPO_DE_ZONA",
  "numero": "NUMERO",
  "interior": "INTERIOR",
  "lote": "LOTE",
  "dpto": "DEPARTAMENTO",
  "manzana": "MANZANA",
  "kilometro": "KILOMETRO",
  "departamento": "DEPARTAMENTO",
  "provincia": "PROVINCIA",
  "distrito": "DISTRITO",
  "direccion": "DIRECCION",
  "direccion_completa": "DIRECCION_COMPLETA",
  "ultima_actualizacion": "2016-05-08T00:00:00-05:00"
}

• ACTUALIZACIÓN DIARIA

  RUC.COM.PE se actualiza DIARIAMENTE con la información que optenemos desde el PADRÓN REDUCIDO que publica la SUNAT todos los días.

  Última actualización con la SUNAT hace 20 minutos .

• COMO FUNCIONA
  • Regístrate en RUC.COM.PE para optener una RUTA y generar un TOKEN.
  • Te conectas con nuestra aplicación vía WEB SERVICE REST, enviando a la RUTA el TOKEN y un RUC en formato .JSON
  • 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:
  https://ruc.com.pe/api/v1/consultas
• CONSULTA RUC

  Envíanos un .JSON a la RUTA, el TOKEN y un numero deRUC.

  ---

  Ruta para la solicitud:

  https://ruc.com.pe/api/v1/consultas

  Tipo de solicitud:

  POST

  Cabecera de la solititud:

  Content-Type: application/json

  Cuerpo de la solititud para RUC

  1 2 3 4

  { "token": "ef5e49a4-f461-4928-8b01-064e522a4a86-49610454-2d87-4152-bf66-2f7cd19f86c1", "ruc": "10178520739" }

  ---

  Respuesta en .JSON para RUC.

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

  { "success": true, "ruc": "20600398017", "nombre_o_razon_social": "NOMBRE O RAZÓN SOCIAL", "estado_del_contribuyente": "ESTADO_DEL_CONTRIBUYENTE", "condicion_de_domicilio": "CONDICION_DE_DOMICILIO", "ubigeo": "UBIGEO", "tipo_de_via": "TIPO_DE_VIA", "nombre_de_via": "NOMBRE_DE_VIA", "codigo_de_zona": "CODIGO_DE_ZONA", "tipo_de_zona": "TIPO_DE_ZONA", "numero": "NUMERO", "interior": "INTERIOR", "lote": "LOTE", "dpto": "DEPARTAMENTO", "manzana": "MANZANA", "kilometro": "KILOMETRO", "departamento": "DEPARTAMENTO", "provincia": "PROVINCIA", "distrito": "DISTRITO", "direccion": "DIRECCION", "direccion_completa": "DIRECCION_COMPLETA", "ultima_actualizacion": "2016-05-08T00:00:00-05:00" }

• CONSULTA DNI

  Envíanos un .JSON a la RUTA, el TOKEN y un numero de DNI.

  ---

  Ruta para la solicitud:

  https://ruc.com.pe/api/v1/consultas

  Tipo de solicitud:

  POST

  Cabecera de la solititud:

  Content-Type: application/json

  Cuerpo de la solititud para DNI

  1 2 3 4

  { "token": "ef5e49a4-f461-4928-8b01-064e522a4a86-49610454-2d87-4152-bf66-2f7cd19f86c1", "dni": "99999999" }

  ---

  Respuesta en .JSON para DNI.

  1 2 3 4 5

  { "success": true, "dni": "99999999", "nombre_completo": "NOMBRES COMPLETOS" }

• CONSULTA TIPO DE CAMBIO

  Envíanos un .JSON a la RUTA, el TOKEN y FECHAS.

  ---

  Ruta para la solicitud:

  https://ruc.com.pe/api/v1/consultas

  Tipo de solicitud:

  POST

  Cabecera de la solititud:

  Content-Type: application/json

  Cuerpo de la solititud para el TIPO DE CAMBIO

  1 2 3 4 5 6 7 8

  { "token": "ef5e49a4-f461-4928-8b01-064e522a4a86-49610454-2d87-4152-bf66-2f7cd19f86c1", "tipo_cambio": { "moneda": "PEN", "fecha_inicio": "DD/MM/AAAA", "fecha_fin": "DD/MM/AAAA" } }

  ---

  Respuesta en .JSON para TIPO DE CAMBIO.

  1 2 3 4 5 6 7 8 9 10 11

  { "success": true, "exchange_rates": [ { "fecha": "DD/MM/AAAA", "moneda": "PEN", "compra": 3.618, "venta": 3.624 } ] }

• EJEMPLOS DE CÓDIGO

  Aquí tenemos ejemplos de código en algunos lenguajes de programación:

  Para PHP

  • Descargar ejemplo en PHP usando JSON

  Para C#

  • Leer tutorial 1
  • Leer tutorial 2
  • Leer tutorial 3

  Para VB.NET

  • Leer tutorial 1

  Para JAVA

  • Leer tutorial 1
  • Leer tutorial 2

  Para VISUAL BASIC 6

  • Leer tutorial 1

  Para VISUAL FOX PRO

  • Leer tutorial 1