Integração PCP Protheus x Totvs Mes

Âncora
inicio inicio

Contexto de negócio

1. MES
   Manufacturing Execution Systems, ou simplesmente MES, é o termo utilizado para designar os sistemas focados no gerenciamento das atividades de produção e que estabelecem uma ligação direta entre o Planejamento e o Chão de Fábrica. Os sistemas MES geram informações precisas e em tempo real, que promovem a otimização de todas as etapas da produção, desde a emissão de uma ordem até o embarque dos produtos acabados.
   A importância destes sistemas vem da lacuna que normalmente existe entre o ERP (Entreprise Resource Planning) e os softwares específicos da linha de produção. O MES pode importar dados do ERP e integrá-los com o dia a dia da produção, gerenciando e sincronizando as tarefas produtivas com o fluxo de materiais.
   Considerando que na cadeia de suprimento o maior valor agregado costuma estar na produção, faz todo sentido investir em sistemas que otimizem o fluxo, controle e qualidade do material (Fonte: PPI-Multitask).
   
   
2. Planejamento e Controle da Produção
   A reunião dos meios de produção (matéria-prima, mão de obra e equipamentos) possibilita a fabricação de produtos que surgem pela ação dos Sistemas produtivos. Os planos que servem de guia na execução e no controle da produção são comandados pelo órgão auxiliar denominado Planejamento e Controle da Produção (PCP), que dita normas à linha de produção, visando a um fluxo ordenado e contínuo do processo produtivo.
   
   
3. Chão de Fábrica
   Permite ao usuário planejar, "apontar" e monitorar as atividades executadas em cada centro de trabalho da fábrica e máquina, possibilitando uma visão integrada das operações realizadas, em execução e a serem processadas. Permite o Gerenciamento e Monitoramento dos resultados (produtividade, eficiência, atrasos, qualidade, utilização, níveis de parada, motivos de refugo, desvio de tempo real / padrão, etc) obtidos. Na utilização integrada ao MES, os apontamentos serão realizados pelo sistema MES.

Sistemas Envolvidos

• PCP PROTHEUS

• PCP - SIGASFC PROTHEUS

• PC-FACTORY (PPI MULTITASK)

Objetivo da Integração

O objetivo da Integração PC Factory (software MES da empresa PPI Multitask) X PROTHEUS é disponibilizar aos clientes TOTVS uma nova opção para controle da produção por meio da automação dos processos, permitindo a atualização e extração de informações de forma on-line de modo a simplificar o fluxo dos clientes.

Escopo

Permite a integração entre o módulo PCP e SIGASFC do Protheus com o MES PC-Factory da PPI-Multitask, que tem como objetivo controlar os apontamentos das ordens de produções. O Protheus tem como responsabilidade a criação das ordens de produção e o PC-Factory, os apontamentos.

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

Para a versão 12 do Protheus, deve-se aplicar o pacote de atualizações da expedição contínua.
A Build deve ser igual ou superior a 7.00.131227A e data 08/09/2014.
Endereço de IP e porta liberada para execução do WebService. Estes dados serão utilizados no arquivo APPSERVER.INI na sessão WEBSERVICE.
Deve atualizar o arquivo APPSERVER.INI na sessão WEBSERVICE.
Para configurar um WebService deve-se verificar o documento de configuração a seguir: https://tdn.totvs.com/display/PROT/Configurar+Portais+e+Webservices
Exemplo :

;CONFIGURACAO WEBSERVICE

[HTTP]
enable=1
port=8090

[10.80.62.219:8090]
ENABLE=1
Trace=1
PATH=C:\TOTVS 11\Microsiga\Protheus_Data\web\ws
ENVIRONMENT=mssqlserver
INSTANCENAME=WS
RESPONSEJOB=JOB_WS_9901
DEFAULTPAGE=wsindex.apw

[JOB_WS_9901]

SECURITY=1
TYPE=WEBEX
ENVIRONMENT=mssqlserver
INSTANCES=1,20
SIGAWEB=WS
INSTANCENAME=WS
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT

;FIM CONFIGURACAO WEBSERVICE

Também deve-se atualizar no arquivo APPSERVER.INI na sessão PROXY (caso exista proxy configurado)

[PROXY]

Enable=1
Server=proxy-jv.jv01.local
Port=8080
User=XXXXX
Password=*******

Quadro de compatibilidade:

Checklist de Aderência ao Ambiente do Cliente

O checklist abaixo tem por objetivo validar se o TOTVS MES é aderente ao ambiente atual do cliente, considerando que existem situações não contempladas na integração.

Situações não atendidas ou atendidas parcialmente pela Integração:

Instalação/Atualização

A integração Protheus x PC-Factory PPI-Multitask é ativada por intermédio dos seguintes passos:

1. Abrir o programa de Parâmetros da integração: PCPA109 (Atualizações -> Integração MES-> Parâmetros).
2. Setar o campo Ativo para "1- Ativo".
3. No campo caminho Informar a URL do WebService da PPI-Multitask.
4. Verificar a conectividade do WebService por meio do botão Testar.
5. Indicar se a integração irá gerar fisicamente os arquivos XML.
6. Configurar os filtros para cada informação que será trafegada entre os sistemas.
7. Confirmar a ativação por meio do botão CONFIRMA.
   

O botão de Testar verifica se é possível realizar a conexão com o WebService informado no campo Caminho. Este botão tem dois retornos:

• Conexão com o WebService realizada com Sucesso.
• Não foi possível realizar a conexão com o WebService do PC-Factory.

Para os clientes que desejam utilizar gerenciador de conexão WSDL no envio de mensagens na Integração TOTVSMES, deve alterar para TRUE os campos MV_COPPI

Selecionando o campo Gera XML, serão gerados os XML das mensagens trocadas. Se não estiver selecionado, será gravado apenas em tabelas. A geração dos arquivos não é obrigatória. Serve como uma ferramenta útil para encontrar problemas e poderá ser gravado no diretório de XMLs enviados com sucesso ou XMls pendentes.
Os nomes do arquivos seguirão o seguinte padrão:
OK_<MSG>_<DATAHORA>_<REGISTRO>
PEND_<MSG>_<DATAHORA>_<REGISTRO>
ERR_<MSG>_<DATAHORA>_<REGISTRO>
Em que: OK - Se mensagem entregue sem problemas
          PEND- Se mensagem não foi enviada
          ERR - Se mensagem enviada, porém retornou erro.
          MSG - Nome da mensagem. Ex.: Item, Wharehouse, Workcenter, etc.
          DATAHORA: Data e Hora do envio
          REGISTRO: Código do registro que está sendo enviado. Ex.: Código do item, número da ordem, etc.

Para cada arquivo movimentado (produto, local de estoque, recurso, ferramenta, máquina, roteiro, estrutura, endereço, movimentos, saldos e ordem de produção) terá um folder. Para cada folder, será possível montar filtros e definir parametrizações. Os filtros serão utilizados nas rotinas que enviarão informações ao PC-Factory, permitindo selecionar o que deve ser enviado. Serão exibidos os campos da tabela selecionada (folder) e operadores para que sejam montados os filtros. Se não existir nenhum filtro cadastrado todo registro incluído, alterado ou excluído será enviado ao PC-Factory. Para montar os filtros o usuário requer conhecimento do dicionário de dados pois é utilizado diretamente o nome das tabelas e dos campos.
Exemplo:
Montar um filtro para que somente seja enviado os produtos que sejam classificados como Produto Acabado. O filtro será: B1_TIPO = "PA"

O envio de informações do Protheus para o PC-Factory PPI-Multitask ocorre nas seguintes transações:

• Cadastro, alteração e exclusão de produto MATA010, local de estoque AGRA045 e recurso MATA610, SFCA006 e SFCA002;
• Cadastro e alteração de ordens MATA650;
• Processo para FIRMAR ordens MATA651;
• Manutenção das operações MATA632 ou PCPA124;
• Manutenção dos empenhos, MATA380 e MATA381;
• Cadastro, alteração e exclusão de Operações x Componentes MATA637;
• Carga máquina MATA690;
• Cálculo do MRP MATA712 (versão 11.8) ou PCPA107 (versão 12), PCPA107 e PCPA712;
• Cadastro, alteração e exclusão de estrutura, MATA200 e PCPA200;
• Splits de produção gerados pelas rotinas que manipulam ordem e o SFCA310 Apontamento Modelo 1 do Chão de Fábrica;
• Cadastro, alteração e exclusão do endereço MATA015;
• Cadastro, alteração e exclusão de ferramentas MATA620;
• Atualização de saldos.
  • NF de Entrada - Rotinas que executam a função B2ATUCOMD1;
  • NF de Venda - Rotinas que executam a função B2ATUCOMD2;
  • Mov. Internas - Rotinas que executam a função B2ATUCOMD3;
  • Inclusão de saldo MATA220 e MATA805.

O envio de informações do PC-Factory PPI-Multitask para o Protheus ocorre nas seguintes transações:

• Cadastro de motivos de parada SFCA004;
• Cadastro de motivos de refugo SFCA003;
• Movimentações avulsas de estoque. Entrada MATA250. Saída MATA240;
• Transferência de estoque MATA261;
• Apontamento de produção MATA681 e SFCA310;
• Apontamento de parada MATA682 e SFCA311;
• Recusa/Apontamento de perda MATA685.
  

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 RM Conector 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

As seguintes transações serão trocadas entre a TOTVS e a PPI-Multitask:

Fluxo das Informações

Fluxo das informações das transações:

• Produto, local de estoque e recurso: no momento da criação, alteração ou exclusão de um produto no programa MATA010, de um local de estoque no programa AGRA045 ou de um recurso nos programas MATA610 ou SFCA006 ou SFCA002 (máquina) e ferramentas no MATA620. Os programas verificam se a integração está ativa e, se estiver ativa, efetuam o envio do cadastro para o PC-Factory. Caso não ocorrer erro, o cadastro não apresentará nenhuma mensagem, porém se ocorrer erro uma mensagem será exibida questionando se deseja criar uma pendência de envio no programa PCPA110. Se optar por gerar a pendência o processo, será comitado no Protheus e a atualização para o PC-Factory deverá ser realizada por meio do PCPA110.
  Na engenharia também são integrados os cadastros de estrutura (MATA200, PCPA200, PCPA120, PCPA135), roteiro (MATA632, MATA637 ou PCPA124), e endereços MATA015, sempre quando ocorrer a criação, alteração ou exclusão de um registro.
• Ordem de produção: no momento da criação ou alteração de uma ordem de produção, ou durante a alteração da situação de uma ordem (alocação/carga máquina, requisição, alteração de operações ou empenhos, MRP, criação de splits), o programa irá verificar se a integração está ativa e, se estiver ativa, irá efetuar o envio do cadastro para o PC-Factory. Se não ocorrer erro, o cadastro não apresentará nenhuma mensagem. Caso ocorra erro, uma mensagem será exibida* e uma pendência de envio poderá ser criada no programa PCPA110. Ao final do processo das rotinas que processam múltiplas ordens, como por exemplo carga máquina, serão exibidas as quantidades de registros que foram enviados ao PPI-Multitask e também os que tiveram pendência de envio. Obs.: Algumas rotinas geram pendências sem realizar o questionamento devido ao número de ordens processadas.
  Rotinas que foram afetadas pela integração: Manutenção de Ordens (MATA650), Rotina para Firmar Ordens (MATA651), Manutenção das Operações (MATA632, MATA637 ou PCPA124), Manutenção dos Empenhos (MATA380 e MATA381), Carga Máquina (MATA690) e MRP (MATA712, PCPA107 e PCPA712), Splits de produção (SFCA310).
• Programa de gerenciamento de pendências PCPA110 - este programa tem por função administrar as pendências/exceções referentes à integração que são criadas quando a mensagem não for enviada ao PC-Factory, sejam elas, pendências ou erro. Permite o reprocessamento de uma mensagem, exclusão de uma pendência e a visualização do XML, além de possuir filtro por data de envio, transação, tipo de pendência e rotina geradora. A rotina também permite consultar as mensagens enviadas com sucesso.
• Programa de Sincronização PCPA111 - permite o envio das informações do produto, local de estoque, recurso, ferramentas, roteiro, estrutura, endereço, saldo em estoque e ordem de produção e tem como objetivo efetuar uma atualização da base de dados do PC Factory. Além dos filtros definidos no PCPA109, também será possível adicionar novos filtros para cada tabela.
• Apontamento de produção: Esta rotina consiste no WebService para receber os apontamentos de produção realizados no PC-Factory. Poderá processar apontamentos de produção e parada de recurso. Executará o mesmo processo que as rotinas MATA681 e MATA682. Quando o Chão de Fábrica estiver instalado, executará o mesmo processo que a rotina SFCA316 e SFCA311.
  O fluxo da integração será o seguinte:
  a. Operador efetua reporte normalmente conforme sua operação no PC-Factory.
  b. Em um processo batch ou disparado paralelamente no sistema, ocorre a montagem da mensagem (XML) conforme Schema de Mensagem Única TOTVS e o envio dessa mensagem(XML) para o Protheus; que validará a mensagem e encaminhará ao respectivo adapter de negócio (MATA681/MATA682 ou SFCA316/SFCA311) para processamento.
  c. Em caso de erros, esse reporte ficará com um status de pendente para envio dentro do software MES e o usuário poderá tomar ações no próprio PC Factory (o Protheus não manterá rastreabilidade das mensagens recebidas, mas registrará em LOG o processamento).
  d. Em caso de sucesso no reporte, será retornado ao PC-Factory o número do registro do reporte realizado no Protheus. Esse número poderá ser utilizado em caso de estorno.
• Atualização de saldo no PC-Factory ocorrerá das seguintes formas:
  a. Request: o PC-Factory solicita um saldo gerando mensagem XML de request. Nesta mensagem pode solicitar o saldo por item, por local de estoque, entre outros.
  b. Atualização Protheus: Quando ocorrer uma atualização de saldo no Protheus deverá enviar uma mensagem XML ao PC-Factory. São consideradas as principais rotinas do ERP, como Nota fiscal de entrada e venda e algumas movimentações internas e a inclusão de saldo via MATA220 e MATA805.
• Movimentações de estoque: Quando o PC-Factory realiza movimentações de estoque e transferências, estas movimentações serão atualizadas no Protheus.
  No caso das movimentações, se for E (entrada), deverá executar o MATA250. Se for S (saída), deverá executar MATA240. Nos casos de transferências executará o MATA261.
• Recusa/Apontamento de perda. Esta rotina consiste no WebService para receber os registros de recusa realizados no PC-Factory. Executará o mesmo processo que as rotinas MATA685.
• Consulta de Log de importação PCPA112: Essa rotina consiste na consulta dos registros dos apontamentos que foram processados pela integração Protheus x PC-Factory. Rotina deverá exibir os apontamentos efetuados e o status de cada processo.

Ponto de Entrada

Para facilitar o uso da integração e tornar o uso flexível em qualquer ambiente produtivo, foram criados alguns pontos de entrada para solucionar possíveis situações específicas não atendidas pelo padrão e também, permitir configurações mais precisas no uso da integração:

Apontamento: O ponto de entrada MATI681CRG permite adicionar informações que serão utilizadas no apontamento da produção e no apontamento de parada, tabela SH6. Exemplo: Caso exista algum campo específico ou tabela específica não tratada pela integração, poderá usar essa função para setar seu conteúdo. Detalhes em: MATI681CRG - Adicionar informações Adapter do apontamento.

Apontamento: O ponto de entrada MT680VAL permite validar se alguma informação deverá ser obrigatória como tempo, quantidade, entre outros. Essas validações ficarão a cargo dos clientes, pois cada um terá sua regra. Detalhes em: MT680VAL - Inclusão das Produções.

