nGuia: número da guia de trânsito agropecuária no XML da NF-e

nGuia, em agropecuario/guiaTransito, informa o número da guia de trânsito animal, vegetal ou de origem florestal relacionada à NF-e. O número identifica a guia, não a NF-e, a chave de acesso ou o receituário de defensivo.

Caminho desta ocorrência: /nfeProc/NFe/infNFe/agropecuario/guiaTransito/nGuia.

Número e contexto da guia precisam coincidir

O grupo reúne tpGuia, tipo documental; UFGuia, UF de emissão da guia; serieGuia, se houver série; e nGuia. O número só deve ser comparado com o documento de origem junto dessas informações. Não use a UF de destino ou a série da NF-e como substitutos dos dados da guia.

O XSD exige o número quando guiaTransito existe. agropecuario oferece uma alternativa entre defensivos e guia de trânsito; o número do receituário pertence a outro ramo. A exigência de guia na operação é contextual, não nasce apenas da existência do campo no schema. NT 2024.003 v1.10, ZF04–08, p. 8–9.

Formato e exemplo sem perder zeros

Fragmento sintético parcial de um número de guia fictício:

<nGuia xmlns="http://www.portalfiscal.inf.br/nfe">000123456</nGuia>

São nove dígitos, com zeros iniciais preservados. O padrão admite de um a nove dígitos; não admite hífen, barra, letras ou espaços. Guarde como texto quando houver zeros significativos na fonte. Não trunque um número maior nem remova caracteres verdadeiros para forçar a validação: confirme se o dado consultado é o número correto e se pertence ao tipo de guia documentado. XSD PL 010f v1.04, nGuia.

O fragmento não é uma guia emitida nem uma NF-e completa; falta o contexto do grupo e do documento real.

Erro de formato e guia inválida são diagnósticos diferentes

Uma falha de XSD pode decorrer de tamanho, caracteres ou posição. A 10ZF04-10/837 é outra camada: valida o número da guia no banco integrado da SEFAZ com o órgão estadual de defesa agropecuária, conforme a regra facultativa de NF-e 55. Um número lexicalmente correto pode não corresponder à guia ou ao contexto consultado.

Para 837, compare número, tipo, UF de emissão e série com o documento original; registre resposta completa, ambiente e autorizadora. Não transforme rejeição cadastral em troca aleatória de dígitos. Se a guia tem número incompatível com o campo, confirme a identificação e a documentação do órgão emissor antes de qualquer correção. NT, p. 13.

Aplicabilidade e conferência antes da geração

As regras de presença são listadas para NF-e 55 e dependem de UF, produto/NCM, CFOP e, no caso animal, finalidade normal. A tabela 4.1 indica ZF05-10 para bovinos 0102XXXX em BA, GO, MA e MT desde 01/10/2025; a ZF05-20 vegetal está marcada como não ativada em nenhuma UF; a ZF05-30 florestal permanece futura. Essas informações são de validação de autorização e não dispensam a obrigação de guia determinada pela autoridade competente.

Antes de gerar o XML, confirme operação, documento, UF, tipo e data com o responsável e o órgão de origem; depois represente o número verdadeiro e confira a estrutura. Não presuma suporte do emissor ou autorização apenas porque o fragmento passou no XSD. NT, p. 12–14.

Os códigos que identificam a espécie da guia estão em tipo da guia de trânsito.