serieGuia: série da guia de trânsito, distinta da série da NF-e
<serieGuia>agropecuario › guiaTransito › serieGuiaRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
serieGuia identifica a série da guia de trânsito em agropecuario/guiaTransito. A série pertence ao documento agropecuário ou florestal de origem; ela não é a série fiscal ide/serie da NF-e.
Caminho desta ocorrência: /nfeProc/NFe/infNFe/agropecuario/guiaTransito/serieGuia.
Quando informar e quando omitir
A NT determina informar sempre que houver série da guia. A ocorrência 0–1 no XSD permite omitir quando o documento efetivamente não tem série; não autoriza descartar uma série existente ou substituí-la por zero.
O grupo continua exigindo tpGuia, UFGuia e nGuia. A série ajuda a identificar a guia com seu tipo, UF de emissão e número. Consulte esses dados no documento original, não no cadastro da numeração fiscal da NF-e. NT 2024.003 v1.10, ZF04–08, p. 8–9.
Texto de 1 a 9 caracteres não é apenas um número
Fragmento sintético parcial de série fictícia alfanumérica:
<serieGuia xmlns="http://www.portalfiscal.inf.br/nfe">AB-01</serieGuia>
O campo restringe TString a um a nove caracteres; portanto, não tem o mesmo padrão apenas numérico de nGuia. Preserve letras, zeros e sinais que pertençam à série real, dentro da representação permitida. O tipo preserva espaços e exige texto com caracteres válidos nas extremidades; um elemento vazio ou somente com espaços não representa uma série ausente.
Se não há série, omita o elemento. Se há série incompatível com o tamanho/tipo, confirme o dado e o documento: não corte o texto nem invente outra identificação. XSD PL 010f v1.04, serieGuia e TString.
Como conferir a série no grupo correto
A ordem é tpGuia, UFGuia, serieGuia quando existente, e nGuia. Colocar a série depois do número viola essa sequência. O fragmento desta página é parcial, sem pretensão de ser uma NF-e completa.
Para uma guia real, compare o conjunto com o arquivo gerado: tipo documental, UF que emitiu a guia, série exata e número. A 10ZF04-10/837 trata de guia inválida no banco integrado da SEFAZ com o órgão estadual; passar na validação de texto não comprova existência ou adequação da guia. NT, p. 13.
Exigência da guia e próximo passo técnico
A família de regras é de NF-e 55, com adoção facultativa por UF e condições de produto/NCM/CFOP. A tabela 4.1 registra ZF05-10 de bovinos 0102XXXX em BA, GO, MA e MT desde 01/10/2025; a validação vegetal ZF05-20 não está ativada em nenhuma UF e a florestal ZF05-30 é futura. Essas condições não autorizam dispensar uma guia exigida pelo órgão competente.
Se o erro é estrutural, corrija sequência ou serialização da série verdadeira. Se a identificação diverge da guia, confirme documento e órgão de origem antes de ajustar o cadastro. Não mude a série fiscal da NF-e para resolver a série agropecuária e não reenvie documento autorizado por tentativa. NT, p. 12–14.
Para conferir o outro componente de identificação sem perder zeros, consulte número da guia de trânsito.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/agropecuario/guiaTransito/serieGuia- 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
9- minLength
1- pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}- whiteSpace
preserve