Download the PHP package nexconnect/dgii-consultas without Composer
On this page you can find all versions of the php package nexconnect/dgii-consultas. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download nexconnect/dgii-consultas
More information about nexconnect/dgii-consultas
Files in nexconnect/dgii-consultas
Package dgii-consultas
Short Description Consulta de RNC a partir del listado público de la DGII (República Dominicana), guardado en tu equipo.
License MIT
Homepage https://nexconnect.do
Informations about the package dgii-consultas
dgii-consultas (PHP)
Consulta de RNC a partir del listado público de la DGII (República Dominicana). El listado se guarda en tu equipo y las consultas no usan la red ni servicios intermedios. Requiere PHP 8.1 o superior, de 64 bits, con la extensión zip. No tiene otras dependencias de ejecución.
No está afiliado a la DGII. Es un proyecto independiente que lee un archivo que la DGII publica en su sitio. No lo respalda, no lo mantiene ni lo patrocina la Dirección General de Impuestos Internos.
Instalación
actualizar() descarga por https con los flujos de PHP: necesita la extensión openssl y allow_url_fopen activado (lo normal). Con importar() no hace falta ninguna de las dos.
Una consulta
fecha_listado es la fecha del listado consultado (hora de Santo Domingo, UTC-4): revísala, porque el listado puede estar viejo. Las fechas son DateTimeImmutable a medianoche en UTC-4, sin depender de la zona horaria por defecto de PHP, que la librería nunca cambia.
Contribuyente
rnc, razon_social, nombre_comercial, actividad, fecha_inicio (DateTimeImmutable o null), estado, regimen_pago y fecha_listado. Todos los de texto pueden ser null. Son propiedades public readonly: el objeto es inmutable.
Listado
| Método | Qué hace |
|---|---|
new Listado(?string $carpeta = null, string $url = Listado::URL_DGII) |
$carpeta es la caché (por omisión, DGII_CONSULTAS_CACHE o la del sistema). Detrás de un servidor web, pásala siempre. |
actualizar(bool $aceptar_corto = false): bool |
Hace un HEAD y baja el listado solo si hace falta. Devuelve true si cargó un listado, lo que no garantiza datos nuevos: compara la fecha si te importa. |
importar(string $ruta, bool $aceptar_corto = false): void |
Carga un DGII_RNC.zip bajado a mano. |
buscar(mixed $rnc): ?Contribuyente |
Acepta espacios y guiones; 9 u 11 dígitos ASCII. Lo que no sea texto da RncInvalido. Nunca usa la red. |
fecha(): ?DateTimeImmutable, filas(): ?int, descartadas(): ?int |
Datos del listado en uso, o null si no hay. |
Los errores viven en NexConnect\DgiiConsultas\Errores y son hijos de ErrorDgii: RncInvalido, ListadoNoDisponible, ErrorDescarga y ListadoRechazado. Un listado rechazado (no es un zip, falla el CRC, trae demasiadas pocas filas) nunca reemplaza al que ya tenías.
Si la DGII bloquea la descarga
Si responde HTTP 403, baja DGII_RNC.zip con tu navegador y cárgalo con $listado->importar('DGII_RNC.zip').
Dónde se guarda
En DGII_CONSULTAS_CACHE si existe; si no, en ~/Library/Caches/dgii-consultas (macOS), %LOCALAPPDATA%\dgii-consultas (Windows) o $XDG_CACHE_HOME/dgii-consultas o ~/.cache/dgii-consultas (el resto). El formato es el mismo que usan las otras librerías del proyecto, así que pueden compartir la carpeta.
Detrás de un servidor web, pasa la misma carpeta en el cron y en la web, con new Listado('/var/cache/dgii-consultas'): PHP-FPM limpia el entorno y el usuario no suele ser el del cron, así que sin carpeta explícita cada uno usaría una distinta. El usuario del cron debe poder escribir en ella y el del servidor web, leerla.
Cada consulta hace una búsqueda binaria sobre el índice sin cargarlo en memoria, así que cada proceso de PHP (una petición web, por ejemplo) gasta muy poca: la carga de un listado completo (unas 800 mil filas) cabe en el memory_limit de 128 MB que PHP trae por omisión.
Desarrollo
Créditos
Reconocemos el trabajo previo de developersdo/dgii-consultas, un proyecto con el mismo nombre dentro de la comunidad de desarrolladores dominicanos.
Hecho por NexConnect, que desarrolla facturación electrónica (e-CF) para empresas dominicanas. El código y la documentación completa están en github.com/NexConnect-SRL/dgii-consultas.
All versions of dgii-consultas with dependencies
php-64bit Version *
ext-zip Version *