Download the PHP package jamesmosq/moonshine-colombia-puc-ciiu without Composer
On this page you can find all versions of the php package jamesmosq/moonshine-colombia-puc-ciiu. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jamesmosq/moonshine-colombia-puc-ciiu
More information about jamesmosq/moonshine-colombia-puc-ciiu
Files in jamesmosq/moonshine-colombia-puc-ciiu
Package moonshine-colombia-puc-ciiu
Short Description PUC (Plan Único de Cuentas) y CIIU colombianos para MoonShine 4.x — campos, árboles y filtros
License MIT
Homepage https://github.com/jamesmosq/moonshine-colombia-puc-ciiu
Informations about the package moonshine-colombia-puc-ciiu
moonshine-colombia/puc-ciiu
PUC (Plan Único de Cuentas) y CIIU (Clasificación Industrial Uniforme) colombianos para MoonShine 4.x.
Campos de búsqueda con autocompletado AJAX, árboles navegables jerárquicos y filtros para Resources de MoonShine. Datos oficiales del Decreto 2649/93 (PUC) y el DANE (CIIU).
Contenido
- Requisitos
- Instalación
- Campos de búsqueda
- CuentaPucField
- ActividadCiiuField
- Componentes árbol
- PucTreeComponent
- CiiuTreeComponent
- Filtros para Resources
- Modelos Eloquent
- PUC Comercial vs ESAL
- Información de los datos
- Pruebas
- Licencia
Requisitos
| Dependencia | Versión mínima |
|---|---|
| PHP | 8.3+ |
| Laravel | 11, 12 ó 13 |
| MoonShine | 4.x |
Instalación
Ejecutar migraciones y seeders:
Los seeders son idempotentes: se pueden ejecutar varias veces sin duplicar datos.
Campos de búsqueda
CuentaPucField
Campo AJAX para seleccionar una cuenta del PUC. Muestra [código] nombre en el campo y guarda el código como string.
Muestra: [1105] Caja
Guarda: "1105" (string)
Evento Alpine al seleccionar: puc-selected → { value, label, node }
ActividadCiiuField
Campo AJAX para seleccionar una actividad económica CIIU. Por defecto solo permite seleccionar clases (4 dígitos).
Muestra: [0111] Cultivo de cereales
Evento Alpine: ciiu-selected → { value, label, node }
Componentes árbol
Los árboles cargan cada nivel de forma lazy al expandir, lo que los hace eficientes incluso con el PUC completo.
PucTreeComponent
Características:
- Íconos D (débito) y C (crédito) en cada nodo
- Filtro rápido sobre nodos ya expandidos
- Botón "Seleccionar" al pasar el mouse, solo en cuentas hoja
- Emite evento Alpine
puc-selected(opuc-selected:{targetField}) - Soporte dark mode
CiiuTreeComponent
Jerarquía CIIU:
Filtros para Resources
Usar en el método filters() de cualquier Resource de MoonShine.
| Filtro | Columna por defecto | Opciones |
|---|---|---|
ClasePucFilter |
clase |
1–9 con nombre de cada clase |
NaturalezaFilter |
naturaleza |
debito / credito |
SeccionCiiuFilter |
seccion |
A–U (21 secciones CIIU) |
Todos los filtros son nullable (incluyen opción "Todos") y aceptan columna personalizada:
Modelos Eloquent
CuentaPuc
Jerarquía PUC:
| Nivel | Nombre | Dígitos | Ejemplo |
|---|---|---|---|
| 1 | Clase | 1 | 1 — Activos |
| 2 | Grupo | 2 | 11 — Disponible |
| 3 | Cuenta | 4 | 1105 — Caja |
| 4 | Subcuenta | 6 | 110505 — Caja General |
| 5 | Auxiliar | 8+ | 11050501 |
Naturaleza: clases 1, 5, 6, 7 → débito · clases 2, 3, 4, 8, 9 → crédito
ActividadCiiu
PUC Comercial vs ESAL
PUC Comercial (Decreto 2649 de 1993)
Plan estándar para empresas con ánimo de lucro. Cargado por defecto con PucComercialSeeder. Cubre 9 clases, 52 grupos, 356 cuentas y 2.179 subcuentas.
PUC ESAL (Decreto 4400 de 2004)
Plan para Entidades Sin Ánimo de Lucro: fundaciones, asociaciones, corporaciones y cooperativas. Adapta el PUC comercial para:
- Fondos sociales y patrimoniales (clase 3 ampliada)
- Ingresos no constitutivos de renta
- Cuentas de excedentes y déficit del ejercicio
- Vigencias fiscales especiales
Para activar el PUC ESAL:
- Crea el archivo
puc_esal.jsoncon el mismo formato quepuc_colombia.json - Cópialo a
packages/moonshine-colombia-puc/database/seeders/data/puc_esal.json -
Ejecuta el seeder:
- Usa el campo con el tipo ESAL:
Información de los datos
PUC Colombia
| Campo | Detalle |
|---|---|
| Base legal | Decreto 2649 de 1993 y sus modificaciones |
| Registros incluidos | 2.596 (niveles 1 a 4) |
| Actualización | Manual — conforme al decreto vigente |
| Licencia de los datos | Dominio público (norma oficial colombiana) |
CIIU Colombia
| Campo | Detalle |
|---|---|
| Fuente | DANE — Clasificación Industrial Uniforme Rev. 4 |
| Registros generados | ~865 (22 secciones + 89 divisiones + 250 grupos + 504 clases) |
| Licencia de los datos | Dominio público (estadística oficial del DANE) |
Pruebas
La suite incluye 91 tests / 150 assertions sobre SQLite en memoria:
| Grupo | Tests | Qué cubre |
|---|---|---|
| PUC Feature | 23 | Seeder, modelo, scopes, relaciones, endpoints |
| CIIU Feature | 19 | Seeder, modelo, scopes, relaciones, endpoints |
| Componentes árbol | 11 | Instanciación, make(), propiedades |
| Filtros y Campos | 22 | Instanciación MoonShine, columnas, nullable |
| Opciones estáticas (Unit) | 15 | Arrays de filtros sin depender de MoonShine |
| Base Laravel | 2 | Ejemplo incluido por defecto |
Licencia
MIT — ver LICENSE.
Los datos del PUC y el CIIU son de dominio público por ser normas y estadísticas oficiales de la República de Colombia.
All versions of moonshine-colombia-puc-ciiu with dependencies
laravel/framework Version ^11.0|^12.0|^13.0
moonshine/moonshine Version ^4.0