{"id":37005120,"url":"https://github.com/consulta/consulta-laravel","last_synced_at":"2026-01-14T00:39:39.173Z","repository":{"id":56957507,"uuid":"210471837","full_name":"consulta/consulta-laravel","owner":"consulta","description":"Paquete de Laravel para validación de RUC y DNI en Perú","archived":false,"fork":false,"pushed_at":"2024-08-20T23:23:58.000Z","size":44,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-12-22T00:44:59.964Z","etag":null,"topics":["consulta","laravel","package","paquete","php","reniec","rest-api","sunat","validacion"],"latest_commit_sha":null,"homepage":"https://consulta.pe","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/consulta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-09-23T23:43:53.000Z","updated_at":"2024-09-27T14:13:11.000Z","dependencies_parsed_at":"2022-08-21T04:40:22.828Z","dependency_job_id":null,"html_url":"https://github.com/consulta/consulta-laravel","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/consulta/consulta-laravel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/consulta%2Fconsulta-laravel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/consulta%2Fconsulta-laravel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/consulta%2Fconsulta-laravel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/consulta%2Fconsulta-laravel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/consulta","download_url":"https://codeload.github.com/consulta/consulta-laravel/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/consulta%2Fconsulta-laravel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28406520,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T21:51:37.118Z","status":"ssl_error","status_checked_at":"2026-01-13T21:45:14.585Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["consulta","laravel","package","paquete","php","reniec","rest-api","sunat","validacion"],"created_at":"2026-01-14T00:39:39.064Z","updated_at":"2026-01-14T00:39:39.151Z","avatar_url":"https://github.com/consulta.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://consulta.pe/img/logo_consulta_pe.png\"\u003e \u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://travis-ci.com/consulta/consulta-laravel\"\u003e\u003cimg src=\"https://travis-ci.com/consulta/consulta-laravel.svg?branch=master\" alt=\"Build Status\"\u003e\u003c/a\u003e\n\u003ca href=\"https://packagist.org/packages/consulta/laravel\"\u003e\u003cimg src=\"https://poser.pugx.org/consulta/laravel/v/stable\" alt=\"Latest Stable Version\"\u003e\u003c/a\u003e\n\u003ca href=\"https://packagist.org/packages/consulta/laravel\"\u003e\u003cimg src=\"https://poser.pugx.org/consulta/laravel/license\" alt=\"License\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# Paquete Oficial para Laravel \n### Para Laravel \u003c 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)!!\n\n## Instalación\nInstalar usando composer:\n\n```bash\n   composer require consulta/laravel\n```\n\nO agregar la siguiente línea a tu archivo composer.json:\n\n```\n   \"require\": {\n       ...\n       \"consulta/laravel\": \"1.*\"\n       ...\n   }\n```\n## Configuración\n\n### servicio consulta\n\nagregar en `config/services.php` la siguiente entrada\n\n ```bash\n 'consulta' =\u003e [\n          'token' =\u003e env('CONSULTA_TOKEN')\n       ],\n```\n    \n### variable de entorno\n\nagregar al `.env` la siguiente entrada:\n\n ```bash\nCONSULTA_TOKEN=\u003ctu-token-de-acceso\u003e\n```\n\n** Puedes generar tu token registrándote en la web de [consulta.pe](https://consulta.pe/auth/register)\n\n## Uso\n\n### Consulta Persona\n```php\nuse Consulta\\Laravel\\Consulta;\n\n$person = Consulta::reniec()-\u003efind('43989177');\n\n// respuesta:\narray:6 [▼\n  \"dni\" =\u003e \"43989177\"\n  \"nombres\" =\u003e \"CARLOS EMMANUEL\"\n  \"apellido_paterno\" =\u003e \"CERVERA\"\n  \"apellido_materno\" =\u003e \"BARTUREN\"\n  \"caracter_verificacion\" =\u003e \"2\"\n  \"caracter_verificacion_anterior\" =\u003e null\n]\n\n```\n\n### Consulta Empresa\n\n#### Por DNI\n```php\nuse Consulta\\Laravel\\Consulta;\n\n$companybyDni = Consulta::sunat()-\u003ebyDni('46126030');\n\n//respuesta\narray:12 [▼\n  \"ruc\" =\u003e 10461260301\n  \"razon_social\" =\u003e \"VIDAL LUJAN PAUL EDWIN\"\n  \"tipo_contribuyente\" =\u003e \"PERSONA NATURAL SIN NEGOCIO\"\n  \"nombre_comercial\" =\u003e \"SERVICIOS MÚLTIPLES DMC\"\n  \"fecha_inscripcion\" =\u003e \"16-09-2009\"\n  \"fecha_inicio_actividades\" =\u003e \"01-10-2009\"\n  \"estado_contribuyente\" =\u003e \"ACTIVO\"\n  \"condicion_contribuyente\" =\u003e \"HABIDO\"\n  \"direccion\" =\u003e \"-\"\n  \"sistema_emision_comprobante\" =\u003e \"MANUAL\"\n  \"actividad_comercio_exterior\" =\u003e \"SIN ACTIVIDAD\"\n  \"sistema_contabilidad\" =\u003e \"MANUAL\"\n]\n```\n\n### Por RUC\n\n```php\nuse Consulta\\Laravel\\Consulta;\n\n$company = Consulta::sunat()-\u003ebyRuc('20601772541');\n\n//consulta\narray:12 [▼\n  \"ruc\" =\u003e 20601772541\n  \"razon_social\" =\u003e \"TECACTUS S.A.C.\"\n  \"tipo_contribuyente\" =\u003e \"SOCIEDAD ANONIMA CERRADA\"\n  \"nombre_comercial\" =\u003e \"-\"\n  \"fecha_inscripcion\" =\u003e \"03-01-2017\"\n  \"fecha_inicio_actividades\" =\u003e \"03-01-2017\"\n  \"estado_contribuyente\" =\u003e \"ACTIVO\"\n  \"condicion_contribuyente\" =\u003e \"HABIDO\"\n  \"direccion\" =\u003e \"CAL.TRES NRO. 231 DPTO. 613 URB. JACARANDA LIMA - LIMA - SAN BORJA\"\n  \"sistema_emision_comprobante\" =\u003e \"MANUAL/COMPUTARIZADO\"\n  \"actividad_comercio_exterior\" =\u003e \"IMPORTADOR/EXPORTADOR\"\n  \"sistema_contabilidad\" =\u003e \"MANUAL/COMPUTARIZADO\"\n]\n```\n\n### Consulta Vehicular\n\n#### Por Placa\n```php\nuse Consulta\\Laravel\\Consulta;\n\n$companybyDni = Consulta::vehicle()-\u003efind('\u003cplaca\u003e'); // placa sin guión\n\n//respuesta de ejemplo.Se han ocultado datos en esta respuesta por seguridad\narray:12 [▼\n  \"data\" =\u003e array:8 [\n    \"plate\" =\u003e \"\u003cplaca\u003e\"\n    \"current_plate\" =\u003e \"\u003cplaca\u003e\"\n    \"registration_entry\" =\u003e \"\u003cnúmero de partida\u003e\"\n    \"vehicle_information\" =\u003e array:31 [\n      \"vin\" =\u003e \"\u003cbin info\u003e\"\n      \"axles\" =\u003e \"2\"\n      \"brand\" =\u003e \"JEEP\"\n      \"color\" =\u003e \"GRIS\"\n      \"model\" =\u003e \"GRAND CHEROKEE LIMITED\"\n      \"plate\" =\u003e \"\u003cplaca\u003e\"\n      \"seats\" =\u003e \"5\"\n      \"usage\" =\u003e \"Vehiculos Particulares (Categoria M)\"\n      \"width\" =\u003e \"2.15\"\n      \"height\" =\u003e \"1.78\"\n      \"length\" =\u003e \"4.82\"\n      \"status\" =\u003e \"EN CIRCULACION\"\n      \"wheels\" =\u003e \"4\"\n      \"payload\" =\u003e \"0.787\"\n      \"version\" =\u003e \"4X4\"\n      \"category\" =\u003e \"M1\"\n      \"body_type\" =\u003e \"SUV\"\n      \"condition\" =\u003e \"SIN DEFINIR\"\n      \"cylinders\" =\u003e \"6\"\n      \"fuel_type\" =\u003e \"GASOLINA\"\n      \"drivetrain\" =\u003e \"4X4\"\n      \"dry_weight\" =\u003e \"2.162\"\n      \"model_year\" =\u003e \"2012\"\n      \"passengers\" =\u003e \"4\"\n      \"engine_power\" =\u003e \"210@6350\"\n      \"gross_weight\" =\u003e \"2.949\"\n      \"current_plate\" =\u003e \"\u003cplaca\u003e\"\n      \"engine_number\" =\u003e \"\u003cengine_number\u003e\"\n      \"serial_number\" =\u003e \"\u003cserial_number\u003e\"\n      \"manufacturing_year\" =\u003e \"2012\"\n      \"engine_displacement\" =\u003e \"3.6\"\n    ]\n    \"previous_plates\" =\u003e []\n    \"owners\" =\u003e array:1 [\n      0 =\u003e array:5 [\n        \"name\" =\u003e \"\u003cnombre del propietario actual\u003e\"\n        \"type\" =\u003e \"person\"\n        \"title_number\" =\u003e \"\u003cnúmero de título\u003e\"\n        \"ownership_date\" =\u003e \"\u003cfecha\u003e\"\n        \"document_number\" =\u003e \"\u003cdni\u003e\"\n      ]\n    ]\n    \"previous_owners\" =\u003e array:3 [\n      0 =\u003e array:1 [\n        0 =\u003e array:3 [\n          \"name\" =\u003e \"\u003cnombre propietario anterior\u003e\"\n          \"document_type\" =\u003e \"PARTIDA\"\n          \"document_number\" =\u003e \"\u003cdocument_number\u003e\"\n        ]\n      ]\n      1 =\u003e array:1 [\n        0 =\u003e array:3 [\n          \"name\" =\u003e \"\u003cnombre propietario anterior\u003e\"\n          \"document_type\" =\u003e \"PARTIDA\"\n          \"document_number\" =\u003e \"\u003cdocument_number\u003e\"\n        ]\n      ]\n      2 =\u003e array:1 [\n        0 =\u003e array:3 [\n          \"name\" =\u003e \"\u003cnombre propietario anterior\u003e\"\n          \"document_type\" =\u003e \"PARTIDA\"\n          \"document_number\" =\u003e \"\u003cdocument_number\u003e\"\n        ]\n      ]\n    ]\n    \"liens\" =\u003e []\n  ]\n]\n```\n\n## Reglas de validación Disponibles\n\n - [`IsValidDNIDigit`](#isvaliddnidigit)\n - [`IsValidDNI`](#isvaliddni)\n - [`IsValidRUC`](#isvalidruc)\n \n \n### `IsValidDNIDigit`\n\nDetermina si el dígito de verificación corresponde al dni ingresado\n\n```php\n// in a `FormRequest` \n\npublic function rules()\n{\n    return [\n        'dni' =\u003e \"required|size:8\",\n        'validation_digit' =\u003e ['required','size:1',new IsValidDNIDigit($this-\u003edni)],\n    ];\n}\n```\n### `IsValidDNI`\nDetermina si el número de DNI ingresado pertenece a un peruano mayor de edad\n\n```php\n// in a `FormRequest` \n\npublic function rules()\n{\n    return [\n        'dni' =\u003e ['required','size:1',new IsValidDNI()],\n    ];\n}\n```\n\n### `IsValidRUC`\n\nDetermina si el número de RUC ingresado pertenece a una empresa registrada en la Superintendencia Nacional de Aduanas y de Administración Tributaria (SUNAT).\n\n\n#### parámetros:\n \nLa clase IsValidRUC admite un único parametro, cuando es ``true`` valida además que la empresa esté activa y habida.  \n\n\n```php\n// in a `FormRequest` \n\npublic function rules()\n{\n    return [\n        'ruc' =\u003e ['required','size:11',new IsValidRUC(true)],\n    ];\n}\n```\n\n## Docs\nPara mayor información consulta la documentación de [consulta.pe](https://consulta.pe/) para:\n\n - [Identidad de personas](https://consulta.pe/identidad-personas)\n - [Datos Corporativos](https://consulta.pe/datos-corporativos)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconsulta%2Fconsulta-laravel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconsulta%2Fconsulta-laravel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconsulta%2Fconsulta-laravel/lists"}