Árvore de páginas

Í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

  1. Atualizar o RPO e artefatos (schemas) do TSS. Para mais detalhes consultar documentação detalhada: Transmissão de Documentos Eletrônicos
  2. Atualizar o RPO do ERP Protheus com pacote de fonte disponibilizado:
    1. Protheus 12.1.2210 (garantia estendida): https://r.totvs.io/p/1215769 
    2. Protheus 12.1.2310 (garantia estendida): https://r.totvs.io/p/1215770
    3. Protheus 12.1.2410: https://r.totvs.io/p/1215768
    4. Protheus 12.1.2510: https://r.totvs.io/p/1215789
  3. 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.
  4. 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 
DadoConteúdo
CampoNCR_EMREC 
TipoCaracter
Tamanho1
Decimal0
Formato@!
ContextoReal
PropriedadeAlterar
TituloReceituario 
Desc. PortuguêsEmite Receituario        
Opções1=SIM;2=NAO
Val. SistemaPertence('12')
UsadoSim
MódulosTodos


  • Campo NCR_EMGUIA:
DadoConteúdo
CampoNCR_EMGUIA
TipoCaracter
Tamanho1
Decimal0
Formato@!
ContextoReal
PropriedadeAlterar
TituloEmite Guia  
Desc. PortuguêsEmite Guia de Transporte 
Opções1=SIM;2=NAO
Val. SistemaPertence('12')
UsadoSim
MódulosTodos


Criação de novas tabelas, índices e campos


  • NER - Dados Guia/Receituário Entrada


SX2 - Tabela

DadosConteúdo
PrefixoNER
DescriçãoDados Guia/Receituario Entrada
Modo Filial:Exclusivo


SX2 - Tabela

DadosConteúdo
TabelaNER
ChaveNER_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
VisualizadoNão
Padrão SistemaSim


SX3 - Campos

DadoConteúdo
CampoNER_FILIAL
TipoCaracter
Tamanho8
Decimal0
ContextoReal
PropriedadeVisualizar
Grupo de Campos033 - Tamanho da Filial
TituloFilial
Desc. PortuguêsFilial do Sistema        
BrowseSim


DadoConteúdo
CampoNER_DOC
TipoCaracter
Tamanho9
Decimal0
Formato@!                                           
ContextoReal
PropriedadeVisualizar
Grupo de Campos018 - Documento de entrada/saida
TituloDocumento   
Desc. PortuguêsNumero do Documento           
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNER_SERIE 
TipoCaracter
Tamanho3
Decimal0
Formato!!!                                           
ContextoReal
PropriedadeVisualizar
Grupo de Campos094 - Id de Controle dos doc.fiscais
TituloSerie Doc   
Desc. PortuguêsSerie Documento Entrada  
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNER_FORNEC
TipoCaracter
Tamanho6
Decimal0
Formato@!                                           
ContextoReal
PropriedadeVisualizar
Grupo de Campos001 - Codigo Cliente/Fornecedor
TituloFornecedor  
Desc. PortuguêsFornecedor da Nota Fiscal
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNER_LOJA  
TipoCaracter
Tamanho2
Decimal0
Formato@!                                           
ContextoReal
PropriedadeVisualizar
Grupo de Campos002 - Loja Cliente/Fornecedor
TituloLoja Fornec 
Desc. PortuguêsLoja do Fornecedor       
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNER_TPVINC
TipoCaracter
Tamanho1
Decimal0
Formato
ContextoReal
PropriedadeVisualizar
Grupo de Campos
TituloTipo Vinculo
Desc. PortuguêsTipo de Vinculo
Lista opções1=Receituario;2=Guia de Transporte
Val. SistemaPertence("12")
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNER_ITEM  
TipoCaracter
Tamanho3
Decimal0
Formato
ContextoReal
PropriedadeVisualizar
Grupo de Campos
TituloItem        
Desc. PortuguêsItem        
Lista opções
Val. Sistema
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNER_NUMREC
TipoCaracter
Tamanho30
Decimal0
Formato
ContextoReal
PropriedadeAlterar
Grupo de Campos
TituloNum. Receita
Desc. PortuguêsNumero Receituario       
Lista opções
Val. Sistema
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNER_CGC   
TipoCaracter
Tamanho14
Decimal0
Formato@R! NN.NNN.NNN/NNNN-99 
ContextoReal
PropriedadeAlterar
Grupo de Campos
TituloResp Tecnico
Desc. PortuguêsCGC/CPF                  
Lista opções
Val. SistemaCGC(M->NER_CGC)
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNER_TPGUIA
TipoCaracter
Tamanho1
Decimal0
Formato
ContextoReal
PropriedadeAlterar
Grupo de Campos
TituloTipo da Guia
Desc. PortuguêsTipo de Guia de Transito 
Cons. PadrãoKJ - Tipos de Guia de Transporte
Val. SistemaExistCpo("SX5","KJ"+M->NER_TPGUIA)
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNER_UF    
TipoCaracter
Tamanho2
Decimal0
Formato@!
ContextoReal
PropriedadeAlterar
Grupo de Campos010 - Estado
TituloEstado Guia 
Desc. PortuguêsUF da Guia de Transito   
Cons. Padrão12 - Unidade Federativa
Val. SistemaExistCpo("SX5","12"+M->NER_UF)                                                                                                                                  
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNER_SERGUI
TipoCaracter
Tamanho9
Decimal0
Formato@!
ContextoReal
PropriedadeAlterar
Grupo de Campos
TituloSerie.Guia  
Desc. PortuguêsSerie da Guia de Transito
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNER_NUMGUI
TipoCaracter
Tamanho9
Decimal0
Formato
ContextoReal
PropriedadeAlterar
Grupo de Campos
TituloNumero Guia 
Desc. PortuguêsNumero da Guia de Transit
UsadoSim
BrowseSim
MódulosTodos os módulos



  • NES - Dados Guia/Receituário Saída


