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.

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

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.

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

(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

• CD_UNI_NEGOCIO_BX - Unidade de Negócio ERP

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

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

Transações

Unidade de Medidas

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

• Código

• Descrição.

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  Code	SAH	AH_UNIMED	UNIMEDIDA	CD_UNI_MEDIDA
  Description	SAH	AH_DESCPO	UNIMEDIDA	DE_UNI_MEDIDA

  
  
  Fluxo das Informações:
  

  Grupo de Produtos

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

• Código
• Descrição Grupo

• Clas. Grupo

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  Code	SBM	BM_GRUPO	GRPINSUMO	CD_INT_ERP
  Description	SBM	BM_DESC	GRPINSUMO	DE_GRP_INSUMO
  FamilyClassificationCode	SBM	BM_CLASGRU	GRPINSUMO
  Code	SBM	BM_GRUPO	GRPMATERIAL	CD_INT_ERP
  Description	SBM	BM_DESC	GRPMATERIAL	DE_GRP_MATERIAL
  FamilyClassificationCode	SBM	BM_CLASGRU	GRPINSUMO

  
  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

Fluxo das Informações:

Insumos/Materais

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

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

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

Depósito/Unidade Receptora/Ponto de Abastecimento

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

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

• Filial

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  Code	NNR	NNR_CODIGO	DEPOSITO	CD_INT_ERP
  Description	NNR	NNR_DESCRI	DEPOSITO	DE_DEPOSITO
  WarehouseClassification	NNR	NNR_INTP	DEPOSITO	-
  CompanyId	NNR	-	DEPOSITO	ID_UNIDADEADM
  BranchId	NNR	NNR_FILIAL	DEPOSITO	ID_UNIDADEADM
  Code	NNR	NNR_CODIGO	UNIRECEPTORA	CD_INT_ERP
  Description	NNR	NNR_DESCRI	UNIRECEPTORA	DE_UNI_RECEP
  WarehouseClassification	NNR	NNR_INTP	UNIRECEPTORA	-
  CompanyId	NNR	-	UNIRECEPTORA	ID_UNIDADEADM
  BranchId	NNR	NNR_FILIAL	UNIRECEPTORA	ID_UNIDADEADM
  Code	NNR	NNR_CODIGO	PONTOABAST	CD_INT_ERP
  Description	NNR	NNR_DESCRI	PONTOABAST	DE_PONTO_ABAST
  WarehouseClassification	NNR	NNR_INTP	PONTOABAST	-
  CompanyId	NNR	-	PONTOABAST	ID_UNIDADEADM
  BranchId	NNR	NNR_FILIAL	PONTOABAST	ID_UNIDADEADM

  
  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

Fluxo das Informações:

Centro de Custos

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

• Código
• Descrição
• Empresa

• Filial

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  Code	CTT	CTT_CUSTO	CCUSTO	CD_INT_ERP
  Description	CTT	CTT_DESC01	CCUSTO	DE_CCUSTO
  CompanyId	CTT	-	CCUSTO	ID_UNIDADEADM
  BranchId	CTT	CTT _FILIAL	CCUSTO	ID_UNIDADEADM

  
  
  Fluxo das Informações:
  

  Prestador de Serviços/Fornecedor

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

• Código
• Descrição
• Empresa

• Filial

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  Code	SA2	A2_COD	PRESTSERV	CD_ PRESTSERV
  Description	SA2	A2_NOME	PRESTSERV	DE_ PRESTSERV
  CompanyId	SA2	-	PRESTSERV	ID_UNIDADEADM
  BranchId	SA2	A2 _FILIAL	PRESTSERV	ID_UNIDADEADM

  
  
  Fluxo das Informações:
  

  Conta Contábil/Plano de Contas

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

• Código
• Descrição
• Tipo
• InternalId

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

• Código
• Descrição

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

• Empresa – opcional em modo compartilhado
• Filial – opcional em modo compartilhado
• Código

• Descrição

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  FuncCode	SRV	RV_COD	MDO_EVEN_FOLHA	CD_MDO_EVEN_FOLHA
  Description	SRV	RV_DESC	MDO_EVEN_FOLHA	DE_MDO_EVEN_FOLHA

  
  
  Fluxo das Informações:
  

  Sindicatos

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

• Empresa – opcional em modo compartilhado
• Filial – opcional em modo compartilhado
• Código

• Descrição

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  Code	RCE	RCE_CODIGO	MDO_SINDICATO	CD_MDO_SINDICATO
  UnionName	RCE	RCE_DESCRI	MDO_SINDICATO	DE_MDO_SINDICATO

  
  
  Fluxo das Informações:
  

  Horários

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

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  WorkShitCode	SR6	R6_TURNO	MDO_HORARIO	CD_MDO_HORARIO (Código + Sequencia da Semana)
  	SR6	R6_TURNO	MDO_ESCALA_FOLGA_ERP	CD_MDO_ESCALA_FOLGA_ERP
  Description	SR6	R6_DESC	MDO_HORARIO	DE_MDO_HORARIO
  StartSequence				Sequência 1-7 (Semana 01) Sequência 8-14 (Semana 02) Sequência 15-21 (Semana 03) ...
  TypeOfDay	SPJ	PJ_TPDIA	MDO_HORARIO_JOR	1 – Trabalhado (Gera jornada na tabela)
  HourType				1 – Jornada (Jornada Inicial e Final )2 – Intervalo 3 – Lanche (2-3 Refeição e Intervalo – Iniciais e Finais)
  StartHour	SPJ	PJ_ENTRA1 PJ_ENTRA2 PJ_ENTRA3 PJ_ENTRA4	MDO_HORARIO_JOR	HR_INI_JORNADA HR_INI_REFEICAO1 HR_INI_REFEICAO2 HR_INI_INTERVALO1 HR_INI_INTERVALO2
  EndHour	SPJ	PJ_SAIDA1 PJ_SAIDA2 PJ_SAIDA3 PJ_SAIDA4	MDO_HORARIO_JOR	HR_FIM_JORNADA HR_FIM_REFEICAO1 HR_FIM_REFEICAO2 HR_FIM_INTERVALO1 HR_FIM_INTERVALO2

  
  
  
  
  Fluxo das Informações:
  

  Funcionários

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

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  Code	SRA	RA_MAT	FUNCIONAR	CD_INT_ERP
  FullName	SRA	RA_NOME	FUNCIONAR	DE_FUNCIONAR
  BadgeNumber	SRA	RA_CHAPA	FUNCIONAR	CD_CRACHA
  HiringDate	SRA	RA_ADMISSA	FUNCIONAR	DT_ADIMISSAO
  EmployeePositionCode	SRA	RA_CARGO	CARGO	CD_INT_ERP
  SalaryCategory	SRA	RA_CATFUNC	1- FUNCIONARDISP 2- FUNCIONARCLASSE	1 - FG_FREQ_PGTO 2 - Gera tabela 3 - Tarefeiro (Gera classe pagamento como rural e frequência de pagamento mensal). Demais códigos (Define a frequência de pagamento e gera classe de pagamento diferente de rural)
  CostCenterCode		RA_CC	CCUSTO	CD_INT_ERP
  BirthDate	SRA	RA_NASC	FUNCIONAR	DT_NASCIMENTO
  Gender	SRA	RA_SEXO	FUNCIONAR	FG_SEXO
  EmployeeType	SRA	RA_TIPOADM	FUNCIONAR	FG_PROP_TERC Conteúdo > 8 grava 'T' Conteúdo < 9 grava 'P' Tipo de Funcionário Próprio ou Terceiro
  GovernamentalInformation (CPF)	SRA	RA_CIC	FUNCIONAR	NO_CPF
  PIS	SRA	RA_PIS	FUNCIONAR	NO_PIS

  
  
  Fluxo das Informações:
  

  Movimento 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.
• Entrada dos Produtos Beneficiados no Estoque;

• Entrada de Matéria Prima Pesagem.

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  Code	SD3	D3_DOC	BRG_BXMATERIAL_EMS	NO_BOLETIM
  InternalId			BRG_BXMATERIAL_EMS	CD_UADM_ERP | CD_ESTABELEC | ID_BOLETIM
  Number	SD3	D3_DOC	BRG_BXMATERIAL_EMS	NO_BOLETIM
  Series				Fixo: null
  Type				Enviado E ou S  E-ntrada  S-aída
  MovementTypeCode	SD3	D3_TM	BRG_BXMATERIAL_EMS	FG_TPMOVTO
  CompanyId			BRG_BXMATERIAL_EMS	CD_UADM_ERP
  BranchId	SD3	D3_FILIAL	BRG_BXMATERIAL_EMS	CD_ESTABELEC
  RegisterDateTime			BRG_BXMATERIAL_EMS	DT_CONSUMO
  Code	SD3	D3_COD	BRG_BXMATERIAL_EMS	CD_MATERIAL_ERP
  InternalId			BRG_BXMATERIAL_EMS	CD_UADM_ERP
  EmissionDate	SD3	D3_EMISSAO	BRG_BXMATERIAL_EMS	DT_CONSUMO
  ItemCode	SD3	D3_COD	BRG_BXMATERIAL_EMS	CD_MATERIAL_ERP
  ItemInternalId			INSUMO MATERIAL	||ID_INSUMO ||ID_MATERIAL
  UnitPrice	SD3	D3_CUSTO1	BRG_BXMATERIAL_EMS	Quando Type = 'S'Fixo 0 (Zero) Quando Type = 'E'QT_VALOR / QT_CONSUMO
  TotalPrice			BRG_BXMATERIAL_EMS	Quando Type = 'S'Fixo 0 (zero)Quando Type = 'E'QT_VALOR
  Quantity	SD3	D3_QUANT	BRG_BXMATERIAL_EMS	QT_CONSUMO
  UnitOfMeasureCode	SD3	D3_UM	BRG_BXMATERIAL_EMS	CD_UNI_MEDIDA
  UnifOfMeasureInternalId			UNIMEDIDA	||ID_UNIMEDIDA
  WarehouseCode	SD3	D3_LOCAL	BRG_BXMATERIAL_EMS	CD_DEPOSITO
  WarehouseInternalId			1-PONTOABAST 2-UNIRECEPTORA DEPOSITO 1-Combustivel e Lubrificação 2-Matéria Prima	Empresa|Filial|ID_PONTOABAST Empresa|Filial|ID_UNIRECEPTORA Empresa|Filial|ID_DEPOSITO
  BinLocation	SD3	D3_LOCALIZ	BRG_BXMATERIAL_EMS	CD_LOCALIZACAO Fixo: null
  NumberSeries	SD3	D3_NUMSERI		Fixo: null
  LotOrSerialNumber	SD3	D3_NUMLOTE	BRG_BXMATERIAL_EMS	NO_LOTE
  LotExpirationDate	SD3	D3_DTVALID		Fixo: null
  CostCenterCode	SD3	D3_CC	BRG_BXMATERIAL_EMS	CD_CCUSTO
  CostCenterInternalId			CCUSTO	Compartilhado: ||ID_CCUSTO Exclusivo: Empresa|Filial|ID_CCUSTO
  AccountantAcountCode	SD3	D3_CONTA	BRG_BXMATERIAL_EMS	CD_CONTA
  Observation				Fixo: null

  
  
  Fluxo das Informações:
  

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

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

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  CompanyId	SN4	-	BRG_CSTG_INTDE	CD_EMPRESA
  BranchId	SN4	N4_FILIAL	BRG_CSTG_INTDE	CD_FILIAL
  AssetCode	SN4	N4_ITEM	BRG_CSTG_INTDE	CD_EQUIPTO
  CostCenterCode	SN4	N4_CCUSTO	BRG_CSTG_INTDE	CD_CCUSTO
  DateFin	SN4	N4_DATA	BRG_CSTG_INTDE	DT_REFER
  PeriodDepreciationAmount	SN4	N4_VLROC1	BRG_CSTG_INTDE	QT_VALOR

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

  Despesas Gerais/Bloqueio do Calendário Contábil

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

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  CompanyId	-	-	BRG_CSTG_INTDG	CD_EMPRESA
  BranchId	CT3	CT3_FILIAL	BRG_CSTG_INTDG	CD_FILIAL
  CostCenterCode	CTT	CTT_CUSTO	BRG_CSTG_INTDG	CD_CCUSTO
  AccountCode	CT1	CT1_CONTA	BRG_CSTG_INTDG	CD_CTA_CON
  InitialBalance	CT3	CT3_ ANTDEB; CT3_ANTCRD	BRG_CSTG_INTDG	-
  CreditValue	CT3	CT3_CREDIT	BRG_CSTG_INTDG	QT_VALOR
  DebitValue	CT3	CT3_DEBITO	BRG_CSTG_INTDG	QT_VALOR
  GLPeriodDate	CTG	CTG_DTFIM	BRG_CSTG_INTDG	DT_REFER

  
  Fluxo das Informações:
  

  Valores de Materiais

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

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  CompanyId			BRG_BXMATERIAL_EMS	CD_UADM_ERP
  ItemCode	SB2	B2_COD	BRG_BXMATERIAL_EMS	CD_MATERIAL_ERP
  BranchId	SB2	B2_FILIAL	BRG_BXMATERIAL_EMS	CD_ESTABELEC
  WarehouseCode	SB2	B2_LOCAL	BRG_BXMATERIAL_EMS	CD_DEPOSITO
  Sequence				Índice econômicos
  MaterialValue LaborValue OverHeadValue (Soma do conteudo)	SB2	B2_B2_CMFIM1	BRG_BXMATERIAL_EMS	QT_VALOR QT_VALOR1QT_VALOR2QT_VALOR3QT_VALOR4

  
  
  Fluxo das Informações:
  

  Situaçã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

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  EmployeeCode	SR8	R8_MAT	FUNCIONAR	CD_INT_ERP
  CommencementDate	SR8	R8_DATAINI	FUNCIONARDISP FUNCIONARAFAST (afastamento/Férias)	DT_EVENTO DT_INICIO (Afastamento/Férias)
  SituationnDay	SR8	R8_DURACAO	FUNCIONARDISP FUNCIONARAFAST	DT_EVENTO DT_FIM Data Final = Data Inicial + quantidade de dias. (se for maior que zero)
  SituationMeaning	SR8	R8_TIPO		Quando o conteúdo for: 1 - 4 (Ativo) 2 – 7 – 8 – 9 - 10 (Afastado) 5 (Férias)6 (Demissão)

  
  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.

Fluxo das Informações:

Histórico de Salários do Funcionário

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

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  EmployeeCode	SR7	R7_MAT	FUNCIONAR	CD_INT_ERP
  ChangeDate	SR7	R7_DATA	FUNCIONARSAL	DT_INICIO
  Salary	SR3	R3_VALOR	FUNCIONARSAL	VL_SALARIO
  PaymentFrequency	SR7	R7_TIPOPGT	FUNCIONARSAL	FG_FREQ_PGTO (Mensalista, Quinzenalista, Semanalista, Diarista, Horista)

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

  Histórico de Horários e Escalas do Funcionário

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

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  EmployeeCode	SPF	PF_MAT	FUNCIONAR	CD_INT_ERP
  ChangeDate	SPF	PF_DATA	FUNCIONARHR FUNCIONARESCA	DT_INICIO DT_INICIO
  WorkShiftCode	SPF	PF_TURNOPA	MDO_ESCALA_FOLGA_ERP	CD_MDO_ESCALA_FOLGA_ERP
  WorkShiftSequence	SPF	PF_SEQUEPA	MDO_HORARIO	CD_MDO_HORARIO (WorkShiftCode + WorkShiftSequence )

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

Transferência 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)

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  CompanyId (Origem)	SRA		EMPRESA	CD_INT_ERP
  BranchId (Origem)	SRA	RA_FILIAL	FILIAL	CD_FILIAL
  Code (Origem)	SRA	RA_MAT	FUNCIONAR	CD_INT_ERP
  CompanyId	SRA		EMPRESA	CD_INT_ERP
  BranchId	SRA	RA_FILIAL	FILIAL	CD_FILIAL
  TransferDate			FUNCIONARDISP	DT_EVENTO
  Code	SRA	RA_MAT	FUNCIONAR	CD_INT_ERP
  CostCenterCode	SRA	RA_CC	CCUSTO	CD_INT_ERP

  
  Notas:
  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.