Apontamento: O ponto de entrada MATI680OPR permite alterar o código da operação recebida no apontamento da produção. Detalhes em: MATI681OPR - Alterar código operação mensagem apontamento produção.

Apontamento: O ponto de entrada MTI681QTAP permite alterar a quantidade recebida no apontamento da produção. Este ponto de entrada é indicado para aplicar o fator de conversão na quantidade do apontamento quando ERP e PC-Factory trabalham com unidade de medida diferente. Detalhes em: MTI681QTAP - Alterar quantidade do apontamento ProductionAppointment.

Apontamento: O ponto de entrada MATI681EXC permite verificar se o apontamento será executado ou não. Este ponto de entrada é indicado para validações que impeçam o apontamento de produção e parada. Também usado para casos em que é necessário atualizar alguma informação antes do apontamento (exemplo: estornar um endereçamento). Detalhes em: MATI681EXC - Processa mensagem Apontamento.

Apontamento: O ponto de entrada MATI681INT Permite processar o XML no PE para validação/gravação customizada, podendo optar  por executar a rotina padrão de apontamento de produção ou não. Se houver execução da rotina padrão e houver erro, será desfeito somente o que foi realizado na rotina padrão. O ponto de entrada  é chamado antes do inicio da transação  da rotina padrão de apontamento  de produção . Detalhes em: MATI681INT - Permite processa XML antes da mensagem de apontamento de produção

Apontamento: O ponto de entrada MT681ALXML permite modificar qualquer informação da mensagem. Este ponto é indicado para empresas que possuem produtos com controles distintos entre o ERP e o PC-Factory. Por exemplo, controla Lote no PC-Factory e não controla no ERP. O Lote é gerado no XML e retirado via ponto de entrada. Detalhes em: MT681ALXML - Alterar informações XML ProductionAppointment.

Ordem de Produção: O ponto de entrada MTI650ADOP permite adicionar uma nova operação na mensagem de ordens de produção. Para cada operação que está sendo enviada, este ponto de entrada será executado uma vez. Detalhes em: MTI650ADOP - Adicionar nova operação Adapter ordem de produção.

Ordem de Produção: O ponto de entrada MTI650FCOP permite alterar fator de conversão da segunda unidade de medida da operação que será enviada na mensagem de ordens de produção. Detalhes em: MTI650FCOP - Alterar fator de conversão segunda unidade de medida da operação Adapter ordem de produção.

Ordem de Produção: O ponto de entrada MTI650QTOP permite alterar a quantidade da operação que será enviada na mensagem de ordens de produção. Detalhes em: MTI650QTOP - Alterar quantidade da operação adapter ordem de produção.

Ordem de Produção: O ponto de entrada MTI650UMOP permite alterar a segunda unidade de medida da operação que será enviada na mensagem de ordens de produção. Detalhes em: MTI650UMOP - Alterar segunda unidade de medida da operação Adapter ordem de produção.

Ordem de Produção: O ponto de entrada MTI650TMAC permite alterar o tempo de máquina (TimeMachine) na mensagem de ProductionOrder. Detalhes em: MTI650TMAC - Alterar quantidade do tempo de máquina no adapter ProductionOrder.

Ordem de Produção: O ponto de entrada MTI650LOTE permite gerar o Lote da ordem na tag LotCode na mensagem ProductionOrder. Detalhes em: MTI650LOTE - Adicionar lote na mensagem de Ordens de produção.

Ordem de Produção: O ponto de entrada MTI650UTTP permite alterar o valor enviado na tag UnitTimeType. Detalhes em: MTI650UTTP - Alterar o valor da tag UnitTimeType da mensagem ProductionOrder.

Cadastros: O ponto de entrada PCPXFUNPPI permite inibir a integração em determinada rotina. Exemplo: Caso não deseje que na criação de ordens MATA650 ocorra a integração, poderá utilizar essa função para inibir o uso. Detalhes em: PCPXFUNPPI - Rotinas que não realizam integração com o PC-Factory.

Cadastro de Item: o Ponto de entrada PCPADDTAGS permite incluir tags específicas nas mensagens padrões TOTVS. Está habilitado para o cadastro de item MATA010. Detalhes em: PCPADDTAGS - Adicionar informações XML Integração TOTVS MES.

Cadastro de Processos: o Ponto de entrada PCPADDTAGS permite incluir tags específicas nas mensagens padrões TOTVS. Está habilitado para o cadastro de roteiro MATA632 e PCPA124. Detalhes em: PCPADDTAGS - Adicionar informações XML Integração TOTVS MES.

Cadastro de Processos: O ponto de entrada MTI632UTTP permite alterar o valor enviado na tag UnitTimeType. Detalhes em: MTI632UTTP - Alterar o valor da tag UnitTimeType da mensagem ItemScript.

Cadastro de Máquina: O ponto de entrada MTI610UTTP permite alterar o valor enviado na tag UnitTimeType. Detalhes em: MTI610UTTP - Alterar o valor da tag UnitTimeType da mensagem Machine.

Movimentos internos. Os pontos de entrada MATI250CRG e MATI240CRG possibilitam alguma validação específica. Essas validações ficarão a cargo dos clientes, pois cada um terá sua regra. Não podem ser alterados os valores dos campos que foram gerados pela mensagem. Detalhes em: MATI240CRG - Adicionar informações Adapter de movimentações internas e MATI250CRG - Adicionar informações Adapter de movimentos de produção.

