Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Produtos e serviços

tpViaTransp na NF-e: via internacional da importação

<tpViaTransp>det › prod › DI › tpViaTransp

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

tpViaTransp informa a via de transporte internacional registrada na DI ou na Declaração Única de Importação (Duimp). Ele pertence ao grupo de importação do produto, no caminho /nfeProc/NFe/infNFe/det/prod/DI/tpViaTransp.

O campo descreve a informação aduaneira da importação. Não identifica a transportadora, não define quem paga o frete e não informa o tipo de intermediação da compra.

Códigos aceitos no leiaute atual

O XSD PL 010f v1.04 define expressamente os seguintes valores:

Código Via internacional
1 Marítima
2 Fluvial
3 Lacustre
4 Aérea
5 Postal
6 Ferroviária
7 Rodoviária
8 Conduto
9 Meios próprios
10 Entrada/saída ficta
11 Courier
12 Em mãos
13 Por reboque

O MOC 7, p.19, apresenta uma lista mais antiga, até 7. Para integração, a lista deve ser confrontada com o schema do ambiente; rejeitar localmente 8 a 13 com base apenas naquela página pode bloquear dados admitidos pela estrutura atual.

Dentro de cada DI enviado, tpViaTransp é obrigatório uma vez. O XML recebe o código como texto da enumeração: 4, não 04 nem Aérea. Não há código 0 para representar ausência.

De onde obter o dado

Leia a via internacional da declaração efetivamente associada à mercadoria. Não use automaticamente a via de transporte do trecho rodoviário entre o porto e o estabelecimento. Uma carga cuja importação foi marítima pode continuar por caminhão no Brasil sem que esse trecho transforme a via internacional em 7.

Se um produto reúne mais de uma declaração, confira a via em cada ocorrência DI. O leiaute admite até 100 grupos DI por produto; isso não autoriza copiar a informação da primeira para todas as demais.

O significado aduaneiro de uma categoria especial, como entrada/saída ficta ou meios próprios, depende da operação e da declaração. Quando houver dúvida, confirme com o responsável aduaneiro a descrição documentada e o registro aplicável; não escolha um código por semelhança com o transporte físico observado.

Relação com AFRMM e campos de transporte

No caso marítimo, tpViaTransp=1, o MOC documenta a informação de vAFRMM e a regra I23b-10, com rejeição 330 se o valor não for enviado. O campo AFRMM representa o adicional ao frete para renovação da marinha mercante, não o valor do frete. Sua origem e eventual tratamento específico precisam ser conferidos nos documentos aduaneiros; a via, por si só, não fornece o montante.

transp/modFrete descreve a modalidade do frete na NF-e. tpIntermedio descreve conta própria, conta e ordem ou encomenda. Esses campos possuem domínios e papéis diferentes; números iguais não demonstram equivalência. MOC 7, pp.19–20 e 95.

Exemplo e diagnóstico

Fragmento sintético parcial, apenas do elemento; não é uma DI completa nem uma nota pronta para transmissão:

<tpViaTransp xmlns="http://www.portalfiscal.inf.br/nfe">4</tpViaTransp>

A hipótese é que a declaração registra via aérea. Não há cálculo para obter 4. Se o emissor apresenta 04, compare a representação visual com o XML: a tela pode formatar um número, mas o arquivo deve respeitar a enumeração real.

Em erro de schema, confira elemento ausente, enumeração, zeros à esquerda e posição entre dDesemb, vAFRMM quando presente e tpIntermedio. Em 330, confirme se a via real é 1 e se AFRMM foi serializado. Em divergência documental, compare declaração, cadastro e XML de cada item.

Corrija o dado ou o mapeamento comprovadamente incorreto. Não altere a via verdadeira para escapar de uma dependência de AFRMM ou de outro requisito. Quando a declaração estiver indisponível, a pendência é obter a evidência da importação, não preencher um padrão genérico.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/prod/DI/tpViaTransp
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
inline:xs:string · 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.

enumeration
1
enumeration
10
enumeration
11
enumeration
12
enumeration
13
enumeration
2
enumeration
3
enumeration
4
enumeration
5
enumeration
6
enumeration
7
enumeration
8
enumeration
9
whiteSpace
preserve