Envio de receituário via eDocs - INDEA (MT)

Esta documentação tem como objetivo explicar o processo de comunicação entre o ERP (Gestão Empresarial | ERP) e o Sistema de Defesa Vegetal do Estado de Mato Grosso, por meio do eDocs.

Conforme Instrução Normativa nº 006/2018, a emissão de receituário, que tem destino de aplicação em solo mato-grossense (ou seja, pode vir de outra UF), deve ser comunicada ao INDEA, 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 INDEA 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.

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 INDEA 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
cpfAgronomico	CPF do agrônomo responsável pela emissão da receita.	E113RTC.CgcCpf	Tela de Cadastro do Responsável Técnico (F113RTC), campo CNPJ/CPF
nrReceita	Número do receituário.	E113REF.NumRec	Tela de Emissão de Receitas (F113REM) -campo Número da Receita
nrArt	Número da ART.	E113REF.NumArt	Tela de Emissão da Receita Agronômica (F113REM), campo Número da ART
itens[codRegMapaAgrotoxico]	Código de registro do produto junto ao MAPA.	E113BUL.CodMap	Tela de Bula (F113BUL), campo Registro Mapa
itens[codUnidadeMedida]	Código da unidade de medida junto ao INDEA referente ao campo areaTratada.	E113UME.CodPuf	Tela de Unidade de Medida da Dose (F113UMD), campo Código por estado
itens[codTipoAplicacao]	Código do tipo de aplicação junto ao INDEA.	E113APT.CodApt	Tela de Tipo Aplicação (F113APT), campo Código
itens[codCultura]	Código da cultura junto ao INDEA.	E113EPE.CodPuf	Tela de Ligação de Espécie/Cultura x Estado (F113EPE), campo Código por estado
itens[codPraga]	Código da praga junto ao INDEA.	E113DIE.CodPuf	Tela de Pragas (F113DPP), coluna Código por estado
itens [quantidade]	Quantidade do produto.	E113RIF.QtdRei	Tela de Emissão da Receita Agronômica (F113REM), grade Itens da Receita, coluna Quantidade.
itens[areaTratada]	Quantidade/Área tratada.	E113RIF.VlrAre	Tela de Emissão da Receita Agronômica (F113REM), grade Itens da Receita, coluna Área.

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 Mato Grosso. 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 INDEA. 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 INDEA seja específica para receitas aplicadas em Mato Grosso, 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á.