Guia Rápido Integração - PIMS Multicultivos x Protheus utilizando o PIMSConnector 13/11/2015

Sumário


1. Objetivo
2. Protheus
3. PIMS Multicultivos
4. Transações
4.1 Unidade de Medidas
4.2 Grupo de Produtos
4.3 Insumos/Materais
4.4 Depósito/Unidade Receptora/Ponto de Abastecimento
4.5 Centro de Custos
4.6 Prestador de Serviços/Fornecedor
4.1 Conta Contábil/Plano de Contas
4.2 Cargos
4.3 Verbas
4.4 Sindicatos
4.5 Horários
4.6 Funcionários
4.7 Movimento de Estoque
4.8 Depreciação de Bens/Cálculo de Depreciação mensal do Ativo Fixo
4.9 Despesas Gerais/Bloqueio do Calendário Contábil
4.10 Valores de Materiais
4.11 Situação do Funcionário
4.12 Histórico de Salários do Funcionário
4.13 Histórico de Horários e Escalas do Funcionário
4.14 Transferência de Funcionário
4.15 Movimento de Ruralistas
4.16 Solicitação de Materiais Aplicados na OS de Oficina
4.17 Retorno da Contabilização de Custo (Lançamentos Contábeis)

Objetivo


Este documento tem como objetivo apresentar as informações BÁSICAS sobre configuração e parametrização dos ambientes envolvidos. Informações complementares devem ser consultadas na documentação total do sistema.

Protheus


O BackOffice Protheus deve estar devidamente instalado e Configurado em ambiente de Homologação e Produção, com versão 11.80 ou superior.
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.

  1. Acesse em

  1. Clique em para realizar a busca do parâmetro.





Todas as variáveis são iniciadas pelo prefixo MV_ e agem sobre diversas operações no Sistema.

     Valor  .T.

     Valor .T.

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. Acesse em

  1. Clique em

  1. Informe os dados do Adapter em seguida clique em



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

Descrição

Mensagem

Rotina

Condição Adapter

Tipo

Unidade de Medida

UNITOFMEASURE

QIEA030

-

Sync

Depósito

WAREHOUSE

AGRA045

(NNR->NNR_INTP) $ "1|2|4

Sync

Grupo de Materiais

FAMILY

MATA035

-

Sync

Materiais

ITEM

MATA010

(SB1->B1_TIPO) $ "IA|MM

Sync

Baixa de Estoque

STOCKTURNOVER

MATA241

!Empty(SD3->D3_NRBPIMS)

Sync

Valores de Estoque

ITEMCOSTING

MATA330

(SB1->B1_TIPO) $ "IA|MM

Async

Solicitação de Materiais

REQUEST

MATA105

-

Sync

Centro de Custos

COSTCENTER

CTBA030

-

Sync

Fornecedores

CUSTOMERVENDOR

MATA020

-

Sync

Conta Contábil

ACCOUNTANTACCOUNT

CTBA020

(CT1->CT1_CLASSE) $ "2"

Sync

Despesas Gerais

PERIODGLBALANCE

CTBA012A

-

Async

Lançamentos Contábeis

ACCOUNTINGENTRY

CTBA102

-

Async

Depreciação de Bens

ASSETDEPRECIATION

ATFA051

-

Async

Cargos

EMPLOYEEPOSITION

GPEA370

-

Sync

Verbas

PAYROLLAMOUNT

GPEA040

-

Sync

Sindicatos

LABORUNION

GPEA340

-

Sync

Funcionários

EMPLOYEE

GPEA010

-

Sync

Situação do Funcionário

EMPLOYEESITUATIONS

GPEM040

-

Sync

Movimento dos Ruralistas

MONTHLYPAYROLL

GPEA090

-

Async

Horários/Escalas

SCHEDULEWORK

PONA080

-

Sync

Histórico de Horários/Escalas

EMPLOYEEHISTORYWORKSHIFT

PONA160

-

Sync

Transferência

EMPLOYEEBRANCHTRANSFER

GPEA180

-

Sync

Histórico Salário

EMPLOYEEHISTORYSALARYPOSITION

GPEA250

-

Sync


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. Acesse em

  1. Clique em para adicionar os Agents padrão.




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. Acesse em

  1. Clique em e informe os dados do Agendamento

  1. Clique em e informe os dados da Recorrência

  1. Clique em e em seguida para confirmar.


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.

PIMS Multicultivos


O PIMS Multicultivos deve estar devidamente instalado e configurado em ambiente de Homologação e Produção, com versão Novembro 2014 ou superior.
Parâmetros
O Sistema PIMS Multicultivos 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.

Valor – True

Valor – InventoryTransaction

Valor – 204

Valor – True

Valor – True

