You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# gt-utils-js 🇬🇹
1
+
# gt-utils-js
2
2
3
3
La biblioteca estándar definitiva, sin dependencias (Zero-Dependency) y con tipado estricto (TypeScript) para validaciones y utilidades específicas de Guatemala.
4
4
@@ -18,13 +18,13 @@ pnpm add gt-utils-js
18
18
19
19
Esta biblioteca provee 7 submódulos especializados:
20
20
21
-
-💳**Identidad:** Validación rigurosa de NIT y CUI/DPI (Módulo 11 oficial de SAT y RENAP). Incluye la nueva disposición SAT 2025 donde los CUI válidos operan como NIT. Retorna el departamento y código de municipio emisor.
22
-
-💰**Finanzas:** Conversión de números a letras para Facturación Electrónica (FEL) y detección de bancos por número de cuenta (G&T, Banrural, BI, BAM, Promerica, etc).
23
-
-🚗**Vehículos:** Analizador y validador de Placas Vehiculares (comerciales, particulares, motos, y reglas estrictas del reglamento de tránsito, como exclusiones de vocales O, I, Q, Ñ).
24
-
-🌍**Geografía:** Resolución Inversa Nacional: pasa coordenadas (Lat, Lng) y te dice en qué municipio y departamento de Guatemala caen (Ray-Casting algorithm ligero).
25
-
-🧾**Impuestos:** Retenciones de IVA y escalonadas de ISR (Régimen General > Q2,500) redondeadas al centavo contable exacto.
26
-
-📆**Feriados y Calendario:** Algoritmo astronómico para cálculo de Semana Santa, listado de asuetos, y traslados de feriados largos de acuerdo a la Ley de Promoción de Turismo Interno (Decreto 19-2018 y CC).
27
-
-💼**Laboral:** Calculadora de Liquidaciones al centavo. Determina fechas de corte y pagos proporcionales de Aguinaldo, Bono 14, Vacaciones y cálculo de indemnización por despido injustificado (regla de 14 salarios / 12 meses).
21
+
-**Identidad:** Validación rigurosa de NIT y CUI/DPI (Módulo 11 oficial de SAT y RENAP). Incluye la nueva disposición SAT 2025 donde los CUI válidos operan como NIT. Retorna el departamento y código de municipio emisor.
22
+
-**Finanzas:** Conversión de números a letras para Facturación Electrónica (FEL) y detección de bancos por número de cuenta (G&T, Banrural, BI, BAM, Promerica, etc).
23
+
-**Vehículos:** Analizador y validador de Placas Vehiculares (comerciales, particulares, motos, y reglas estrictas del reglamento de tránsito, como exclusiones de vocales O, I, Q, Ñ).
24
+
-**Geografía:** Resolución Inversa Nacional: pasa coordenadas (Lat, Lng) y te dice en qué municipio y departamento de Guatemala caen (Ray-Casting algorithm ligero).
25
+
-**Impuestos:** Retenciones de IVA y escalonadas de ISR (Régimen General > Q2,500) redondeadas al centavo contable exacto.
26
+
-**Feriados y Calendario:** Algoritmo astronómico para cálculo de Semana Santa, listado de asuetos, y traslados de feriados largos de acuerdo a la Ley de Promoción de Turismo Interno (Decreto 19-2018 y CC).
27
+
-**Laboral:** Calculadora de Liquidaciones al centavo. Determina fechas de corte y pagos proporcionales de Aguinaldo, Bono 14, Vacaciones y cálculo de indemnización por despido injustificado (regla de 14 salarios / 12 meses).
Copy file name to clipboardExpand all lines: docs/geo.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# 🌍 Módulo de Geografía (Geo)
1
+
# Módulo de Geografía (Geo)
2
2
3
3
Este submódulo te permite hacer resolución inversa (Reverse Geocoding) localmente, ¡sin depender de APIs de Google Maps o Mapbox y de forma completamente offline! Utiliza el algoritmo matemático **Ray-Casting** para determinar si unas coordenadas caen dentro de los polígonos de Guatemala.
4
4
@@ -30,7 +30,7 @@ type MunicipalityResult = {
30
30
31
31
---
32
32
33
-
## 💡 Ejemplos de Uso
33
+
## Ejemplos de Uso
34
34
35
35
A continuación se presentan varios ejemplos prácticos que te ayudarán a entender cómo implementar esto en aplicaciones reales, como aplicaciones de delivery, sistemas de logística, o controles de fraude.
Copy file name to clipboardExpand all lines: docs/holidays.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# 📆 Módulo de Feriados y Calendario Legal
1
+
# Módulo de Feriados y Calendario Legal
2
2
3
3
Este submódulo es una maravilla de la matemática y legislación local. Contiene el **Algoritmo Astronómico de Computus** para calcular fechas movibles basadas en la luna (como la Semana Santa) y aplica de forma automática la **Ley que Promueve el Turismo Interno** de Guatemala, con sus modificaciones por la Corte de Constitucionalidad.
Copy file name to clipboardExpand all lines: docs/identity.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# 💳 Módulo de Identidad
1
+
# Módulo de Identidad
2
2
3
3
El módulo de identidad provee funciones robustas para validar los documentos de identificación y registros tributarios de Guatemala, sin requerir internet para consultar bases de datos externas.
Al momento en el que el usuario llena el formulario de registro, puedes validar en milisegundos que su DPI o NIT sea verdadero, incluso obteniendo información adicional para precargarle datos.
0 commit comments