Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Responsável técnico, NFF, agro e PAA

serieGuia: série da guia de trânsito, distinta da série da NF-e

<serieGuia>agropecuario › guiaTransito › serieGuia

Revisã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