Background Image

DATOS CORPORATIVOS

Valida con quién haces negocio.

Consulta RUC
RUC El número de RUC no es válido

Para realizar la consulta RUC desde la web
"SIN CÓDIGO DE VALIDACIÓN"
debes iniciar sesión.

Iniciar Sesión
Datos obtenidos para: "{{ company.ruc }}"
RUC: {{ company.ruc }}
Razon social: {{ company.razon_social }}
Tipo contribuyente: {{ company.tipo_contribuyente }}
Nombre comercial: {{ company.nombre_comercial }}
Fecha inscripcion: {{ company.fecha_inscripcion }}
Fecha inicio actividades: {{ company.fecha_inicio_actividades }}
Estado contribuyente: {{ company.estado_contribuyente }}
Condicion contribuyente: {{ company.condicion_contribuyente }}
Direccion: {{ company.direccion }}
Sistema emision comprobante: {{ company.sistema_emision_comprobante }}
Actividad comercio exterior: {{ company.actividad_comercio_exterior }}
Sistema contabilidad: {{ company.sistema_contabilidad }}

El RUC no es válido

No se pudo verificar el RUC.
Intente nuevamente en unos segundos.

API

Para consumir el API es necesario un token de acceso personal, puedes administrarlos desde panel de gestión de tokens.

Para realizar una consulta, envía una solicitud POST a:
https://consulta.pe/api/sunat/query/ruc
con el atributo "ruc" para la consulta en cuestión.

Nombre Tipo Descripción Requerido
ruc String El número RUC a consultar si
Cabeceras de Solicitud
Accept: application/json
Authorization: Bearer tu-token
Cuerpo de solicitud
{
  "ruc": "10462019853"
}
Cuerpo de respuesta
{
  "ruc": 10462019853,
  "razon_social": "VILLAFUERTE HERNANDO FABRIZIO ENRIQUE",
  "tipo_contribuyente": "PERSONA NATURAL SIN NEGOCIO",
  "nombre_comercial": "-",
  "fecha_inscripcion": "30-11-2012",
  "fecha_inicio_actividades": "30-11-2012",
  "estado_contribuyente": "ACTIVO",
  "condicion_contribuyente": "HABIDO",
  "direccion": "AV. DEL AIRE NRO. 1015 DPTO. 501 INT. E3 RES. CONDOMINIO DEL AIRE (ESPALDA DE LA VIDENA) LIMA - LIMA - SAN LUIS",
  "sistema_emision_comprobante": "MANUAL",
  "actividad_comercio_exterior": "SIN ACTIVIDAD",
  "sistema_contabilidad": "MANUAL"
}
Cabeceras de respuesta
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 58
Ejemplo usando CURL
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tu-token" \
-d '{"ruc":"10462019853"}' \
"https://consulta.pe/api/sunat/query/ruc"

Para realizar una consulta usando el número de dni, envía una solicitud POST a:
https://consulta.pe/api/sunat/query/dni
con el atributo "dni" para la consulta en cuestión.

Nombre Tipo Descripción Requerido
dni String El número DNI a consultar si
Cabeceras de Solicitud
Accept: application/json
Authorization: Bearer tu-token
Cuerpo de solicitud
{
  "dni": "46201985"
}
Cuerpo de respuesta
{
  "ruc": 10462019853,
  "razon_social": "VILLAFUERTE HERNANDO FABRIZIO ENRIQUE",
  "tipo_contribuyente": "PERSONA NATURAL SIN NEGOCIO",
  "nombre_comercial": "-",
  "fecha_inscripcion": "30-11-2012",
  "fecha_inicio_actividades": "30-11-2012",
  "estado_contribuyente": "ACTIVO",
  "condicion_contribuyente": "HABIDO",
  "direccion": "AV. DEL AIRE NRO. 1015 DPTO. 501 INT. E3 RES. CONDOMINIO DEL AIRE (ESPALDA DE LA VIDENA) LIMA - LIMA - SAN LUIS",
  "sistema_emision_comprobante": "MANUAL",
  "actividad_comercio_exterior": "SIN ACTIVIDAD",
  "sistema_contabilidad": "MANUAL"
}
Cabeceras de respuesta
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 58
Ejemplo usando CURL
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tu-token" \
-d '{"dni":"46208712"}' \
"https://consulta.pe/api/sunat/query/dni"
Librerías API

Ver repositorio completo en Github

Instalación

Instalar usando composer:

   composer require tecactus/sunat-php

O agregar la siguiente línea a tu archivo composer.json:

   "require": {
       ...
       "tecactus/sunat-php": "2.*"
       ...
   }
Uso
   // incluir el autoloader de vendor
   require 'vendor/autoload.php';

   // crear un nuevo objeto de la clase RUC
   $sunatRuc = new Tecactus\Sunat\RUC('tu-token-de-acceso-personal');

   // para consultar los datos usando el número de RUC
   print_r( $sunatRuc->getByRuc('12345678901') );

   // para consultar los datos usando el númer de DNI
   print_r( $sunatRuc->getByDni('12345678') );

   // para devolver el resultado como un array pasar 'true' como segundo argumento.
   print_r( $sunatRuc->getByRuc('12345678901', true) );

Ver repositorio completo en Github

Instalación

Instalar usando NuGet:

   PM> Install-Package Tecactus.Api

O agregar los siguientes dll a tu proyecto:

Uso
    try
    {
        // instanciar un objecto de la clase Ruc
        var ruc = new Tecactus.Api.Sunat.Ruc("tu-token-de-acceso-personal");

        // el método 'get' devuelve un objeto de la clase Company.
        // Caso contrario lanza una excepción cuyo mensaje describe el error sucitado.
        var Tecactus.Api.Sunat.Company company = ruc.get("12345678901");
    }
    catch (Exception exception)
    {
        MessageBox.Show(exception.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
Lista de Excepciones

ver la lista de excepciones en Github

Ver repositorio completo en Github

Instalación
Tecactus CDN

Referencia el archivo

<!-- Última versión compilada y minificada -->
<script src="https://tecactus-4b42.kxcdn.com/reniec-sunat-js.min.js"></script>
Instalar con Bower
bower install reniec-sunat-js
Instalar con npm
npm install reniec-sunat-js
Uso
<!-- Última versión compilada y minificada -->
<script src="https://tecactus-4b42.kxcdn.com/reniec-sunat-js.min.js"></script>

<!-- Ejemplo -->
<script>
    var tecactusApi = new TecactusApi("tu-token-de-acceso-personal")

    // consulta Sunat usando número de RUC
    tecactusApi.Sunat.getByRuc("20123456789")
        .then(function (response) {
            console.log("consulta correcta!")
            console.log(response.data)
        })
        .catch(function (response) {
            console.log("algo ocurrió")
            console.log("código de error: " + response.code)
            console.log("mensaje de respuesta: " + response.status)
            console.log(response.data)
        })

    // consulta Sunat usando número de DNI
    tecactusApi.Sunat.getByDni("41235678")
        .then(function (response) {
            console.log("consulta correcta!")
            console.log(response.data)
        })
        .catch(function (response) {
            console.log("algo ocurrió")
            console.log("código de error: " + response.code)
            console.log("mensaje de respuesta: " + response.status)
            console.log(response.data)
        })
</script>