SX2 - Tabela

DadosConteúdo
PrefixoNES
DescriçãoDados Guia/Receituario Saída
Modo Filial:Exclusivo


SX2 - Tabela

DadosConteúdo
TabelaNES
ChaveNES_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
VisualizadoNão
Padrão SistemaSim


SX3 - Campos

DadoConteúdo
CampoNES_FILIAL
TipoCaracter
Tamanho8
Decimal0
ContextoReal
PropriedadeVisualizar
Grupo de Campos033 - Tamanho da Filial
TituloFilial
Desc. PortuguêsFilial do Sistema        
BrowseSim


DadoConteúdo
CampoNES_DOC   
TipoCaracter
Tamanho9
Decimal0
Formato@!                                           
ContextoReal
PropriedadeVisualizar
Grupo de Campos018 - Documento de entrada/saida
TituloNum.Docto   
Desc. PortuguêsNumero do Documento           
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNES_SERIE
TipoCaracter
Tamanho3
Decimal0
Formato!!!                                           
ContextoReal
PropriedadeVisualizar
Grupo de Campos094 - Id de Controle dos doc.fiscais
TituloSerie NF    
Desc. PortuguêsSerie NF                 
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNES_CLIENT
TipoCaracter
Tamanho6
Decimal0
Formato@!                                           
ContextoReal
PropriedadeVisualizar
Grupo de Campos001 - Codigo Cliente/Fornecedor
TituloCod.Cliente   
Desc. PortuguêsCodigo Cliente           
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNES_LOJA  
TipoCaracter
Tamanho2
Decimal0
Formato@!                                           
ContextoReal
PropriedadeVisualizar
Grupo de Campos002 - Loja Cliente/Fornecedor
TituloLoj.Cli     
Desc. PortuguêsLoja Cliente             
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNES_TPVINC
TipoCaracter
Tamanho1
Decimal0
Formato@!                                           
ContextoReal
PropriedadeVisualizar
Grupo de Campos
TituloTipo Vinculo
Desc. PortuguêsTipo de Vinculo
Lista opções1=Receituario;2=Guia de Transporte
Val. SistemaPertence("12")
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNES_ITEM  
TipoCaracter
Tamanho3
Decimal0
Formato@!                                           
ContextoReal
PropriedadeVisualizar
Grupo de Campos
TituloItem        
Desc. PortuguêsItem        
Lista opções
Val. Sistema
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNES_NUMREC
TipoCaracter
Tamanho30
Decimal0
Formato@!                                           
ContextoReal
PropriedadeAlterar
Grupo de Campos
TituloNum. Receita
Desc. PortuguêsNumero Receituario       
Lista opções
Val. Sistema
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNES_CGC   
TipoCaracter
Tamanho14
Decimal0
Formato@R! NN.NNN.NNN/NNNN-99 
ContextoReal
PropriedadeAlterar
Grupo de Campos
TituloCNPJ/CPF    
Desc. PortuguêsCNPJ/CPF Responsavel Tec.
Lista opções
Val. SistemaCGC(M->NES_CGC)
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNES_TPGUIA
TipoCaracter
Tamanho1
Decimal0
Formato@!                                           
ContextoReal
PropriedadeAlterar
Grupo de Campos
TituloTp.Guia     
Desc. PortuguêsTipo Guia Transito       
Cons. PadrãoKJ - Tipos de Guia de Transporte
Val. SistemaExistCpo("SX5","KJ"+M->NES_TPGUIA)                                                                                                                              
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNES_UF    
TipoCaracter
Tamanho2
Decimal0
Formato@!
ContextoReal
PropriedadeAlterar
Grupo de Campos010 - Estado
TituloEstado Guia 
Desc. PortuguêsEstado Guia              
Cons. Padrão12 - Unidade Federativa
Val. SistemaExistCpo("SX5","12"+M->NES_UF)                                                                                                                                  
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNES_NUMGUI
TipoCaracter
Tamanho9
Decimal0
Formato@!
ContextoReal
PropriedadeAlterar
Grupo de Campos
TituloNumero Guia 
Desc. PortuguêsNumero da Guia Transito  
UsadoSim
BrowseSim
MódulosTodos os módulos


DadoConteúdo
CampoNES_SERGUI
TipoCaracter
Tamanho9
Decimal0
Formato
ContextoReal
PropriedadeAlterar
Grupo de Campos
TituloSerie Guia T
Desc. PortuguêsSerie Guia de Transito   
UsadoSim
BrowseSim
MódulosTodos 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:

ChaveDescrição
1                       GTA - GUIA DE TRANSITO ANIMAL                          
2TTA - TERMO DE TRANSITO ANIMAL                         
3DTA - DOCUMENTO DE TRANSFERENCIA ANIMAL                
4ATV - AUTORIZACAO DE TRANSITO VEGETAL                  
5PTV - PERMISSAO DE TRANSITO VEGETAL                    
6GTV - GUIA DE TRANSITO VEGETAL                         
7GUIA 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