Integração Backoffice Protheus x PIMS MultiCultivos 

 12.1.10 (Março/2016)

Sumário

1. Contexto de negócio (Introdução)

2. Sistemas Envolvidos

3. Integração

4. PIMSConnector
4.1. EAI PIMSConnector
4.2. PIMSConnector Console
4.3. Mensagem Única
4.4. InternalID

5. Escopo

6. Pré-requisitos instalação/implantação/utilização
6.1. PIMS Multicultivos
6.2. Protheus
6.3. PIMSConnector

7. Instalação/Atualização
7.1. PIMSConnector
7.2. Protheus

8. Controle de Versão

9. Suporte

10. Transações/Entidades/Mensagens únicas

11. Fluxo das Informações
11.1. Cadastros
11.2. Processos

12. Fluxo das Informações

13. Anexos

Contexto de negócio (Introdução)

O PIMSConnector é um esforço para componentizar e modularizar o desenvolvimento de novas integrações entre as aplicações PIMS e ERP's, como Protheus e Datasul, por exemplo. O PIMSConnector surgir com o objetivo de criar um ambiente único, ou seja, padronizar as formas de interação entre o segmento Agroindustrial com outros segmentos. Com isto, conseguimos facilitar os meios de comunicação entre as aplicações de nossos clientes e tornar o processo de integração mais simples, ágil, conectado, cloud e essencial. Outro ponto de vista é que este projeto tem como objetivo viabilizar a independência na comunicação entre diferentes tecnologias de integração permitindo, por exemplo, que uma aplicação envie dados para a integração através de acesso direto à base de dados enquanto outra aplicação, que receberá os dados, poderá fazê-lo através de uma Web Service.

Sistemas Envolvidos

Abaixo estão descrito os sistemas envolvidos no processo de integração.

• Sistema/Módulo Vertical - O PIMS Multicultivos é um software que atende todas as demandas de gestão da cadeia produtiva de culturas anuais como: milho, soja, trigo e algodão além dos subsegmentos de biocombustíveis, citros, fruticultura e florestas.

• BackOffice(s) – Protheus é um sistema que contempla todos os principais processos da empresa através de seus módulos onde cada módulo corresponde a uma área específica de gestão, como por exemplo, o módulo FAT (Vendas e Faturamento) que contempla a área de Vendas, fazendo a integração das informações com as demais áreas da empresa. Cada módulo é responsável por dezenas de processos de negócios baseado em práticas do dia a dia de diversos segmentos de negócio.

Integração

Visando ofertar uma solução do seguimento Agro x BackOffice Protheus mais adequada a necessidade do cliente, foi criado o PIMSConnector. Responsável pelo processo de integração entre PIMS X Protheus.

PIMSConnector

A seguir serão apresentadas seções com as principais visões arquiteturais da aplicação. Cada uma possui um foco distinto e possivelmente um público específico.

• Visão Geral do Modelo de Componentes da Solução

Figura 1 - Visão dos Componentes da Solução

Aplicações PIMS: são as aplicações especializadas desenvolvidas pela TOTVS Agro que precisam trocar dados com ERP's utilizados pelos clientes. Exemplos: PIMS Multicultivos, PIMS CS, PIMS PI e PIMS MI.

Aplicações ERP: são produtos como Protheus, Datasul, que são utilizados pelos clientes e que precisam trocar informações com as aplicações especializadas da TOTVS Agro.

Drivers: são os componentes responsáveis pela implementação das regras de validação e integração. Estes podem ser divididos em dois tipos: drivers de coleta de dados (DataDriver) e drivers de processamento de integração (ProcessDriver).

DataDriver: um driver de coleta de dados é o componente responsável por obter os dados de uma aplicação em uma das pontas (aplicação PIMS ou ERP) e enviá-los para o PIMSConnector Bridge para serem processados e integrados.

ProcessDriver: um driver de processamento de integração que é invocado pelo PIMSConnector Bridge para processar os dados recebidos e enviá-los (integrá-los) à aplicação na outra ponta.

Bridge: é responsável por intermediar a comunicação entre drivers do tipo DataDriver e ProcessDriver, identificando os drivers adequados para o processamento das integrações. Este módulo disponibiliza serviços de registro e invocação de integrações (envio de dados) aos drivers.

Considerações Sobre Acoplamento

Os drivers de coleta de dados não saberão quais drivers de processamento de integração serão invocados para o processamento dos dados enviados para a Bridge, nem os drivers de processamento de integração saberão sobre os drivers de coleta de dados que originaram os dados. Isto garante um baixo acoplamento entre estes componentes e a fácil substituição dos mesmos quando necessário.

Registro de Drivers

Os drivers do tipo ProcessDriver precisam se registrar no módulo PIMSConnector Bridge, informando o nome da integração e a URI que oferece o serviço de processamento, para que sejam encontrados quando houver a necessidade de processamento de uma integração. Já os drivers do tipo DataDriver não precisam se registrar, apenas conhecer os serviços disponibilizados pelo módulo PIMSConnector Bridge que recebem os dados.

Considerações Sobre Tecnologias de Comunicação

Uma das características importantes a considerar neste projeto é que, a comunicação feita pelos drivers com as aplicações a serem integradas, poderão dar-se de diversas formas e com tecnologias distintas. Há integrações feitas através da comunicação direta com bancos de dados, comunicação através de web services SOAP, web services REST, chamadas HTTP, troca de mensagens através de middlewares orientados a mensagens, sockets, e quaisquer outras que possam surgir derivadas das anteriores. É importante que cada driver implementado seja independente da forma de comunicação adotada, para que se possa permitir que a regra de negócio seja a mesma em cada situação, para não haver duplicação. Para isso existe o conceito de Wrapper de Comunicação. Wrappers de Comunicação são componentes responsáveis exclusivamente pela comunicação do driver com as aplicações que precisam ser integradas, ou seja, das quais os drivers recebem os dados e para as quais eles enviam estes dados, após o processamento da integração.

Visão dos Componentes Driver

Esta visão apresenta, ainda em alto nível, possíveis estratégias de implementação para os Drivers.


Se pensarmos em um componente de Driver como sendo um arquivo .jar, este poderá apresentar os componentes de um DataDriver, de um ProcessDriver ou os dois, ao mesmo tempo, sendo cada tipo implementado por uma classe distinta.

Visão dos Componentes ProcessDriverWrapper

Esta visão apresenta, ainda em alto nível, possíveis estratégias de implementação para os Wrappers de ProcessDrivers.


A ideia é que os Wrappers implementem uma interface que possui um método que possa ser chamado pelo ProcessDriver para a entrega dos dados processados. Neste caso o ProcessDriver é ativo, no sentido em que invoca o Wrapper quando necessário. Cada Wrapper terá acesso ao ProcessDriver em questão para repassar as respostas recebidas.

Visão dos Componentes DataDriverWrapper
Esta visão apresenta, ainda em alto nível, possíveis estratégias de implementação para os Wrappers de DataDrivers.


A ideia é que os Wrappers implementem uma interface que possui um método que possa ser chamado pelos aplicativos envolvidos na integração para a entrega dos dados (obtenção passiva de dados), ou então o Wrapper implementará uma estratégia de recuperação dos dados (obtenção ativa dos dados). Uma vez que tenha obtido os dados, o Wrapper invocará no DataDriver o método responsável por receber os dados e o DataDriver passará os dados adiante, fazendo qualquer alteração necessária. Neste processo o DataDriver será passivo na obtenção dos dados, uma vez que ela é dependente da tecnologia de comunicação.

Visão Geral do Modelo de Componentes da Solução com Wrappers
Esta visão apresenta a utilização dos Wrappers na relação entre os componentes da solução.

EAI PIMSConnector

O EAI PIMSConnector permite a troca de mensagens no formato XML (eXtensible Markup Language), com qualquer produto ou software que disponibilize um WebService para esta finalidade. O EAI PIMSConnector interpreta e gerencia as informações enviadas ou recebidas por aplicativos PIMS ou por outro Software. Após interpretar as informações o EAI PIMSConnector entrega aos Adapters para realizar o processo de validação de negócio. Aos finalizar estas validações o EAI PIMSConnector devolverá ao software que originou as informações um aviso (XML) que identifica se o processamento foi realizado com sucesso ou falha. É importante ressaltar que o EAI PIMSConnector não é responsável por realizar a validação de negócio, apenas envia e recebe mensagens. Ele também é responsável por tentar entregar a mensagem novamente, quando a entrega anterior não foi possível. Desta maneira, erros no processamento da mensagem, problemas na regra de negócio envolvida na integração, problemas com consumo de memória, normalmente são decorrentes da rotina envolvida no processamento da mensagem e não do EAI PIMSConnector.

Acessando o WSDL do EAI PIMSConnector

O EAI PIMSConnector possui duas URLs distintas, que podem ser acessadas conforme os endereços abaixo

URL1: http://<servidor-PIMSConnector>:<porta-PIMSConnector>/ MensagemUnica/PIMSConnectorCDATAWS?wsdl

URL2: http://<servidor-PIMSConnector>:<porta-PIMSConnector>/ MensagemUnica/PIMSConnectorWS?wsdl

PIMSConnector Console

O PIMSConnector Console é a interface apresentada ao usuário, na qual é possível acompanhar, consultar e configurar as integrações entre PIMS x ERP realizadas pela aplicação PIMSConnector. 

O PIMSConnector Console é uma interface Web e seu acesso é realizado através do link descrito abaixo:

