vDevTrib de IBS municipal no total: soma documentada e vedação no item

vDevTrib em /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSMun/vDevTrib representa o total de devolução de IBS municipal. Sua existência no schema não demonstra que a devolução municipal esteja permitida no cálculo dos itens da operação.

Identidade técnica: tag; XPath /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSMun/vDevTrib.

Para consultas XPath com prefixos, associe n a http://www.portalfiscal.inf.br/nfe em cada elemento. Em XML cuja raiz é NFe, retire o ancestral nfeProc da consulta; não remova namespaces do documento original.

Nesta página:

• Campo estrutural e regra de uso precisam ser separados
• Como representar uma parcela comprovadamente inexistente
• O que verificar em um XML com valor positivo
• Exemplo XML e hipóteses do fragmento
• Versão e cronograma: o que conferir no ambiente
• Cronologia específica da restrição de devolução
• Leituras relacionadas

Campo estrutural e regra de uso precisam ser separados

No XSD PL 010f v1.04, vDevTrib é filho obrigatório de gIBSMun total, entre vDif e vIBSMun. Usa TDec1302RTC: até 13 algarismos inteiros e duas casas quando fracionário, sem sinal. O leiaute W44, p.29 da NT 2025.002 v1.52, define a grandeza.

W44-10/1082, p.71, compara o total devolvido do IBS municipal com a soma dos valores correspondentes nos itens. Contudo, UB43-10/1112, p.46, considera indevido o grupo gIBSMun/gDevTrib dos itens para modelos 55 e 65. As duas informações coexistem: uma descreve como conferir o total; a outra restringe o grupo de origem. Não use a regra de soma como autorização fiscal.

Como representar uma parcela comprovadamente inexistente

Em um cenário sintético da edição conferida, sem grupo de devolução municipal nos itens e com sua inexistência confirmada, o fragmento no total é <vDevTrib>0.00</vDevTrib>. Ele precisa estar dentro de gIBSMun total, junto de seus outros filhos, e não forma uma nota completa.

Não crie gDevTrib no item só para justificar o zero do total. Também não use número negativo para devolver mercadoria, nem copie devolução de CBS ou de IBS estadual. Um exemplo com valor municipal devolvido positivo exigiria um contexto e uma versão que documentassem a permissão do grupo; a estrutura XSD isolada não fornece essa condição.

O que verificar em um XML com valor positivo

Confirme modelo, data, ambiente, versão de leiaute/pacote e o caminho exato do valor. Veja se o leitor capturou a CBS, o componente estadual ou até o total como se fosse um item. Depois examine se existe gIBSMun/gDevTrib no item e qual regra/retorno foi aplicado.

Se o valor corresponde a uma operação real cuja representação precisa de devolução municipal, reúna documentos, fundamento e especificação da versão aplicável com o responsável fiscal e o integrador. Não zere um valor verdadeiro nem retire grupo por tentativa para obter autorização. A solução técnica exige esclarecer a origem e o contrato permitido, corrigindo somente a causa comprovada. Preserve XML autorizado e o retorno original.

Exemplo XML e hipóteses do fragmento

A hipótese é uma soma conhecida igual a zero: inexistência confirmada de devolução de IBS municipal e nenhum grupo indevido de devolução municipal nos itens. Não é preenchimento padrão para um dado desconhecido. O campo isolado é parcial a gIBSMun total.

<vDevTrib xmlns="http://www.portalfiscal.inf.br/nfe">0.00</vDevTrib>

A validação desse fragmento é estrutural e limitada à declaração do seu caminho. Não equivale à validação da nota completa, à assinatura ou à autorização.

Versão e cronograma: o que conferir no ambiente

A estrutura descrita foi conferida no PL 010f v1.04. O snapshot da ficha pode oferecer PL 010e v1.02; uma afirmação sobre o pacote mais novo não deve ser atribuída automaticamente a todo arquivo histórico.

A NT 2025.002 v1.52 é a edição de setembro de 2026, publicada no catálogo em 1º/10/2026. O aviso ENCAT de 5/10/2026 adiou as alterações dessa rodada para 26/10/2026 em homologação e 16/11/2026 em produção. Essas datas não suspendem todas as regras anteriores nem tornam ativas as regras que continuam marcadas como implementação futura. Em 14/10/2026, os dois novos marcos ainda eram futuros.

Separe a existência de uma tag no schema, a condição fiscal da operação e a ativação da regra de negócio. A condição legal não se deduz da ausência de rejeição, e o cronograma não comprova implantação em cada autorizadora. Registre data, modelo, ambiente, pacote usado e retorno para interpretar uma divergência concreta.

Cronologia específica da restrição de devolução

UB24-10, UB43-10 e UB62-10 foram incluídas na versão 1.40. O histórico da NT 2025.002 v1.52, p.5, prevê essa rodada até 1º/07/2026 em homologação e 3/08/2026 em produção. Nas pp. 44, 46 e 49, essas regras não estão marcadas como implementação futura. Portanto, em 14/10/2026 são restrições com cronograma documental anterior ao corte, e não regras adiadas pelo aviso relativo às mudanças da v1.52. Isso distingue a previsão oficial da comprovação operacional: a aplicação efetiva em uma autorizadora concreta deve ser confirmada pelo ambiente e retorno; não foi realizado teste de transmissão para esta explicação.

Leituras relacionadas

O grupo municipal contém os outros valores obrigatórios do total. gIBSMun — /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSMun.