Saltar para o conteúdo principal
USA Digital Services Tax Compliance

Erros do USA Digital Services Tax Compliance no Odoo: o que significa cada mensagem e o que fazer

Os avisos do USA Digital Services Tax Compliance trazem um texto que já indica a regra que foi violada: códigos repetidos, datas trocadas, valores negativos, declarações fora de ordem ou tentativas de alterar o registo de auditoria. Aqui encontra cada mensagem literal, quando aparece e o que fazer a seguir.

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
5 min

As mensagens estão em inglês porque é assim que o módulo as devolve; copiamo-las tal como são para que as possa pesquisar com o texto exato que vê no ecrã. Tenha uma coisa em conta antes de as ler: são verificações que a app faz sobre os seus dados, não regras fiscais. O que cada jurisdição exige tem de ser confirmado na respetiva fonte. Se ainda não tem claro o percurso de cada registo, comece por como funciona o módulo por dentro e volte aqui quando surgir um aviso.

Avisos ao criar jurisdições, nexo e categorias

Lista de jurisdições fiscais com oito registos e colunas de nome, código, estado, data efetiva, taxa do imposto principal e frequência de declaração
A lista de jurisdições, com a coluna de código que o módulo exige que seja única

O que significa Jurisdiction code must be unique?

Que o código atribuído à jurisdição já está a ser usado por outra. O módulo não permite duas jurisdições com o mesmo código. Antes de criar uma nova, pesquise esse código na lista: se já existir, trabalhe sobre a jurisdição que o tem; se for mesmo uma jurisdição diferente, atribua-lhe outro código. O mesmo acontece com as categorias de serviço: Service category code must be unique aparece quando repete o código de uma categoria já criada, e resolve-se da mesma forma, reutilizando a existente ou escolhendo outro código.

Porque aparece Each company can only have one nexus status per jurisdiction?

Porque está a criar um segundo estado de nexo para a mesma empresa e a mesma jurisdição, e o módulo só admite um por cada par empresa e jurisdição. Se trabalha com várias empresas no Odoo, confirme a que empresa pertence o registo que está a tentar guardar: o estado de nexo que procura pode já existir e o que precisa é de o alterar, não de criar outro.

O que faço com This calculation method is for Washington only e as suas variantes?

Há quatro mensagens do mesmo tipo: This calculation method is for Washington only, This calculation method is for Chicago only, This calculation method is for Utah only e This calculation method is for Maryland only. Cada uma indica que o método de cálculo escolhido se destina a uma única jurisdição e está a ser usado noutra. Reveja o par: ou a jurisdição do registo não é a que pensava, ou o método não é o que lhe corresponde. Altere um dos dois para que coincidam e guarde novamente.

Sequência com a lista de Jurisdictions, o painel Digital Services Tax Dashboard com cartões de Chicago, Maryland State e Washington State, a lista de jurisdições e o formulário de declaração de Maryland State
Da lista de jurisdições ao painel com os seus cartões e a uma declaração de Maryland State

Avisos em períodos, receitas e valores

O que querem dizer Period start date cannot be after period end date e Base period start must be before end date?

Ambas falam de datas trocadas. A primeira aparece quando a data de início do período é posterior à de fim. A segunda surge com o período base, quando o início não é anterior ao fim; repare que o texto exige que o início seja anterior, não apenas que não seja posterior. Reveja as duas datas do registo, corrija a que estiver errada e guarde novamente.

Porque não me deixa introduzir um valor negativo?

Há duas verificações de sinal. Revenue cannot be negative aplica-se às receitas e Tax and payment amounts cannot be negative aos valores de imposto e de pagamento. O módulo não aceita esses valores abaixo de zero. Introduza o valor em positivo e confirme que está a preencher o campo pretendido; se o que quer é corrigir um período já concluído, veja a pergunta seguinte.

O que significam Period must be verified before marking complete e Cannot edit completed period entries. Create an adjustment entry instead.?

A primeira aparece se tentar marcar um período como concluído sem o ter verificado antes: o módulo exige esse passo. Verifique o período e volte a marcá-lo como concluído. A segunda surge quando o período já está concluído e tenta editar as suas entradas. A própria mensagem diz o que fazer: não altere a entrada original e crie uma entrada de ajuste. Se quiser rever que campos se preenchem em cada registo, consulte a configuração do módulo.

Avisos em declarações, pagamentos e registo de auditoria

Formulário de declaração de Maryland State com empresa, período, prazo, estado Draft - Not Filed, cálculo do imposto e secção de pagamento por pagar
Uma declaração de Maryland State ainda no estado Draft - Not Filed, com a secção de pagamento por pagar

O que significa Can only have one filing per jurisdiction per period?

Que já existe uma declaração para essa jurisdição nesse mesmo período. O módulo só admite uma. Procure a que já existe e trabalhe sobre ela em vez de criar outra; se o período indicado não era o correto, corrija-o na nova antes de guardar.

Porque não consigo marcar como submetida, confirmar ou registar um pagamento?

Três mensagens indicam o que pode fazer com uma declaração consoante o seu estado:

  • Only draft filings can be marked as filed: só uma declaração em rascunho pode ser marcada como submetida.
  • Can only confirm filed filings: só se confirma uma declaração que já foi submetida.
  • Payment can only be recorded for filed/confirmed filings: o pagamento regista-se em declarações submetidas ou confirmadas.

Veja o estado da declaração e faça primeiro o passo em falta. Se surgir o aviso de pagamento com uma declaração em rascunho, marque-a antes como submetida.

Posso corrigir ou apagar uma entrada do registo de auditoria?

Não. Audit log is append-only; entries cannot be modified aparece se tentar alterar uma entrada e Audit log entries cannot be deleted se tentar apagá-la. O registo de auditoria só permite acrescentar entradas, por isso não é uma falha que tenha de resolver. Se algo do que reflete estiver errado, a correção faz-se no registo de origem e dentro do que os outros avisos permitem (por exemplo, com uma entrada de ajuste se o período já estiver concluído).

Como a FlexigoTech o pode ajudar

Se um aviso o bloqueia e não encontra a causa, ou precisa de integrar o módulo com o resto do seu Odoo, a FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. O módulo está publicado na Odoo Apps para 17, 18, 19 e 20 e custa 9 € por versão do Odoo, pagamento único sem IVA; o serviço local da FlexigoTech Cloud é à parte, a 29 €/mês ou 290 €/ano sem IVA (Pro: 58 €/mês ou 580 €/ano). Sem subscrição, ou com o serviço suspenso, para o que a subscrição fornece e os dados ficam no seu Odoo. Tem os detalhes na página do módulo e na sua ficha da Odoo Apps.

Continue a ler

Como funciona USA Digital Services Tax Compliance no Odoo por dentroQue menus o USA Digital Services Tax Compliance adiciona ao Odoo, que registos guarda internamente e o que depende do serviço externo da FlexigoTech Cloud.Arranque do USA Digital Services Tax Compliance no Odoo: campos, estados e primeira semanaQue versão comprar, que campos preencher no registo de alterações, nas alterações por jurisdição e nos processos judiciais, e o que rever na primeira semana.USA Digital Services Tax Compliance no Odoo: um caso para decidir se serve à sua empresaUm caso para decidir se o USA Digital Services Tax Compliance serve ao seu Odoo: versões, o que cobre o serviço local, o que fica de fora e que dados envia.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes