Saltar para o conteúdo principal
India GST Compliance

Erros e avisos do India GST Compliance no Odoo: quando aparecem e o que fazer

As mensagens do India GST Compliance são de dois tipos: as que aparecem quando um montante, uma percentagem ou uma data não cumpre a regra que a própria mensagem enuncia, e as que avisam que o módulo não se liga nem ao portal de fatura eletrónica (IRP) nem ao portal GST. As primeiras resolvem-se corrigindo o dado; as segundas, fazendo esse passo fora do módulo. Aqui percorremo-las com um caso inventado, mensagem a mensagem e com o texto literal.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 4 de novembro de 2026

O essencial

Versões
Odoo 17, 18, 19 e 20
Verificado
no código do módulo, versão 20.0 · nas fontes indicadas no fim
Leitura
6 min

Um caso inventado para percorrer todas as mensagens

Exemplo Caso ilustrativo: a empresa e os seus dados são inventados para explicar o fluxo.

A Saffron Tools é uma distribuidora inventada com sede em Pune que gere as compras e as vendas no Odoo e acabou de instalar o India GST Compliance. A responsável de contabilidade, Meera, tem de rever o crédito fiscal das faturas de fornecedor, preparar a declaração do período e submeter o que for preciso. Ao longo do mês vai encontrando todas as mensagens que o módulo pode mostrar. Vemo-las pela ordem em que lhe surgem, com o texto tal como aparece e o que ela fez para avançar.

Se ainda estiver a configurar o módulo, convém ler antes a implementação do India GST Compliance, que explica que definições e campos preencher.

O crédito reclamado não pode ultrapassar o elegível

A Meera começa pelo crédito de impostos suportados. Na lista Input Tax Credit Management vê cada fatura de fornecedor com o total elegível, o total reclamado e o estado ITC.

Lista Input Tax Credit Management com faturas de fornecedor, total elegível, total reclamado e estado ITC
Faturas de fornecedor com os totais elegível e reclamado, nos estados Claimed, Ineligible e Available.

Ao ajustar uma delas, escreve no CGST reclamado um montante superior ao CGST elegível. O módulo responde com esta mensagem:

  • Claimed CGST cannot exceed eligible CGST.

Há uma mensagem equivalente para cada um dos outros componentes do imposto:

  • Claimed IGST cannot exceed eligible IGST.
  • Claimed SGST cannot exceed eligible SGST.

O que significa. O módulo verifica, componente a componente, que o valor reclamado não ultrapassa o elegível.

O que fazer. Veja que componente a mensagem indica (IGST, CGST ou SGST) e reveja só esse. Baixe o montante reclamado até não ultrapassar o elegível ou, se o erro estava no elegível, corrija esse outro montante. A Meera tinha copiado o reclamado de outra fatura; ao introduzir o correto, a mensagem desapareceu.

Percentagens, taxas e montantes fora do intervalo

Depois, a Meera preenche uma percentagem de uso empresarial e carrega numa tecla a mais. Aparece:

  • Business use percentage must be between 0 and 100.

Na mesma sessão surgem mais duas: uma por uma taxa de GST mal escrita e outra por um montante base introduzido com sinal negativo.

  • GST rate must be between 0 and 100.
  • Base amount must be positive.

O que significa. São regras de intervalo que o próprio texto deixa claras: a percentagem de uso empresarial e a taxa de GST têm de estar entre 0 e 100, e o montante base tem de ser positivo.

O que fazer. Corrija o valor para cumprir a condição da mensagem e volte a guardar. Se não vir logo que campo está errado, leia a mensagem inteira: indica o campo (Business use percentage, GST rate ou Base amount), por isso não é preciso rever o resto do registo.

Datas do período que não batem certo

Com o crédito revisto, a Meera passa para GST Return Preparation, onde cada declaração tem o período, o vencimento, o imposto total e o imposto líquido a pagar.

Lista GST Return Preparation com declarações, períodos, vencimento, imposto total, imposto líquido a pagar e estados
Declarações com os períodos e vencimentos, nos estados Filed, Submitted e Draft.