[http://<servidor-PIMSConnector>:<porta-PIMSConnector>/PIMSConnector|]

Afim de auxiliar o usuário com possíveis dúvidas, o ícone de suporte exibido no canto superior direito da tela de acesso, redireciona o mesmo para o Portal do Cliente Totvs https://totvs.fluigidentity.com/cloudpass/.

MENU HOME

Objetivo: Disponibilizar ao usuário, uma interface que facilite a consulta dos status das integrações através de gráficos, com atualizações automáticas. Ao abrir o monitor as informações exibidas são referentes a todas as aplicações,

no dia atual e considerando as mensagens enviadas. 

Filtros que podem ser aplicados:

• Aplicação:
  • É possível escolher se as informações exibidas nos gráficos serão as informações enviadas pelo Protheus, PIMS ou por ambos.
    
    
• Período:
  • Nesse campo é possível escolher 4 períodos padrão (Hoje, Semana, 2 Semanas e Mês), ou se desejar é possível escolher um período personalizado escolhendo a opção outro e preenchendo os campos Data Inicial e Data Final.
    
    
• Data Inicial:
  • Campo exibido quando no campo período é selecionada a opção outro. Esse campo contém a data inicial para o filtro dos dados que serão exibidos nos gráficos.
    
    
• Data Final
  • Campo exibido quando no campo período é selecionada a opção outro. Esse campo contém a data final para o filtro dos dados que serão exibidos nos gráficos.

Na parte superior do Monitor contém os totalizadores, eles informam a quantidade de integrações separadas por seus status que correspondam as opções aplicadas no filtro (Erros, Em Processamento, Finalizados).

Listagem de Integrações

Em todos os gráficos e totalizadores é possível saber exatamente quais as integrações compõem aquela quantidade, bem como visualizar o seu XML, para isso é necessário apenas clicar na fatia do gráfico desejado ou no ícone do totalizador. Em alguns casos (Totalizadores, gráfico Mensagens x Status, gráfico Mensagens x Filial e Ranking: Mensagens x Aplicação) ao clicar na fatia ou no ícone uma lista contendo os nomes técnicos das integrações e suas quantidades será exibida.

Clicando no ícone da lupa (ao lado esquerdo do nome técnico) é aberta uma lista das transações contidas ali. Essa lista de transações também é aberta diretamente ao clicar no gráfico Transações x Mensagens com Erros, Transações x Mensagens Finalizadas e Transações x Mensagens em Processamento.

Ainda é possível visualizar informações detalhadas da transação, basta clicar no ícone da lupa (ao lado esquerdo do status). Serão exibidas informações detalhadas sobre aquela transação.

MENU MONITOR DE INTEGRAÇÃO

Objetivo: Disponibilizar ao usuário, uma interface que facilite a consulta dos status das integrações através de gráficos.O painel superior exibe as integrações do dia, separando por suas situações. Ao clicar sobre os ícones Erros, Finalizados, Aviso ou Em Processamento, é possível visualizar os detalhes das integrações processadas. O mesmo também acontece com as barras dos gráficos.

Os gráficos exibem a quantidade de integrações separadas em três períodos, sendo eles, semanal, mensal e total.

Observação.: As informações serão atualizadas automaticamente a cada 90 segundos. 

MENU ADMINISTRAÇÃO

Propriedades -->PIMSConnector

Objetivo: Configurar as propriedades referentes ao funcionamento do PIMSConnector.

Nesta tela, as informações são organizadas em uma tabela de quatro colunas. Na coluna Grupo, é informado o grupo de cada parâmetro, na coluna Nome é informada o nome de cada parâmetro,

na coluna descrição é informada a descrição de cada propriedade, na coluna Valor é informado o valor de cada parâmetro são informados os valores que o usuário pode indicar, e na coluna Valor,

 é possível cadastrar as configurações desejadas.

Ao abrir a tela não é exibido nenhum parâmetro, para que eles sejam visualizados é necessário aplicar uma consulta, para isso utilize o menu Procurar. Caso deseje procurar por nome preencha o valor desejado no campo nome, caso deseje procurar pela descrição preencha o valor desejado no campo descrição. Os resultados exibidos serão aqueles que contenham em seu nome ou descrição o valor inserido no campo no momento da busca. Caso seja necessário exibir todos os parâmetros do PIMSConnector, é necessário deixar o campo Nome e o campo Descrição em branco e clicar no botão consultar.

 Observação: Para configurar o parâmetro clique no botão editar


São exibidas as seguintes propriedades:

Saiba mais:

• Tipo de integração (DB) banco de dados (WS) webservices: Web Service, representa a comunicação via WebService com troca de arquivos XMLs. Banco de Dados, representa a comunicação realizada via banco de dados, ou seja, as informações são recuperadas e atualizadas em tabelas intermediárias.

• Habilita o reenvio de mensagem com falha de comunicação: Quando está habilitado o reenvio da mensagem com falha, o PIMSConnector verificará as mensagens armazenadas no banco com status de falha de comunicação e realizará novamente o seu envio através de um agendamento pré-configurado no parâmetro "configuração da expressão CRON (agendamento) para reenvio de mensagem – Padrão 5 minutos".

• Insere mensagem de resposta na base de dados: Quando estiver parametrizado com "Sim" serão gravadas no banco do PIMSConnector as mensagens que forem do tipo "ResponseMessage", ou seja, o ERP envia uma mensagem de negócio (BusinnessMessage), o PIMS realizada o processamento e devolve uma resposta de Sucesso ou Erro.

• Endereço de comunicação com webservices do ERP: Informar o endereço de comunicação com ERP (http://ENDERECO_IP:PORTA/eai2-ws/EAIService). O PIMSConnector enviará mensagens de negócio, resposta de processamento, confirmação de recebimento e receberá as mensagens do ERP através desse endereço.)

• Endereço de comunicação com webservices de Custo Itens Online: Parâmetro deve ser configurado quando fizer uso do Custo de Item on-line. Informar o endereço de comunicação com o webservice do ERP para processamento do custo de item on-line.

Propriedades -->Bridge

Objetivo: Configurar as propriedades referentes ao funcionamento da Bridge.

Nesta tela, as informações são organizadas em uma tabela de três colunas. Na coluna Nome é informada a descrição de cada propriedade, na coluna Valores Válidos são informados os valores que o usuário pode indicar, e na coluna Valor, é possível cadastrar as configurações desejadas.

São exibidas as seguintes propriedades:

• Nome do Serviço do PIMSConnector. Valores válidos = PIMSConnector
  
  
• Porta de acesso ao banco de Dados do PIMSConnector via conexão por padrão é utilizado 9092, porém pode ser utilizada outras portas.
  
  
• Permite acesso remoto via conexão. Valores válidos = true/false
  
  
• Porta de acesso via Web ao Banco de Dados do PIMSConnector por padrão é utilizado 8082, porém pode ser utilizada outras portas.
  
  
• Permite acesso remoto via Web. Valores válidos = PIMSConnector
  
  
• Hostname ou IP de acesso ao PIMSConnector.
  
  
• Porta de acesso JNDI por padrão é 1099, porém pode ser utilizada outras portas
  
  
• Porta de acesso ao PIMSConnector por padrão é 8080, porém pode ser utilizada outras portas
  
  
• Tipo de esquema de comunicação é forma de comunicação entre os módulos dentro do PIMSConnector.

E-Mail --> Configurações

Tem como configurar as propriedades referentes ao endereço de e-mail, que será utilizado como remetente para envio de e-mails realizados pelo PIMSConnector.

• Nome do Remetente: Nome do remetente de e-mail
  
  
• E-mail Remetente: Endereço de e-mail que será utilizado como remetente;
  
  
• Usuário: Usuário de acesso ao servidor de e-mail do remetente;
  
  
• Senha: Senha do de acesso ao servidor de e-mail do remetente;
  
  
• Servidor SMTP: Endereço SMTP do servidor de e-mail;
  
  
• Porta SMTP: Número da porta de conexão com o servidor de e-mail;
  
  
• Assunto: Assunto do e-mail;
  
  
• Mensagem padrão: Texto que será exibido no corpo do e-mail;
  
  
• Utiliza Protocolo SSL: Marcar caso o servidor de e-mail necessite de protocolo SSL;
  
  
• Utiliza Protocolo TLS: Marcar caso o servidor de e-mail necessite de protocolo TLS;
  
  
• Extrato Versão: Com essa opção marcada o PIMSConnector enviará uma vez por mês de forma automática um e-mail para a TOTVS Agro, informando a versão do PIMSConnector.

E-Mail --> Destinatários

Objetivo: Configurar quais endereços de e-mail irão receber os relatórios de integração enviados pelo PIMSConnector.

Ao selecionar a opção de menu Destinatários, o sistema exibe em grid todos os destinatários de e-mail já cadastrados. As colunas 'Resumo Geral', 'OS Oficina', 'Movimento de Estoque' e 'Movimentos dos Ruralistas' poderão ser marcadas com "S" ou "N", de acordo com os tipos de e-mails que cada destinatário irá receber.

No cadastro de um novo destinatário, o campo código é preenchido automaticamente, portanto é necessário informar apenas o Nome do Destinatário, o E-mail, e selecionar quais os tipos de informações serão enviadas. Os tipos de informações enviadas pelo PIMSConnector são:

• Resumo Geral: será enviado um e-mail com o resumo geral de todas as integrações realizadas, tanto em caso de falha como de sucesso, de acordo com o período agendado;

• OS Oficina: será enviado ao destinatário um e-mail com os erros ocorridos durante as integrações de Solicitação de Materiais da OS Oficina.

• Movimento de Estoque: será enviado ao destinatário um e-mail com os erros ocorridos durante as integrações de Movimentação de Estoque.

• Movimentos dos Ruralistas: será enviado ao destinatário um e-mail com os erros ocorridos durante as integrações de Movimentos dos Ruralistas, de acordo com o período agendado;

E-Mail --> Agendamento

Objetivo: Disponibilizar as configurações de agendamento, para enviar e-mails automaticamente no período selecionado.

Ao selecionar a opção de menu E-mail Agendamento, o sistema exibe ao usuário os detalhes do Driver responsável pelo envio dos e-mails, e os campos nos quais é possível configurar data e hora para o envio automático.
Os campos informativos referentes ao driver são:

• Nome do Driver;
• Aplicação;
• Tipo do Driver;
• Nome da Integração;
• Nome do Wrapper;
• Tipo de Comunicação;
• Versão da Mensagem;
• Service URL.

Os campos editáveis para o agendamento são:

• Mês;
• Dia do Mês;
• Hora;
• Minuto.
• Segundo;
• Tipo Agendamento (I – Intervalo, F - Fixo);

Para preencher as informações de agendamento, o usuário deve seguir o padrão de expressão CRON, assim como nos demais agendamentos do sistema.
Após salvar as opções de agendamento, no período agendado será enviado por e-mail o relatório geral das integrações.


Excluir Transações --> Agendada

Objetivo: Disponibilizar as configurações de agendamento, para excluir automaticamente as transações que foram processadas com sucesso ou erro. Está processo propor-se, diminuir o volume de informações armazenadas no processo de integração.

Ao selecionar a opção de menu Excluir Transações Agendada, o sistema exibe ao usuário os detalhes do Driver responsável pela exclusão das Transações, e os campos nos quais é possível configurar data e hora para o sistema excluir automaticamente os registros existentes no PIMSConnector.

Obs.: O processo de exclusão das mensagens integradas, mantem 30 dias de histórico as mensagens precedentes aos 30 dias serão apagadas.

Os campos informativos referentes a está integração são:

• Nome do Driver: Nome do Driver responsável por executar o processo de exclusão das Transações;
  
  
• Aplicação: Aplicação na qual está registrado o Driver;
  
  
• Tipo do Driver: Campo que descreve se o Driver é referente ao PIMS ou ao ERP;
  
  
• Nome da Integração: Nome da integração pertinente ao Driver registrado;
  
  
• Nome do Wrapper: Nome do Wrapper responsável por executar o processo de exclusão das Transações;
  
  
• Tipo de Comunicação: Indica de que maneira as informações recebidas durante a integração serão armazenadas;
  
  
• Versão da Mensagem: Informa ao usuário, em qual versão de desenvolvimento estão as mensagens de integração;
  
  
• Service URL: Indica a URL de comunicação do Web Service do PIMSConnector.

Os campos editáveis para o agendamento são:

• Mês;
• Dia do Mês;
• Hora;
• Minuto.
• Segundo;
• Tipo Agendamento (I – Intervalo, F - Fixo);

Para preencher as informações de agendamento, o usuário deve seguir o padrão de expressão CRON, assim como nos demais agendamentos do sistema.

Excluir Transações --> Transações Manual

Objetivo: Exibir ao usuário as Transações existentes, e permitir que o mesmo possa excluir os registros selecionados que estão com o status de processamento sucesso ou erro.

Ao selecionar a Excluir de Transações Manual, o sistema exibe ao usuário a grid de transações, que inicialmente estará vazia. Para consultar os registros existentes, o

usuário deve preencher os filtros localizados do lado esquerdo da tela.

Os filtros disponíveis para consulta são:

• Data Inicial: Campo obrigatório, que define a partir de qual data os registros serão selecionados.
  
  
• Hora Inicial: Indica em que período os registros serão selecionados.
  
  
• Data Final: Campo obrigatório, que define até qual data os registros serão selecionados.
  
  
• Hora Final: Indica em que período os registros serão selecionados, levando em consideração apenas as informações existentes com Data Final e Hora Final inferiores ou iguais aos valores informados nos filtros.
  
  
• Tipo Transação: Seleciona integrações de envio ou recebimento de informações.
  
  
• Tipo Mensagem: Seleciona integrações do tipo BusinessMessage, ResponseMessage ou ReceiptMessage.
  
  
• Tipo Processamento: Seleciona integrações do tipo síncrona ou assíncrona.
  
  
• Status: Seleciona a integração de acordo com sua situação
  • Finalizado
  • Falha
  • Aviso
    
    
• Transação: Campo que restringe a busca das integrações de acordo com o nome da transação informado.

Ao realizar a consulta, a tabela de Transações é preenchida de acordo com os filtros aplicados. As informações exibidas são;

• Status;
• Transação;
• Descrição;
• Tipo de Processamento;
• Tipo de Transação;
• Tipo de Mensagem;
• Data;
• Hora.

Todas as colunas possuem a opção de filtro, que permite refinar a busca entre os registros exibidos na grid.

Para apagar a Transação escolhida, o usuário pode clicar sobre o ícone de exclusão, exibido para cada linha da tabela. Desta forma, será excluída apenas uma transação por vez.

Para apagar todas as transações filtradas, existe na parte inferior direita da tela, o botão Excluir todos. Desta forma, todas as transações selecionadas pelo filtro lateral serão excluídas.

Configurações PIMS --> Conexão PIMS

Objetivo: Configurar a conexão com o banco de dados do PIMS Multicultivos de forma intuitiva.

Configurações PIMS --> Parâmetros PIMS

Objetivo: Realizar a configuração dos parâmetros do PIMS. É possível configurar todos os parâmetros do PIMS MultiCultivos referente ao processo de

integração  (CONTEXT_APL = PIMSGRAOS.EAI).

Ao abrir a tela não é exibido nenhum parâmetro, para que eles sejam visualizados é necessário aplicar uma consulta, para isso utilize o menu Procurar. Caso deseje procurar pelo nome

preencha o valor desejado no campo nome, caso deseje procurar pela descrição preencha o valor desejado no campo descrição. Os resultados exibidos serão aqueles que contenham em

eu nome ou descrição o valor inserido no campo no momento da busca. Caso seja necessário exibir todos os parâmetros do PIMSMC referentes a integração, é necessário deixar o campo

Nome e o campo Descrição em branco e clicar no botão consultar.

 Observação: Para configurar o parâmetro clique no botão editar

Wizard --> Configuração

Objetivo: O Wizard de Configuração tem como objetivo facilitar o processo configuração do PIMSConnector 

Na tela inicial do Wizard, selecione Configuração.
 

Selecione o modelo de integração a ser utilizada e clique em Avançar.
 

Preencha a URL do Web Service de comunicação com ERP, se necessário informar usuário e senha e clique em Avançar.
 

Na tela seguinte desmarque as mensagens que não serão integradas e clique em Avançar.

A próxima tela realizaremos as parametrização do PIMSConnector e PIMS Multicultivos.

Após realizar todas as configurações necessárias dos Parâmetros clique em Avançar.

Na próxima etapa poderá realizar as configurações de e-mail, se optar por não configurar  marque a opção Desabilitar Configuração

Na tela seguinte configure os destinatários que receberam os e-mail com resumo do processamento das mensagens.

Observação: Esta tela não aparecerá, caso seja desabilitar a configuração de e-mail no passo anterior. 
 

Configure o tempo para execução das mensagens que serão integradas de forma Assíncrona.  A mensagem MensagemUnicaDataDriver é obrigatório a sua configuração.

Por questões de segurança altere a senha do usuário ADMIN  (usuário padrão do Sistema) 

Ao finalizar as configurações do Wizard, será apresentado o resumo dos procedimentos efetuados, clique em Concluir para finalizar as configurações.

Wizard  --> Diagnóstico

Objetivo: Realizar uma avaliação no sistema em busca de possíveis problemas de configuração.

Na tela inicial do Wizard, selecione Diagnóstico.
 

Clique em Iniciar Diagnóstico para iniciar a avaliação do sistema.
 

Após finalizar a avaliação aparecerá um resumo dos teste executados, se o diagnóstico terminar sem erros clique em Concluir, senão clique e Avançar para prosseguir com diagnóstico. 

Observação: Representação dos ícones

 Sucesso    Alerta    Erro

A tela seguinte mostra todos os erros encontrados, clique em Solucionar Problemas.

Após clicar em Solucionar Problemas será aberto a tela de configuração dos itens listados anteriormente, faça as configurações e clique em Validar para que o sistema valide as alterações feitas. 

Após o sistema validar as configurações com sucesso clique em Avançar para ir para próximo item a ser ajustado.  

Ao percorrer os itens e realizar as alterações necessárias, clique em Concluir para finalizar o Wizard.

Adapter EAI

Objetivo:  Listar  todas as mensagens disponíveis no PIMSConnector. O Adapter EAI possibilitar habilitar ou desabilitar as mensagens que serão integradas pelo PIMSConnector.

 Selecionar as mensagens que serão integradas.

Observação:  Caso seja apresentado uma mensagem, informando que a integração não esta habilitado, é necessário avaliar as configurações do Adapter EAI.  

Exemplo.("A Integração UnitOfMeasure do Modulo de Estoque não esta habilitada no PIMSConnector.")

De/Para Msg Única

Objetivo: Exibir os relacionamentos entre o PIMS x Protheus, pois cada registro possui um identificador de referência única, tanto da aplicação de origem quanto da aplicação de destino.

Sendo assim, torna-se possível rastrear o cadastro e verificar seu relacionamento correspondente em ambos os sistemas.

As colunas 'Origem', 'Transação' e 'Descrição' permitem ao usuário selecionar as opções disponíveis para a consulta, já as colunas 'Valor Externo', 'Valor Interno', 'Data' e 'Hora' permitem que o usuário digite as informações desejadas. As colunas 'Data' e 'Hora' possuem máscaras de digitação, que restringem a digitação aos formatos dd/MM/yyyy para data e HH:mm para a hora. 

Ao clicar no ícone exibido na primeira coluna, o usuário é direcionado para a tela de detalhes.

• UUID: Identificador único da mensagem de integração;
  
  
• Origem: Nome da Aplicação de origem das informações integradas;
  
  
• Transação: Nome da transação que contém a mensagem de integração;
  
  
• Descrição: Descrição em Português do nome da transação realizada;
  
  
• Valor Externo: Código gerado na aplicação de origem da integração;
  
  
• Valor Interno: Código gerado pelo PIMSConnector;
  
  
• Data: Data de geração do registro de De/Para;
  
  
• Hora: Hora de geração do registro de De/Para.

Empresa e Filial

Objetivo: Registrar o mapeamento de Empresa  e Filial existente no Protheus.

Manutenção de Usuário

Objetivo: Realizar a criação ou alteração dos usuários do sistema PIMSConnector.

Na tela de Manutenção de Usuários, as informações serão demonstradas em uma tabela com quatro colunas. Na primeira coluna, cada usuário, exibe o ícone de alteração.

As colunas 'Nome' e 'Login' possuem o filtro que permite ao usuário digitar as informações que deseja buscar, a coluna 'Perfil' possui o filtro que permite ao usuário selecionar a opção de consulta, como ilustrado na imagem abaixo;

Para cadastrar um usuário, basta clicar no botão 'Novo'. Para alterar um usuário, basta clicar no ícone de alteração, situado na primeira coluna da tabela Manutenção de Usuários.

São exibidas as seguintes propriedades:

• Login: será informado o login que o usuário utilizará para acessar o sistema.
  
  
• Nome de Usuário: nome completo do usuário?  
  
  
• Perfil: define as permissões de acesso ao sistema, de acordo com o tipo de usuário.
  
  
• Senha: a senha de acesso ao sistema
  
  
• Confirmar Senha:  para confirmar se a senha digitada está correta.
  
  
• Idioma: selecionar o idioma dos textos exibidos para esse funcionário.
  
  

O usuário do tipo "MANAGER", possui uma funcionalidade que permite que permite filtrar as empresar que poderão ser visualizadas pelo Usuário

O  botão Filtrar Empresas,  tem por objetivo indicar de quais empresas/filais aquele usuário poderá ver as informações.

As empresas e filais selecionadas para aquele usuário, serão as que ele terá permissão para visualizar as mensagens integradas.

Observação: Caso não seja selecionada nenhuma empresa/filial o usuário terá acesso as mensagens de todas as empresas/filais.

Para usuários logados com perfil "MANAGER" aparecerá no rodapé ao lado do cadeado um novo ícone, clicando nesse ícone abrirá um pop-up listando todas as empresas/filiais que o usuário tem permissão para visualizar as informações.

MENU MONITORAMENTO

Monitor de Integração

Objetivo: Exibir a listagem de toda as Integrações trafegadas através do PIMSConnector. Na tela, a listagem das integrações entre PIMS e ERP é demonstrada através de uma grid.

Os dados são organizados por data e cada linha é referente a uma única transação. Na parte superior de cada coluna da grid existe um campo de busca. Para as colunas 'Status', 'Transação', 'Descrição', 'Tipo de Processamento', 'Tipo de Transação' e 'Tipo de Mensagem', o campo de busca permite ao usuário selecionar uma opção disponível para a consulta. Para as colunas 'Data' e 'Hora', é possível digitar a informação desejada, e para facilitar a digitação, as colunas 'Data' e 'Hora' possuem em seus filtros as máscaras dd/MM/yyyy para data e HH:mm para a hora.

Na primeira coluna da tabela de Integrações é exibido um ícone que direciona o usuário para a tela de detalhes.

• UUID: Identificador único da mensagem de integração, não pode ser igual ao identificador de qualquer outra mensagem em qualquer um dos aplicativos participantes da integração.
  
  
• Código: Número sequencial gerado pelo PIMSConnector para controle interno das transações.
  
  
• Transação: Nome da transação que contém a mensagem de integração
  
  
• Descrição: Nome da integração
  
  
• Data: Data de processamento da integração.
  
  
• Hora: = Hora de processamento da integração.
  
  
• Tipo Transação: Informa se a mensagem integrada é de envio ou recebimento de informações.
  
  
• Tipo Processamento: Informa se a integração é síncrona ou assíncrona.
  
  
• Tipo Mensagem: Informa se a mensagem integrada é do tipo BusinessMessage, ResponseMessage ou ReceiptMessage.
  
  
• Status: Demonstra a situação da integração (Não processado, Em execução, Finalizado, Falha, ou Bloqueado).
  
  
• Dados da Transação: Exibe a estrutura do arquivo XML gerado pela aplicação de origem da integração.
  
  
• Mensagem de Processamento: Campo utilizado apenas para integrações de Movimentação de Estoque quando o tipo for síncrono, para exibir mensagens de processamento contidas no retorno da transação.

Consultar Mensagens

Objetivo: Possibilitar a aplicação de filtros que restringem a consulta de Mensagens de Integração, simplificando o retorno da busca e a visualização dos registros.

Ao acessar a opção de menu Consultar Mensagens, o sistema exibe a tabela de Mensagens vazia. Para consultar os registros existentes, o usuário deve preencher os filtros obrigatórios, localizado ao lado esquerdo da tela.

Os filtros disponíveis para a consulta são:

• Data Inicial: Campo obrigatório, que define a partir de qual Data os registros serão selecionados.
• Hora Inicial: Indica em que período os registros serão selecionados, a partir da Hora Inicial informada.
  
  
• Data Final: Campo obrigatório, que define até qual Data os registros serão selecionados.
  
  
• Hora Final: Indica em que período os registros serão selecionados.
  
  
• Código: Seleciona o código sequencial e único gerado para cada integração.
  
  
• UUID: Seleciona o Identificador único da mensagem de integração.
  
  
• Conteúdo XML: quando preenchido, seleciona apenas as transações que possuem no conteúdo do XML os valores informados;
  
  
• Tipo Transação: Seleciona integrações de envio ou recebimento de informações.
  
  
• Tipo Mensagem: Seleciona integrações do tipo BusinessMessage, ResponseMessage ou ReceiptMessage.
  
  
• Tipo Processamento: Seleciona integrações do tipo síncrona ou assíncrona.
  
  
• Status: Seleciona a integração de acordo com sua situação
  
  
• Transação: Campo que restringe a busca das integrações de acordo com o nome da transação informado.

Ao clicar no botão 'Consultar', o sistema exibe o resultado da busca na tabela do Monitor de Integração. Quando a tabela está preenchida, é possível realizar outras consultas através dos filtros disponíveis para cada coluna

exibida. Na primeira coluna da tabela de Integrações é exibido um ícone que direciona o usuário para a tela de detalhes.

Consultar Logs

Objetivo: Exibir ao usuário as mensagens gravadas em log durante o processamento da integração.

Ao acessar a opção de menu Consultar Logs, o sistema exibe a tabela de Logs vazia. Para consultar os registros existentes, o usuário deve informar os filtros obrigatórios, no lado esquerdo da tela.
Os filtros disponíveis são:

• Data Inicial: campo obrigatório para filtrar a data inicial do período no qual o usuário deseja realizar a busca;
  
  
• Hora Inicial: quando preenchido indica a partir de que período os registros serão selecionados;
  
  
• Data Final: campo obrigatório para filtrar a data final do período no qual o usuário deseja realizar a busca;
  
  
• Hora Final: quando preenchido, indica em que período os registros serão selecionados, levando em consideração apenas as informações existentes com Data Final e Hora Final inferiores ou iguais aos valores informados nos filtros;
  
  
• UUID: seleciona os registros levando em consideração o número de identificação único de cada log;
  
  
• Conteúdo da Mensagem: campo que restringe a busca, para selecionar apenas mensagens de log que possuem os caracteres informados no filtro;
  
  
• Origem: seleciona a integração de acordo com sua aplicação de origem;
  
  
• Destino: seleciona a integração de acordo com sua aplicação de destino;
  
  
• Status: seleciona o log de acordo com o status de retorno do processamento (Todos, Falha, Sucesso ou Aviso);
  
  
• Operação: para este campo, é possível escolher as opções: Todos, Atualização/Inclusão ou Exclusão, para selecionar os logs de acordo com a operação realizada;
  
  
• Transação: campo no qual se informa o nome da integração que será filtrada;

Após preencher os filtros e aplicar a consulta, o sistema exibirá na grid os registros encontrados. Para cada coluna da grid existe um campo de busca, no qual é possível inserir e consultar as informações desejadas. As colunas 'Status', 'Transação', 'Origem', 'Destino' e 'Operação' possuem o tipo de filtro que permite ao usuário selecionar as opções disponíveis para a consulta. As colunas 'Data' e 'Hora' permitem ao usuário digitar a informação, e para facilitar a digitação, as colunas 'Data' e 'Hora' possuem em seus filtros as máscaras dd/MM/yyyy para data e HH:mm para a hora.

Ao clicar no ícone da primeira coluna, surge uma nova tela, na qual é possível ver mais detalhes da mensagem.

Consultar Logs JBoss

Objetivo: Disponibilizar ao usuário os logs gerados pelo Jboss durante a execução do PIMSConnector. Os logs são demonstrados em tabela. Os dados são organizados por nome e cada linha é referente a um arquivo de log.

• A primeira coluna possibilita ao usuário selecionar um ou mais arquivos para realizar o download.
  
  
• Nome: Apresenta o nome do arquivo.
  
  
• Tamanho: Exibe o tamanho do arquivo.
  
  
• Tipo: Exibe o tipo (extensão do arquivo).
  
  
• Data: Exibe a data da última alteração ou inclusão dos arquivos de log.
  
  
• Download: Permite ao usuário realizar o download dos logs.

Consultar Transações

Objetivo: Demonstrar todo o fluxo das transações realizadas entre os Drivers PIMS e ERP.

Ao acessar a opção de menu Consultar Transações, o sistema exibe uma tabela vazia. Para consultar as transações existentes, o usuário deve preencher os filtros obrigatórios, no lado esquerdo da tela.

Os filtros disponíveis para a consulta são:

• Data Inicial: campo obrigatório, que define a partir de qual Data as transações serão procuradas;
  
  
• Hora Inicial: quando preenchido, indica a partir de que período os registros serão selecionados;
  
  
• Data Final: Campo obrigatório, que define até qual Data as transações serão procuradas;
  
  
• Hora Final: quando preenchido, indica em que período os registros serão selecionados, levando em consideração apenas as informações existentes com Data Final e Hora Final inferiores ou iguais aos valores informados nos filtros;
  
  
• UUID: campo opcional que se refere ao número de identificação de cada transação;
  
  
• Conteúdo XML: quando preenchido, seleciona apenas as transações que possuem no conteúdo do XML os valores informados;
  
  
• Tipo Driver Origem: define se serão filtradas as transações que tiveram origem no Driver do PIMS ou no Driver do ERP. Por padrão, este campo é preenchido com o valor 'Todos';
  
  
• Aplicação de Origem: define se serão filtradas as transações que tiveram origem no PIMS ou no ERP. Por padrão, este campo é preenchido com o valor 'Todos';
  
  
• Nome da Integração: campo responsável por restringir a busca de acordo com o nome da Integração selecionada. Por padrão é preenchido com o valor 'Todos';
  
  
• Status: indicar se a consulta deve recuperar transações com status de Sucesso, Falha, Em Execução ou Todos.

A primeira coluna exibe um ícone de detalhe para cada transação existente. Ao clicar no ícone, o sistema exibe ao usuário a tela de Detalhes da Transação.

O campo Dados da Transação, demonstra a estrutura do XML de integração, após, transformação e processamento realizados pelo PIMSConnector. Também é possível verificar os logs gerados durante a transação, clicando no botão 'Detalhes do Log'. Os detalhes do log são apresentados em tabela, com cinco colunas:

• Data
• Hora
• Origem
• Mensagem
• Tipo de Mensagem

Cada coluna, assim como nas outras grids mostradas anteriormente, possui o campo de filtro, no qual é possível informar os dados que deseja consultar.

Monitor de Recursos

Objetivo: Exibir na forma de gráficos o uso de recursos do servidor onde está instalado o PIMSConnector

Monitor de usuários 

Objetivo: Exibir todos os usuários conectados ao PIMSConnector.

Observação: 

Ícone para encerrar a conexão . 

Após clicar no ícone , será exibida a pergunta "Deseja realmente encerrar a sessão?", clicando em "Sim" a conexão do usuário será encerrada obrigando o usuário a realizar o login novamente.

Monitor de Processos

Objetivo: Exibir ao usuário os processos agendados que estão em execução.

Ao acessar a opção de menu Monitor de Processos, o sistema a lista as integrações que estão em execução.

Informações disponíveis para a consulta são:

• Agendamento: Exibe o nome do Driver que possui um agendamento configurado.
  
  
• Status: Indica o status atual da Integração exemplo: Aguardando Execução, Executando, etc.
  
  
• Última Execução: Exibe Data e Hora que o agendamento foi executado pela última vez.
  
  
• Próxima Execução: Exibe Data e Hora que o agendamento será executado novamente.
  
  
• Expressão CRON: Exibe a expressão que demonstra a configuração do agendamento.

MENU AGENDAMENTOS

Objetivo: A tela de Agendamentos têm como objetivo exibir ao usuário os detalhes dos agendamentos, além de permitir que usuário configure o período para o qual deseja agendar os processos e integrações.

Os dados dos processos são dispostos em tabela (grid). Na parte superior da grid, para cada coluna, existe um campo de consulta, no qual é possível inserir informações que serão buscadas entre os

A primeira coluna da grid exibe o ícone que habilita os campos de agendamento, caso o processo não possua agendamento serão exibidos apenas os detalhes do processo.

Campos existentes:

• Nome do Driver: Nome do Driver responsável por manipular os dados da integração.
  
  
• Aplicação: Aplicação na qual o Driver de integração está registrado
  
  
• Tipo do Driver: Indica se o Driver está registrado para o PIMS ou ERP.
  
  
• Nome da Integração: Nome da integração pertinente ao Driver registrado.
  
  
• Nome do Wrapper: Nome do Wrapper responsável pela comunicação entre o Driver e a Bridge.
  
  
• Tipo de Comunicação: Indica de que maneira as informações recebidas durante a integração serão armazenadas.
  
  
• Service URL: Url de comunicação do PIMS Multicultivos com o PIMSConnector

• Versão da Mensagem: Informa ao usuário, em qual versão de desenvolvimento estão as mensagens de integração.
  
  

Se o processo possuir agendamento, na tela onde aparecem as informações dos drivers, também ficarão visíveis os campos de agendamento. Nesses campos devem ser informados os parâmetros do agendamento, como:

• Mês;
• Dia do Mês;
• Hora;
• Minuto.
• Segundo;
• Tipo Agendamento (I – Intervalo, F - Fixo);

Os parâmetros do Driver suportam dados que formarão uma expressão CRON. Uma Expressão CRON é composta por seis campos ordenados e separados por espaço em branco. Os campos podem conter qualquer um dos valores permitidos, juntamente com várias combinações de caracteres especiais também permitidos para este campo.

As informações referentes aos parâmetros Segundo, Minuto, Hora, Dia do Mês, Mês e detalhes sobre expressão CRON estão descritas no tópico 15 - Anexos do manual.

MEUS DADOS

Objetivo: Permitir ao usuário logado, consultar ou alterar as informações do seu perfil.

Esta tela apresenta ao usuário as seguintes informações:

• Login: campo no qual será informado o login que o usuário utilizará para acessar o sistema.
  
  
• Nome de Usuário: campo preenchido com o nome do usuário.
  
  
• Perfil: campo que define as permissões de acesso ao sistema de acordo com o tipo de usuário.
  
  
• Senha: campo no qual será cadastrada a senha de acesso.
  
  
• Confirmar Senha: campo para confirmar se a senha digitada está correta.

Mensagem Única

As informações referente a Mensagem Única está disponível no endereço abaixo;

http://tdn.totvs.com.br/pages/viewpage.action?pageId=181141980

InternalID

É uma ferramenta utilizada para converter campos de chaves primárias de aplicativos externos para a chave primária do aplicativo interno. Pode ser referenciada como EAI de – para ou depara.

Durante a troca de mensagens, o aplicativo externo pode ter mais, menos ou diferentes campos correspondentes à chave primária. Assim, fica impossível identificar qual registro corresponde aos valores recebidos na mensagem. Isso pode ocorrer com vários aplicativos externos ao mesmo tempo e para a mesma mensagem. Para resolver essa situação, tornando-a invisível para o Helper e o Adapter durante a extração dos dados recebidos, foram criadas as funções do InternalId.

Foi adicionado um código interno (InternalId) no XML da mensagem para identificar os campos chaves do aplicativo externo. Chegando ao destino, os campos são convertidos para os valores locais no corpo da estrutura.

Exemplo:

A estrutura do cadastro de clientes no Logix é armazenada na tabela "empresas", onde o campo chave é "cod_empresa". Porém, na estrutura do ERP Protheus existe a necessidade de se incluir o campo "filial". Desta forma, é necessário criar uma estrutura InternalId, onde existam campos equivalentes de "cod_empresa" no Logix, para cada cadastro de "empresa" + "filial".
 

Desta forma, a partir do exemplo, tem-se que a empresa "01" do Logix corresponde à empresa e filial "01" "02". Se fosse enviado somente o código da empresa, quando o Protheus enviasse o código "01" conflitaria com três códigos no Logix, tornando falha a troca de mensagens.

Escopo

Fazem parte do escopo de integração os seguintes processos:
 

Mensagens

• Envio de inclusão e atualização da Unidade de Medida do Protheus, para o PIMS Multicultivos, estoque e custos, via mensagem única.
  
  
• Envio de inclusão e atualização do Grupo de Produto do Protheus, para o PIMS Multicultivos, estoque e custos, via mensagem única.
  
  
• Envio de inclusão e atualização do Produto do Protheus, para o PIMS Multicultivos, estoque e custos, via mensagem única.
  
  
• Envio de inclusão e atualização do Depósito do Protheus, para o PIMS Multicultivos, estoque e custos, via mensagem única.
  
  
• Envio de inclusão e atualização do Centro de Custo do Protheus, para o PIMS Multicultivos, módulo de contabilidades gerencial, via mensagem única.
  
  
• Envio de inclusão e atualização do Fornecedor do Protheus, para o PIMS Multicultivos, estoque e custos, via mensagem única.
  
  
• Envio de inclusão e atualização da Conta Contábil do Protheus, para o PIMS Multicultivos, módulo de contabilidades gerenciais, via mensagem única.
  
  
• Envio dos Valores dos Materiais do Protheus, para o PIMS Multicultivos, estoque e custos, via mensagem única.
  
  
• Envio dos valores de Despesas Gerais do Protheus, para o PIMS Multicultivos, módulo de contabilidades gerenciais, via mensagem única.
  
  
• Envio de valores de Depreciação mensal do Protheus, para o PIMS Multicultivos, módulo de contabilidades gerenciais, via mensagem única.
  
  
• Envio da Movimentação de Estoque do PIMS Multicultivos, para o Protheus, estoque e custos, via mensagem única.

• Envio da mensagem de Solicitação de Armazém / Compra do PIMS Multicultivos para o Protheus.
  
  
• Envio da mensagem de Lançamentos Contábeis do PIMS Multicultivos para o Protheus
  
  
• Envio da mensagem de Cargo do Protheus para o PIMS Multicultivos
  
  
• Envio da mensagem de Funcionário do Protheus para o PIMS Multicultivos.
  
  
• Envio da mensagem de Verbas do Protheus para o PIMS Multicultivos
  
  
• Envio da mensagem de Sindicatos do Protheus para o PIMS Multicultivos
  
  
• Envio da mensagem de Situação do Funcionário do Protheus para o PIMS Multicultivos
  
  
• Envio da mensagem de Movimento dos Ruralistas do PIMS Multicultivos para o Protheus
  
  
• Envio da mensagem de Horários/Escalas do Protheus para o PIMS Multicultivos
  
  
• Envio da mensagem de Histórico de Horários/Escalas do Protheus para o PIMS Multicultivos
  
  
• Envio da mensagem de Transferência do Protheus para o PIMS Multicultivos
  
  
• Envio da mensagem de Histórico Salário do Protheus para o PIMS Multicultivos

Painel de Monitoramento

• Visualizar as mensagens processadas pelo PIMSConnector.
  
  
• Visualizar os logs de processamentos das mensagens que foram enviadas e recebidas pelo ERP e PIMS Multicultivos.
  
  
• Visualizar os logs de processamentos do servidor de Aplicação Jboss.

Configurações

• Realizar as configurações de agendamento, para as integrações de envio do PIMS Multicultivos para o Protheus, nas integrações assíncronas.
  
  
• Realizar a parametrização de envio e recebimento das mensagens via monitor.
  
  
• Realizar as parametrizações do PIMSConnector via Monitor.

Não fazem parte do escopo de integração os seguintes processos:

Mensagens

• Envio da mensagem de Unidade de Medida do PIMS Multicultivos para o Protheus.
  
  
• Envio da mensagem de Grupo de Produto do PIMS Multicultivos para o Protheus.
  
  
• Envio da mensagem de Produto do PIMS Multicultivos para o Protheus.
  
  
• Envio da mensagem de Depósito do PIMS Multicultivos para o Protheus.
  
  
• Envio da mensagem de Centro de Custo do PIMS Multicultivos para o Protheus.
  
  
• Envio da mensagem de Fornecedor do PIMS Multicultivos para o Protheus.
  
  
• Envio da mensagem de Conta Contábil do PIMS Multicultivos para o Protheus.
  
  
• Envio da mensagem de Valores dos Materiais do PIMS Multicultivos para o Protheus.
  
  
• Envio da mensagem de Despesas Gerais do PIMS Multicultivos para o Protheus.
  
  
• Envio da mensagem de Depreciação mensal PIMS Multicultivos para o Protheus.
  
  
• Envio da mensagem de Movimentação de Estoque do Protheus, para PIMS Multicultivos.

• Envio da mensagem de Solicitação de Armazém / Compra do Protheus, para PIMS Multicultivos.
  
  
• Envio da mensagem de Lançamentos Contábeis do Protheus, para PIMS Multicultivos.
  
  
• Envio da mensagem de Cargo do PIMS Multicultivos para o Protheus.
  
  
• Envio da mensagem de Funcionário do PIMS Multicultivos para o Protheus.
  
  
• Envio da mensagem de Verbas do PIMS Multicultivos para o Protheus
  
  
• Envio da mensagem de Sindicatos do PIMS Multicultivos para o Protheus
  
  
• Envio da mensagem de Situação do Funcionário do PIMS Multicultivos para o Protheus
  
  
• Envio da mensagem de Movimento dos Ruralistas do Protheus para PIMS Multicultivos
  
  
• Envio da mensagem de Horários/Escalas do PIMS Multicultivos para o Protheus
  
  
• Envio da mensagem de Histórico de Horários/Escalas do PIMS Multicultivos para o Protheus
  
  
• Envio da mensagem de Transferência do PIMS Multicultivos para o Protheus
  
  
• Envio da mensagem de Histórico Salário do PIMS Multicultivos para o Protheus

Painel de Monitoramento

• Reprocessamentos das mensagens enviadas ou recebidas pelo PIMS Multicultivos ou Protheus.

Pré-requisitos instalação/implantação/utilização

Abaixo serão relacionados os pré-requisitos necessários para o processo de integração entre PIMS x Protheus;

PIMS Multicultivos

O PIMS Multicultivos deve estar devidamente instalado e configurado em ambiente de Homologação e Produção, com versão 12.1.6 ou superior.

Parâmetros

O Sistema PIMSMulticultivos utiliza configurações padronizadas ou específicas, chamadas de parâmetros.

Um parâmetro é uma variável que atua como elemento chave na execução de determinados processamentos. De acordo com seu conteúdo é possível obter diferentes resultados.

• USING_INVENTORY_LIST - Determina se o envio de dados será em lista de itens ou item a item
  Valor – True
  
  
• NOME_TRANSACAO_BAIXA - Nome da transação de Movimento de Estoque
  Valor – InventoryTransaction
  
  
• CD_CCUSTO_PADRAO_DISP - Código do CCUSTO Padrão para Disponibilidades
  Valor – 204
  
  
• EMPRESA_FILIAL_EAI - Controle por Empresa x Filial
  Valor – True
  
  
• ESTORNO_BAIXA - Se executa estorno de baixa de material
  Valor – True
  
  
• URL_PIMSCONNECTOR - URL para execução de integrações de forma síncrona.
  Valor – (http://IP_PIMSConnector:PORTA_PIMSConnector/SynchronousWSWrapperPimsMC/dataService).
  
  
• FG_MOV_ESTOQUE_SINC - Permite configurar as integrações de movimentação de estoque para executarem de forma síncrona ou assíncrona.
  Valor – True
  
  
• CHAR_CD_CCUSTO - Caracteres a serem retirados do Código do Centro de Custo
  Valor – True / False – A definir na Implantação
  
  
• FG_CENTRALIZAR_REGIAO_ADM - Centralizar dados por Região Administrativa
  Valor – True / False – A definir na Implantação 

Configurações services_client.xml.

O Sistema PIMS Multicultivos realiza algumas configurações específicas de seus clientes em arquivo XML, chamado services_client.xml. Dentro do arquivo services_client.xml, existem variáveis que precisam ser preenchidas conforme as necessidades de cada cliente.

Abaixo serão listadas as variáveis que deverão ser preenchidas respeitando o valor pré-definido pelo ERP.

Variáveis referentes ao processo de integração

• brg.tipoDocumento Valor="Definir na Implantação"
• brg.tipoMovimento Valor="Definir na Implantação"
• brg.tipoDocumentoEstorno Valor="Definir na Implantação"
• brg.tipoMovimentoEstorno Valor="Definir na Implantação"

Variáveis referentes ao processo de Aplicação Insumos

• appinsumos.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• appinsumos.brg.tipoDocumento Valor="Definir na Implantação"
• appinsumos.brg.tipoMovimento Valor="Definir na Implantação"

Variáveis referentes ao processo de Blocagem

• blocagem.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• blocagem.brg.tipoDocumento Valor="Definir na Implantação"
• blocagem.brg.tipoMovimento Valor="Definir na Implantação"

Variáveis referentes ao processo de Tratamento Semente

• tratsemente.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• tratsemente.brg.tipoDocumento Valor="Definir na Implantação"
• tratsemente.brg.tipoMovimento Valor="Definir na Implantação"

Variáveis referentes ao processo de Pesagem

• pesagem.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• pesagem.brg.tipoDocumento Valor="Definir na Implantação"
• pesagem.brg.tipoMovimento Valor="Definir na Implantação"

Variáveis referentes ao processo de Abastecimento

• abastecimento.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• abastecimento.brg.tipoDocumento Valor="Definir na Implantação"
• abastecimento.brg.tipoMovimento Valor="Definir na Implantação"

Variáveis referentes ao processo de Lubrificação

• lubrificacao.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• lubrificacao.brg.tipoDocumento Valor="Definir na Implantação"
• lubrificacao.brg.tipoMovimento Valor="Definir na Implantação"

Variáveis referentes ao processo de Beneficiamento

• beneficiamento.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• beneficiamento.brg.tipoDocumento Valor="Definir na Implantação"
• beneficiamento.brg.tipoMovimento Valor="Definir na Implantação"

Variáveis referentes ao processo de Plantio

• plantio.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• plantio.brg.tipoDocumento Valor="Definir na Implantação"
• plantio.brg.tipoMovimento Valor="Definir na Implantação"

Variáveis referentes ao processo de Serviço Campo

• srvcampo.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• srvcampo.brg.tipoDocumento Valor="Definir na Implantação"
• srvcampo.brg.tipoMovimento Valor="Definir na Implantação"

Variáveis referentes ao processo de Estorno da Aplicação Insumos

• appinsumos.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• appinsumos.brg.tipoDocumentoEstorno Valor="Definir na Implantação"
• appinsumos.brg.tipoMovimentoEstorno Valor="Definir na Implantação"

Variáveis referentes ao processo de Estorno da Blocagem

• blocagem.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• blocagem.brg.tipoDocumentoEstorno Valor="Definir na Implantação"
• blocagem.brg.tipoMovimentoEstorno Valor="Definir na Implantação"

Variáveis referentes ao processo de Estorno do Tratamento de Semente

• tratsemente.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• tratsemente.brg.tipoDocumentoEstorno Valor="Definir na Implantação"
• tratsemente.brg.tipoMovimentoEstorno Valor="Definir na Implantação"

Variáveis referentes ao processo de Estorno da Pesagem

• pesagem.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• pesagem.brg.tipoDocumentoEstorno Valor="Definir na Implantação"
• pesagem.brg.tipoMovimentoEstorno Valor="Definir na Implantação"

Variáveis referentes ao processo de Estorno do Abastecimento

• abastecimento.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• abastecimento.brg.tipoDocumentoEstorno Valor="Definir na Implantação"
• abastecimento.brg.tipoMovimentoEstorno Valor="Definir na Implantação"

Variáveis referentes ao processo de Estorno da Lubrificação

• lubrificacao.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• lubrificacao.brg.tipoDocumentoEstorno Valor="Definir na Implantação"
• lubrificacao.brg.tipoMovimentoEstorno Valor="Definir na Implantação"

Variáveis referentes ao processo de Estorno do Beneficiamento

• beneficiamento.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• beneficiamento.brg.tipoDocumentoEstorno Valor="Definir na Implantação"
• beneficiamento.brg.tipoMovimentoEstorno Valor="Definir na Implantação"

Variáveis referentes ao processo de Estorno do Plantio

• plantio.brg.codigoMovimentoEntrada Valor="Definir na Implantação"
• plantio.brg.tipoDocumentoEstorno Valor="Definir na Implantação"
• plantio.brg.tipoMovimentoEstorno Valor="Definir na Implantação"

Protheus

O BackOffice Protheus deve estar devidamente instalado e Configurado em ambiente de Homologação e Produção, com versão 11.8. Versão superior a 11.8, está previsto liberação para RoadMap 2016.
 

Parâmetros 

O Sistema Microsiga Protheus utiliza em suas rotinas configurações padronizadas ou específicas, chamadas de parâmetros.
Um parâmetro é uma variável que atua como elemento chave na execução de determinados processamentos. De acordo com seu conteúdo é possível obter diferentes resultados.
Todas as variáveis são iniciadas pelo prefixo MV_ e agem sobre diversas operações no Sistema.

• MV_EAIURL2 - Endereço WebService que Receberá os Dados Enviados (Exemplo:http://10.31.6.68/TBC/wsEAIService.asm).
  
  

• MV_I330FSM - Filtra produtos sem movimentação no período do recálculo
  Valor  .T.
  
  

• MV_MSGPIMS - Nova integração via MGS Única
  Valor .F.
  
  

• MV_EAIWS - Informe o nome do Client WebService do EAI para
  Valor – WSEAISERVICE
  
  

• MV_EAIMETH - Informe o método de envio do EAI para envio a outro EAI
  Valor – receiveMessage
  
  

• MV_PIMSINT - Habilita integração Protheus x PIMSGraos
  Valor .F. 

Adapter EAI.

O recurso Adapter EAI (Enterprise Application Integration) permite estabelecer integrações entre o Microsiga Protheus® e outro ERP. Utilizando esse recurso, o Administrador do Sistema passa a definir quais rotinas devem ser integradas, marcando condições de Envio e Recebimento de procedimentos e transações a serem efetuadas entre os dois Sistemas relacionados, e orientando os Métodos a serem aplicados.

1. Acessar o modulo SigaCFG
2. Clique em Ambiente
3. Clique em Schedule
4. Clique em Adapter E.A.I.
5. Em Rotina informe o nome da aplicação que contem INTEGDEF.
6. Informe uma descrição para a mensagem em Descrição.
7. Em Modelo/Mensagem preencha o ID da mensagem única.
8. Selecione EAI em Canal Envio.
9. No campo Mensagem Única selecione Sim.
10. Preencha as demais informações conforme Help de campo.
11. Confira os dados e clique em Ok.

O quadro abaixo demonstra algumas informações a serem preenchidas nas configurações do Adapte

Legenda:
Async - Assíncrona
Sync - Síncrona

Schedule

O Schedule é um recurso de programação de tarefas que possibilita gerar e enviar relatórios e posições de processos controlados pelos módulos do Protheus.

O Schedule agenda tarefas para envio desses relatórios através de e-mail ou por acesso à Internet, assim, é necessário uma configuração específica na estação de trabalho do usuário que consulta os relatórios.
 

Configuração de Agents

Para que as tarefas possam ser executadas é necessário que exista um agent cadastrado com a empresa equivalente.

A opção Legenda permite verificar o status dos Agents.
 

Para configurar os Agents:

1. Em Agent, selecione Cadastro. O Schedule permite que Agents sejam adicionados automaticamente.
   
   
2. Clique em Adicionar Agent e informe um Agent para cada empresa existente no cadastro de empresas.
   
   
3. Para incluir Agents manualmente clique em .
   
   
4. Para alterar ou excluir Agents clique em .

Cadastro de Agendamentos

Realiza o cadastro de agendamentos, permite a seleção de mais de uma empresa e filial para a execução de tarefas.

Para cadastrar agendamentos:

1. Em Agendamentos, selecione Cadastro.
   
   
2. Caso necessário, clique em Importar agendamentos antigos para registros de versões anteriores.
   
   
3. Na pasta Detalhes clique em para adicionar um agendamento. Também é possível alterar (lápis) e excluir .
   
   
4. Posicione o cursor no campo Rotina e, em seguida, clique em para informar uma rotina (FWEAI).
   
   
5. Informe a rotina e os parâmetros entre parênteses para que sejam lidos.
   
   
6. Selecione a(s) empresa(s)/filial(is)
   
   
7. Clique em Recorrência e selecione uma das seguintes opções:

• • Diária: informe o período de dias que deve ser considerado.
    
    
  • Semanal: informe os dias da semana considerados.
    
    
  • Mensal: informe o mês a ser considerado.
    
    
  • Anual: informe o ano a ser considerado.
    
    
  • Sempre ativo: mantém a rotina agendada em funcionamento contínuo até a data de término, se houver. Pode ser definida uma data de término para a recorrência.

Configuração WebService

Um Web Service em AdvPL utiliza-se de working threads para atender as solicitações de processamento através do protocolo HTTP

Para isso, existem duas maneiras de habilitar um Web Service:

1. Através da criação da seção [WebServices], no arquivo de configuração (appserver.ini), do TOTVS | Application Server.
   
   
2. Configuração manual de um ambiente working threads extended (WEBEX), no arquivo de configuração (appserver.ini), do TOTVS | Application Server.

A diferença entre ambas é que a segunda opção permite especificar mais detalhes do ambiente de execução do serviço, configurar os serviços de Web Sites simultaneamente e o atendimento diferenciado do processamento para mais de um host e diretórios virtuais.
 

Configurações do Modulo de Controladoria

Para que o processo de integração seja realizado com sucesso, no módulo de Controladoria é necessário que seja executado o compatibilizador do módulo Ativo Fixo (SIGAATF) – UPDATF com data igual ou superior à 24/02/15, para geração do campo Int. PIMS (N3_INTP), utilizado para definir no cadastro do bem se a depreciação será exportada para o PIMS.

Configurações do Modulo de Materiais

Para que o processo de integração seja realizado com sucesso, no módulo de Materiais é necessário que esteja com UPDATE com data igual ou superior à 15/08/15.

PIMSConnector

Sistema Operacional

O aplicativo PIMSConnector é desenvolvido na plataforma Java EE, e pode, em teoria, ser instalado em qualquer sistema operacional que suporte a execução de aplicações Java.

Atualmente as plataformas testadas/homologadas são:

Windows XP SP3, Windows 2003 Server, Windows 2008 Server ou ainda Windows 7, preferencialmente 64 bits *.
Linux (distribuições como RedHat, Ubuntu e Fedora, mas não se limitando a estas, desde que em suas versões Server), preferencialmente 64 bits *.

Sistema Gerenciador de Banco de Dados 

A aplicação PIMSConnector está homologada para realizar integração com os seguintes SGBDs:

• SQL Server 2005
• SQL Server 2008
• Oracle 11g

Servidores de Aplicações

O servidor de aplicações utilizado para implantação do PIMSConnector é o Jboss 6.1.0. Este servidor é multiplataforma, ou seja, um único instalador pode ser utilizado para qualquer sistema operacional.

A obtenção do software deve ser feita junto à equipe de suporte da TOTVS Agro, uma vez que a versão do servidor utilizada para instalação do PIMSConnector possui algumas configurações específicas de acordo com o banco de dados utilizado.

SDK Java
A instalação de um SDK Java é exigida, e as seguintes versões podem ser utilizadas:

• JDK 6 - Estas devem ser obtidas de acordo com o sistema operacional utilizado, e a plataforma (64 bits ou 32 bits)

Requisitos de Hardware e Ambiente

Para a implantação do PIMSConnector recomendam-se dois ambientes, um para HOMOLOGAÇÃO e um para PRODUÇÃO. Recomenda-se esta configuração para que as atualizações de versão sejam executadas e testadas inicialmente em ambiente de homologação, para posteriormente serem feitas em ambiente de produção.

Servidores de Aplicações

Para o servidor de aplicações de Produção (Jboss) é esperado que se tenha (como configuração mínima):

• Servidor Pentium Xeon ou Quad Core 64 bits (mínimo de 2 cpus),
• 4 GB de RAM disponíveis
• 10 GB de HD disponíveis

Para o servidor de aplicações de Homologação (Jboss) é esperado que se tenha (como configuração mínima):

• Servidor Pentium Core 2 Duo ou Dual Core (mínimo de 2 cpus) 64 bits,
• 4 GB de RAM *disponíveis ***
• 10 GB de HD disponíveis

Observação:

Sistemas operacionais de 32 bits apresentam uma restrição quanto à capacidade de gerenciamento de memória, se limitando a cerca de 3GB de RAM. Por esta razão, é aconselhado que o sistema operacional dos servidores seja de 64 bits.
Espera-se que esta quantidade de memória não seja a memória total do servidor, mas que esteja disponível exclusivamente para a aplicação.

Instalação/Atualização

Este tópico tem por objetivo orientar a instalação da integração, visando o seu funcionamento completo.

PIMSConnector

Os Procedimentos de Instalação / Atualização do PIMSConnector está descrito no Manual de Instalação do PIMSConnector.

Protheus

Os procedimentos de Instalação / Atualização pode ser encontrados no site da TOTVS TDN - http://tdn.totvs.com/

Controle de Versão

O grupo TOTVS representado por suas marcas irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.
Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos PIMSConnector, PIMS Multicultivos e BackOffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Transações/Entidades/Mensagens únicas

Abaixo são demostradas as transações/entidades que são trocadas e quem envia a informação para quem.

Fluxo das Informações

Nesta sessão será descrito o detalhamento e fluxo de cada integração

Cadastros

Integração de Unidade de Medidas.

A integração de Unidade de Medida consiste na movimentação do cadastro no sentido Protheus para PIMS Multicultivos, ou seja, será realizado no Protheus e enviado para o PIMS Multicultivos através do PIMSConnector. 

A integração de Unidade de Medidas para o Protheus é realizado através do cadastro da Unidade de Medidas (QIEA030).O cadastro de Unidade de Medidas deve ser efetuado no Protheus e sincronizado automaticamente PIMS Multicultivos. Nesta integração é possível incluir, alterar e excluir a Unidade de Medida. 

Os campos do cadastro da unidade de medidas a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os necessários ao funcionamento da integração.

Unidade de Medidas

Identificador da Mensagem: Unidade de Medidas
Versão: 2.000
Módulo <Protheus>: <BackOffice – Estoque e Custo>
Módulo <PIMS Multicultivos>: < Unidade de Medidas>
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Campos Obrigatórios para o funcionamento da Integração

• Código
• Descrição.

Integração de Grupo de Insumos/Materiais.

A integração de Grupo de Insumos/Materiais consiste na movimentação do cadastro no sentido Protheus para PIMS Multicultivos, ou seja, será realizado no Protheus e enviado para o PIMS Multicultivos através do PIMSConnector. O objetivo é permitir o controle do consumo dos insumos e materiais automotivos pelo seu respectivo grupo.

A integração de Grupo de Insumos/Materiais para o Protheus é realizado somente no cadastro de Grupo de Produto (MATA035), porém, no PIMS Multicultivos o cadastro pode ser realizado em duas tabelas distintas. Para que a integração ocorra, existe no Protheus a classificação do Grupo de Produtos que determina o tipo de item, se é Grupo de Insumo ou Grupo de Material Automotivo.

O cadastro de Grupo de Produtos deve ser efetuado no Protheus e sincronizado automaticamente no PIMS Multicultivos. Nesta integração é possível incluir, alterar e excluir um grupo de produto.
Os campos do cadastro de Grupo de Produto do Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os necessários ao funcionamento da integração.

Family/Grupo de Produtos
Identificador da Mensagem: Family
Versão: 2.002
Módulo <Protheus>: <BackOffice – Estoque e Custo>
Módulo <PIMS Multicultivos>: <Grupo Insumo / Grupo Materiais>
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Notas:
Para que o cadastro de grupo de materiais seja enviado com sucesso ao PIMS Multicultivos é necessário que seja escolhido alguma das classificações descritas abaixo no Protheus:

• 1 = Outros- Não realiza integração com PIMS Multicultivos.

• 2 = Material Automotivo - Será realizado o cadastro na tabela GRPMATERIAL, que representa Grupo de Materiais do MANFRO no PIMS Multicultivos.

• 3 = Insumos Agrícolas - Será realizado o cadastro na tabela GRPINSUMO, que representa Grupo de Insumos PIMS Multicultivos

A integração de Grupo de Produto permite escolher como será tratada a formação do código do Grupo de Produto no PIMS Multicultivos, seja de forma sequencial ou respeitando o código informado no ERP.
Para funcionamento em modo sequencial, precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo;

Para funcionamento em modo normal, precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo;

Campos Obrigatórios para o funcionamento da Integração

• Código
• Descrição Grupo
• Clas. Grupo

Integração de Insumos/Materiais.

A integração de Insumos/Materiais consiste na movimentação do cadastro no sentido Protheus para PIMS Multicultivos, ou seja, será realizado no Protheus e enviado para o PIMS Multicultivos através do PIMSConnector. O objetivo é permitir o controle do consumo dos insumos e materiais automotivos pela sua respectiva classificação.

A integração de Insumos/Materiais para o Protheus é realizado somente no cadastro de Produto (MATA010), porém, no PIMS Multicultivos o cadastro pode ser realizado em duas tabelas distintas. Para que a integração ocorra, existe no Protheus a classificação dos Produtos que determina o tipo de item, se é Insumo ou Material Automotivo.

O cadastro de Produtos deve ser efetuado no Protheus e sincronizado automaticamente PIMS Multicultivos. Nesta integração é possível incluir, alterar e excluir um produto.
Os campos do cadastro de Produto do Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os necessários ao funcionamento da integração.

Item/Produtos
Identificador da Mensagem: Item
Versão: 2.001
Módulo <Protheus>: <BackOffice – Estoque e Custo>
Módulo <PIMS Multicultivos>: < Insumo / Materiais>
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Notas:
Para que o cadastro de Produto seja enviado com sucesso ao PIMS Multicultivos, é necessário que seja preenchido no cadastro de produto os tipos descritos abaixo no Protheus:

• MM= Material Automotivo - Será realizado o cadastro na tabela MATERIAL, que representa os Materiais do MANFRO no PIMS Multicultivos.

• IA = Insumo Agrícolas - Será realizado o cadastro na tabela INSUMO, que representa Grupo de Insumos PIMS Multicultivos

Observação: Caso o processo de integração já esteja em funcionamento, e o campo Tipo (Protheus) não estiver devidamente preenchido com um dos dois tipos demonstrados acima, será necessário ajustar o cadastro de produto, caso contrário, a integração não funcionará corretamente.

A integração de Produto permite escolher como será tratada a formação do código do Produto no PIMS Multicultivos, seja de forma sequencial ou respeitando o código informado no ERP.
Para funcionamento em modo sequencial, precisa alterar o parâmetro abaixo no PIMS Multicultivos, como descrito no quadro abaixo;

Para funcionamento em modo normal, precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo;

Campos Obrigatórios para o funcionamento da Integração

• Código
• Descrição
• Tipo
• Unidade
• Grupo

Integração de Depósito/Unidade Receptora/Ponto de Abastecimento

A integração de Depósito / Unidade Receptora / Ponto de Abastecimento consiste na movimentação do cadastro sentido Protheus para PIMS Multicultivos, ou seja, será realizado no Protheus e enviado para o PIMS Multicultivos através do PIMSConnector. O objetivo é realizar o movimento dos respectivos depósitos do ERP para PIMS.

A integração de Depósito / Unidade Receptora / Ponto de Abastecimento para o Protheus é realizado somente no cadastro de Armazéns de Estoque (AGRA045), porém, no PIMS Multicultivos o cadastro pode ser realizado em três tabelas distintas. Para que a integração ocorra corretamente, existe no Protheus a classificação do armazém, que determina se o cadastro será um Depósito, Unidade Receptora ou Ponto de Abastecimento. Nesta integração é possível incluir, alterar e excluir um Depósito, Unidade Receptora ou Ponto de Abastecimento. 

Os campos do cadastro de Depósito / Unidade Receptora / Ponto de Abastecimento a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os necessários ao funcionamento da integração.

WareHouse/Depósito
Identificador da Mensagem: WareHouse
Versão: 1.001
Módulo <Protheus>: <BackOffice – Gestão Agrícola>
Módulo <PIMS Multicultivos>: < Depósito / Unidade Receptora / Ponto de Abastecimento>
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Notas:
Para que o cadastro de depósitos seja enviado com sucesso ao PIMS Multicultivos, é necessário que seja escolhida alguma das classificações descritas abaixo no Protheus:

• 1 = Depósito - Será realizado o cadastro na tabela DEPOSITO, que representa o depósito de insumos no PIMS Multicultivos.

• 2 = Unidade Receptora - Será realizado o cadastro na tabela UNIRECEPTORA, que representa a unidade receptora dos produtos beneficiados no PIMS Multicultivos

• 3 = Não integra – Não realiza o envido da informação para o PIMS Multicultivos

• 4 = Ponto de Abastecimento - Será realizado o cadastro na tabela PONTOABAST, que representa o ponto de abastecimento no PIMS Multicultivos

Notas:

A integração de Depósito / Unidade Receptora / Ponto de Abastecimento poder ser utilizada em modo totalmente exclusivo ou compartilhada, realizando as configurações descritas abaixo;
Para funcionamento em modo exclusivo, o cadastro de Depósito / Unidade Receptora / Ponto de Abastecimento no Protheus precisa estar totalmente exclusivo no nível de Empresa e Filial e precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo:

Para funcionamento em modo compartilhado, o cadastro de Depósito / Unidade Receptora / Ponto de Abastecimento no Protheus precisa estar como compartilhado e precisa alterar o parâmetro no PIMS Multicultivos, como definido no quadro abaixo:

A integração de Depósito / Unidade Receptora / Ponto de Abastecimento permite que seja realizada a preambulação do código, onde será adicionado o código da Unidade Administrativa junto ao código do deposito, está configuração pode ser realizada através das configurações descritas abaixo;

Para realizar a preambulação do cadastro de Depósito / Unidade Receptora / Ponto de Abastecimento é necessário que seja alterado o PIMS Multicultivos, como descrito no quadro abaixo:

Para não realizar a preambulação do cadastro de Depósito / Unidade Receptora / Ponto de Abastecimento é necessário que seja alterado o PIMS Multicultivos, como descrito no quadro abaixo:

Campos Obrigatórios para o funcionamento da Integração

• Código
• Descrição
• Classificação
• Empresa
• Filial

Integração de Centro de Custos.

A integração de Centro de Custos consiste na movimentação do cadastro no sentido Protheus para PIMS Multicultivos, ou seja, será realizado no Protheus e enviado para o PIMS Multicultivos através do PIMSConnector. O objetivo é realizar o movimento dos respectivos centros de Custos do ERP para PIMS.

A integração de Centro de Custo para o Protheus é realizada através do cadastro do centro de Custo (CTBA180).

O cadastro de Centro de custo deve ser efetuado no Protheus e sincronizado automaticamente PIMS Multicultivos. Nesta integração é possível incluir, alterar e excluir um Centro de Custos
Os campos do cadastro de Centro de Custos do Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os necessários ao funcionamento da integração.

CostCenter/Centro de Custo
Identificador da Mensagem: CostCenter
Versão: 2.000
Módulo <Protheus>: <BackOffice – Ativo Fixo>
Módulo <PIMS Multicultivos>: < Centro de Custo>
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Notas:
A integração de Centro de Custo poder ser utilizada em modo totalmente exclusivo ou compartilhada, realizando as configurações descritas abaixo;
Para funcionamento em modo exclusivo, o cadastro de Centro de Custo no Protheus precisa estar totalmente exclusivo no nível de Empresa e Filial e precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo:

Para funcionamento em modo compartilhado, o cadastro de Centro de Custo no Protheus precisa estar como compartilhado e precisa alterar o parâmetro no PIMS Multicultivos, como definido no quadro abaixo:

A integração de Centro de Custo permite que seja realizada a preambulação do código, onde será adicionado o código da Unidade Administrativa junto ao código do centro de custo, está configuração pode ser realizada através das configurações descritas abaixo;
Para realizar a preambulação do cadastro de Centro de Custo é necessário que seja alterado o PIMS Multicultivos, como descrito no quadro abaixo:

Para não realizar a preambulação do cadastro de Centro de Custo é necessário que seja alterado o PIMS Multicultivos, como descrito no quadro abaixo:

Campos Obrigatórios para o funcionamento da Integração

• Código
• Descrição
• Empresa
• Filial

Integração de Prestador de Serviços / Fornecedor

A integração de Prestadores de Serviço consiste na movimentação do cadastro no sentido Protheus para PIMS Multicultivos, ou seja, será realizado no Protheus e enviado para o PIMS Multicultivos através do PIMSConnector.
A integração de Prestador de Serviços para o Protheus é realizada através do cadastro de Fornecedor (MATA020).

O cadastro de Prestador de Serviços deve ser efetuado no Protheus e sincronizado automaticamente PIMS Multicultivos. Nesta integração é possível incluir, alterar e excluir um Prestador de Serviços.

Os campos do cadastro de Fornecedor do Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os necessários ao funcionamento da integração.

CustomerVendor/Fornecedor

Identificador da Mensagem: CustomerVendor
Versão: 2.002
Módulo <Protheus>: <BackOffice – Estoque e Custo>
Módulo <PIMS Multicultivos>: < Prestador de Serviços>
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Notas:

A integração de Prestador de Serviços pode ser utilizada em modo totalmente exclusivo ou compartilhada, realizando as configurações descritas abaixo;
Para funcionamento em modo exclusivo, o cadastro de Prestador de Serviços no Protheus precisa estar totalmente exclusivo ao nível de Empresa e Filial e precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo:

Para funcionamento em modo compartilhado, o cadastro de Prestador de Serviços no Protheus, precisa estar como compartilhado, e precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo;

Campos Obrigatórios para o funcionamento da Integração

• Código
• Descrição
• Empresa
• Filial

Integração de Conta Contábil.

A integração de Conta Contábil consiste na movimentação do cadastro no sentido Protheus para PIMS Multicultivos, ou seja, será realizado no Protheus e enviado para o PIMS Multicultivos através do PIMSConnector.
A integração de Conta Contábil para o Protheus é realizado através do cadastro de Plano de Contas (CTBA020).

O cadastro de Conta Contábil deve ser efetuado no Protheus e sincronizado automaticamente PIMS Multicultivos. Nesta integração é possível incluir, alterar e excluir uma Conta Contábil.
Os campos do cadastro de Plano de Contas do Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os necessários ao funcionamento da integração.

AccountantAccount /Conta Contábil
Identificador da Mensagem: AccountantAccount
Versão: 2.000
Módulo <Protheus>: <BackOffice – Contabilidade Gerencial>
Módulo <PIMS Multicultivos>: < Conta Contábil>
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Notas:
Para funcionamento da integração de Conta Contábil no PIMS Multicultivos, o campo Classe Conta no Protheus deverá ser preenchido sempre como analítica, caso contrário, o processo de integração não funcionará.

Campos Obrigatórios para o funcionamento da Integração

• Código
• Descrição
• Tipo (Se Analítico ou Sintético)
• InternalId

Integração de Cargos

A integração de Cargos consiste na movimentação do cadastro no sentido Protheus para PIMS Multicultivos, ou seja, será realizado no Protheus e enviado para o PIMS Multicultivos através do PIMSConnector.
A integração de Cargos para o Protheus é realizada através do cadastro de Cargo (GPEA370).

O cadastro de Cargos deve ser efetuado no Protheus e sincronizado automaticamente no PIMS Multicultivos. Nesta integração é possível incluir, alterar e excluir um cargo.

Os campos do cadastro de Cargos do Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os campos necessários ao funcionamento da integração.

EmployeePosition /Cargos
Identificador da Mensagem: EmployeePosition
Versão: 1.001
Módulo <Protheus>: <BackOffice – Gestão de Pessoal>
Módulo <PIMS Multicultivos>: <Cargo>
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Notas:

Para funcionamento da integração de Cargo no PIMS Multicultivos, deverá existir uma unidade de medida cadastrada com a descrição "A DEFINIR", caso contrário, o processo de inclusão ou alteração não funcionará.

Para o processo de exclusão será obrigatório informação do código do cargo e a exclusão será realizada se o cargo não estiver relacionado com a disponibilidade do funcionário.
Campos obrigatórios para o funcionamento da Integração

• Código
• Descrição

Integração de Verbas

A integração de Verbas consiste na movimentação do cadastro no sentido Protheus para PIMS Multicultivos, ou seja, será realizado no Protheus e enviado para o PIMS Multicultivos através do PIMSConnector.
A integração de Verbas para o Protheus é realizada através do cadastro de Verba (GPEA040).

O cadastro de Verbas deve ser efetuado no Protheus e sincronizado automaticamente no PIMS Multicultivos. Nesta integração é possível incluir, alterar e excluir uma verba.

Os campos do cadastro de Verbas do Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os campos necessários ao funcionamento da integração.

PayrollAmount /Verbas
Identificador da Mensagem: PayrollAmount
Versão: 1.000
Módulo <Protheus>: <BackOffice – Gestão de Pessoal>
Módulo <PIMS Multicultivos>: Tabela Auxiliar
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Notas:

A integração de Verba poder ser utilizada em modo totalmente exclusivo ou compartilhado, realizando as configurações descritas abaixo;
Para funcionamento em modo exclusivo, o cadastro de Verbas no Protheus precisa estar totalmente exclusivo em nível de Empresa e Filial e precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo:

Para funcionamento em modo compartilhado, o cadastro de Verba no Protheus precisa estar como compartilhado e precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo:

No modo compartilhado, a integração da verba é replicada para todas as unidades administrativas do PIMS Multicultivos, portanto a exclusão da verba, será excluída em todas as unidades administrativas.

No PIMS Multicultivos não existe manutenção nesta tabela (MDO_EVEN_FOLHA). Ela tem como finalidade fazer o relacionamento com o Protheus (De/Para) no envio da integração de Movimentos Ruralistas gerados no PIMS Multicultivos. No cadastro de verbas do PIMS Multicultivos há uma aba definida como interfaces onde existem os campos "Código da Verba no ERP" e "Código da Verba no ERP para Domingo e Feriado", onde será informado para qual código da verba do Protheus será gerada a movimentação de ruralistas.

Campos obrigatórios para o funcionamento da Integração

• Empresa – opcional em modo compartilhado
• Filial – opcional em modo compartilhado
• Código
• Descrição

Integração de Sindicatos

A integração de Sindicatos consiste na movimentação do cadastro no sentido Protheus para PIMS Multicultivos, ou seja, será realizado no Protheus e enviado para o PIMS Multicultivos através do PIMSConnector.  A integração de Sindicatos para o Protheus é realizada através do cadastro de Sindicato (GPEA340).

O cadastro de Sindicatos deve ser efetuado no Protheus e sincronizado automaticamente no PIMS Multicultivos. Nesta integração é possível incluir, alterar e excluir um sindicato.

Os campos do cadastro de Sindicatos do Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os campos necessários ao funcionamento da integração.

LaborUnion /Sindicatos
Identificador da Mensagem: LaborUnion
Versão: 1.001
Módulo <Protheus>: <BackOffice – Gestão de Pessoal>
Módulo <PIMS Multicultivos>: <Sindicato>
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Notas:

A integração de Sindicato poder ser utilizada em modo totalmente exclusivo ou compartilhado, realizando as configurações descritas abaixo;
Para funcionamento em modo exclusivo, o cadastro de Sindicatos no Protheus precisa estar totalmente exclusivo em nível de Empresa e Filial, e precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo:

Para funcionamento em modo compartilhado, o cadastro de Sindicatos no Protheus precisa estar como compartilhado e precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo:

No modo compartilhado, a integração de sindicato é replicada para todas as unidades administrativas do PIMS Multicultivos. Na opção de exclusão será excluído o sindicato de todas as unidades administrativas desde que o mesmo não esteja relacionado com o cadastro de funcionários. A exclusão será somente total, ou seja, se houver algum relacionamento em alguma das unidades administrativas, não será realizada exclusão parcial.
Campos obrigatórios para o funcionamento da Integração

• Empresa – opcional em modo compartilhado
• Filial – opcional em modo compartilhado
• Código
• Descrição

Integração de Horários

A integração de Horário consiste na movimentação do cadastro no sentido Protheus para PIMS Multicultivos, ou seja, será realizada no Protheus e enviada para o PIMS Multicultivos através do PIMSConnector.  A integração de Horários para o Protheus é realizada através do cadastro de Tabela de Horário (PONA080).

O cadastro de horário deve ser efetuado no Protheus e sincronizado automaticamente no PIMS Multicultivos. Nesta integração é possível incluir e alterar.

Os campos do cadastro de Tabela de Horário do Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os campos necessários ao funcionamento da integração.

ScheduleWork /Horários
Identificador da Mensagem:ScheduleWork
Versão: 1.000
Módulo <Protheus>: <BackOffice – Gestão de Pessoal>
Módulo <PIMS Multicultivos>: <Horários>
Tipo de Envio: <Assíncrona/Síncrona>

Notas:

A integração de Horário pode ser utilizada em modo totalmente exclusivo ou compartilhado, realizando as configurações descritas abaixo:
Para funcionamento em modo exclusivo, o cadastro de Tabela de Horário no Protheus, precisa estar totalmente exclusivo em nível de Empresa e Filial e precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo:

Para funcionamento em modo compartilhado, o cadastro de Tabela de Horários no Protheus precisa estar como compartilhado e precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo. No modo compartilhado, a integração do horário é replicada para todas as unidades administrativas do PIMS Multicultivos.

Campos obrigatórios para o funcionamento da Integração

• Empresa – opcional em modo compartilhado
  
  
• Filial – opcional em modo compartilhado
  
  
• Código do Horário
  
  
• Descrição do Horário
  
  
• Sequencia
  
  
• Tipo de Dia
  
  
• Tipo de Hora
  
  
• Hora Inicial
  
  
• Hora Final

Processo:

No processo de integração de horários no PIMS Multicultivos serão gerados:

• Cadastro de Horário (MDO_HORARIO): Código e descrição do horário. O código do horário é formado pelo código do turno enviado pelo Protheus + sequência da semana. Ex: 00101 e 00102 (Código 001 e semana 01 e 02). No XML recebido a sequência 1 a 7 corresponde à semana 01, sequência 8 a 14 à semana 02 e assim sucessivamente. Para cada semana será gerado um horário.

• Vigência do Horário (MDO_HORARIO_VG): Corresponde a data inicial e final de vigência. Na integração é gravada na data inicial o primeiro dia do ano corrente que está sendo realizada a integração e a data final não é preenchida. A MDO_HORARIO_VG tabela é gerada quando não existe informação para o horário correspondente, não é alterada pela integração.

• Jornada de Trabalho (MDO_HORARIO_JOR): Corresponde a jornada de trabalho, horário de refeição e intervalo em determinado dia da semana. Somente é gerada informação quando o tipo de dia é definido como trabalhado. Para os tipos DSR e Compensado não é gerado informação na tabela MDO_HORARIO_JOR. No processo de integração esta tabela é sempre apagada e gerada novamente.

• Tabela Auxiliar de Escala de Folgas (MDO_ESCALA_FOLGA_ERP). Esta tabela não possui manutenção dentro do PIMS Multicultivos. Tem como finalidade prover informações para geração de escalas de folga do funcionário na integração de troca de turno (Histórico de Horário). A tabela possui informação referente ao código do turno e as semanas com os dias, com situação de trabalhado, compensado e DSR enviados pelo Protheus.

Integração de Funcionário

A integração de Funcionário consiste na movimentação do cadastro no sentido Protheus para PIMS Multicultivos, ou seja, será realizada no Protheus e enviada para o PIMS Multicultivos através do PIMSConnector.  A integração de Funcionário para o Protheus é realizada através do cadastro de Funcionários (GPEA010).

O cadastro de funcionário deve ser efetuado no Protheus e sincronizado automaticamente no PIMS Multicultivos. Nesta integração é possível incluir, alterar e excluir o funcionário

Os campos do cadastro de Funcionário do Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os campos necessários ao funcionamento da integração.

Employee /Funcionário
Identificador da Mensagem: Employee
Versão: 3.002
Módulo <Protheus>: <BackOffice – Gestão de Pessoal>
Módulo <PIMS Multicultivos>: <Funcionário>
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Notas:

A integração de funcionário é utilizada em modo exclusivo. No Protheus precisa estar totalmente exclusivo em nível de Empresa e Filial.
A integração de Funcionário gera as seguintes tabelas:

• Funcionário (FUNCIONAR). O código do funcionário no PIMS Multicultivos é formado pelo código proveniente do Protheus e pelo conteúdo do campo "Prefixo do Funcionário" do cadastro de filial. Se não for informado mantém o mesmo código do Protheus, se for informado, o código fica composto por "Prefixo do Funcionário" + "Código do Protheus (com tamanho fixo de 6 posições completado com zeros a esquerda)". O cadastro de funcionário tem relacionamento com o cadastro de sindicato, porém, não é uma informação obrigatória. Quando informado, é verificada a existência do mesmo no PIMS Multicultivos.

• Disponibilidade (FUNCIONARIODISP). Disponibilidade do funcionário representa o histórico de cargo, centro de custo, unidade administrativa e situações do funcionário;
• Ativo;
• Férias;
• Afastado;
• Demitido.

Na inclusão do funcionário é gerada a informação de disponibilidade tendo como base a data de admissão. Na alteração do funcionário será atualizada a disponibilidade quando houver uma alteração de cargo ou se houver alguma correção na data de admissão. A disponibilidade tem relacionamento com Cadastro de Cargos e Centro de Custos, sendo obrigatórios para geração da disponibilidade.

• Classe de Pagamento (FUNCIONARCLASSE). A Classe de Pagamento do cadastro de funcionário, representa o histórico de mudanças de classe de pagamento. Para ser gerado o histórico da classe de pagamento na inclusão ou na alteração do funcionário é necessário ter os seguintes parâmetros pré-definidos:

  Nome Parâmetro	Contexto	Descrição	Valor
  CD_MDO_CLASSE_PGT_RURAL	PIMSGRAOS.MAO_OBRA_RURAL	Integração funcionário: código da classe de pagto p/ tipo T - Tarefeiro	Informar código
  CD_MDO_CLASSE_PGT_RURAL	CD_MDO_CLASSE_PGT_FIXO	Integração funcionário: código da classe de pagto p/ tipo diferente de T -Tarefeiro	Informar código

  
  Se os parâmetros não estiverem previamente definidos, o histórico de classe de pagamento não será gerado, porém o cadastro de funcionários será gerado.
  Campos obrigatórios para o funcionamento da Integração

   

• Empresa
• Filial
• Código / Matrícula do Funcionário
• Nome do Funcionário
• Cargo do Funcionário
• Centro de Custo do Funcionário
• Sexo do Funcionário
• Data de Admissão

Processos

Integração de Movimentação de Estoque

A integração de movimento de estoque consiste na movimentação de lançamentos no sentido PIMS Multicultivos para Protheus, ou seja, será realizado no PIMS Multicultivos e enviado para o Protheus através do PIMSConnector. Abaixo são listadas as rotinas que realizam a movimentação de estoque:

As movimentações de saídas realizarão a retirada dos produtos consumidos no PIMS. Esta movimentação pode ser realizada através dos seguintes apontamentos:

• Apontamentos de Aplicações de Insumos;
• Apontamentos de Plantio;
• Apontamento de Tratamento de Sementes;
• Apontamento de Abastecimentos;
• Apontamento de Lubrificação;
• Baixa dos Insumos Consumidos no Beneficiamento.

As movimentações de entrada realizarão a inclusão dos produtos produzidos no PIMS para ERP. Esta movimentação pode ser realizada através dos seguintes apontamentos:

• Entrada dos Produtos Beneficiados no Estoque;
• Entrada de Matéria Prima Pesagem.

Se necessário, as movimentações de estoque poderão ser estornadas para reconstituir o saldo no estoque, caso haja inconsistência nas quantidades lançadas no PIMS Multicultivos, este processo é realizado através do processo de liberação de boletins.

• Apontamentos de Aplicações de Insumos;
• Apontamentos de Plantio;
• Apontamento de Tratamento de Sementes;
• Apontamento de Abastecimentos;
• Apontamento de Lubrificação;
• Baixa dos Insumos Consumidos no Beneficiamento;
• Entrada dos Produtos Beneficiados no Estoque;
• Entrada de Matéria Prima Pesagem.
  
  

Origens dos Apontamentos

As informações inseridas no PIMS Multicultivos possuem deferentes origens, sua identificação é realizada através do campo FG_ORIGEM, este campo é preenchido com letras que identificarão qual apontamento solicitou a movimentação deste material. As origens utilizadas na integração de movimentação de estoque estão descritas abaixo:

• P – Apontamento de Plantio;
• I – Aplicação de Insumos;
• T – Tratamento de Sementes;
• C – Apontamento de Combustíveis;
• L – Apontamento de Lubrificação;
• E - Entrada dos Produtos Beneficiados no Estoque;
• M – Entrada de Matéria Prima Pesagem;
• Y – Estorno do Custo produto Beneficiado;
• Z – Entrada do Custo Produto Beneficiado;
• B – Baixa dos Insumos Consumidos no Beneficiamento;
• O – Ordem de Serviço de Campo.
  
  

Status de Processamento

O PIMS Multicultivos realiza o controle de processamento das suas movimentações através de status atribuído ao campo FG_STATUS. Para correto funcionamento do processo de integração, utilizaremos alguns dos status descritos abaixo:

• 0 – Aguardando execução
• 1 – Em Execução
• 2 – Enviado para o ERP
• 3 – Erro no Processamento pelo ERP
• 4 – Valorizado com Sucesso pelo ERP
• 5 – Erro atualizado pelo PIMS
• 6 – Valorizado pelo PIMS
• 10 – Aguardando Execução do Estorno
• 11 – Em execução do Estorno
• 12 – Erro na execução do estorno pelo ERP
• 15 – Processado com Sucesso pelo ERP

Tipos de Movimentos

Para identificar quando será realizada uma movimentação de Saída ou Entrada, é utilizado o campo FG_TPMOVTO. Este campo define qual operação será realizada, seu valor do precisa ser definido em conjunto com a equipe do ERP.

Notas:

A integração de movimentação de estoque pode ser realizada de forma assíncrona ou síncrona, conforme a configuração realizada no parâmetro abaixo;
Para habilitar o processo de movimentação de estoque de forma síncrona (Online), precisa alterar o parâmetro FG_MOV_ESTOQUE_SINC no PIMS Multicultivos, como descrito no quadro abaixo:

Para habilitar o processo de movimentação de forma assíncrona (off-line), precisa alterar o parâmetro abaixo no PIMS Multicultivos, como descrito no quadro:

O envio da integração de Movimentação de Estoque deve ser realizado em modo lista, para não haver inconsistência no processo de movimentação com o Estoque no ERP. O parâmetro deve estar como demostrado no quadro abaixo:

Para configurar a Unidade de Negócio a ser utilizado no processo de integração, é necessário preencher o parâmetro descrito no quadro abaixo.

Os campos necessários para a movimentação de estoque do PIMS Multicultivos a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os necessários ao funcionamento da integração.

StockTurnover/Movimentação de Estoque

Identificador da Mensagem: StockTurnover
Versão: 1.003
Módulo <Protheus>: <BackOffice – Estoque e Custo>
Módulo <PIMS Multicultivos>: < Apontamentos>
Tipo de Envio: <Assíncrona/Síncrona>

Integração de Depreciação de Bens / Cálculo de Depreciação mensal do Ativo Fixo

A integração de Depreciação de Bens consiste na movimentação de lançamentos no sentido Protheus para PIMS Multicultivos, ou seja, será realizada no Protheus e enviada para o PIMS através do PIMSConnector. O objetivo é a alocação de custos de depreciação para os equipamentos no processamento de custos agrícolas, obtidos através dos valores de depreciação de bem.

A integração de Depreciação de Bens para o Protheus é realizada através do processamento de Cálculo de Depreciação mensal do módulo Ativo Fixo (ATFA050).
Os campos do Processamento de Cálculo de Depreciação no Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os necessários ao funcionamento da integração.

Observação: Caso seja necessário realizar o reprocessamento de depreciação de bens para o mesmo período, é necessário realizar a Exclusão de Registros Integrados no PIMS Multicultivos. Se a Exclusão de Registros Integrados não for realizada, pode gerar inconsistências nos valores enviados no processo de integração.

Notas:
Para que a Depreciação de Bens seja enviada com sucesso ao PIMS Multicultivos é necessário que o campo Int. PIMS no cadastro do Bens (Protheus), esteja preenchido com "Sim". O campo Int. PIMS será editável somente para os tipos fiscais.

A integração de Depreciação de Bens para o PIMS Multicultivos, verifica a valor do parâmetro EMPRESA_FILIAL_EAI, para determinar se utilizará a integração em modo totalmente exclusivo ou compartilhado. Abaixo é descrito as informações do parâmetro:

Depreciação de Bens

Identificador da Mensagem: Depreciação de Bens
Versão: 1.000
Módulo <Protheus>: <BackOffice – Ativo Fixo>
Módulo <PIMS Multicultivos>: <Depreciação de Bens>
Tipo de Envio: <Assíncrona/Síncrona>
Campos Obrigatórios para o funcionamento da Integração

• Período de Depreciação
• Código do Centro de Custos
• Código do Equipamento
• Código da Empresa
• Código da Filial
• Valor

Integração de Despesas Gerais / Bloqueio do Calendário Contábil

A integração de Despesas Gerais consiste na movimentação de lançamentos no sentido Protheus para PIMS Multicultivos, ou seja, será realizada no Protheus e enviada para o PIMS Multicultivos através do PIMSConnector. O objetivo é realizar o processamento dos custos agrícolas, através dos valores consumidos por Centro de Custos e Conta Contábil.

A integração de Despesas Gerais para o Protheus é realizada através do Bloqueio do Calendário Contábil (CTBA010).

O Processamento de Despesas Gerais deve ser efetuado no Protheus e sincronizado automaticamente PIMS Multicultivos.

Os campos do Bloqueio do Calendário Contábil no Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os necessários ao funcionamento da integração.

Observação: Caso seja necessário realizar o reprocessamento de despesas gerais, para o mesmo período, é preciso realizar a Exclusão de Registros Integrados no PIMS Multicultivos. Se a Exclusão de Registros Integrados não for realizada, pode gerar inconsistências nos valores enviados no processo de integração.

Notas:

A integração de Despesas Gerais para o PIMS Multicultivos verifica o valor do parâmetro EMPRESA_FILIAL_EAI, para determinar se utilizará a integração em modo totalmente exclusivo ou compartilhado. Abaixo é descrito as informações do parâmetro:

Despesas Gerais / Bloqueio do Calendário Contábil

Identificador da Mensagem: Despesas Gerais
Versão: 1.000
Módulo <Protheus>: <BackOffice – Contabilidade Gerencial>
Módulo <PIMS Multicultivos>: < Despesas Gerais >
Tipo de Envio: <Assíncrona/Síncrona>

Campos Obrigatórios para o funcionamento da Integração:

• Período das Despesas Gerais
• Código do Centro de Custos
• Código da Conta Contábil
• Código da Empresa
• Código da Filial
• Valor

Integração de Valores de Materiais

A integração de Valores de Materiais consiste na movimentação de lançamentos no sentido Protheus para PIMS Multicultivos, ou seja, será realizada no ERP e enviada para o PIMS Multicultivos através da tabela intermediária BRG_BXMATERIAL_EMS.

O objetivo é valorizar os itens apontados no PIMS Multicultivos;

• Aplicações de Insumos,
• Apontamentos de Plantio
• Tratamento de Sementes;
• Apontamento de Abastecimento;
• Apontamento de Lubrificantes

Os valores serão gerados pelo recálculo do custo médio no Protheus (MATA330). No PIMS Multicultivos tem um serviço agendado que chega a tabela BRG e atualiza os apontamentos correspondentes.

Valores de Materiais
Identificador da Mensagem: ItemCosting
Versão: 1.000
Módulo <Protheus>: <BackOffice – Estoque/Custos >
Módulo <PIMS Multicultivos>: <Apontamentos>
Tipo de Envio: <Assíncrona/Síncrona>

Notas:

Campos obrigatórios para o funcionamento da Integração:

• Empresa – se não vier atualiza todas as empresas
• Filial – se não vier atualiza todas as filiais
• Depósito – se não vier atualiza todos os depósitos
• Código do Produto
• Sequência – para determinar o campo da tabela a atualizar
• Valor

Integração de Situação do Funcionário

A integração de Situação do Funcionário consiste na movimentação de informações referentes a Férias, Afastamentos e Demissões no sentido Protheus para PIMS Multicultivos, ou seja, será realizada no Protheus e enviada para o PIMS Multicultivos através do PIMSConnector.

A integração de Situação do Funcionário no Protheus é realizada através das rotinas Calculo de Rescisão (GPEM040), Reintegração de Funcionário (GPEA810), Cadastro de Afastamentos(GPEA240), Cadastro de Funcionários(GPEA010), Calculo de Férias (GPEM030), Calculo de Férias Coletivas(GPEM060) e Calculo de múltiplas Rescisões (GPEM630).

O Processamento da Situação do Funcionário deve ser efetuado no Protheus e sincronizado automaticamente PIMS Multicultivos.
Os campos da Situação do Funcionário no Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os campos necessários ao funcionamento da integração.

Situação do Funcionário
Identificador da Mensagem: EmployeeSituations
Versão: 1.000
Módulo <Protheus>: <BackOffice – Gestão de Pessoal>
Módulo <PIMS Multicultivos>: <Funcionários (Disponibilidade, Rescisão e Afastamento>
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Notas:
O processo de integração de situação do funcionário gera as seguintes informações:

• Disponibilidade (FUNCIONARDISP). Representa o histórico de movimentos da situação do funcionário, que pode ser Ativo, Afastado, Férias ou Demissão.

• Afastamento (FUNCIONARAFAST). Representa o histórico de movimento de afastamentos com data de início e data final abrangendo as situações de férias e afastamento.

• Rescisão (FUNCIONARDISP). Representa informação sobre a demissão do funcionário.

Campos Obrigatórios para o funcionamento da Integração:

• Empresa
• Filial
• Código do Funcionário
• Data Inicial da Situação
• Quantidade de Dias na situação
• Tipo de Situação

Integração de Histórico de Salários do Funcionário

A integração de Histórico de Salários do Funcionário consiste na movimentação de alteração salarial no sentido Protheus para PIMS Multicultivos, ou seja, será realizada no Protheus e enviada para o PIMS Multicultivos através do PIMSConnector.
A integração de Histórico de Salários do Funcionário no Protheus é realizada através das Rotinas Cadastro de Funcionários(GPEA010), Cadastro de Histórico Salarial (GPEA250), Calculo de Dissídio Retroativo(GPEM690) e Reajuste salarial (GPER200).

O processamento de alteração de salário do funcionário deve ser efetuado no Protheus e sincronizado automaticamente no PIMS Multicultivos.
Os campos do Histórico de Salários do Funcionário no Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os campos necessários ao funcionamento da integração.

Histórico de Salário do Funcionário
Identificador da Mensagem: EmployeeHistoryçSalaryPosition
Versão: 1.000
Módulo <Protheus>: <BackOffice – Gestão de Pessoal>
Módulo <PIMS Multicultivos>: <Funcionários (Salário)>
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Notas:
Para realizar a integração do histórico de salário do funcionário é necessário que o funcionário tenha disponibilidade informada (aba "Disponibilidade" do cadastro de funcionário) e a classe de pagamento do funcionário deve ser do tipo rural.

Campos Obrigatórios para o funcionamento da Integração:

• Empresa
• Filial
• Código do Funcionário
• Data de alteração de salário
• Valor do Salário
• Frequência de Pagamento

Integração de Histórico de Horários e Escalas do Funcionário

A integração de Histórico de Horários e Escalas do Funcionário consiste no envio das trocas de turnos no sentido Protheus para PIMS Multicultivos, ou seja, será realizada no Protheus e enviada para o PIMS Multicultivos através do PIMSConnector. A integração de Histórico de Horários e Escalas do Funcionário no Protheus é realizada através da Troca de Turnos (PONA160).

O processamento de troca de turnos do funcionário deve ser efetuado no Protheus e sincronizado automaticamente no PIMS Multicultivos.

Os campos da Troca de Turnos do Funcionário no Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os campos necessários ao funcionamento da integração.

Histórico de Horários e Escalas do Funcionário
Identificador da Mensagem: EmployeeHistoryWorkShift
Versão: 1.000
Módulo <Protheus>: <BackOffice – Gestão de Pessoal>
Módulo <PIMS Multicultivos>: <Funcionários (Escala de Folga e Horário)>
Tipo de Envio: <Assíncrona/Síncrona>
Tipo de Evento: Upsert / Delete

Notas:

Para realizar a integração do histórico de horário e escalas do funcionário é necessário que o funcionário tenha disponibilidade informada (aba "Disponibilidade" do cadastro de funcionário).
Esta integração gera as seguintes informações:

• Histórico de Horário (FUNCIONARHR). Representa movimento de alteração de horário. Se o horário possuir mais de uma sequência, será gerado movimento até o final do ano corrente tendo como data todas as segundas-feiras após a data de alteração enviada na mensagem de integração. Quando possui apenas uma sequência, será gerado apenas um registro na tabela de histórico de horário. No processo de integração sempre serão excluídos todos os registros existentes a partir da data de alteração.

• Histórico de Escalas de Folga (FUNCIONARESCA). Representa movimento de alteração de escalas de folga. No processo de integração sempre serão excluídos todos os registros existentes a partir da data de alteração. Antes da geração do registro na tabela de histórico de escala de folga é realizada a inclusão ou alteração da escala de folga (Tabelas  Mão de Obra Rural  Escalas de Folga), o código da escala de folga será formado pelo código do turno mais o código do funcionário e a descrição será o nome do funcionário, na sequência serão gerados os dias de folga ( Tabelas  Mão de Obra Rural Escalas de Folga  Aba "Dias de Folga" ) , ou seja, para cada funcionário existirá um cadastro de escala de folga, para gerar o cadastro é utilizado uma tabela auxiliar que é gerada na integração do Horário (Tabela de horário do Protheus).

Quando a mensagem de integração for uma exclusão, serão excluídos todos os registros referentes a horário e escalas de folga a partir da data enviada no XML da mensagem.

Campos Obrigatórios para o funcionamento da Integração:

• Empresa
• Filial
• Código do Funcionário
• Data de alteração do horário
• Código do Horário (Turno) – opcional na exclusão
• Sequência do Horário (Semana 1, Semana 2, ....) – opcional na exclusão

Integração de Transferência de Funcionário

A integração de Transferência de Funcionário consiste no processo no sentido Protheus para PIMS Multicultivos, ou seja, será realizada no Protheus e enviada para o PIMS Multicultivos através do PIMSConnector.
A integração de Transferência de Funcionário no Protheus é realizada através da Transferência do Funcionário (GPEA180).

Os campos da Transferência do Funcionário no Protheus a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os campos necessários ao funcionamento da integração.

Transferência de Funcionário
Identificador da Mensagem: SetEmployeeBranchTranfer
Versão: 1.000
Módulo <Protheus>: <BackOffice – Gestão de Pessoal>
Módulo <PIMS Multicultivos>: <Funcionários (Disponibilidade e Rescisão)>
Tipo de Envio: <Assíncrona/Síncrona>

Notas:

Para ser realizada a integração de transferência, é preciso que o funcionário possua informação de disponibilidade. No processo serão recuperadas as informações de disponibilidade do funcionário para criação de nova disponibilidade.
A integração utiliza o parâmetro abaixo para determinar se o funcionário que está sendo transferido de empresa ou filial é classificado como tarefeiro ou não, ou seja, se o tipo da classe de pagamento é rural. Este parâmetro considera a empresa ou filial destino, se o parâmetro informado for igual a classe de pagamento do funcionário na origem, ele é considerado como tarefeiro (rural).

A integração de transferência de funcionário é composta por três tipos de processos:

• Alteração de Centro de Custo: Este processo consiste apenas na mudança de centro de custo, gerando uma nova disponibilidade para o funcionário pelo código informado na mensagem de integração.

• Transferência de Empresa ou Filial e mesmo código no destino: Este processo consiste na mudança de empresa ou de filial do funcionário mantendo o mesmo código. Se o centro de custo for enviado na mensagem de integração, será considerado para geração da nova disponibilidade, caso contrário, será considerado o centro de custo recuperado na disponibilidade registrada para o funcionário. Neste processo também é gerado o histórico de classe de pagamento.

• Transferência de Empresa ou Filial e código diferente no destino: Este processo consiste na mudança de empresa ou filial do funcionário através de um novo código. Se o centro de custo for enviado na mensagem de integração, será considerado para geração de nova disponibilidade, caso contrário será considera o centro de custo recuperado na disponibilidade registrado para o funcionário. Neste processo é gerada uma rescisão para o código anterior do funcionário e criado um novo funcionário seguindo a mesma rotina de integração de Funcionário.

Campos Obrigatórios para o funcionamento da Integração:

• Empresa - Origem
• Filial - Origem
• Código do Funcionário – Origem
• Empresa – Destino
• Filial – Destino
• Código do Funcionário – Destino
• Data de Transferência
• Centro de Custo (Opcional nas transferências de Empresa e Filial)

Integração de Movimento de Ruralistas

A integração de Movimento de Ruralistas consiste no processo no sentido PIMS Multicultivos para o Protheus, ou seja, será realizada no PIMS Multicultivos e enviada para o Protheus através do PIMSConnector.

A integração de Movimento de Ruralistas é realizada na opção Processamentos  Mão de Obra Rural  Geração de Dados para Folha de Pagamento – ERP no PIMS Multicultivos.

Movimento dos Ruralistas
Identificador da Mensagem: MonthlyPayroll
Versão: 1.000
Módulo <PIMS Multicultivos>: <Geração de Dados para Folha de Pagamento - ERP>
Módulo <Protheus>: <BackOffice – Gestão de Pessoal>
Tipo de Envio: <Assíncrona/Síncrona>

Notas:

Se a mensagem for processada com sucesso no Protheus, será excluído o registro da tabela BRG_MDO_BOLRUR, se houver erro, será gravado código de status de erro no registro correspondente ao processo. Toda vez que for realizada a geração do movimento pelo PIMS Multicultivos, serão excluídos todos os registros referentes à data informada e os filtros informados para processamento.

Campos Obrigatórios para o funcionamento da Integração:

• Empresa
• Filial
• Código do Funcionário
• InternalId do Funcionário
• Código da Verba
• InternalId da Verba
• Tipo de Conteúdo da verba 1-Horas 2-Dias 3-Valor 4-Referência
• Quantidade do Tipo da Verba
• Valor da Verba
• Data de Pagamento
• Data de Referência
• Mês de Competência
• Ano de Competência
• Tipo de Registro 1-Adiantamento 2-Calculado 3-Lançamento do Ponto Eletrônico 4-Fechamento 5-Gerado 6-Informado 7-Férias 8-1ª. Parcela 9-2ª. Parcela 10-Rescisão
• Centro de Custo
• InternalId do Centro de Custo

Integração de Solicitação de materiais Aplicados na OS de oficina

Tem como objetivo registrar os serviços de manutenção realizados pelos mecânicos nos equipamentos. Essa inclusão é realizada através da Ordem de Serviço de Oficina Mecânica.
O PIMSMulticultivo é responsável por gerar a OS e apontar os materiais que serão solicitados ao Protheus. O Protheus por sua vez, tem a responsabilidade de analisar o estoque, identificar a necessidade de realizar compra ou solicitação de estoque e enviar os materiais que serão atendidos.

A integração de Solicitação ao Armazém no Protheus utiliza as seguintes rotinas: Solicitação ao Armazém (MATA105), Liberação de SA (MATA107), Gerar Pré-Requisição (MATA106), Baixa de Pré-Requisição(MATA185) e Movimento Interno (MATA241)
Na inclusão das solicitações de matérias é necessário escolher o Tipo de Peça / Serviço, conforme abaixo;

• Interna – Peça que movimentarão o estoque, caso não existam em estoque, será gerado processo de compras;
• Externa – Peças que realizarão processado de compras;
• Mão de Obra Externa – Mão de Obra que serão executadas por terceiros.
  
  

A opção Tipo de Peça / Serviço, informado no cadastro de solicitação de materiais do PIMS, influencia diretamente no comportamento da solicitação de armazém do Protheus pois, ao determinar que o tipo de peça ou serviço será externa ou mão de obra Externa, o fluxo de processamento do Protheus irá mudar. Quando for tipo externo ou mão de obra externo, o Protheus irá realizar o processo de compra, mesmo que o produto tenha saldo em estoque. Este procedimento será realizado pois, as peças solicitas pelo PIMS, já foram aplicadas no equipamento, através de um estabelecimento externo.

O processo de integração é iniciado ao acionar o botão enviar, onde será alterado a Situação da Solicitação de Materiais de NP (Não Processado pelo ERP) para EV (Enviado ao ERP). Após envio ao ERP, não será mais permitido modificar as informações envidas ao Protheus.

Ao acionar o botão enviar, internamente o processo de integração realizará a manipulação de Status, conforme abaixo:

• 0 - Não processado
• 1 – Em processamento
• 2 – Enviado ao ERP aguardando retorno
• 3 – Erro no envio da integração
• 4 – Processado pelo ERP
• 9 – Integrado Manualmente – Ponto de Abastecimento não está marcado para integrar
• 5 – Cancelado ou Excluído pelo ERP
  
  

O processo de integração entre PIMS x Protheus utilizando o PIMSConnector pode ser realizado de duas formas assíncrona ou síncrona, dependendo das configurações realizadas no parâmetro FG_MOV_OFICINA_SINC.
Para funcionamento em modo síncrono (Online), precisa alterar o parâmetro abaixo no PIMS Multicultivos, como descrito no quadro abaixo:

Para funcionamento em modo assíncrono (Off-line), precisa alterar o parâmetro abaixo no PIMSMulticultivo, como descrito no quadro abaixo:

Obs.: Para um melhor funcionamento e controle do processo de integração da Solicitação de Materiais é recomendado que o processo de envio esteja habilitado para funcionar em modo Síncrona (Online).
A integração de solicitação de materiais controla as ocorrências de processamento através do cadastro de situações, onde teremos as seguintes situações:

Integração de Retorno da Contabilização de Custo (Lançamentos Contábeis)

Tem como objetivo retornar à contabilização de custo ao ERP. Esse processo é realizado através da rotina de Contabilização de Retorno de Custos.

Retorno da Contabilização de Custos ao ERP
Identificador da Mensagem: AccountingEntry
Versão: 2.000
Módulo <Protheus>: <BackOffice – Controladoria >
Módulo <PIMS Multicultivos>: <CUSTAG>
Tipo de Envio: <Assíncrona/Síncrona>