Un caso inventado para recorrer todos los mensajes
Ejemplo Caso ilustrativo: la empresa y sus datos son inventados para explicar el flujo.
Saffron Tools es una distribuidora inventada con sede en Pune que lleva sus compras y sus ventas en Odoo y acaba de instalar India GST Compliance. Su responsable de contabilidad, Meera, tiene que dejar revisado el crédito fiscal de las facturas de proveedor, preparar la declaración del periodo y presentar lo que toque. A lo largo del mes se va encontrando con todos los mensajes que el módulo puede mostrar. Los vemos en el orden en que le salen, con el texto tal cual aparece y lo que hizo para seguir.
Si todavía estás configurando el módulo, antes te conviene leer la puesta en marcha de India GST Compliance, que explica qué ajustes y campos rellenar.
El crédito reclamado no puede superar al elegible
Meera empieza por el crédito de impuestos soportados. En la lista Input Tax Credit Management ve cada factura de proveedor con su total elegible, su total reclamado y su estado ITC.

Al ajustar una de ellas, escribe en el CGST reclamado un importe mayor que el CGST elegible. El módulo responde con este mensaje:
Claimed CGST cannot exceed eligible CGST.
Hay un mensaje equivalente para cada uno de los otros componentes del impuesto:
Claimed IGST cannot exceed eligible IGST.Claimed SGST cannot exceed eligible SGST.
Qué significa. El módulo comprueba, componente a componente, que lo reclamado no pase de lo elegible.
Qué hacer. Fíjate en qué componente nombra el mensaje (IGST, CGST o SGST) y revisa solo ese. Baja el importe reclamado hasta que no supere al elegible o, si el error estaba en el elegible, corrige ese otro importe. Meera había copiado el reclamado de otra factura; al poner el correcto, el mensaje desapareció.
Porcentajes, tipos e importes fuera de rango
Después, Meera rellena un porcentaje de uso empresarial y se le cuela una tecla de más. Sale:
Business use percentage must be between 0 and 100.
En la misma sesión le aparecen otros dos: uno por un tipo de GST mal escrito y otro por un importe base que introdujo con signo negativo.
GST rate must be between 0 and 100.Base amount must be positive.
Qué significa. Son reglas de rango que el propio texto deja claras: el porcentaje de uso empresarial y el tipo de GST tienen que estar entre 0 y 100, y el importe base tiene que ser positivo.
Qué hacer. Corrige el valor para que cumpla la condición del mensaje y vuelve a guardar. Si no ves a primera vista qué campo está mal, lee el mensaje entero: nombra el campo (Business use percentage, GST rate o Base amount), así que no hace falta revisar el resto del registro.
Fechas del periodo que no cuadran
Con el crédito revisado, Meera pasa a GST Return Preparation, donde cada declaración lleva su periodo, su vencimiento, el impuesto total y el impuesto neto a pagar.

Al crear la declaración del periodo nuevo copia las fechas de otra y las deja al revés. El módulo la para con:
Period start date must be before period end date.
Lo arregla, pero entonces el vencimiento queda antes del fin del periodo y aparece el siguiente:
Due date must be after period end date.
Qué significa. El módulo exige un orden en las fechas: el inicio del periodo antes que el fin, y el vencimiento después del fin.
Qué hacer. Con el primer mensaje, revisa el inicio y el fin del periodo. Con el segundo, mira el vencimiento y el fin del periodo: corrige el que esté mal. Meera tenía bien el periodo y solo tuvo que mover el vencimiento.
Los dos avisos que dicen que el módulo no envía nada
Llega el momento de presentar. Meera daba por hecho que el módulo enviaba la factura electrónica y la declaración, y se encuentra con dos avisos. Ninguno de los dos es un fallo del dato: son avisos de que esa parte se hace fuera del módulo.
Factura electrónica e IRN
Not submitted: this module does not connect to the e-invoice portal (IRP) of the GSTN, so no IRN is requested. Get the IRN with the Odoo app "Indian - E-invoicing" (l10n_in_edi) or on the IRP portal.
Qué significa. India GST Compliance no se conecta al portal de factura electrónica (IRP) del GSTN, así que no pide ningún IRN y no se ha enviado nada.
Qué hacer. El propio mensaje da dos caminos: obtener el IRN con la app de Odoo Indian - E-invoicing (l10n_in_edi) o hacerlo en el portal IRP.
Presentación de la declaración
Not filed: this module does not connect to the GST portal. File the return on the GST portal, then use "Mark as Submitted" on it.
Qué significa. El módulo tampoco se conecta al portal GST, de modo que la declaración no se ha presentado.
Qué hacer. Presenta la declaración en el portal GST y, después, usa Mark as Submitted sobre esa declaración en Odoo. El orden lo marca el mensaje: primero el portal, luego la acción en Odoo.
Qué aprender del caso de Saffron Tools
- En este módulo, los errores de validación son reglas sobre importes, porcentajes y fechas: el texto dice qué campo falla y qué condición tiene que cumplir.
- Los mensajes del crédito fiscal nombran un solo componente (IGST, CGST o SGST): revisa ese y no el resto.
- Los dos avisos no se arreglan corrigiendo un dato: el IRN se obtiene con
Indian - E-invoicingo en el portal IRP, y la declaración se presenta en el portal GST antes de usarMark as Submitted. - Al terminar, repasa las listas del módulo para comprobar cómo han quedado los registros.

Aparte de estos mensajes, el módulo tiene la lista Compliance Alerts, con las columnas Alert Type, Severity, Alert Date, Due Date y Resolved. Si quieres ver qué menús añade el módulo y qué recorre cada registro, lo tienes en cómo funciona India GST Compliance por dentro.

Cómo te ayuda FlexigoTech
FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones a medida, así que podemos ayudarte a dejar India GST Compliance configurado o a revisar contigo un mensaje que no termines de entender. India GST Compliance está publicado en Odoo Apps para 17.0, 18.0, 19.0 y 20.0 a 9 € por versión de Odoo, pago único y sin IVA; el servicio local de FlexigoTech Cloud cuesta 29 €/mes o 290 €/año sin IVA (Pro: 58 €/mes o 580 €/año).
Tienes todos los detalles en la página del módulo en flexigotech.com y en su ficha de Odoo Apps.
Sigue leyendo
Comprobado en el código del módulo (versión 20.0) y en las fuentes enlazadas
Fuentes
- Código del módulo: flexigo_india_gst_compliance_suite 20.0 (b766f923): models/gst_filing_integration.py
- Código del módulo: flexigo_india_gst_compliance_suite 20.0 (b766f923): models/gst_input_tax_credit.py
- Código del módulo: flexigo_india_gst_compliance_suite 20.0 (b766f923): models/gst_return_preparation.py
- Código del módulo: flexigo_india_gst_compliance_suite 20.0 (b766f923): models/gst_tax_calculation.py
- Código del módulo: flexigo_india_gst_compliance_suite 20.0 (b766f923): wizards/gst_filing_wizard.py
- apps.odoo.com/apps/modules/20.0/flexigo_india_gst_compliance_suite
- apps.odoo.com/apps/modules/17.0/flexigo_india_gst_compliance_suite
- apps.odoo.com/apps/modules/18.0/flexigo_india_gst_compliance_suite
- apps.odoo.com/apps/modules/19.0/flexigo_india_gst_compliance_suite
- flexigotech.com/en/services.html
- flexigotech.com/precios.html