Ao criar a declaração do novo período copia as datas de outra e deixa-as trocadas. O módulo trava-a com:

  • Period start date must be before period end date.

Corrige, mas então o vencimento fica antes do fim do período e aparece a seguinte:

  • Due date must be after period end date.

O que significa. O módulo exige uma ordem nas datas: o início do período antes do fim, e o vencimento depois do fim.

O que fazer. Com a primeira mensagem, reveja o início e o fim do período. Com a segunda, veja o vencimento e o fim do período e corrija o que estiver errado. A Meera tinha o período certo e só teve de mudar o vencimento.

Os dois avisos que dizem que o módulo não envia nada

Chega a hora de submeter. A Meera assumia que o módulo enviava a fatura eletrónica e a declaração, e depara-se com dois avisos. Nenhum é um problema do dado: são avisos de que essa parte se faz fora do módulo.

Fatura eletró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.

O que significa. O India GST Compliance não se liga ao portal de fatura eletrónica (IRP) do GSTN, por isso não pede nenhum IRN e nada foi enviado.

O que fazer. A própria mensagem indica dois caminhos: obter o IRN com a app do Odoo Indian - E-invoicing (l10n_in_edi) ou fazê-lo no portal IRP.

Submissão da declaração

  • 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.

O que significa. O módulo também não se liga ao portal GST, pelo que a declaração não foi submetida.

O que fazer. Submeta a declaração no portal GST e, depois, use Mark as Submitted nessa declaração no Odoo. A ordem é a da mensagem: primeiro o portal, depois a ação no Odoo.

O que aprender com o caso da Saffron Tools

  • Neste módulo, as mensagens de validação são regras sobre montantes, percentagens e datas: o texto diz que campo falha e que condição tem de cumprir.
  • As mensagens do crédito fiscal indicam um só componente (IGST, CGST ou SGST): reveja esse e não os restantes.
  • Os dois avisos não se resolvem corrigindo um dado: o IRN obtém-se com Indian - E-invoicing ou no portal IRP, e a declaração submete-se no portal GST antes de usar Mark as Submitted.
  • No fim, percorra as listas do módulo para confirmar como ficaram os registos.
Percurso por Input Tax Credit Management, Compliance Alerts, GST Return Preparation e de volta a Input Tax Credit Management
As listas de crédito fiscal, alertas e declarações, uma após outra.

Além destas mensagens, o módulo tem a lista Compliance Alerts, com as colunas Alert Type, Severity, Alert Date, Due Date e Resolved. Se quiser ver que menus o módulo acrescenta e por onde passa cada registo, tem tudo em como funciona o India GST Compliance por dentro.

Lista Compliance Alerts com as colunas Alert Type, Severity, Alert Date, Due Date e Resolved, botão New e pesquisa
Seis alertas na lista; só Audit Notification aparece marcada como resolvida.

Como a FlexigoTech ajuda

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida, por isso podemos ajudar a deixar o India GST Compliance configurado ou rever consigo uma mensagem que não perceba bem. O India GST Compliance está publicado na Odoo Apps para 17.0, 18.0, 19.0 e 20.0 a 9 € por versão do Odoo, pagamento único e sem IVA; o serviço local da FlexigoTech Cloud custa 29 €/mês ou 290 €/ano sem IVA (Pro: 58 €/mês ou 580 €/ano).

Tem todos os detalhes na página do módulo em flexigotech.com e na sua página na Odoo Apps.

Continue a ler

Como funciona o India GST Compliance no Odoo: glossário de menus, modelos e listasGlossário do India GST Compliance no Odoo: os menus que acrescenta em Faturação, os modelos que define e o que se vê em cada lista, com os nomes tal como aparecem.Pôr a funcionar o India GST Compliance no Odoo: versões, campos de estado e primeira semanaPerguntas e respostas para pôr a funcionar o India GST Compliance no Odoo: versões, serviço local, campos de estado e o que rever na primeira semana.Como funciona por dentro o Argentina ARCA Supplier Invoice Validation no OdooGlossário de menus, ações agendadas e dados do módulo Argentina ARCA Supplier Invoice Validation and Withholding Management para Odoo.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes