O BackOffice Protheus deve estar devidamente instalado e Configurado em ambiente de Homologação e Produção, com versão 11.8 ou superior.
Parâmetros
O sistema BackOffice Protheus utiliza em suas rotinas configurações padronizadas ou específicas, denominadas 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.11.21.120:9380/PIMSConnectorWS/EAIService).
- 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. ( OBS: Se utilizar a integração Solicitação de Materiais da Ordem de Serviço de Oficina (Request), o Valor deverá estar como .T.).
- MV_CNXPIMS - Habilita integração do módulo de Gestão de Contratos do Protheus x PIMS Multicultivos
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.
- Acessar o modulo SigaCFG
- Clique em Ambiente
- Clique em Schedule
- Clique em Adapter E.A.I.
- Em Rotina informe o nome da aplicação que contem INTEGDEF.
- Informe uma descrição para a mensagem em Descrição.
- Em Modelo/Mensagem preencha o ID da mensagem única.
- Selecione EAI em Canal Envio.
- No campo Mensagem Única selecione Sim.
- Preencha as demais informações conforme Help de campo.
- Confira os dados e clique em Ok.
O quadro abaixo demonstra algumas informações a serem preenchidas nas configurações do Adapter:
Descrição | Mensagem | Rotina | Condição Adapter | Tipo | Fluxo |
Unidade de Medida | UNITOFMEASURE | QIEA030 | - | Sync | Protheus → PIMS |
Depósito | WAREHOUSE | AGRA045 | (NNR->NNR_INTP) $ "1|2|4" | Sync | Protheus → PIMS |
Grupo de Materiais | FAMILY | MATA035 | - | Sync | Protheus → PIMS |
Materiais | ITEM | MATA010 | (SB1->B1_TIPO) $ "IA|MM|SV|SM" OBS: Se for utilizar outros tipos de materiais incluir o código na condição. | Sync | Protheus → PIMS |
Baixa de Estoque | STOCKTURNOVER | MATA241 | !Empty(SD3->D3_NRBPIMS) | Sync | PIMS → Protheus |
Valores de Estoque | ITEMCOSTING | MATA330 | (SB1->B1_TIPO) $ "IA|MM|SV|SM" OBS: Se for utilizar outros tipos de materiais incluir o código na condição. | Async | Protheus → PIMS |
Solicitação de Materiais | REQUEST | MATA105 | - | Sync | PIMS → Protheus |
Documento de Entrada | INPUTDOCUMENT | MATA103 | M110NFPIMS() | Sync | Protheus → PIMS |
Centro de Custos | COSTCENTER | CTBA030 | - | Sync | Protheus → PIMS |
Fornecedores | CUSTOMERVENDOR | MATA020 | - | Sync | Protheus → PIMS |
Conta Contábil | ACCOUNTANTACCOUNT | CTBA020 | (CT1->CT1_CLASSE) $ "2" | Sync | Protheus → PIMS |
Despesas Gerais | PERIODGLBALANCE | CTBA012A | - | Async | Protheus → PIMS |
Lançamentos Contábeis | ACCOUNTINGENTRY | CTBA102 | - | Async | PIMS → Protheus |
Depreciação de Bens | ASSETDEPRECIATION | ATFA051 | - | Async | Protheus → PIMS |
Item Contábil | ACCOUNTINGITEM | CTBA040 | Sync | Protheus → PIMS | |
Classe de Valor | CLASSVALUE | CTBA060 | Sync | Protheus → PIMS | |
Cargos | EMPLOYEEPOSITION | GPEA370 | - | Sync | Protheus → PIMS |
Verbas | PAYROLLAMOUNT | GPEA040 | - | Sync | Protheus → PIMS |
Sindicatos | LABORUNION | GPEA340 | - | Sync | Protheus → PIMS |
Funcionários | EMPLOYEE | GPEA010 | - | Sync | Protheus → PIMS |
Situação do Funcionário | EMPLOYEESITUATIONS | GPEM040 | - | Sync | Protheus → PIMS |
Movimento dos Ruralistas | MONTHLYPAYROLL | GPEA090 | - | Async | PIMS → Protheus |
Horários/Escalas | SCHEDULEWORK | PONA080 | - | Sync | Protheus → PIMS |
Histórico de Horários/Escalas | EMPLOYEEHISTORYWORKSHIFT | PONA160 | - | Sync | Protheus → PIMS |
Transferência | SETEMPLOYEEBRANCHTRANSFER | GPEA180 | - | Sync | Protheus → PIMS |
Histórico Salário | EMPLOYEEHISTORYSALARYPOSITION | GPEA250 | - | Sync | Protheus → PIMS |
Ano Agrícola | AGRICULTURALYEAR | OGA100 | Sync | PIMS → Protheus | |
Período de Produção | PRODUCTIONPERIOD | UBAW130 | Sync | PIMS → Protheus | |
Proprietário | AGRICULTURALOWNER | OGA010 | Sync | PIMS → Protheus | |
Fazenda | FARM | AGRA005 | Sync | PIMS → Protheus | |
Setor | AGRICULTURALSECTOR | UBAW120 | Sync | PIMS → Protheus | |
Talhão | PARTOFLAND | AGRA010 | Sync | PIMS → Protheus | |
Variedade | AGRICULTURALVARIETY | AGRA050 | Sync | PIMS → Protheus | |
Variedade x Talhão | PARTOFLANDVARIETYRELATIONSHIP | AGRA010A | Sync | PIMS → Protheus | |
Consulta do Resultado do Processamento de Algodão | RESULTCOTTONPROCESSING | UBAW110 | Sync | PIMS → Protheus | |
Pesagem de Matéria Prima | WEIGHINGRAWMATERIALS | AGRI500 | Sync | Protheus → PIMS | |
Posição Agrícola | PRODUCTIONSITESSITUATION | AGRA560 | Async | PIMS → Protheus | |
Ordem de Produção | PRODUCTIONORDER | MATA680 | Sync | PIMS → Protheus | |
Consulta de Ordens de Colheita | GETHARVESTORDER | AGRA530 | Sync | Protheus → PIMS | |
Gestão de Contratos | CONTRACT | CNTA300 | CnCtrxPims() | Sync | Protheus → PIMS |
Medição de Contratos | CONTRACTMEASUREMENT | CNTA121 | - | Async | PIMS → Protheus |
Cultura | AGRICULTURALCULTURE | AGRA800 | Sync | PIMS → Protheus |
Legenda
Async - Assíncrona
Sync - Síncrona
Observação
M110NFPIMS() - Rotina desenvolvida pela equipe de materiais, para filtrar as movimentações da integração de Documento de Entrada
CnCtrxPims() - Rotina desenvolvida pela equipe de gestão de contratos para filtrar os contratos que irão realizar integração.
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:
- Em Agent, selecione Cadastro. O Schedule permite que Agents sejam adicionados automaticamente.
- Clique em Adicionar Agent e informe um Agent para cada empresa existente no cadastro de empresas.
- Para incluir Agents manualmente clique em .
- 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:
- Em Agendamentos, selecione Cadastro.
- Caso necessário, clique em Importar agendamentos antigos para registros de versões anteriores.
- Na pasta Detalhes clique em para adicionar um agendamento. Também é possível alterar (lápis) e excluir .
- Posicione o cursor no campo Rotina e, em seguida, clique em para informar uma rotina (FWEAI).
- Informe a rotina e os parâmetros entre parênteses para que sejam lidos.
- Selecione a(s) empresa(s)/filial(is)
- 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.
- Diária: informe o período de dias que deve ser considerado.
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:
- Através da criação da seção [WebServices], no arquivo de configuração (appserver.ini), do TOTVS | Application Server.
- 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.
Configurações do Modulo de Gestão de Contratos
Para que o processo de integração seja realizado é necessário a utilização do Protheus versão 12.1.20 ou superior.
Para que o contrato seja integrado é necessário que o tipo do contrato utilizado possua o campo Integ. PIMS ativo.
Para que a medição seja realizada se faz necessário que o contrato esteja integrado com o PIMS.