Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Transporte

vServ do transporte na NF-e: valor do serviço e diferença para frete

<vServ>transp › retTransp › vServ

Revisão editorial em 26 de set. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

vServ dentro de transp/retTransp é o valor do serviço no grupo de retenção de ICMS do transporte. O caminho é /nfeProc/NFe/infNFe/transp/retTransp/vServ. Ele não é um campo genérico para todo serviço vendido, nem substitui valores de frete dos produtos ou totais da NF-e.

O contexto do pai é indispensável: a mesma palavra “serviço” pode aparecer em informações de outra natureza. Aqui, o dado deve ser reconciliado com a prestação de transporte à qual a retenção documentada se refere.

Quatro valores que não devem ser equiparados

Campo ou informação Função
retTransp/vServ Valor do serviço de transporte no bloco de retenção
retTransp/vBCRet Base fiscal definida para a retenção
retTransp/vICMSRet Valor do ICMS retido
det/prod/vFrete e total de frete Frete representado nos valores da operação da nota

A semelhança comercial não prova igualdade automática. Confira o documento do serviço, a composição do valor e a memória de cálculo; não copie vFrete para vServ por nome parecido nem faça rateio nos produtos a partir desse campo sem regra e origem definidas. MOC X12–X15, p.60.

Se a informação vem de integração, confirme se o contrato transmite reais ou centavos e se o valor corresponde ao serviço inteiro desse registro. modFrete também não fornece o montante: ele descreve a modalidade, inclusive contratação ou transporte próprio.

Obrigatoriedade e representação

vServ é o primeiro filho de retTransp, obrigatório uma vez quando esse pai existe. O pai admite ausência estrutural; não se cria retenção só para registrar um valor de frete.

O tipo TDec_1302 do PL_010c admite até treze dígitos inteiros e duas casas quando decimal, além das alternativas inteiras/zero no padrão. Para R$ 1.000,00, use como representação ilustrativa 1000.00, sem R$, sem separador de milhar e sem vírgula. A aceitação estrutural não valida o valor comercial nem a ocorrência de retenção.

Exemplo com valores distintos

Fragmento parcial e sintético, não pronto para transmissão. Serviço, base e percentual foram assumidos apenas para a demonstração; a diferença entre R$ 1.000,00 e R$ 800,00 não define uma redução de base para o leitor:

<retTransp xmlns="http://www.portalfiscal.inf.br/nfe">
  <vServ>1000.00</vServ>
  <vBCRet>800.00</vBCRet>
  <pICMSRet>12.00</pICMSRet>
  <vICMSRet>96.00</vICMSRet>
  <CFOP>5352</CFOP>
  <cMunFG>4106902</cMunFG>
</retTransp>

Na hipótese de aplicação percentual simples, 800 × 12 ÷ 100 = 96. Aplicar 12% diretamente a vServ daria R$ 120,00 e usaria outra parcela. Código e município também são demonstrativos, sem seleção fiscal. O resultado exato evita supor regras de arredondamento.

Como investigar valor inesperado

Compare vServ com o documento do serviço e com a entrada recebida pela integração. Se o cadastro mostra 1.000,00 e o XML mostra 100000.00, investigue escala centavos/reais. Se o XML repete o valor dos produtos, confira mapeamento entre campos e a operação a que o serviço pertence. Se repete a base, veja se houve cópia de variável distinta.

Não transforme um valor ausente em zero. A pendência de origem é diferente de um zero explícito comprovado; ambos podem parecer o mesmo número depois de um preenchimento automático errado.

Para rejeição 755, o ponto é a presença de retTransp na NFC-e ou na NF-e com tpImp=6, não o valor do serviço. A NT 2026.002 v1.10a, X11-10 documenta a ampliação, com teste em 01/07/2026 e produção em 03/08/2026 para o conjunto de transporte, sem prova operacional de implantação por UF aqui.

Confirme com o responsável fiscal a ocorrência da retenção e a composição aplicável, levando documento do serviço, contrato e memória. Depois corrija a origem comprovada e confira os seis campos do grupo retTransp. Preserve XML assinado; não altere montantes apenas para tentar autorizar.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/transp/retTransp/vServ
Namespace
http://www.portalfiscal.inf.br/nfe
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
1–1 no contexto do elemento pai
Tipo
TDec_1302 · string
Preenchimento no catálogo
Condicional

A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.

pattern
0|0\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})?
whiteSpace
preserve