balsa na NF-e: identificação no XML e limites de uso
<balsa>transp › balsaRevisão editorial em 26 de set. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
balsa identifica a balsa utilizada no transporte e fica diretamente em transp/balsa. Não é a placa de um caminhão embarcado, o nome da transportadora nem a descrição dos volumes. A informação deve vir da identificação logística da embarcação efetivamente utilizada.
O caminho completo é /nfeProc/NFe/infNFe/transp/balsa, no namespace http://www.portalfiscal.inf.br/nfe. Se estiver lendo a NF-e sem o envelope de processamento, o caminho começa em NFe/infNFe; o significado do campo não muda.
Alternativa do meio de transporte
O campo comporta texto de 1 a 20 caracteres e no máximo uma ocorrência. No XSD, ele participa de uma escolha entre o trecho rodoviário (veicTransp e reboque), vagao e balsa. Não basta dizer que cada um é opcional: a escolha impede juntar essas alternativas na mesma posição da sequência. MOC, X25b, p.61; schema PL_010c, transp.
Uma viagem que combina caminhão e travessia não autoriza, só por essa descrição, colocar placa, vagão e balsa juntos. É necessário confirmar qual informação deve ser representada nesse documento e as exigências do seu contexto. O artigo explica a estrutura disponível, sem decidir obrigações de documentos de transporte adicionais.
Quando não existe informação aplicável de balsa, ausência da tag é diferente de <balsa/>: a tag vazia não contém o identificador exigido pelo formato. Não use “NÃO INFORMADO” como substituto de uma identificação desconhecida.
Exemplo de leitura
Trecho parcial e sintético, não pronto para transmissão. A hipótese é uma NF-e em que a alternativa balsa é aplicável e a identificação logística é BALSA ALFA:
<transp xmlns="http://www.portalfiscal.inf.br/nfe">
<modFrete>0</modFrete>
<balsa>BALSA ALFA</balsa>
</transp>
modFrete=0 representa a hipótese de contratação por conta do remetente; não é código do modal aquaviário. balsa vem depois das informações anteriores de transporte que existirem e antes de vol. O texto não exige identificador numérico: letras podem fazer parte da identificação. Preserve a identificação real, sem espaços de preenchimento nas extremidades e sem cortá-la automaticamente para caber.
NFC-e, DANFE Tipo 2 e rejeição 759
O MOC X25b-10 prevê a rejeição 759 quando uma NFC-e contém balsa. A NT 2026.002 v1.10a, p.19 inclui também a NF-e modelo 55 com DANFE Simplificado Tipo 2 (tpImp=6). A linha do cronograma que inclui X25b-10 indica teste em 01/07/2026 e produção em 03/08/2026. Essas datas documentam o conjunto de regras e não uma consulta à implantação da UF.
A permissão de frete na entrega em domicílio não libera balsa nesses documentos. As condições de modFrete e a vedação de balsa são verificações distintas.
O que conferir quando a integração falha
Se há falha de schema, veja comprimento, texto vazio, ordem dos filhos e presença de alternativas concorrentes. Por exemplo, veicTransp seguido de balsa pode violar a escolha mesmo com ambos os textos preenchidos corretamente.
Se o retorno é 759, confira ide/mod e ide/tpImp no XML enviado. O problema documentado é a presença da informação em um contexto proibido; trocar o nome da balsa não corrige essa condição. Compare o registro da operação e a geração do XML para localizar por que o campo foi emitido. Não altere o modelo nem invente ausência de transporte para obter autorização.
A identificação logística pode ser corrigida na origem quando comprovadamente errada. A definição do documento e das obrigações fiscais de uma operação multimodal depende de seus documentos e da confirmação do responsável fiscal. Preserve o XML autorizado e assinado. A visão do grupo transp ajuda a conferir a posição da balsa em relação às demais informações.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/transp/balsa- Namespace
http://www.portalfiscal.inf.br/nfe- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 0–1 no contexto do elemento pai
- Tipo
- inline:TString · TString
- 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.
- maxLength
20- minLength
1- pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}- whiteSpace
preserve