(http://IP_PIMSConnector:PORTA_PIMSConnector/SynchronousWSWrapperPimsMC/dataService).

Valor – True

Valor – True / False – A definir na Implantação

Valor – True / False – A definir na Implantação

Valor – 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, chamadas services_client.xml. Dentro do arquivo services_client.xml, existe 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


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


Variáveis referentes ao processo de Blocagem


Variáveis referentes ao processo de Tratamento Semente


Variáveis referentes ao processo de Pesagem


Variáveis referentes ao processo de Abastecimento


Variáveis referentes ao processo de Lubrificação


Variáveis referentes ao processo de Beneficiamento


Variáveis referentes ao processo de Plantio


Variáveis referentes ao processo de Serviço Campo


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


Variáveis referentes ao processo de Estorno da Blocagem


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


Variáveis referentes ao processo de Estorno da Pesagem


Variáveis referentes ao processo de Estorno do Abastecimento


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


Variáveis referentes ao processo de Estorno do Beneficiamento

 

Transações

Unidade de Medidas


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


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

 



Fluxo das Informações:

Insumos/Materais

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

 

Mensagem Padrão

 

PROTHEUS

PIMS Multicultivos

Tabela

Campo

Tabela

Campo

Code

SB1

B1_COD

INSUMO

CD_INT_ERP

Name

SB1

B1_DESC

INSUMO

DE_INSUMO

ProductType

SB1

B1_TIPO

INSUMO

-

UnitOfMeasureCode

SB1

B1_UM

INSUMO

ID_UNIMEDIDA

Trail

SB1

B1_RASTRO

INSUMO

FG_CTRL_LOTE

StockGroupCode

SB1

B1_GRUPO

INSUMO

ID_GRPINSUMO

 

 

 

 

 

Code

SB1

B1_COD

MATERIAL

CD_INT_ERP

Name

SB1

B1_DESC

MATERIAL

DE_MATERIAL

ProductType

SB1

B1_TIPO

MATERIAL

-

UnitOfMeasureCode

SB1

B1_UM

MATERIAL

ID_UNIMEDIDA

StockGroupCode

SB1

B1_GRUPO

MATERIAL

ID_GRPMATERIAL


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:


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.
Fluxo das Informações:

Depósito/Unidade Receptora/Ponto de Abastecimento

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

 



Fluxo das Informações:

Centro de Custos

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

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

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

 

Mensagem Padrão

 

PROTHEUS

PIMS Multicultivos

Tabela

Campo

Tabela

Campo

Code

CT1

CT1_CONTA

CONTACUSTO

CD_INT_ERP

Description

CT1

CT1_DESC01

CONTACUSTO

DE_CONTA_CUSTO

AnalyticalOrSynthetic

CT1

CT1_CLASSE

CONTACUSTO

FG_TP_CONTA

InternalId

-

-

CONTACUSTO

INTERNALID_ERP


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


Fluxo das Informações:

Cargos

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

 

Mensagem Padrão

 

PROTHEUS

PIMS Multicultivos

Tabela

Campo

Tabela

Campo

PositionCode

SQ3

Q3_CARGO

CARGO

CD_INT_ERP

Description

SQ3

Q3_DESCSUM

CARGO

DE_CARGO


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.
Fluxo das Informações:

Verbas

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

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

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

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

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:

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

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

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

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



Fluxo das Informações:

Histórico de Salários do Funcionário

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

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

 


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.
Fluxo das Informações:

Transferência de Funcionário

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



Fluxo das Informações:

Movimento de Ruralistas

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

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;


Fluxo das Informações no Protheus:

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

 

Mensagem Padrão

 

PROTHEUS

PIMS Multicultivos

Tabela

Campo

Tabela

Campo

MovementDate

CTT2

DDATALANC

BRG_RETCUSTO

DT_CONTABILIZACAO

CompanyId

CTT2

-

BRG_RETCUSTO

CD_EMPRESA

BranchId

CTT2

CT2_FILIAL

BRG_RETCUSTO

CD_FILIAL

CostCenterDebitCode

CTT2

CT2_DCD

BRG_RETCUSTO

CD_CCUSTO_DEBITO

DebitAccountCode

CTT2

CT2_DEBITO

BRG_RETCUSTO

CD_CONTACUSTO_DEBITO

CostCenterCreditCode

CTT2

CT2_DCC

BRG_RETCUSTO

CD_CCUSTO_CREDITO

CreditAccountCode

CTT2

CT2_CREDIT

BRG_RETCUSTO

CD_CONTACUSTO_CREDITO

BatchNumber

CTT2

CT2_LOTE

BRG_RETCUSTO

NO_LOTE

SubLot

CTT2

CT2_SBLOTE

BRG_RETCUSTO

NO_SUB_LOTE

ComplementaryHistory

CTT2

CT2_HP

BRG_RETCUSTO

HISTORICO_PADRAO

EntryValue

CTT2

CT2_VLR01

BRG_RETCUSTO

VALOR



Notas:
Para o funcionamento do processo de integração entre PIMS x Protheus, o agendado Contabilização de Retorno de Custos ao ERP (ProcessarCaptacaoRetornoCustos), presente no PIMS Multicultivos não deve estar habilitado, pois este agendamento é utilizado para integração entre PIMS Multicultivos x Datasul utilizando o TOTVS ESB.
Fluxo das Informações: