tpGuia: códigos 1 a 7 da guia de trânsito agropecuária e florestal
<tpGuia>agropecuario › guiaTransito › tpGuiaRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
tpGuia informa o tipo da guia de trânsito em agropecuario/guiaTransito. O código identifica a espécie documental animal, vegetal ou florestal; não informa tributação, CFOP ou número da guia.
Caminho desta ocorrência: /nfeProc/NFe/infNFe/agropecuario/guiaTransito/tpGuia.
Quais códigos o XML aceita
O campo é obrigatório no grupo e aceita exatamente os códigos abaixo:
| Código XML | Tipo descrito no leiaute |
|---|---|
| 1 | GTA, Guia de Trânsito Animal |
| 2 | TTA, Termo de Trânsito Animal |
| 3 | DTA, Documento de Transferência Animal |
| 4 | ATV, Autorização de Trânsito Vegetal |
| 5 | PTV, Permissão de Trânsito Vegetal |
| 6 | GTV, Guia de Trânsito Vegetal |
| 7 | Guia Florestal, com referência a DOF, SisFlora de PA/MT ou SIAM de MG |
Nas descrições de algumas regras aparecem 01,02 e outros códigos com dois dígitos. A enumeração do XSD e a coluna de tamanho do leiaute usam um dígito: no XML, 1 é aceito;01 não é o literal enumerado. NT 2024.003 v1.10, ZF05, p. 8; regras, p. 12–13; XSD PL 010f v1.04, tpGuia.
Exemplo e dados que completam a identificação
Fragmento sintético parcial, sob hipótese de uma GTA já identificada no documento de origem:
<tpGuia xmlns="http://www.portalfiscal.inf.br/nfe">1</tpGuia>
O grupo exige ainda UFGuia, UF de emissão da guia, e nGuia, número com 1–9 dígitos. serieGuia é informada sempre que a guia tiver série. O tipo não deve ser escolhido por tentativa ou apenas pela descrição genérica do produto: consulte a guia efetivamente emitida e as exigências do órgão competente.
O fragmento não comprova emissão da guia nem é uma NF-e completa. Alterar 1 para outro tipo só para remover mensagem muda a informação documental e não é um diagnóstico.
Quais condições de presença e ausência conferir
A ZF05-10/836 trata de falta de guia animal em produto animal vivo, finalidade normal e CFOP fora destas exceções: X.105, X.106, X.111, X.112, X.113, X.114, X.115, X.155, X.156, X.907, X.949, X.454 e X.922. O X na notação da NT representa o primeiro dígito conforme a operação; não é um CFOP para preencher. A ZF05-14/310 trata de guia animal indevida quando nenhum item tem NCM nos padrões 01xxxxxx ou 0301xxxx.
A ZF05-20/311 trata de falta de guia vegetal e tem as mesmas exceções de CFOP, acrescentando X.914. A ZF05-24/312 trata de guia vegetal quando nenhum item tem NCM nos padrões 06xxxxxx, 07xxxxxx, 08xxxxxx ou 12xxxxxx.
São regras facultativas da NF-e 55, com adoção a critério da UF. A tabela 4.1 registra ZF05-10 para bovinos 0102XXXX em BA, GO, MA e MT desde 01/10/2025. A ZF05-20 está marcada como não ativada em nenhuma UF. A ZF05-30/839 florestal está expressamente em implementação futura. Não converta existência de código 7 em prova de rejeição florestal já implantada. NT, p. 12–14.
Como diagnosticar sem alterar dados verdadeiros
Se o XSD rejeitar 01, confira o mapeamento para a enumeração de um dígito. Para 836/310/311/312, confronte os produtos/NCMs, CFOPs e condições reais com a regra do tipo de guia e a adoção por UF; não troque CFOP ou NCM para evitar exigência. Para 837, a 10ZF04-10 valida a guia no banco integrado: compare tipo, UF, série e número com a fonte original.
Uma regra não ativada não dispensa obrigações do órgão competente. Se a dúvida é qual documento se aplica, reúna produto, origem/destino, data, operação e guia disponível para confirmação com o responsável e a autoridade emissora. Depois represente o tipo verdadeiro e confira o grupo. NT, p. 12–14.
A informação condicional que completa a identificação está em série da guia de trânsito.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/agropecuario/guiaTransito/tpGuia- 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
2- enumeration
3- enumeration
4- enumeration
5- enumeration
6- enumeration
7- whiteSpace
preserve