Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Índices

Índice


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> disponibilizadas no XML da NF-e (modelo 55) no ERP Protheus, conforme publicado na Nota Técnica 2024.003 versão 1v1.06 de NF-e..

Abaixo exemplos das novas tags que serão adicionadas ao XML da NF-e:

Exemplos de tag Exemplos de tag usando Guia de TransporteTransito:

<agropecuario>
            <guiaTransito>
                <tpGuia>1</tpGuia>
                <UFGuia>SP</UFGuia>
                <serieGuia>564545465</serieGuia>
                <nGuia>156015610</nGuia>
            </guiaTransito>
        </agropecuario>
    </infNFe>

...

    <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
  3. sistema
  4. RPO do ERP Protheus com pacote de fonte disponibilizado
  5. aqui [Alterar esse link]
  6. 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.
  7. No módulo do "Configurador (SIGACFG)", acessar "Base de Dados/ Dicionário / Base de Dados". Pesquisar pela tabela NCR e clicar em "Editar". Na seção de campos, marcar a opção de Usado.
    ● NCR_EMREC - Configurar como campo usado

● NCR_EMGUIA - Configurar como campo usado

Image Removed

  1. :
    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
  2. 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.
  3. No módulo do "Configurador (SIGACFG)", acessar
  4. No módulo do "Configurador (SIGACFG)", acessar
  5. "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 conforme exemplo. Exemplo:

Após alteração, clicar em Salvar.

Documento de entrada - Vinculação dos dados de Guia de Transporte ou Defensivo

dsds


Aviso
titleImportante

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 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 (MATA460Ainclusão do documento de entrada, no módulo "Compras (SIGACOM)", acessar a rotina "Atualizações / Movimentos / Documento de Entrada (MATA103)". Em seguida realizar os filtros necessários e posicionar no documento que no qual se deseja vincular os dados de guia de transporte ou defensivo .  Agora e clicar no botão "Outras Ações / Dados Guia/Receituário".

Image RemovedImage Added


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.


Image RemovedImage Added

Pronto, os dados de receituário (defensivo) está foi vinculado ao documento.


Documento de saída .

Transmissão do documento eletrônico

- 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 No módulo  Faturamento (SIGAFAT) , e 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.

Image Removed

No botão Rec.XML é possível recuperar o XML autorizado.

Image Removed

Note que as novas tags foram incluídas no XML

Image Removed

...

Atualização de Campos

Para o correto funcionamento da rotina de Vinculação de guias de transporte e receituário, deve-se incluir os campos abaixo na tabela já existente do sistema NCR - Produtos Agronegócio:

  • Campo: NCR_EMREC 

...

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".

Image Added


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.

Image Added

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.

Image Added

No botão Rec.XML é possível recuperar o XML autorizado.

Image Added

Note que as novas tags foram incluídas no XML

Image Added



Aviso
titleImportante

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
Âncora
03
03

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 

Image Removed

Image Removed

Image Removed

Image Removed

Image Removed

Image Removed

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

Image RemovedImage Added

Image RemovedImage Added

Image RemovedImage Added

Image RemovedImage Added

Image RemovedImage Added

Image Removed

Criação de tabelas, índices e campos

  • NER - Dados Guia/Receituário Entrada

SX2 - Tabela

...

Image Removed

SX2 - Tabela

...

Image Added


  • 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

Image Added

Image Added

Image Added

Image Added

Image Added

Image Added


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

Image Added


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

Image Added


SX3 - Campos

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

Image Added

Image Removed

SX3 - Campos

...

Image Removed

...

Image Removed


SERIE 3!! 094 Id de Controle dos doc.fiscaisSerie Doc Serie Documento Entrada  
DadoConteúdo
CampoNER_
DOC
TipoCaracter
Tamanho
9
Decimal0
Formato@!
                                          
ContextoReal
PropriedadeVisualizar
Grupo de Campos
018 -
Documento de entrada/saida
Titulo
Documento   
Desc. Português
Numero do Documento           
UsadoSim
BrowseSim
MódulosTodos os módulos

Image RemovedImage Added


DadoConteúdo
CampoNER_FORNECSERIE 
TipoCaracter
Tamanho63
Decimal0
Formato@!!!                                           
ContextoReal
PropriedadeVisualizar
Grupo de Campos001 - Codigo Cliente/Fornecedor094 - Id de Controle dos doc.fiscais
TituloFornecedor  Serie Doc   
Desc. PortuguêsFornecedor da Nota FiscalSerie Documento Entrada  
UsadoSim
BrowseSim
MódulosTodos os módulos

Image RemovedImage Added


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

Image RemovedImage Added


DadoConteúdo
CampoNER_TPVINCLOJA  
TipoCaracter
Tamanho12
Decimal0
Formato@!                                           
ContextoReal
PropriedadeVisualizar
Grupo de Campos002 - Loja Cliente/Fornecedor
TituloLoja Fornec TituloTipo Vinculo
Desc. PortuguêsTipo de Vinculo
Lista opções1=Receituario;2=Guia de Transporte
Val. SistemaPertence("12")
Loja do Fornecedor       
UsadoSim
BrowseSim
MódulosTodos os módulos

Image RemovedImage Added


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

Image RemovedImage Added


DadoConteúdo
CampoNER_NUMRECITEM  
TipoCaracter
Tamanho303
Decimal0
Formato
ContextoReal
PropriedadeAlterarVisualizar
Grupo de Campos
TituloNum. ReceitaItem        
Desc. PortuguêsNumero Receituario Item           
Lista opções
Val. Sistema
UsadoSim
BrowseSim
MódulosTodos os módulos

Image RemovedImage Added


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

Image RemovedImage Added


DadoConteúdo
CampoNER_TPGUIACGC   
TipoCaracter
Tamanho114
Decimal0
Formato
ContextoReal
@R! NN.NNN.NNN/NNNN-99 
ContextoReal
PropriedadePropriedadeAlterar
Grupo de Campos
TituloTipo da GuiaResp Tecnico
Desc. PortuguêsTipo de Guia de Transito 
Cons. PadrãoKJ - Tipos de Guia de Transporte
CGC/CPF                  
Lista opções
Val. SistemaCGC(M->NER_CGC)
UsadoSim
BrowseSim
MódulosTodos os módulos

Image Added


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

Image Added


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

Image Added


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

Image Added


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

Image Added



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


SX2 - Tabela

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

Image Added


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

Image Added


SX3 - Campos

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

Image Added


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

Image Added


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

Image Added


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

Image Added


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

Image Added


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

Image Added


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

Image Added


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

Image Added


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

Image Added


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)                                                                                                                              ExistCpo("SX5","KJ"+M->NER_TPGUIA)
UsadoSim
BrowseSim
MódulosTodos os módulos

Image RemovedImage Added


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

Image Added


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

Image RemovedImage Added


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

Image Removed

...

Image Added


SX5 - Tabela Genéricas

Incluir os seguintes dados na tabela genérica (SX5):


Tabela: 00

Chave: KJ

Descrição: Tipos de Guia de Transporte                            

Image Added


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)    


Image Added




Image Removed

04.  XXXX SCREEN

Main Fields and Parameters

...

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