Índices
01. RESUMO
Este documento tem como objetivo detalhar as especificações para fazer constar na NF-e os dados relativos ao trânsito de produtos animais vivos, vegetais e florestais, mais especificamente o passo a passo para geração das tags <agropecuario> no XML da NF-e (modelo 55) no ERP Protheus, conforme publicado na Nota Técnica 2024.003 v1.06.
Abaixo exemplos das novas tags que serão adicionadas ao XML da NF-e:
Exemplos de tag usando Guia de Transito:
<agropecuario>
<guiaTransito>
<tpGuia>1</tpGuia>
<UFGuia>SP</UFGuia>
<serieGuia>564545465</serieGuia>
<nGuia>156015610</nGuia>
</guiaTransito>
</agropecuario>
</infNFe>
Exemplos de tag usando Defensivo:
<agropecuario>
<defensivo>
<nReceituario>012345678910020561056105656045</nReceituario>
<CPFRespTec>51356666051</CPFRespTec>
</defensivo>
</agropecuario>
02. EXEMPLO DE USO
Pré-requisitos
- Atualizar o RPO e artefatos (schemas) do TSS. Para mais detalhes consultar documentação detalhada: Transmissão de Documentos Eletrônicos
- Atualizar o RPO do ERP Protheus com pacote de fonte disponibilizado:
- Protheus 12.1.2210 (garantia estendida): https://r.totvs.io/p/1215769
- Protheus 12.1.2310 (garantia estendida): https://r.totvs.io/p/1215770
- Protheus 12.1.2410: https://r.totvs.io/p/1215768
- Protheus 12.1.2510: https://r.totvs.io/p/1215789
- Atualização do dicionário de dados (criação de tabelas, índices e campos) conforme informado no tópico 03. ATUALIZAÇÃO DE DICIONÁRIOS DE DADOS.
- No módulo do "Configurador (SIGACFG)", acessar "Ambiente / Cadastros / Parâmetros". Pesquisar pelo parâmetro MV_CADPROD, adicionar o texto "AGRO" ao conteúdo deste parâmetro e salva-lo. Com isso será apresentado a seção de Produtos Agronegócio na cadastro de Produtos.
Exemplo "|SA5|SBZ|SB5|DH5|AGRO".
Cadastro de produtos
No cadastro de produtos (Atualizações / Cadastros / Produtos - MATA010), na aba Outros na seção Produtos Agronegócio informar como 1-Sim o campo Receituário ou o campo Emite Guia. Exemplo:
Após alteração, clicar em Salvar.
Importante
Importante destacar que devem ser seguidos os dados de NCM, CFOP e CSOSN conforme informado na Nota Técnica 2025.003 v1.06.
Documento de entrada - Vinculação dos dados de Guia de Transporte ou Defensivo
Após inclusão do documento de entrada, no módulo "Compras (SIGACOM)", acessar a rotina "Atualizações / Movimentos / Documento de Entrada (MATA103)". Em seguida posicionar no documento no qual se deseja vincular os dados de guia de transporte ou defensivo e clicar no botão "Outras Ações / Dados Guia/Receituário".
Informar os dados necessários e Confirmar. Para os produtos preenchido com "1-Sim" no campo de Emite Guia no cadastro de Produto, será necessário o preenchimento da aba Guia de Transporte.
Pronto, os dados de receituário (defensivo) foi vinculado ao documento.
Documento de saída - Vinculação dos dados de Guia de Transporte ou Defensivo
Após realizar o pedido de venda (utilizando o produto modificado acima) e faturar este pedido de venda, será possível informar os dados do Defensivo ou da Guia de Transito. Para isso, basta entrar no módulo de Faturamento (SIGAFAT) e acessar "Atualizações / Faturamento / Documentos de saída (MATA460A)". Em seguida realizar os filtros necessários e posicionar no documento no qual se deseja vincular os dados de guia de transporte ou defensivo. Agora clicar no botão "Outras Ações / Dados Guia/Receituário".
Informar os dados necessários e Confirmar. Para os produtos preenchido com "1-Sim" no campo de Emite Guia no cadastro de Produto, será necessário o preenchimento da aba Guia de Transporte.
Pronto, os dados de receituário (defensivo) foi vinculado ao documento de saída.
Transmissão do documento eletrônico
No módulo Faturamento (SIGAFAT), acessar "Atualizações / NF-e e NFS-e / NF-e Sefaz (SPEDNFE)". Realizar a transmissão do documento e logo após monitora-lo para ver seu status.
No botão Rec.XML é possível recuperar o XML autorizado.
Note que as novas tags foram incluídas no XML
Importante
Devido ao momento de vinculação da Guia de Transporte ou Receituário (Defensivo), rotinas automáticas de transmissão de NF-e (como o AUTONFE) poderão realizar a transmissão dos documentos eletrônicos sem esta vinculação, desta forma não gerando as tags no XML como o esperado.
Neste cenário é aconselhável o uso do ponto de entrada FISVALNFE para a validar se o documento deve ser ou não considerado para transmissão, utilizando-se do critério se a guia/receituário foi informada ou não.
03. ATUALIZAÇÃO DE DICIONÁRIOS DE DADOS
Pacote de dicionário de dados para utilização via UPDDISTR: https://suporte.totvs.com/portal/p/10098/download?e=1215569
Caso não seja realizado a atualização do dicionário de dados via pacote UPDDISTR, os campos, tabelas e índices poderão ser incluídos manualmente. São eles:
Criação manual dos campos NCR - Produtos Agronegócio
- Campo: NCR_EMREC
| Dado | Conteúdo |
|---|---|
| Campo | NCR_EMREC |
| Tipo | Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Alterar |
| Titulo | Receituario |
| Desc. Português | Emite Receituario |
| Opções | 1=SIM;2=NAO |
| Val. Sistema | Pertence('12') |
| Usado | Sim |
| Módulos | Todos |
- Campo NCR_EMGUIA:
| Dado | Conteúdo |
|---|---|
| Campo | NCR_EMGUIA |
| Tipo | Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Alterar |
| Titulo | Emite Guia |
| Desc. Português | Emite Guia de Transporte |
| Opções | 1=SIM;2=NAO |
| Val. Sistema | Pertence('12') |
| Usado | Sim |
| Módulos | Todos |
Criação de novas tabelas, índices e campos
- NER - Dados Guia/Receituário Entrada
SX2 - Tabela
| Dados | Conteúdo |
|---|---|
| Prefixo | NER |
| Descrição | Dados Guia/Receituario Entrada |
| Modo Filial: | Exclusivo |
SX2 - Tabela
| Dados | Conteúdo |
|---|---|
| Tabela | NER |
| Chave | NER_FILIAL+NER_DOC+NER_SERIE+NER_FORNEC+NER_LOJA+NER_TPVINC+NER_ITEM |
| Descrição: | Documento + Serie Doc + Fornecedor + Loja Fornec + Tipo Vinculo + Item |
| Mostra Pesq. | Sim |
| Visualizado | Não |
| Padrão Sistema | Sim |
SX3 - Campos
| Dado | Conteúdo |
|---|---|
| Campo | NER_FILIAL |
| Tipo | Caracter |
| Tamanho | 8 |
| Decimal | 0 |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | 033 - Tamanho da Filial |
| Titulo | Filial |
| Desc. Português | Filial do Sistema |
| Browse | Sim |
| Dado | Conteúdo |
|---|---|
| Campo | NER_DOC |
| Tipo | Caracter |
| Tamanho | 9 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | 018 - Documento de entrada/saida |
| Titulo | Documento |
| Desc. Português | Numero do Documento |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NER_SERIE |
| Tipo | Caracter |
| Tamanho | 3 |
| Decimal | 0 |
| Formato | !!! |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | 094 - Id de Controle dos doc.fiscais |
| Titulo | Serie Doc |
| Desc. Português | Serie Documento Entrada |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NER_FORNEC |
| Tipo | Caracter |
| Tamanho | 6 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | 001 - Codigo Cliente/Fornecedor |
| Titulo | Fornecedor |
| Desc. Português | Fornecedor da Nota Fiscal |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NER_LOJA |
| Tipo | Caracter |
| Tamanho | 2 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | 002 - Loja Cliente/Fornecedor |
| Titulo | Loja Fornec |
| Desc. Português | Loja do Fornecedor |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NER_TPVINC |
| Tipo | Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | |
| Titulo | Tipo Vinculo |
| Desc. Português | Tipo de Vinculo |
| Lista opções | 1=Receituario;2=Guia de Transporte |
| Val. Sistema | Pertence("12") |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NER_ITEM |
| Tipo | Caracter |
| Tamanho | 3 |
| Decimal | 0 |
| Formato | |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | |
| Titulo | Item |
| Desc. Português | Item |
| Lista opções | |
| Val. Sistema | |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NER_NUMREC |
| Tipo | Caracter |
| Tamanho | 30 |
| Decimal | 0 |
| Formato | |
| Contexto | Real |
| Propriedade | Alterar |
| Grupo de Campos | |
| Titulo | Num. Receita |
| Desc. Português | Numero Receituario |
| Lista opções | |
| Val. Sistema | |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NER_CGC |
| Tipo | Caracter |
| Tamanho | 14 |
| Decimal | 0 |
| Formato | @R! NN.NNN.NNN/NNNN-99 |
| Contexto | Real |
| Propriedade | Alterar |
| Grupo de Campos | |
| Titulo | Resp Tecnico |
| Desc. Português | CGC/CPF |
| Lista opções | |
| Val. Sistema | CGC(M->NER_CGC) |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NER_TPGUIA |
| Tipo | Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | |
| Contexto | Real |
| Propriedade | Alterar |
| Grupo de Campos | |
| Titulo | Tipo da Guia |
| Desc. Português | Tipo de Guia de Transito |
| Cons. Padrão | KJ - Tipos de Guia de Transporte |
| Val. Sistema | ExistCpo("SX5","KJ"+M->NER_TPGUIA) |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NER_UF |
| Tipo | Caracter |
| Tamanho | 2 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Alterar |
| Grupo de Campos | 010 - Estado |
| Titulo | Estado Guia |
| Desc. Português | UF da Guia de Transito |
| Cons. Padrão | 12 - Unidade Federativa |
| Val. Sistema | ExistCpo("SX5","12"+M->NER_UF) |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NER_SERGUI |
| Tipo | Caracter |
| Tamanho | 9 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Alterar |
| Grupo de Campos | |
| Titulo | Serie.Guia |
| Desc. Português | Serie da Guia de Transito |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NER_NUMGUI |
| Tipo | Caracter |
| Tamanho | 9 |
| Decimal | 0 |
| Formato | |
| Contexto | Real |
| Propriedade | Alterar |
| Grupo de Campos | |
| Titulo | Numero Guia |
| Desc. Português | Numero da Guia de Transit |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
- NES - Dados Guia/Receituário Saída
SX2 - Tabela
| Dados | Conteúdo |
|---|---|
| Prefixo | NES |
| Descrição | Dados Guia/Receituario Saída |
| Modo Filial: | Exclusivo |
SX2 - Tabela
| Dados | Conteúdo |
|---|---|
| Tabela | NES |
| Chave | NES_FILIAL+NES_DOC+NES_SERIE+NES_CLIENT+NES_LOJA+NES_TPVINC+NES_ITEM |
| Descrição: | Num.Docto + Serie NF + Cod.Cliente + Loj.Cli + Tipo Vinculo + Item |
| Mostra Pesq. | Sim |
| Visualizado | Não |
| Padrão Sistema | Sim |
SX3 - Campos
| Dado | Conteúdo |
|---|---|
| Campo | NES_FILIAL |
| Tipo | Caracter |
| Tamanho | 8 |
| Decimal | 0 |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | 033 - Tamanho da Filial |
| Titulo | Filial |
| Desc. Português | Filial do Sistema |
| Browse | Sim |
| Dado | Conteúdo |
|---|---|
| Campo | NES_DOC |
| Tipo | Caracter |
| Tamanho | 9 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | 018 - Documento de entrada/saida |
| Titulo | Num.Docto |
| Desc. Português | Numero do Documento |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NES_SERIE |
| Tipo | Caracter |
| Tamanho | 3 |
| Decimal | 0 |
| Formato | !!! |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | 094 - Id de Controle dos doc.fiscais |
| Titulo | Serie NF |
| Desc. Português | Serie NF |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NES_CLIENT |
| Tipo | Caracter |
| Tamanho | 6 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | 001 - Codigo Cliente/Fornecedor |
| Titulo | Cod.Cliente |
| Desc. Português | Codigo Cliente |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NES_LOJA |
| Tipo | Caracter |
| Tamanho | 2 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | 002 - Loja Cliente/Fornecedor |
| Titulo | Loj.Cli |
| Desc. Português | Loja Cliente |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NES_TPVINC |
| Tipo | Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | |
| Titulo | Tipo Vinculo |
| Desc. Português | Tipo de Vinculo |
| Lista opções | 1=Receituario;2=Guia de Transporte |
| Val. Sistema | Pertence("12") |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NES_ITEM |
| Tipo | Caracter |
| Tamanho | 3 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Visualizar |
| Grupo de Campos | |
| Titulo | Item |
| Desc. Português | Item |
| Lista opções | |
| Val. Sistema | |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NES_NUMREC |
| Tipo | Caracter |
| Tamanho | 30 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Alterar |
| Grupo de Campos | |
| Titulo | Num. Receita |
| Desc. Português | Numero Receituario |
| Lista opções | |
| Val. Sistema | |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NES_CGC |
| Tipo | Caracter |
| Tamanho | 14 |
| Decimal | 0 |
| Formato | @R! NN.NNN.NNN/NNNN-99 |
| Contexto | Real |
| Propriedade | Alterar |
| Grupo de Campos | |
| Titulo | CNPJ/CPF |
| Desc. Português | CNPJ/CPF Responsavel Tec. |
| Lista opções | |
| Val. Sistema | CGC(M->NES_CGC) |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NES_TPGUIA |
| Tipo | Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Alterar |
| Grupo de Campos | |
| Titulo | Tp.Guia |
| Desc. Português | Tipo Guia Transito |
| Cons. Padrão | KJ - Tipos de Guia de Transporte |
| Val. Sistema | ExistCpo("SX5","KJ"+M->NES_TPGUIA) |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NES_UF |
| Tipo | Caracter |
| Tamanho | 2 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Alterar |
| Grupo de Campos | 010 - Estado |
| Titulo | Estado Guia |
| Desc. Português | Estado Guia |
| Cons. Padrão | 12 - Unidade Federativa |
| Val. Sistema | ExistCpo("SX5","12"+M->NES_UF) |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NES_NUMGUI |
| Tipo | Caracter |
| Tamanho | 9 |
| Decimal | 0 |
| Formato | @! |
| Contexto | Real |
| Propriedade | Alterar |
| Grupo de Campos | |
| Titulo | Numero Guia |
| Desc. Português | Numero da Guia Transito |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
| Dado | Conteúdo |
|---|---|
| Campo | NES_SERGUI |
| Tipo | Caracter |
| Tamanho | 9 |
| Decimal | 0 |
| Formato | |
| Contexto | Real |
| Propriedade | Alterar |
| Grupo de Campos | |
| Titulo | Serie Guia T |
| Desc. Português | Serie Guia de Transito |
| Usado | Sim |
| Browse | Sim |
| Módulos | Todos os módulos |
SX5 - Tabela Genéricas
Incluir os seguintes dados na tabela genérica (SX5):
Tabela: 00
Chave: KJ
Descrição: Tipos de Guia de Transporte
Itens:
| Chave | Descrição |
|---|---|
| 1 | GTA - GUIA DE TRANSITO ANIMAL |
| 2 | TTA - TERMO DE TRANSITO ANIMAL |
| 3 | DTA - DOCUMENTO DE TRANSFERENCIA ANIMAL |
| 4 | ATV - AUTORIZACAO DE TRANSITO VEGETAL |
| 5 | PTV - PERMISSAO DE TRANSITO VEGETAL |
| 6 | GTV - GUIA DE TRANSITO VEGETAL |
| 7 | GUIA FLORESTAL (DOF, SISFLORA - PA E MT OU SIAM-MG) |
04. TABELAS USADAS
- SB1 - Descrição Genérica do Produto
- NCR - Produtos Agronegócio
- NER - Dados Guia/Receituário Entrada
- NES - Dados Guia/Receituário Saída
- SX5 - Tabelas Genéricas



















