Fluxo das Informações:

Movimento de Ruralistas

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

  Mensagem Padrão	PROTHEUS		PIMS Multicultivos
  	Tabela	Campo	Tabela	Campo
  CompanyId			BRG_MDO_BOLRUR	CD_EMP_FOL_ERP
  BranchId	SRC	RC_FILIAL	BRG_MDO_BOLRUR	CD_FILIAL_FOL_ERP
  EmployeeCode	SRC	RC_MAT	BRG_MDO_BOLRUR	CD_FUNCIONAR_ERP
  EmployeeInternalId			FUNCIONAR	ID_FUNCIONAR Empresa|Filial|ID_FUNCIONAR
  FundCode	SRC	RC_PD	BRG_MDO_BOLRUR	CD_VERBA_ERP
  FundCodeInternalId			MDO_EVEN_FOLHA	ID_MDO_EVEN_FOLHA Empresa
  InformationType	SRC	RC_TIPO1		Fixo: 3 (3-valor)
  NumberOfHoursPosted	SRC	RC_HORAS		Fixo: 0
  EntryValue	SRC	RC_VALOR	BRG_MDO_BOLRUR	VL_VERBA_ERP
  PaymentDate	SRC	RC_DATA	BRG_MDO_BOLRUR	DT_PGTO
  ReferenceDate	SRC	RC_DTREF	BRG_MDO_BOLRUR	DT_OPERACAO
  MonthCompetence			BRG_MDO_BOLRUR	DT_OPERACAO (Mês)
  YearCompetence			BRG_MDO_BOLRUR	DT_OPERACAO (Ano)
  FundOrigin	SRC	RC_TIPO2	BRG_MDO_BOLRUR	Fixo: 6
  CostCenter	SRC	RC_CC	BRG_MDO_BOLRUR	CD_CCUSTO_ERP
  CostCenterInternalId			CCUSTO	ID_CCUSTO Empresa
  ID_CCUSTO (Compartilhado)

  
  
  Fluxo das Informações:
  

  Solicitação de Materiais Aplicados na OS de Oficina

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)

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: