Envio de receituário via eDocs - IDAF (ES)

Esta documentação tem como objetivo explicar o processo de comunicação entre o ERP (Gestão Empresarial | ERP) e o sistema do Instituto de Defesa Agropecuária e Florestal do Espírito Santo, por meio do eDocs.

Conforme Instrução Normativa nº 013, de 03 de dezembro de 2020, a emissão de receituário, que tem destino de aplicação em solo espírito-santense (ou seja, pode vir de outra UF), deve ser comunicada ao IDAF, que é a autarquia responsável pelo controle dos receituários. Ao emitir ou cancelar uma receita na tela de Emissão da receita agronômica (F113REM), será possível transmitir essa situação para o eDocs, que irá comunicar ao IDAF sobre a ação realizada. Após isso, a agência irá autorizar, ou não, o receituário e a informação será devolvida ao ERP.

Parametrizações ERP (Gestão Empresarial | ERP)

• Responsável técnico vinculado ao cadastro de usuário
• Identificação do Responsável Técnico
• Responsável por Filial

Requisitos de comunicação com o eDocs

Na tela Parâmetros de Integração (F191CPT), deve-se configurar os parâmetros de comunicação com o eDocs, informando a URL, o usuário e a senha.

Requisitos de Receituário Agronômico

O IDAF exige o preenchimento de diversas características de receituário, sendo que os termos que definem essas características podem variar dependendo da UF. Segue, abaixo, lista com os campos exigidos, bem como a fonte de informação no ERP:

Lista de Campos Exigidos

 

Campo	Descrição	Campo Origem	Tela de Cadastro
tpAmbiente	1-Produção; 2-Homologação	Valor Fixo 1
nrControle	Código de controle interno	E113REM.SeqRem
cpfTecnico	CPF do técnico da receita	E113RTC.CgcCpf
tpVinculoTec	Vínculo com alguma revenda. 1-Sim; 2-Não	Valor Fixo 1
nrReceita	Número do receituário.	E113REF.NumRec	Tela de Emissão de Receitas (F113REM) -campo Número da Receita
dhEmissao	Data de Emissão	E113REM.DatRec
nrArt	Número da ART.	E113REF.NumArt	Tela de Emissão da Receita Agronômica (F113REM), campo Número da ART
nrDocProdutor	Número do Doc. Produtor/Comprador	E085CLI.CgcCpf
nmProdutor	Nome Produtor/Comprador	E085CLI.NomCli
nmPropriedade	Nome da Propriedade da Receita	E113REM.LocApl
cdMunicipioIBGE	Código IBGE	E085ENT.CodIbg
nrUTME	Coordenada E Sistema UTM	E085ENT.VlrLat ou E085CLI.VlrLat
nrUTMN	Coordenada N Sistema UTM	E085ENT.VlrLon ou E085CLI.VlrLon
cnpjComerciante	CNPJ do Comerciante, se tpVinculo=1	E075FIL.NumCgc
nmComerciante	Razão Social comerciante, se tpVinculo=1	E075FIL.NomFil
tpAssinatura	Tipo de Assinatura da Receita / Valor Fixo D (Digital), E (Eletrônica) ou M (Manual)		Tela F113RPF - Responsável técnico X Filial
xFile	Valor Fixo Gerado
ds_obs	Observações pertinentes a receita
xMotivo	Justificativa do envio da receita após o prazo legal de 72h
nProt <Retorno>	Número do protocolo gerado	E113REM.ProRem
itens[Seq]	Identificador do Item	E113REI.SeqRei
itens[nrRegistroMAPA]	Código do registro MAPA	E113BUL.CodMap
itens[cdUnidade]	Código da Unidade	E113UME.CodPuf
itens[qdAdquirir]	Quantidade Prescrita	E113REI.QtdRei
itens[qArea]	Área de Aplicação	E113REI.VlrAre
itens[qAdquirida]	Quantidade Adquirida	E140IPV.QtdVen / E120PED.QtdPed / E113REI.QtdRei
itens[uAdquirida]	Unidade adquirida	E113UME
itens[dsTecnologia]	Tecnologia utilizada	E113APT.DesApt
itens[cdTpAplicacao]	Código da Aplicação	E113APT.CodApt
itens[cdCultura]	Código da Cultura	E113EPE.CodPuf
itens[cdEPPO]	Código EPPO da praga	E113DIE.CodPuf
itens[nmEPPOCientifico]	Nome Científico ao código EPPO	E113DPP.DesCie
itens[cpfTecnico]	CPF do Técnico	E113RTC.CgcCpf

Observação

A informação do JSON é gerada através do ERP (Gestão Empresarial | ERP), o eDocs apenas busca a informação.

Armazenamento de Logs

Como acessar os logs

1. Após realizar a emissão do receituário, todos os logs são salvos na pasta informada no campo Local de logs da Central de Configurações Senior.
   
   
2. Após a emissão do receituário, é apresentada uma mensagem de confirmação e através dela o ERP exibe o log em uma tela personalizada.
   
   
3. Nessa tela é possível salvar o arquivo, editar, formatar.
   

Gravação de log

A gravação do log acontece no momento de retorno da chamada entre o ERP e o eDocs, o mesmo sempre será gravado por documento (receituário).

Log XML e Logs de texto do eDocs

eDocs:

No eDocs a forma mais fácil de verificar as inconsistências é através da tela de Eventos do Documento. Acesse: eDocs > Agronegócio > guia Emissões > botão Eventos

Essa tela apresenta as críticas ocorrida no momento da emissão.

ERP

O log no arquivo xml pode ser visualizado na tag <xmlRetorno> e subtag <Mensagem>. Nessa tag contém as crítica de inconsistência ocorrida no envio do documento.

Exemplo Crítica:

Exemplo Sucesso:

Fluxo de exemplo do envio do Receituário Agronômico ao eDocs

Transmissão de Receita Emitida

Para que a transmissão possa ser feita, a situação da receita precisa estar como Emitida e com aplicação destinada ao estado de Espírito Santo. A transmissão pode ocorrer em dois momentos:

• no final do processo de Emitir Receitas: irá ocorrer a troca da situação das receitas selecionadas para Emitida (4). Após isso, será feita uma análise no conjunto de registros selecionados, para identificar os que devem ser transmitidos para o IDAF. Ao enviar, uma tentativa de transmissão será disparada e o número de protocolo que identifica a operação será salvo. Se houver sucesso na transmissão, a situação da receita será trocada para Enviada (5).
• por meio do botão Enviar Receitas: é uma alternativa que pode ser usada para transmitir receitas em momento diferente da emissão, por decisão do usuário ou por conta de algum problema na comunicação.
  Obs.: embora a transmissão para o IDAF seja específica para receitas aplicadas em Espírito Santo, o botão Enviar Receitas ficará habilitado para receitas que não são desse estado, pois podem haver registros misturados na listagem. Porém, a transmissão efetiva à autarquia só irá acontecer para as receitas adequadas ao contexto (os logs serão somente para elas).

Transmissão da Receita Cancelada

Transmitir o cancelamento de receitas somente estará disponível a partir da situação Enviada. A troca da situação para Cancelada (3) acontecerá se a cadeia de comunicação com a autarquia for concretizada. Caso falhe, a situação da receita permanecerá como está.