Transferências: O ponto de entrada MI261RCV possibilita a não execução da integração. Detalhes em: MI261RCV - Executar integração TransferWarehouse.

Recusa: O ponto de entrada MATI685EXC permite verificar se a recusa será executado ou não. Este ponto de entrada é indicado para validações que impeçam o apontamento de recusa ou atualizações de informações necessárias para realizar a recusa. Detalhes em: MATI685EXC - Processa mensagem recusa.

Executar em várias filiais

Em um ambiente com várias filiais é necessário apenas um WEBSERVICE sendo executado. O que indica a filial onde é processado o apontamento são as TAG´s:

<CompanyId>10</CompanyId>

<BranchId>CLSC0001</BranchId>

Quando essas tags estiverem em branco, o sistema considera o que estiver definido no APPSERVER.ini na sessão WEBSERVICE campo PrepareIn.

[WebServices]

PrepareIn=99,01

Controle de latência

Existem situações em que o tempo de espera do webservice é menor que o tempo de processamento das importações para o ERP. Pode ocorrer a situação em que o ERP continue processando a importação e o WebService do PC-Factory para de esperar a resposta. Quando o PC-Factory não recebe a resposta a tempo, o mesmo arquivo é reenviado, podendo gerar duplicidade no processamento da mensagem.

Solução:

Controlar ID do PC-Factory para as mensagens recebidas. Todas as mensagens recebidas deverão ter esse tratamento:

• ProductionAppointment
• StopReport
• MovementsInternal
• TransferWarehouse
• StopReason
• WasteReason

Nos XML´s será usada a TAG  Key name = "IDPCfactory"

<BusinessEvent>

      <Entity>Entity</Entity>

      <Event>upsert</Event>

      <Identification>

        <key name="IDPCFactory">29892829</key>

      </Identification>

</BusinessEvent>

O retorno com erro apresenta a mensagem com o seguinte padrão:

O XML de retorno deverá respeitar a seguinte regra:

• Quando ID já processado e contêm ERRO

              Retorna o ID PC-Factory na tag  <UUID>

              Na tag Message type="ERROR" code="2", utiliza o 2 para indicar erro.

              A mensagem será: ID xxxx já processado. Status: mensagem de erro”.

             Exemplo: <Message type="ERROR" code="2">ID productionappointment-0038 já processado. Status: ProductionOrderNumber não cadastrada no Protheus.</Message>

• Quando ID já processado com sucesso

              Retorna o ID PC-Factory na tag  <UUID>

              Na tag Message type="ERROR" code="3", usa o 3 para indicar o processamento com sucesso.

             A mensagem será: "ID xxxx já processado. Status: ID do Protheus" ou  "ID xxxx já processado. Status: Reprocessado. ID do Protheus" quando o PC-Factory enviar mais de uma vez.

             Exemplo 1:      <Message type="ERROR" code="3">ID productionappointment-0038 já processado. Status: 5091</Message>

             Exemplo 2:      <Message type="ERROR" code="3">ID productionappointment-0038 já processado. Status: Reprocessado. 5091</Message>.

• Quando ID já está na base mas em processamento

              Retorna o ID PC-Factory na tag  <UUID>

              Na tag Message type="ERROR" code="4", usa o 4 para indicar que está em processamento.

              A mensagem será: ID xxxx está sendo processado pelo Protheus.

              Exemplo: <Message type="ERROR" code="4">ID apapapapeaaa está sendo processado pelo Protheus.</Message>

Situações inesperadas que podem ocorrer: a parada do serviço do Protheus, banco de dados fora do ar, falta de energia, entre outros. Se ocorrer durante o processamento da integração, o registro do PC-Factory (ID do PC-Factory) pode ficar travado e a mensagem não sai da fila de processamento. Para tratar essa situação:

O PC-Factory tenta enviar por determinado tempo, tempo esse parametrizado no PC-Factory. Caso continue recebendo a mesma mensagem depois do tempo parametrizado, o PC-Factory gera uma pendência de envio e passa para o próximo registro. Ao passar para o próximo registro, um contador de mensagens não enviadas é gerado. Quando esse contador atinge um limite (parametrizado), o processo de integração é paralisado para que os usuários possam resolver o problema. O controle de processamento ficará registrado em tabela de LOG SOH.

Abaixo tabela dos códigos enviados:

Autenticação

Quando o usuário e a senha estiverem cadastrados no PCPA109 (Parâmetros), folder Segurança, estes dados serão enviados na mensagem para que o PC-Factory efetue a autenticação.

Estes dados serão enviados no cabeçalho da mensagem da seguinte forma:

Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l

Onde: O valor será usuário:senha criptografado em Base64.

O recebimento das mensagens também seguirá o mesmo modelo, porém o PC-Factory enviará um usuário do Protheus.

Security = 0 -> Não utiliza autenticação.

Security = 1 -> Utiliza autenticação

Rotinas envolvidas

Parametrização - PCPA109

A parametrização terá influência direta sobre os registros que serão movimentados entre os dois sistemas.

A rotina de parametrização terá os seguintes campos:

