Integração com TOTVS APS - p10

Características do Requisito

Descrição

Com o objetivo de potencializar a solução ERP nos critérios de planejamento e programação da produção, foi desenvolvida a integração entre os softwares Protheus e TOTVS APS, ambos comercializados pela TOTVS. O TOTVS APS é um sistema de planejamento avançado da produção, que necessita de várias informações oriundas do ERP para realizar o planejamento de produção, tais como a lista de materiais, processos de fabricação dos produtos, ordens de compra, produção em andamento, pedidos e previsões de venda, posição de estoque entre outros.Esta integração viabiliza aos clientes TOTVS que utilizam o ERP Protheus como seu sistema de gestão empresarial usufruir dos benefícios de um aplicativo APS, tais como: visualização da capacidade disponível e dos gargalos de produção; gerenciamento dos estoques de insumos, material em processo e expedição; flexibilização da programação da fábrica e a garantia do nível de atendimento.Arquitetura da IntegraçãoOs canais de comunicação entre os aplicativos são diferenciados conforme o sentido do fluxo de informações. Tal diferenciação existe e foi atribuída conforme critérios de qualidade e velocidade no processamento das informações. Abaixo o detalhamento de cada fluxo:•Fluxo Protheus >> TOTVS APS: Neste sentido a comunicação é iniciada pelo aplicativo TOTVS APS, que realiza pesquisas (query’s) diretamente na base de dados Protheus para leitura dos dados. Tais informações serão tratadas e armazenadas na base de dados TOTVS APS para futuros processamentos.•Fluxo TOTVS APS >> Protheus: Neste sentido a comunicação é iniciada pelo aplicativo TOTVS APS, que realiza diversas chamadas ao WS Protheus entregando os documentos a serem gerados no ERP.  Importante:A comunicação no sentido TOTVS APS >> Protheus depende integralmente da utilização do aplicativo TOTVS ESB para gerenciamento das mensagens XML enviadas. Entidades IntegradasAtravés do programa de atualização de dados do TOTVS APS diversas entidades cadastradas na base de dados Protheus serão lidas e replicadas na base de dados do TOTVS APS. Abaixo estão listadas as principais entidades tratadas pela integração: •Tipos de Produtos•Grupos de Produtos *•Unidades de Medida *•Fornecedores * •Produtos **•Indicadores de Produtos•Saldos em Estoque•Saldo de/em Terceiros•Estruturas * ***•Recursos *•Ferramentas *•Centros de Trabalho *•Operações•Pedidos de Venda•Solicitações de Compra •Solicitações de Importação•Pedidos de Compra•Autorizações de Entrega•Purchase Orders •Ordens de Produção•Empenhos•Apontamentos de Produção  	Importante:*	Se a entidade estiver configurada no Protheus para acesso via modo exclusivo e existirem códigos iguais em filiais diferentes, na integração será considerado o primeiro registro cadastrado, já que no TOTVS APS estes cadastros são únicos (não diferenciados por estabelecimento). Para estes casos recomenda-se a utilização destas entidades com modo de acesso compartilhado.**	Para que os produtos sejam considerados na integração, devem ter o campo Entra MRP? (B1_MRP) configurado como Sim (S).***	Por diferenças conceituais entre os sistemas, componentes de estrutura com quantidade fixa não serão considerados pela integração.Centro de Trabalho Torna-se ObrigatórioO TOTVS APS realiza a alocação de ordens de produção utilizando o conceito de pool de recursos. Neste conceito, os recursos similares (que executam as mesmas tarefas) são agrupados em um mesmo centro de trabalho e as alocações serão direcionadas em primeira instância por centro de trabalho e posteriormente nos recursos deste centro de trabalho.Dessa forma, a utilização da entidade centro trabalho no Protheus torna-se obrigatória (será exigida nos cadastros quando MV_APS igual à TOTVS). Esta entidade deve ser relacionada aos recursos e também às operações, pois este será o vínculo para realização das alocações. 	Importante:Para implantações em bases já populadas, será necessário realizar um trabalho de ajuste nos cadastros de operações para que não haja conflito com o conceito acima descrito.Restrições e Pontos de AtençãoEm razão da existência de algumas incompatibilidades entre as tecnologias aplicadas a cada produto, a integração possui alguns pontos de não aderência ou aplicação de tratamentos especiais. Abaixo estão listadas as principais restrições e pontos de atenção desta integração:•	Entidades não Integradas: Em decorrência da utilização de arquivos locais para algumas entidades no Protheus, estas não serão integradas. São elas:o	Calendárioso	Exceções de Calendárioo	Bloqueio de Recursoso	Bloqueio de Ferramentas 	Importante:Estas entidades devem ser cadastradas manualmente em ambos os sistemas.•	Recursos do ERP não Integrados: Os recursos a seguir, existentes no Protheus, não são suportados pela integração:o	Potência de loteso	Produtos alternativoso	Estruturas por filial (será considerada sempre a estrutura da primeira filial encontrada)o	Componentes de quantidade fixa (serão desconsiderados)o	Tipos de operação** Este conceito existe no TOTVS APS, porém é aplicado ao centro de trabalho e não aos recursos. Desta forma, quando necessário deverá ser ajustado via TOTVS APS após atualização de dados.•	Grupo de Opcionais: Este recurso não é tratado pela integração. Desta forma os clientes que utilizam este recurso no ERP e irão fazer uso da integração, devem utilizar o campo Opc. Default (B1_OPC) no cadastro de produtos para indicar qual o opcional default a ser utilizado nas ordens geradas via TOTVS APS.•	Identificador de Roteiros de Operações: No TOTVS APS o cadastro de roteiros de fabricação não é vinculado especificamente a um item. Este cadastro é realizado de forma independente e posteriormente vinculado ao produto em outra entidade. Como no Protheus existe roteiros com o mesmo código e, devido ao conceito apresentado, o TOTVS APS não admite esta situação, ao integrar-se este cadastro o código dos roteiros no APS será transformado sendo representado pelo número do registro (recno) no Protheus. Para que o usuário possa localizar este cadastro de forma simples, a descrição do cadastro no TOTVS APS será apresentada da seguinte forma: Roteiro do produto/filial: [cod. produto]/[cod. filial].•	Carga Máquina e relacionados: A partir da utilização desta integração, a utilização da rotina Carga Máquina (MATA690) existente no Protheus, torna-se incompatível (uma vez que utilizam conceitos distintos). Desta forma, este processo deve ser descartado pelo cliente. Da mesma forma, todas as rotinas e relatórios relacionados a esta rotina serão inutilizados, como por exemplo: Produção PCP Mod.1 (MATA680) e Acompanhamento de Operações (MATR890). Os relatórios e consultas para acompanhamento de operações podem ser obtidos no software APS.Pré-requisitos para utilização da Integração:•	Utilização do middleware TOTVS ESB.•	Utilização de base de dados com TopConnect/DBAccess, pois o produto TOTVS APS trabalha somente com bancos desta plataforma.•	Módulos Estoque/Custos e Planejamento e Controle de Produção implantados. São desejáveis Compras e Faturamento.•	Disponibilidade de, no mínimo, 2 licenças TOTVS I (recomenda-se 5), servidor web habilitado e web services configurados (serviços MTPurchasesRequest, MTProductionOrder e MTIntegrationAPS habilitados e operantes).•	Compatibilizador UPDPCP16 executado.•	Parâmetro MV_APS configurado como TOTVS.•	Desativação dos Parâmetros MV_GERASC e MV_GERAOPI, pois o controle de geração de ordens de compra e produção será realizado integralmente pelo TOTVS APS.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) desta FNC.
    Importante:
Antes de executar o compatibilizador UPDPCP16 é imprescindível:
a) Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório \PROTHEUS_DATA\DATA) e dos dicionários de dados SXs (diretório \PROTHEUS_DATA\ SYSTEM).
b) Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
c) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
d) Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
e) O compatibilizador deve ser executado com a Integridade Referencial desativada*.

      ATENÇÃO: O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente!
*         A ativação indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no banco de dados. Portanto, antes de utilizá-la, observe atentamente os procedimentos a seguir:
              i.        No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação (APCFG60A).
             ii.        Se não há Integridade Referencial ativa, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário qualquer outro procedimento de ativação ou desativação de integridade, basta finalizar a verificação e aplicar normalmente o compatibilizador, conforme instruções.
            iii.        Se há Integridade Referencial ativa em todas as empresas e filiais, é exibida uma mensagem na janela Verificação de relacionamento entre tabelas. Confirme a mensagem para que a verificação seja concluída, ou;
           iv.        Se há Integridade Referencial ativa em uma ou mais empresas, que não na sua totalidade, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em) integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada e reserve esta anotação para posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework para informações quanto a um arquivo que contém essa informação).
            v.        Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
           vi.        Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.
          vii.        Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da integridade, selecione-a(s) novamente e confirme a ativação.
Contate o Help Desk Framework EM CASO DE DÚVIDAS!

1.    Em Microsiga Protheus TOTVS Smart Client, digite U_UPDPCP16 no campo Programa Inicial.
2.    Clique em OK para continuar.
3.    Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
4.    Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
5.    Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela.
6.    Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização, são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
7.    Clique em Gravar para salvar o histórico (log) apresentado.
8.    Clique em OK para encerrar o processamento.

Descrição de Ajustes
1.    Criação no arquivo SX3 – Campos:
·       Tabela SHY – Operações da Ordem APS:

2.   Criação de tabela no arquivo SX2– Tabelas:

 
3.   Criação de Índices no arquivo SIX – Índices:

Procedimento para Configuração

1.   No Configurador (SIGACFG) acesse Ambientes / Cadastros / Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:

Procedimento para Utilização

1.    No software TOTVS APS acesse a rotina Atualização de Dados (DB0200).
O sistema apresenta a janela de Parâmetros.
2.     Informe as datas de corte e entidades a serem importadas do Protheus para o APS.
3.    Clique em Executar.
4.    Ainda no software TOTVS APS, acesse a rotina Painel de Controle (DB0201).
5.     Execute o Planejamento de Produção até o passo de subordinação.
6.    Também no software TOTVS APS, acesse a rotina Confirmação da Programação (DB0202).
O sistema apresenta a janela de Parâmetros.
7.    Informe as datas de corte e entidades a serem exportadas do APS para o Protheus.
8.    Clique em Executar.
9.    Observe no Protheus a geração das Solicitações de Compra / Autorizações de Entrega e Ordens de Produção.