PHPackages                             consulta/laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. consulta/laravel

ActiveLibrary[Framework](/categories/framework)

consulta/laravel
================

Paquete de Laravel para validación de RUC y DNI en Perú

0.2.5(1y ago)54.3k2MITPHPPHP ^7.2 || ^8.0 || ^8.1CI failing

Since Oct 8Pushed 1y ago2 watchersCompare

[ Source](https://github.com/consulta/consulta-laravel)[ Packagist](https://packagist.org/packages/consulta/laravel)[ RSS](/packages/consulta-laravel/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (7)Dependencies (4)Versions (9)Used By (0)

[![](https://camo.githubusercontent.com/5837bc723a925955002d5324d0525e4981e0a53fda583d321d3b98783bb06f5a/68747470733a2f2f636f6e73756c74612e70652f696d672f6c6f676f5f636f6e73756c74615f70652e706e67)](https://camo.githubusercontent.com/5837bc723a925955002d5324d0525e4981e0a53fda583d321d3b98783bb06f5a/68747470733a2f2f636f6e73756c74612e70652f696d672f6c6f676f5f636f6e73756c74615f70652e706e67)

[![Build Status](https://camo.githubusercontent.com/b9639518ca1623acce24bf6d8b328b6d6e0ca186bcf206172f277a2e2c1732bd/68747470733a2f2f7472617669732d63692e636f6d2f636f6e73756c74612f636f6e73756c74612d6c61726176656c2e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/consulta/consulta-laravel)[![Latest Stable Version](https://camo.githubusercontent.com/94d1f31ef43fe40ee43a001be6034622320bbc3c7f3ee3a165218a0550afc3cf/68747470733a2f2f706f7365722e707567782e6f72672f636f6e73756c74612f6c61726176656c2f762f737461626c65)](https://packagist.org/packages/consulta/laravel)[![License](https://camo.githubusercontent.com/cea1587a87ca890e90cc04ccfe67ecc004300658e3061c5a2abd35bc16d9374b/68747470733a2f2f706f7365722e707567782e6f72672f636f6e73756c74612f6c61726176656c2f6c6963656e7365)](https://packagist.org/packages/consulta/laravel)

Paquete Oficial para Laravel
============================

[](#paquete-oficial-para-laravel)

### Para Laravel &lt; 5.5,otros frameworks o standalone, use el SDK [RENIEC-PHP](https://github.com/tecactus/reniec-php) o [SUNAT-PHP](https://github.com/tecactus/sunat-php)!!

[](#para-laravel--55otros-frameworks-o-standalone-use-el-sdk-reniec-php-o-sunat-php)

Instalación
-----------

[](#instalación)

Instalar usando composer:

```
   composer require consulta/laravel
```

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

```
   "require": {
       ...
       "consulta/laravel": "1.*"
       ...
   }

```

Configuración
-------------

[](#configuración)

### servicio consulta

[](#servicio-consulta)

agregar en `config/services.php` la siguiente entrada

```
'consulta' => [
         'token' => env('CONSULTA_TOKEN')
      ],
```

### variable de entorno

[](#variable-de-entorno)

agregar al `.env` la siguiente entrada:

```
CONSULTA_TOKEN=
```

\*\* Puedes generar tu token registrándote en la web de [consulta.pe](https://consulta.pe/auth/register)

Uso
---

[](#uso)

### Consulta Persona

[](#consulta-persona)

```
use Consulta\Laravel\Consulta;

$person = Consulta::reniec()->find('43989177');

// respuesta:
array:6 [▼
  "dni" => "43989177"
  "nombres" => "CARLOS EMMANUEL"
  "apellido_paterno" => "CERVERA"
  "apellido_materno" => "BARTUREN"
  "caracter_verificacion" => "2"
  "caracter_verificacion_anterior" => null
]
```

### Consulta Empresa

[](#consulta-empresa)

#### Por DNI

[](#por-dni)

```
use Consulta\Laravel\Consulta;

$companybyDni = Consulta::sunat()->byDni('46126030');

//respuesta
array:12 [▼
  "ruc" => 10461260301
  "razon_social" => "VIDAL LUJAN PAUL EDWIN"
  "tipo_contribuyente" => "PERSONA NATURAL SIN NEGOCIO"
  "nombre_comercial" => "SERVICIOS MÚLTIPLES DMC"
  "fecha_inscripcion" => "16-09-2009"
  "fecha_inicio_actividades" => "01-10-2009"
  "estado_contribuyente" => "ACTIVO"
  "condicion_contribuyente" => "HABIDO"
  "direccion" => "-"
  "sistema_emision_comprobante" => "MANUAL"
  "actividad_comercio_exterior" => "SIN ACTIVIDAD"
  "sistema_contabilidad" => "MANUAL"
]
```

### Por RUC

[](#por-ruc)

```
use Consulta\Laravel\Consulta;

$company = Consulta::sunat()->byRuc('20601772541');

//consulta
array:12 [▼
  "ruc" => 20601772541
  "razon_social" => "TECACTUS S.A.C."
  "tipo_contribuyente" => "SOCIEDAD ANONIMA CERRADA"
  "nombre_comercial" => "-"
  "fecha_inscripcion" => "03-01-2017"
  "fecha_inicio_actividades" => "03-01-2017"
  "estado_contribuyente" => "ACTIVO"
  "condicion_contribuyente" => "HABIDO"
  "direccion" => "CAL.TRES NRO. 231 DPTO. 613 URB. JACARANDA LIMA - LIMA - SAN BORJA"
  "sistema_emision_comprobante" => "MANUAL/COMPUTARIZADO"
  "actividad_comercio_exterior" => "IMPORTADOR/EXPORTADOR"
  "sistema_contabilidad" => "MANUAL/COMPUTARIZADO"
]
```

### Consulta Vehicular

[](#consulta-vehicular)

#### Por Placa

[](#por-placa)

```
use Consulta\Laravel\Consulta;

$companybyDni = Consulta::vehicle()->find(''); // placa sin guión

//respuesta de ejemplo.Se han ocultado datos en esta respuesta por seguridad
array:12 [▼
  "data" => array:8 [
    "plate" => ""
    "current_plate" => ""
    "registration_entry" => ""
    "vehicle_information" => array:31 [
      "vin" => ""
      "axles" => "2"
      "brand" => "JEEP"
      "color" => "GRIS"
      "model" => "GRAND CHEROKEE LIMITED"
      "plate" => ""
      "seats" => "5"
      "usage" => "Vehiculos Particulares (Categoria M)"
      "width" => "2.15"
      "height" => "1.78"
      "length" => "4.82"
      "status" => "EN CIRCULACION"
      "wheels" => "4"
      "payload" => "0.787"
      "version" => "4X4"
      "category" => "M1"
      "body_type" => "SUV"
      "condition" => "SIN DEFINIR"
      "cylinders" => "6"
      "fuel_type" => "GASOLINA"
      "drivetrain" => "4X4"
      "dry_weight" => "2.162"
      "model_year" => "2012"
      "passengers" => "4"
      "engine_power" => "210@6350"
      "gross_weight" => "2.949"
      "current_plate" => ""
      "engine_number" => ""
      "serial_number" => ""
      "manufacturing_year" => "2012"
      "engine_displacement" => "3.6"
    ]
    "previous_plates" => []
    "owners" => array:1 [
      0 => array:5 [
        "name" => ""
        "type" => "person"
        "title_number" => ""
        "ownership_date" => ""
        "document_number" => ""
      ]
    ]
    "previous_owners" => array:3 [
      0 => array:1 [
        0 => array:3 [
          "name" => ""
          "document_type" => "PARTIDA"
          "document_number" => ""
        ]
      ]
      1 => array:1 [
        0 => array:3 [
          "name" => ""
          "document_type" => "PARTIDA"
          "document_number" => ""
        ]
      ]
      2 => array:1 [
        0 => array:3 [
          "name" => ""
          "document_type" => "PARTIDA"
          "document_number" => ""
        ]
      ]
    ]
    "liens" => []
  ]
]
```

Reglas de validación Disponibles
--------------------------------

[](#reglas-de-validación-disponibles)

- [`IsValidDNIDigit`](#isvaliddnidigit)
- [`IsValidDNI`](#isvaliddni)
- [`IsValidRUC`](#isvalidruc)

### `IsValidDNIDigit`

[](#isvaliddnidigit)

Determina si el dígito de verificación corresponde al dni ingresado

```
// in a `FormRequest`

public function rules()
{
    return [
        'dni' => "required|size:8",
        'validation_digit' => ['required','size:1',new IsValidDNIDigit($this->dni)],
    ];
}
```

### `IsValidDNI`

[](#isvaliddni)

Determina si el número de DNI ingresado pertenece a un peruano mayor de edad

```
// in a `FormRequest`

public function rules()
{
    return [
        'dni' => ['required','size:1',new IsValidDNI()],
    ];
}
```

### `IsValidRUC`

[](#isvalidruc)

Determina si el número de RUC ingresado pertenece a una empresa registrada en la Superintendencia Nacional de Aduanas y de Administración Tributaria (SUNAT).

#### parámetros:

[](#parámetros)

La clase IsValidRUC admite un único parametro, cuando es `true` valida además que la empresa esté activa y habida.

```
// in a `FormRequest`

public function rules()
{
    return [
        'ruc' => ['required','size:11',new IsValidRUC(true)],
    ];
}
```

Docs
----

[](#docs)

Para mayor información consulta la documentación de [consulta.pe](https://consulta.pe/) para:

- [Identidad de personas](https://consulta.pe/identidad-personas)
- [Datos Corporativos](https://consulta.pe/datos-corporativos)

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 92.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~296 days

Recently: every ~356 days

Total

7

Last Release

672d ago

PHP version history (2 changes)0.1.0PHP ^7.2

0.2.5PHP ^7.2 || ^8.0 || ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/8fdef0e996f65b82fd2c344429cd17177695635620eb34908c87dfbccd062fe0?d=identicon)[paulvl](/maintainers/paulvl)

![](https://www.gravatar.com/avatar/67997529044855ebf48d055ab407242720cbaa0b9ebb40601d6679995a80c38b?d=identicon)[temet\_nosce](/maintainers/temet_nosce)

---

Top Contributors

[![emmanuelbarturen](https://avatars.githubusercontent.com/u/11076563?v=4)](https://github.com/emmanuelbarturen "emmanuelbarturen (12 commits)")[![paulvl](https://avatars.githubusercontent.com/u/8441051?v=4)](https://github.com/paulvl "paulvl (1 commits)")

---

Tags

consultalaravelpackagepaquetephpreniecrest-apisunatvalidacionphpframeworklaravelcaptchavalidatesunatrucvalidarconsultarconsulta rucconsulta ruc sin codigo captchaDNIreniecconsulta-dniconsulta dni sin codigo captchaconsulta sunarpconsulta vehicular

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/consulta-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/consulta-laravel/health.svg)](https://phpackages.com/packages/consulta-laravel)
```

###  Alternatives

[tecactus/reniec-php

RENIEC package for PHP

128.7k](/packages/tecactus-reniec-php)[unopim/unopim

UnoPim Laravel PIM

10.3k2.2k](/packages/unopim-unopim)[laravel-zero/framework

The Laravel Zero Framework.

3491.5M419](/packages/laravel-zero-framework)[laravel/cashier-paddle

Cashier Paddle provides an expressive, fluent interface to Paddle's subscription billing services.

267880.7k3](/packages/laravel-cashier-paddle)[graham-campbell/gitlab

GitLab Is A GitLab Bridge For Laravel

142610.0k2](/packages/graham-campbell-gitlab)[hypervel/framework

The Hypervel framework.

1116.7k8](/packages/hypervel-framework)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