• Ativo: Indica se a integração está ativa. Ao selecionar esse campo, os demais são habilitados. Se este campo estiver desmarcado, nenhuma outra ação poderá ser realizada na rotina.
• Caminho: Indica o caminho do WebService do PC-Factory. Após o caminho, terá um botão testar para verificar se webservice está ativo.
• Terá um painel XML.
  Neste painel poderá indicar:
  - Gera XML - Ao selecionar esse campo, irá gerar os XML das mensagens trocadas. Se não estiver selecionado, será gravado apenas em tabelas. A geração dos arquivos não é obrigatória. Serve como uma ferramenta útil para encontrar problemas. O envio sempre será feito com base do que estiver registrado nas tabelas.
  - Enviados - Diretório onde serão salvos os XMLs enviados com sucesso ao PC-Factory
  - Pendência - Diretório onde serão salvos os XMLs que não foram enviados ao PC-Factory
  Os nomes do arquivos seguirão o seguinte padrão:
  OK_<MSG>_<DATAHORA>_<REGISTRO>
  PEND_<MSG>_<DATAHORA>_<REGISTRO>
  ERR_<MSG>_<DATAHORA>_<REGISTRO>
  Em que: OK - Se mensagem entregue sem problemas
             PEND- Se mensagem não foi enviada
             ERR - Se mensagem enviada, porém retornou erro.
             MSG - Nome da mensagem. Ex.: Item, Wharehouse, Workcenter, etc.
             DATAHORA: Data e Hora do envio
             REGISTRO: Código do registro que está sendo enviado. Ex.: Código do item, número da ordem, etc.
  Obs.: Se selecionar o Gera XML, deverão ser informados os diretórios.

Para cada arquivo movimentado terá um folder. Para cada folder será possível montar filtros. Esses filtros serão utilizados nas rotinas que enviarão informações ao PC-Factory, permitindo selecionar o que deve ser enviado. Serão exibidos os campos da tabela selecionada (folder) e operadores para que sejam montados os filtros. Além de filtros, alguns arquivos possuem parametrizações.

A rotina terá os seguintes folders:

• Produto
• Local de Estoque
• Recurso
• Máquina
  O folder máquina somente será exibido quando o chão de fábrica estiver em uso.
• Ferramenta
• Ordem de Produção
  Painel MRP: Indica como o sistema deverá se comportar em relação as ordens geradas pelo MRP. Terá as seguintes opções:
  "Não integra": As ordens geradas pelo MRP não serão enviadas ao PC-Factory pelo cálculo do MRP
  "Gera Pendência": As ordens geradas pelo MRP ficarão registradas nas pendências de envio
  "Integra": As ordens geradas pelo MRP serão enviadas ao PC-Factory pelo cálculo do MRP.
  
  Painel "Consumo de componentes". Determinar como será o consumo dos componentes. Esse campo pode conter os seguintes valores:
  "1" - BackFlush: Sempre irá realizar a baixa dos componentes conforme o definido na engenharia.
  "2" - Consumo Real: Irá consumir conforme lista de componentes.
  "3" - Consumo Real/Atu Empe: Irá consumir conforme lista de componentes e se não existir saldo suficiente da quantidade empenhada irá ajustar automaticamente a quantidade empenhada.

   Painel "Operações": Define se o filtro criado no folder "Roteiros" deve ser utilizado para filtrar as operações da ordem de produção.

   Painel "Refugo": Define o local de estoque/depósito para o item refugado quando o refugo for o mesmo produto da ordem de produção. Quando o depósito - "WharehouseCodeTo" vier em branco na mensagem               ProductionAppointment, usar o que foi definido no parâmetro.

   Painel "APS": Define se a integração considera ordens geradas pelo APS.  

• Roteiros
• Estrutura
• Endereço
• Movimentos e transferência
  Os movimentos de estoque, entrada ou saída e também as transferências são arquivos recebidos pelo Protheus. Não necessita de filtros, porém deverão ser criados alguns parâmetros para o processamento. São eles:
  Tipo de Movimento de Entrada Produção: Usar campo SOE.OE_VAR1
  Tipo de Movimento de Saída: Usar campo SOE.OE_VAR2
  Tipo de Movimento Co-produto: Usar campo SOE.OE_VAR3
  Tipo de Movimento de Entrada Estoque: Usar campo SOE.OE_VAR4
  Estes tipos de movimentos são cadastrados no MATA230
• Saldo estoque
  Para o folder Saldo de estoque terá a opções de três filtros. Tabela SB2, SB8 e SBF. 
  Também poderá indicar em qual processo de movimentação deverá enviar o saldo ao PC-Factory
  Em que: 
  Nota Fiscal de Entrada   : SOE.OE_VAR1 (Marcado = 1; Desmarcado = 0 )
  Nota Fiscal de Venda     : SOE.OE_VAR2 (Marcado = 1; Desmarcado = 0 )
  Movimentações Internas: SOE.PARINTG (Marcado = 1; Desmarcado = 0 )
  Implantação de Saldo: SOE_OE_VAR3(Marcado = 1; Desmarcado = 0 )
  Estas opções são válidas somente para o envio do Protheus para o PC-Factory. Para o request (solicitação do PC-Factory) não terá filtros.
• Segurança
  Utilizado para realizar o controle autenticação na troca de mensagem entre os sistemas. Permite informar usuário e senha que devem ser válidos no PC-Factory, ou seja, informar o usuário e senha cadastrado no PC-Factory.

Sincronização - PCPA111

