UFGuia na NF-e: UF de emissão da guia de trânsito

UFGuia é a sigla da unidade federada de emissão da guia de trânsito, em /nfeProc/NFe/infNFe/agropecuario/guiaTransito/UFGuia. A NT 2024.003 a identifica como ZF06. O critério é a emissão da guia, não a UF do emitente da NF-e, o estado de destino da carga ou a UF de saída do país.

De onde vem a UF e como evitar uma associação errada?

Leia a guia original e identifique sua UF emissora junto com tipo, série e número. Esses dados compõem uma referência documental. Um número isolado pode não identificar a mesma guia em contextos estaduais diferentes; por isso, copiar a UF do cadastro da empresa como valor padrão pode associar a nota a outro documento.

Hipótese sintética: guia emitida em GO para trânsito com destino em MG. O exemplo representa GO em UFGuia, porque o destino não altera a origem da emissão. Isso não afirma a admissibilidade sanitária de uma rota nem que a empresa emitente esteja em qualquer desses estados.

Quais siglas o XML admite?

O tipo TUfEmi aceita as 27 siglas das unidades federadas brasileiras, incluindo DF, em maiúsculas. Não aceita EX, nome de estado por extenso, código numérico do IBGE ou campo vazio. GO é sigla; 52 é outro tipo de identificação e não preenche esse elemento.

UFGuia é obrigatória dentro de guiaTransito, uma vez, depois de tpGuia e antes da eventual serieGuia e de nGuia. O pai é um ramo alternativo a defensivo em agropecuario; obrigatoriedade do filho não torna a guia universal em toda venda agrícola.

Como reconhecer o campo no exemplo?

Fragmento sintético parcial em relação à NF-e, com guia fictícia, sem validade sanitária real:

<guiaTransito xmlns="http://www.portalfiscal.inf.br/nfe">
  <tpGuia>1</tpGuia>
  <UFGuia>GO</UFGuia>
  <nGuia>12345</nGuia>
</guiaTransito>

O tipo 1 representa GTA; o número é demonstrativo. A série foi omitida porque o exemplo não a possui. Na operação real, informe a série quando existir, conforme a orientação ZF07, e confira sua identidade; não copie a série da NF-e.

A UF da guia é a mesma UF que ativa uma regra?

São conceitos distintos. A tabela UF/NCM da NT define recortes de aplicação de validações pela UF; UFGuia identifica a origem de um documento concreto. Não altere essa sigla para coincidir com um estado da tabela ou com o ambiente autorizador.

Na NT v1.10, a tabela 4.1 relaciona ZF05-10 para bovinos 0102XXXX em BA, GO, MA e MT e declara ZF05-20 não ativada para nenhuma UF. As regras de guia são facultativas conforme as condições documentadas;ZF05-30 florestal é futura. Isso não torna guias sanitárias/ambientais dispensáveis, nem comprova implantação real em cada ambiente. As regras ZF citadas são de modelo 55, embora a estrutura esteja no XSD comum 55/65.

Como investigar erro de sigla ou guia não reconhecida?

Para falha XSD, confira valor, caixa, espaços, namespace e posição. Para 837, guia inválida, ou 838, guia já utilizada, examine também tipo, UF, série, número e situação no órgão emissor; essas consultas cadastrais são facultativas por UF e não se resumem à sigla. Um UFGuia válido no XSD não prova a existência da guia.

Confronte a origem documental e o mapeamento do emissor. Corrija somente o dado demonstradamente errado; não substitua pela UF da empresa ou por uma guia de outra operação. A conferência identifica o documento correto, sem escolher NCM, CFOP ou determinar a validade sanitária do trânsito.

Fontes técnicas

NT 2024.003 — Produtos agropecuários — 1.10, maio/2026: p. 8–9, ZF04–ZF08; p. 12–14, regras de guia e tabela 4.1.

XSD NF-e/NFC-e — PL_010f_v1.04: linhas 6540–6602, guiaTransito/UFGuia.

Tipos básicos NF-e/NFC-e — PL_010f_v1.04: linhas 423–457, TUfEmi.