A sincronização é o processo que será utilizado para popular ou atualizar a base do PC-Factory com os dados do Protheus. O funcionamento se dará da mesma forma que as demais rotinas de integração, enviando uma mensagem XML ao WebService do PC-Factory, respeitando as parametrizações definidas no PCPA109. A única diferença é que serão visualizados todos os dados da tabela que estiver sendo integrada (respeitando os filtros) ao invés de apenas um único registro.

Pendências - PCPA110

Rotina para reenviar as mensagens não enviadas ao sistema PC-Factory, sejam elas pendências ou erro. A rotina também possibilita consultar as mensagens enviadas (LOG de envio).

Poderá verificar as pendências e log das mensagens trafegadas entre os sistemas:

• Cadastro de Estruturas
• Produto/Item
• Local de Estoque (depósitos)
• Recurso PCP
• Ordens de produção (Operações, Roteiros, Componentes, Splits) 
• Recursos do chão de fábrica - Ferramentas, Equipe e Operador
• Ferramentas
• Máquinas do Chão de Fábrica
• Roteiro - Operações
• Endereços
• Saldo 

Possui as seguintes opções: 

• Reprocessar: 
  Para cada linha selecionada deverá executar o envio das mensagens.
• Excluir
  Deverá excluir os registros selecionados
• Salvar XML
  Esta opção permite salvar o XML em um diretório local da máquina que está processando a rotina de pendências.
• Atualizar
  Irá refazer a pesquisa dos registros, atualizando os dados na tela

Log de Importação - PCPA112

Ao receber dados do PC-Factory, o WebService Protheus grava as informações para que possam ser consultadas (tabela SOG). Abaixo a lista das movimentações que geram LOG:

• Apontamento de produção
• Apontamento de parada
• Motivo de Refugo
• Motivo de Parada
• Movimentações de Estoque
• Transferência

Mensagens

Cadastros

Transação Item: Item_3_001.xsd

Identificador da Mensagem: Item

Versão: 3_001
Módulo Protheus: SIGAPCP
Tipo de Envio: Síncrona

Transação Depósito: Warehouse_1_001.xsd

Identificador da Mensagem: Warehouse

Versão: 1_001
Módulo Protheus: SIGAPCP
Tipo de Envio: Síncrona

Transação Recurso PCP / Máquina SFC: Machine_1_000.xsd

Identificador da Mensagem: Machine

Versão: 1_000
Módulo Protheus: SIGAPCP, SIGASFC
Tipo de Envio: Síncrona

No PCP as máquinas são cadastradas na rotina de recursos MATA610 e no Chão de Fábrica a rotina é a SFCA002. A nomenclatura também é alterada. Quando utilizar Chão de Fábrica, será denominada MÁQUINA. Quando utilizar somente o PCP, será RECURSO. A rotina de parâmetros PCPA109 está preparada para apresentar o nome de acordo com o uso do sistema.

Transação Recurso SFC: Resource_1_000

Identificador da Mensagem: Resource

Versão: 1_000
Módulo Protheus: SIGASFC
Tipo de Envio: Síncrona

Transação Estrutura: ItemStructure_1_000.xsd

Mensagem	Tag	Descrição	Tabela/Campo: Protheus	Tipo	Tabela/Campo: PC-Factory	Tipo
BusinessContentType	CompanyId	Código da Empresa		CHAR(02)
	CompanyInternalId	Empresa+Filial	EMPRESA + SG1.G1_FILIAL
	ItemInternalId	Empresa+Filial+código item pai	EMPRESA + SG1.G1_FILIAL +SG1.G1_COD
	ItemCode	Código item pai	SG1.G1_COD	CHAR(15)	TBLInWOHD.ProductCodeTBLInWOHD.WOCode	CHAR(30)
	ItemAmount	Quantidade base do item pai	SB1.B1_QB	NUM(07)	TBLInWOHD.TotalQTY	DEC(19,4)
ItemComponentType
	ItemSequence	Sequência do componente	SG1.G1_TRT	NUM(05)	TBLInBillMat.BillMatExtCode	CHAR(20)
	ItemComponentCode	Código item componente	SG1.G1_COMP	CHAR(15)	TBLInBillMat.ProductCode	CHAR(20)
	ItemComponentInternalId	Internal Id do Item Componente	EMPRESA + SG1.G1_FILIAL + SG1.G1_COMP
	InitialDate	Data validade inicial	SG1.G1_INI	DATE	TBLInWOHD.DtPlanStart	DATETIME
	FinalDate	Data validade final	SG1.G1_FIM	DATE	TBLInWOHD.DtPlanEnd	DATETIME
	IsGhostMaterial	Indica se é fantasma	SB1.B1_FANTASM	BOOLEAN ( FALSE ou TRUE)
	ItemComponentAmount	Quantidade do item componente	SG1.G1_QUANT	DEC(12,6)
	LossFactor	Fator de perda	SG1.G1_PERDA	DEC(05,2)
ListOfScript
	Scriptcode	Código do Roteiro	SGF.GF_ROTEIRO	CHAR(02)	TBLInWOHD.ExtCode	CHAR(20)
	ScriptAlternative	Alternativo do Roteiro	--
	ActivityIntenalID	ID Operação	--
	ActivityCode	Código da Operação	SGF.GF_OPERAC	CHAR(02)	TBLInWodet.Code	CHAR(10)
	ActivityComponentSequence	Sequência do componente na operação	SGF.GF_TRT	NUM(03)

Nota
title Nota:
A tag ItemSequence é obrigatória para o PC-Factory. Para que seja possível a integração da estrutura deverá ser obrigatório o uso do sequencial SG1.G1_TRT. caso contrário o PC-Factory irá retornar inconsistência.A integração da estrutura sempre ocorrerá para a revisão atual da estrutura do produto. A informação da revisão atual da estrutura do produto está disponível no cadastro do produto e/ou no cadastro de indicadores de produto, conforme a parametrização estabelecida.Será enviada a última revisão válida da estrutura. Verificar controles de revisão por filial ( MV_ARQPROD e  MV_REVFIL ) quando revisão manual(MV_REVAUT = F). Quando revisão automática (MV_REVAUT = T) sempre irá enviar a última.

Transação Roteiro - Operações do Item: ItemScript_1_000.xsd

Identificador da Mensagem: ItemScript
Versão: 1_000
Módulo Protheus: SIGAPCP
Tipo de Envio: Síncrona

Mensagem	Tag	Descrição	Tabela/Campo: Protheus	Tipo	Tabela/Campo: PC-Factory	Tipo
BusinessContentType	ItemCode	Código item	SG2.G2_PRODUTO	CHAR(15)	TBLInWOHD.ProductCodeTBLInWOHD.WOCode	CHAR(20)
	ItemDescription	Descrição do item	SB1.B1_DESC	CHAR(40)
	ItemInternalId	Empresa|Filial|Item	EMPRESA + SG2.G2_FILIAL +SG2.G2_PRODUTO
	ScriptCode	Código do Roteiro	SG2.G2_CODIGO	CHAR(02)
	ScriptDescription	Descrição Roteiro	--	CHAR(40)
	ScriptAlternative	Roteiro Alternativo	--	CHAR(02)
ListOfActivity
	ActivityInternalID	ID Operação	SG2.R_E_C_N_O_	NUM(05)
	ActivityCode	Código da Operação	SG2.G2_OPERAC	CHAR(02)	TBLInWodet.Code	CHAR(10)
	ActivityDescription	Descrição Operação	SG2.G2_DESCRI	CHAR(60)	TBLInWodet.Name	CHAR(40)
	MachineCode	Código da Máquina	SG2.G2_RECURSO	CHAR(06)	TBLInWodet.Resource	CHAR(15)
	ToolCode	Código Ferramenta	SG2.G2_FERRAM	CHAR(06)
	ActivityType	Tipo Operação	1 = Executa operação; 2 = Não executa.	CHAR(01)
	WorkCenterCode	Código Centro Trabalho	SG2.G2_CTRAB	CHAR(06)	TBLInWodet.ManagerGrpCode	CHAR(15)
	WorkCenterInternalId	Id Centro de Trabalho	EMPRESA + SG2.G2_FILIAL + SG2.G2_CTRAB
	UnitItemNumber	Lote padrão	SG2.G2_LOTEPAD	NUM(06)	TBLInWodet. StdSpeed	DEC(28,23)
	TimeResource	Tempo Recurso	0		TBLInWodet. StdSpeed	DEC(28,23)
	TimeMachine	Tempo Máquina	SG2.G2_TEMPAD	DEC(05,2)	TBLInWodet. StdSpeed	DEC(28,23)
	TimeSetup	Tempo Preparação	SG2.G2_SETUP	DEC(05,2)	TBLInWodet. SetUpTime	INT
	UnitTimeType	Tipo Unidade Tempo	1 = Horas;2=Minutos;3=Segundos;4=Dias		TBLInWodet. StdSpeedFormat	TINYINT
	ScriptAlternative	Alternativo	SG2.G2_ROTALT	CHAR(02)
	InitialDate	Data Inicial	SG2.G2_DTINI	DATE	TBLInWodet.DtPlanStart	DATETIME
	FinalDate	Data Final	SG2.G2_DTFIM	DATE	TBLInWodet.DtPlanEnd	DATETIME
	PercentageScrapValue	% Refugo	--
	PercentageValue	Proporção	--
	ResourceQuantity	Quantidade Recurso	--

Nota
title Nota:
A tag ActivityType (Tipo Operação) será gerada com o valor fixo '1'; A tag UnitTimeType (Tipo Unidade Tempo) será gerada com o valor fixo '1'; Obrigatório informar as tags InitialDate e FinalDate. Cadastrada no MATA632 ou PCPA124. A tag ListOfPertOrders não será gerada para o Protheus; Na exclusão de um roteiro, não deverá excluir se existir integridade com a rotina de OPERAÇÕES x COMPONENTES, MATA637. Neste caso não necessita enviar nenhuma mensagem ao PC-Factory; Quando incluir, alterar ou excluir dados do MATA637, deverá reenviar a mensagem de estrutura, ItemStructure.

Transação Saldo: ItemStockLevel_1_000.xsd

QuantityUpdated

Identificador da Mensagem: StopReason

Versão: 1_000
Módulo Protheus: SIGAPCP/SIGASFC
Tipo de Envio: Síncrona

Transação Ordem de Produção: ProductionOrder_2_004.xsd

Identificador da Mensagem: ProductionOrder
Versão: 2_003
Módulo Protheus: SIGAPCP
Tipo de Envio: Síncrona

Processos

Transação Apontamento de Produção: ProductionAppointment_2_000.xsd

Identificador da Mensagem: ProductionAppointment

Versão: 2_003
Módulo Protheus: SIGAPCP/SIGASFC
Tipo de Envio: Síncrona