Integração TOTVS APS x Logix Manufatura

Contexto de negócio

O TOTVS APS 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 Logix como seu sistema de gestão empresarial usufruir dos benefícios do sistema APS. 

Sistemas Envolvidos

• TOTVS APS

O TOTVS APS é uma ferramenta avançada de planejamento da produção, que roda independente do ERP. Têm como principais características: a rapidez e desempenho no processamento; a precisão nas programações geradas; a elevada capacidade de refletir a realidade operacional dos diferentes sistemas de produção e a alta tecnologia com que são desenvolvidos.

Veja abaixo o que o TOTVS APS pode responder:

• O que, quanto e quando produzir;
• O que, quanto e quando comprar;
• Em que máquina produzir;
• A que horas começar;
• Quando liberar o material para a fábrica;
• Qual a melhor sequência de produção/setups;
• Como reagir a eventos inesperados;
• A necessidade de turnos adicionais ou horas extras;
• Quando será possível entregar cada pedido;
• O que está restringindo a produção;
• Onde investir para melhorar a entrega.

Sendo que os Resultados gerados são:

• Maior precisão nos Prazos de Entrega;
• Redução das Despesas Operacionais;
• Diminuição do lead-time de produção;
• Flexibilização da Produção;
• Agilidade nas Reprogramações;
• Aumento no Ganho pela Otimização das Restrições;
• Redução dos Estoques de matéria-prima, processo e produto acabado.

Integração

Esta integração viabiliza aos clientes TOTVS que utilizam o ERP Logix como seu sistema de gestão empresarial usufruir dos benefícios do sistema APS.

Escopo

A comunicação entre os dois produtos ocorre em dois momentos: Atualização de Dados e Confirmação. A atualização de dados consiste na busca dos cadastros do Logix através de queries.

A Confirmação consiste em enviar Ordens de Produção e Compras, para alteração e inclusão, por meio de webservices.

A integração APS x Logix atualiza informações de somente uma empresa Logix, porém, em todas as queries, é enviado o código da empresa (estabelecimento APS) informado na tela Parâmetros no Planejamento Avançado (DB1000), para que futuramente o APS possa tratá-la.

Importante:
Se o Logix possuir duas empresas, é necessário que exista dois bancos de dados do APS, cada banco tratando as informações de sua empresa separadamente.

A parametrização do banco de dados do Logix é case-sensitive, enquanto o Progress é case-insensitive, portanto, na atualização de dados, para não ocorrer problemas de índice de tabela, será importado para o APS sempre o primeiro registro encontrado na query. O conselho é que campos chaves sejam cadastrados sempre utilizando letras maiúsculas.

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

A TOTVS orienta que ambos os produtos (APS e Logix) estejam com suas versões e releases equalizadas. Exemplo: versão 12.1.12 Logix e APS (Datasul).

Para utilização do TOTVS APS é necessário a instalação do ambiente Progress e Datasul.

Será necessário duas licenças (Logix) a mais, consumidas pelos dois novos webservices (Ordem de Produção e Ordem de Compra). 

Importante: O License Server (Logix e Datasul) devem estar na versão 2014 ou superior.

1. TOTVS APS

A configuração de banco de dados do TOTVS APS é pré-requisito para inicializar a atualização de dados e deve ser realizada no programa Parâmetros no Planejamento Avançado (DB1000), informando os dados de acordo com o tipo de banco de dados do Logix.

Caso o banco de dados Logix seja Informix, é necessário incluir um Fonte de Dados ODBC e informar no campo “Nome Fonte de Dados (DSN)” o mesmo nome incluído no Fonte de Dados ODBC.

Observação: Para evitar problemas na atualização de dados, ao acessar um registro em edição, recomendamos que a conexão seja parametrizada com Isolation Level Read Uncommitted (leitura suja).

Image Added

Ainda no programa Parâmetros no Planejamento Avançado (DB1000), é necessário informar a URL do Webservice do Logix, que pode ser encontrado no appserver.ini do servidor Logix. 

Dica:
Para facilitar a parametrização do TOTVS APS, utilize a rotina Wizard de Implantação APS (DB4000).

Para empresas que utilizam o conceito de grade de produtos do Logix, ainda é necessário a importação dos Tipos de Grade, por meio do programa Tipos de Grades (DB0142) no TOTVS APS.

O conceito de referência do APS não atende de forma completa o conceito de grade do Logix, dessa forma, serão integrados os tipos de grade e conteúdo das grades ao APS, onde a grade será concatenada ao código do item. Para tanto, é necessário considerar o tipo da grade (cor, tamanho, entre outros) e o conteúdo (vermelho, médio, entre outros) das tabelas do Logix e armazená-las na tabela (tip-grade- dbr) do APS. Onde, a partir dessas informações serão geradas referências de 3 a 5 caracteres.

As informações de tipo de grade estão localizadas na tabela ctr_grade do Logix, que são importadas no programa Tipos de Grades (DB0142) do APS (a importação dos tipos de grade é pré-requisito para integração APS x Logix, quando o Logix utilizar grades em seus itens).

Dicas para configuração do Tipo de Grade e geração do Conteúdo de Grades no APS. A saber:

• Grade com três caracteres limita-se a 1233 grades diferentes.
• Grade com quatro caracteres limita-se a 27233 grades diferentes.
• Grade com cinco caracteres limita-se a 718057 grades diferentes.

As grades são concatenadas ao código do item, que possui 30 caracteres, onde os últimos 15 caracteres são destinados às grades. Portanto, se a empresa utiliza as 5 grades, recomenda-se que seja parametrizado a geração de grades com 3 caracteres (3 x 5 = 15), limitando a 1233 grades.

Caso a empresa utilize o mais comum, duas grades (Cor e Tamanho), recomenda-se que se utilize a geração da grade Cor com quatro caracteres e tamanho com três caracteres.

2. Logix

Não é necessária nenhuma ação no Logix, no que diz respeito aos parâmetros de tela para que a integração seja possível.

Instalação/Atualização

1. TOTVS APS

Não é necessária nenhuma ação em arquivos de configuração do TOTVS APS.

2. Logix

Informar os dados abaixo no arquivo de configuração Totvsprofile.pro

Informar os dados abaixo no arquivo de configuração TotvsAppServer.ini para habilitar o webservice do Logix.

Iniciar o TotvsAppServer Console. Observar se o WebService está habilitado no console, e em um browser observar se os serviços PRODUCTIONORDER e PURCHASEORDER estão habilitados por meio do endereço informado no URLLocation.

Controle de Versão

As mensagens de Ordem de Produção e Compra foram construídas baseadas na versão 2.000 e 1.007, respectivamente.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos TOTVS APS e Manufatura Logix 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 entradas de informações das entidades do APS deverão ser realizadas via acesso direto ao banco de dados Logix. Este formato foi utilizado na integração APS x Protheus, e pelo alto volume de informações, mostrou melhor desempenho e rapidez na atualização de dados, pois o acesso é efetuado diretamente ao banco de dados.

Segue abaixo as entidades integradas:

Entidades não integradas.

Turnos de Exceção: inexistente no Logix.

Roteiro de Fabricação: não será integrado o roteiro de fabricação dos itens, dessa forma não será usado o programa DB0108, onde possui o vínculo do roteiro com o item, e será usado o programa DB0109, onde é vinculado diretamente a operação dos itens. Operação Padrão: não existe Operação Padrão no Logix.

Roteiros do item: não será integrado o roteiro de fabricação dos itens, dessa forma não será usada o programa DB0108, onde possui o vínculo do roteiro com o item, e será usado o programa DB0109, onde é vinculado diretamente a operação dos itens.

Centro de Trabalho Válido: inexistente no Logix.

Código Redutor de Preparação: inexistente no Logix

Referência do Item: inexistente no Logix.

Referência Estrutura: inexistente no Logix.

Recurso Secundário: inexistente no Logix.

Código Redutor de Preparação: inexistente no Logix.

Matriz Redutor de Preparação: inexistente no Logix.

Recurso Secundário x Centro de Trabalho: inexistente no Logix.

Recurso Secundário x Operação: inexistente no Logix.

Grupo de Máquina x Grupo de Máquina Alternativo: inexistente no Logix.

Fluxo das Informações

O TOTVS APS envia somente inclusão, alteração ou deleção de Ordens de Compra e Ordens de Produção por completo. Nunca será enviada a exclusão de uma necessidade ou, operação de ordem de produção. Ele também não envia alterações de entidades cadastrais ao ERP, algumas informações podem ser alteradas no APS com o intuito de simulação. Após a atualização de dados, essas informações são sobrepostas. 

1. Mapeamento de Entidades APS

Atualização de Dados do TOTVS APS, ou seja, as informações recebidas pelo APS.

1.1 Estabelecimento

Programa Logix: LOG00083

1.2 Calendário e Datas Calendário

Programa Logix: LOG70010

No APS, é gravado o dia no calendário, indicando se é dia útil, descanso ou feriado. No Logix não existe a visão dia-a-dia, somente o dia da semana e se este é Normal, Reduzido ou Sem Expediente, e a tabela feriado, que indica os feriados do calendário. A geração do calendário no Logix é automática, gerando 200 anos a partir da data de geração. Como o APS trata data passada, o calendário é gerado com 10 anos no passado, se existir, e 10 anos no futuro, baseado na data da atualização.

O Logix envia o calendário do modulo MAN – Manufatura, ou seja, log_calend_empresa = “MAN”.

O cadastro de calendário permanecerá habilitado no APS e a atualização de dados não irá eliminar os calendários incluídos manualmente no APS.

GAP Identificado:
As diferenças de conceito do calendário entre TOTVS APS e Logix, detalhado acima, obrigou a construção de uma query utilizando funções de banco de dados que não existem no Informix. Devido a restrições tecnológicas do SGBD Informix, não é possível reproduzir o resultado esperado nessa query. Como forma de solução, o cadastro de calendário, deve ser cadastrado no TOTVS APS, quando integrado ao Logix – Informix.

1.3 Turno e Turno dia

Programa Logix: MAN10008 e MAN10006

Existem diferenças entre o cadastro de Turno entre APS e Logix. No APS existe o modelo de turno, que é um agrupador de turnos, e não é permitida sobreposição de horários entre turnos do mesmo modelo. No Logix, não existe uma entidade semelhante ao Modelo de Turno, cada turno possui um código único sendo possível a sobreposição de horas. Sendo assim, é carregado no APS os turnos associados aos Centros de Trabalho do Logix (MAN10006). O código e descrição do Modelo de Turno será o código e descrição do Centro de Trabalho do Logix.

Não serão carregados Turnos, onde:

• Ocorre sobreposição de hora. Exemplo: se o Centro de Trabalho possuir um turno das 8 às 18, e outro turno das 14 as 24, o APS irá carregar somente um dos turnos, pois há sobreposição de horários.
• Data de referência da Atualização de Dados esteja fora da faixa de validade cadastrada no Logix (MAN10006).

Exemplo utilizando Data de Referência 15/10/2014:

Somente os turnos 1 e 3 serão carregados para o APS. O turno 2 não é carregado para o APS, mesmo que teoricamente alguma Ordem fosse programada para produção entre os dias 20/10/2014 e 30/10/2014, pois no APS não existe data de validade no turno e o turno 2 seria considerado erroneamente no dia 15/10/2014. Para essa situação é recomendado que o turno seja cadastrado no APS.

Quando o parâmetro “Turno” estiver desmarcado na Atualização de Dados (DB0200) o Modelo de Turno não é carregado. Porém quando selecionado, são considerados somente os turnos cadastrados no Logix. Alterações realizadas no APS em Turnos provenientes do Logix serão sobrepostos, enquanto registros cadastrados no APS serão mantidos, desde que não exista conflito de codificação com Logix.

O Logix envia todos os turnos do módulo MAN, convertendo a hora inicial e final do turno para decimal.

Ainda no Logix, o usuário pode alterar, de forma manual, a “Quantidade de horas” do dia, mas no APS não é possível que essa quantidade de horas seja diferente da soma das horas diárias do turno.

1.4 Grupo Estoque

Programa Logix: SUP10001

1.5 Unidade Medida

Programa Logix: MAN10013

1.6 Ferramentas

Programa Logix: MIN0020

No Logix as ferramentas são cadastradas como equipamentos.

1.7 Forncedores

Programa Logix: VDP10000

1.8 Depósitos

Programa Logix: SUP10002

1.9 Tipos de Grade

Programa Logix: MAN10068

O conceito de referência do APS não atende de forma completa o conceito de grade do Logix, dessa forma, serão integrados os tipos de grade e conteúdo das grades ao APS, onde a grade será concatenada ao código do item. Para tanto, é necessário buscar o tipo da grade (cor, tamanho, etc) e o conteúdo (vermelho, médio, etc) nas tabelas do Logix e armazená-las na tabela (tip-grade- dbr) do APS. Onde, a partir dessas informações serão geradas referências de 3 a 5 caracteres.

As informações de tipo de grade estão localizadas na tabela ctr_grade do Logix, que são importadas no programa Tipos de Grades (db0142) do APS (a importação dos tipos de grade é pré-requisito para integração APS x Logix, quando o Logix utilizar grades em seus itens).

Dicas para configuração do Tipo de Grade e geração do Conteúdo de Grades no APS. A saber:

Grade com 3 caracteres limita-se a 1233 grades diferentes.

• Grade com 4 caracteres limita-se a 27233 grades diferentes.
• Grade com 5 caracteres limita-se a 718057 grades diferentes.

As grades são concatenadas ao código do item, que possui 30 caracteres, onde os últimos 15 caracteres são destinados às grades. Portanto, se a empresa utiliza as 5 grades, recomenda-se que seja parametrizado a geração de grades com 3 caracteres (3 x 5 = 15), limitando a 1233 grades.

Caso a empresa utilize o mais comum, duas grades (Cor e Tamanho), recomenda-se que utilize-se a geração da grade Cor com 4 caracteres e tamanho com 3 caracteres.

1.10 Item

Programa Logix: MAN10021

São enviados somente itens ativos, que possuem ou fazem parte de uma estrutura, ou que possuem demanda de venda. Exceto no caso de selecionar o parâmetro “Atualizar todas as grades do item”.

Funcionalidade do parâmetro “Atualizar todas as grades do item”:

• Quando selecionado, deve atualizar todas as possibilidades de grades cadastradas para um item no MAN10081 (man_conteudo_grade), e considerar todos os itens, mesmo os que não possuem demanda ou que não fazem parte de uma estrutura.
• Quando desmarcado, deve atualizar somente as grades dos itens e itens que possuem demanda ou que fazem parte de uma estrutura. Esses itens devem ser ignorados quando campo “origem” da query igual a “2”.

Implicações quando parâmetro selecionado:

O volume de informações processadas e tempo da atualização será consideravelmente maior, pois cada combinação de grade corresponde a um item no APS.

A confirmação poderá gerar um elevado número de Ordens de Compras ou Ordens de Produção, afim de atender uma possível necessidade de estoque de segurança.

Exemplo: Um item possui as grades Cor e Tamanho, sendo: Amarelo, Vermelho, Preto e Branco.

P, M, G, GG

A combinação dessas grades gerará 16 itens diferentes no APS, e caso exista Estoque de Segurança a atender, o APS programará 16 Ordens de Produção ou Compra.

Caso as combinações sejam maiores, 100 cores e 100 tamanhos, o volume será de 10000 itens e possíveis 10000 Ordens planejadas pelo APS.

Implicações quando parâmetro desmarcado:

Se o item tiver a quantidade de estoque de segurança informada, porém não faz parte de uma estrutura ou demanda de venda, este não será enviado ao APS e não será planejada a quantidade afim de atender seu estoque de segurança. O mesmo caso ocorre para uma determinada combinação de grade do item.

Grades:
O Logix envia, de forma independente, o código do item, tipo grade 1, conteúdo grade 1 até o tipo grade 5 e conteúdo grade 5, somente das grades em uso. As grades são armazenadas na tabela item-extens-dbr.

Os itens com grade são atualizados no APS da seguinte forma:
Código Item + Cód Grade 1 APS + Cód Grade 2 APS + Cód Grade 3 APS + Cód Grade 4 APS + Cód Grade 5 APS.
As primeiras 15 posições serão utilizadas para o código do item e as últimas 15 serão utilizadas para o código da grade APS. Exemplo Cadastro do Item:

Item APS:

Importante:

Compr-fabric (Item Comprado ou Fabricado)

O Logix verificará o campo item.ies_tip_item, seguindo as regras:

• Se igual ‘C’ retorna o valor 1 (Comprado);
• Se igual ‘B’ retorna o valor 3 (Beneficiado / Fabricado);
• Senão, retorna o valor 2 (Fabricado).

O APS deverá gravar sempre 1 ou 2 no campo item-dbr.compr-fabric, mesmo que o item seja considerado 3 - Beneficiado. Pois quando o item é beneficiado, possui estrutura, porém gera ordem de compra. Para identificar que o item é 3 - Beneficiado, deve ser gravado na tabela de extensão do item extens-item-dbr.log-benef = TRUE, dessa forma, na Confirmação do APS a Ordem de Produção do item beneficiado será ignorada e será enviado uma Ordem de Compra.

Caso um item identificado como Fabricado, Beneficiado ou Final no Logix NÃO possuir estrutura, o APS considerará o mesmo como Comprado, durante a execução de suas rotinas (Planejamento). O ajuste deverá ser realizado no Logix.

Caso um item identificado como Comprado no Logix possuir estrutura, o APS considerará o mesmo como Fabricado, durante a execução de suas rotinas (Planejamento). O ajuste deverá ser realizado no Logix.

Log-sobra (Arredonda sobra pelo lote), div-ordem (Forma de divisão das ordens planejadas ao confirmá-las) e Lote-economico. O campo log-sobra quebra a OP pelo lote atribuído ao campo div-ordem. Na integração Logix, existem os campos “Dias Mínimos entre Ordens” e “Programação Fixa”, que caso for diferente de zero, significa que o campo div-ordem = 3 (divide pelo Lote Econômico) e lote-economico = Programação Fixa da pasta Planejamento 2 do cadastro de item do Logix. Se o campo “Dias Mínimos entre Ordens” ou “Programação Fixa” igual a zero, então div-ordem = 1 (Não divide) e lote-economico = 0.

Exemplo quando log-sobra = false e lote econômico = 300:

Necessidade = 800, gera 3 OPs de 300, 300 e 200 respectivamente.

Exemplo quando log-sobra = true e lote econômico = 300:

Necessidade = 800, gera 3 OPs de 300, 300 e 300 respectivamente.

Para dar maior flexibilidade ao usuário, o campo log-sobra será manutenido exclusivamente no APS.

Política:
Não existe no Logix um campo correspondente à política do item, dessa forma serão consideradas as seguintes regras:

• Se item for comprado, beneficiado ou fantasma deverá ser PERÍODO FIXO.
• Se produzido ou final e o campo dias mínimos entre ordens maior que zero deverá ser PERÍODO FIXO.
• Se produzido ou final e o campo dias mínimos entre ordens igual a zero deverá ser NÍVEL SUPERIOR.
• Exceção: Se ocorrer de um item produzido (pai) possuir a política período fixo e existir algum filho com política Nível Superior, esses serão alterados automaticamente para período fixo, para que não ocorra conflito na execução da Explosão.

Se a política do item, for alterada no APS, deve-se manter o valor do APS.

Res-cq-comp (Tempo de Ressuprimento de CQ de Compras)
Deverá ser o somatório dos seguintes campos:
Tempo Contagem + Tempo Inspeção + Tempo Emergência (Folder planej. Compra do cadastro de item Logix)

Res-for-comp (O Tempo de Ressuprimento do Fornecedor)
Deverá ser o somatório dos seguintes campos:
Tempo Fabricação + Tempo do transporte (Folder planej. Compras)

Tempo-segur (Tempo de segurança do produto)
No APS soma-se o tempo de segurança ao tempo de ressuprimento, e no Logix o campo Tempo Segurança é transformado em quantidade, por isso, não será integrado, e será manutenido exclusivamente no APS.

Ressup-fabri (Tempo Ressuprimento de Fabricação)
Corresponde ao campo Ressuprimento do Logix. No Logix existe ainda os campos Fator Múltiplo 1 e 2, e Limite Múltiplo 1 e 2, onde o tempo de ressuprimento pode aumentar de acordo com a quantidade produzida. Esse conceito é restrito ao Logix e não serão atualizados no TOTVS APS.
Nota: Se o campo for comprado ou beneficiado, é enviado o campo Tempo de Ressuprimento somado ao Tempo de Inspeção. Itens fabricados é apenas o campo Tempo de Ressuprimento.

Tipo-con-est (Tipo de Controle de Estoque)
No Logix não existe um campo correspondente, dessa forma, seguirá as seguintes regras:

• Se o item controlar número de série, é considerado = 2 (Número de Série);
• Se controlar lote, é considerado = 3 (Lote);
• Senão = 1 (Serial).

Nota 1: O tratamento da grade realizado pelo APS não é suportado pela referência, por isso não existirá itens parametrizados como 4 (Referência).
Nota 2: O Controle de Estoque dos itens no Logix é mais amplo, podendo ser controlado por 9 dimensionais diferentes, porém no APS são controlados somente o Lote e Grades, onde outros controles serão sumarizados.

Val-item (Valor do Item)
O Logix enviará o custo médio.

Val-base
A query possui os seguintes campos de custo e preço:
medio-mensal-item: Custo médio.
custo-padrao-item: Logix não possui custo padrão, dessa forma, a query enviará valor zerado.
preco-ult-ent-item: No Logix, somente item comprado possui este custo, itens fabricados terá valor zero.
preco-repos-item: Logix não possui preço de reposição, dessa forma, a query enviará valor zerado.
preco-venda-item: Preço da venda do item.

1.11 Item x Estabelecimento

É criado automaticamente na atualização de dados pela entidade item-dbr, de acordo com o item e estabelecimento.

1.12 Estrutura

Programa Logix: MAN10002

A atualização da estrutura seguirá o conceito do cadastro de item, no que diz respeito a grades.

Estrutura com grade no Logix

Se um item utiliza grade, pode-se cadastrar uma estrutura desse item sem informar a grade, dessa forma, os componentes dessa estrutura serão considerados para todas as grades. Ou seja, existe um compartilhamento dos componentes de acordo com a grade do item.

O Logix enviará a junção de todos os componentes da estrutura, independente se a estrutura do item possui ou não a grade. Ou seja, os componentes da estrutura de um item que utiliza grade, mas não foram informadas as grades, serão repetidos para todas as grades.

Exemplo:

Nota-se no exemplo anterior que a necessidade com Grade Tamanho M não possui estrutura, porém foi cadastrado uma demanda com essa grade. O Logix considera os componentes do item de acordo com o nível de compartilhamento das grades no cadastro da estrutura. Para a camisa verde M, ele busca os componentes da camisa verde e os componentes da camisa sem grades, se existisse algum componente para o tamanho M, estes também seriam adicionados a necessidade. 

Modelo físico das entidades: 

* Obrigatório

Atenção:
Fantasma
No Logix, a definição de fantasma está no cadastro do item, dessa forma a query verifica o tipo do item componente para definir a relação na estrutura do APS.

Qtd-Item
No Logix a quantidade de produção do item pai na estrutura é sempre 1, dessa forma estará fixo na query.

Op-codigo
O Logix enviará o Seq_processo, mesmo campo enviado na operac-engr.op-codigo.
Quando o componente (estrutura ou reserva) com operação em branco, o APS já vincula esse componente na primeira operação na explosão.

Tipo-sobra
Se qtd_necessaria for negativa envia valor 3 (co-produto), senão 4 (normal).

Sequencia
Será enviado um sequencial único da tabela de componente da estrutura.

Importante: A ordem de processamento deve ser operac-engr e depois estrut-item-dbr.

1.13 Centro de Trabalho

Programa Logix: MIN0020 

O CT do APS corresponde ao cadastro de equipamento do Logix.

1.14 Grupo de Máquina

Programa Logix: MAN10078

O GM do APS corresponde ao cadastro de recurso do Logix.

Num-maquina

Para buscar o número de processadores do grupo de máquina no Logix, deve-se verificar o parâmetro da origem do equipamento:

par_pcp_parametros[150,150] = "1" : Equipamento (count da tabela equipamento). Serão considerados os equipamentos cadastrados no MIN0010 e MIN0020 do Logix.

par_pcp_parametros[150,150] = "2" : Cfp_equi (count da tabela cfp_equi). Serão considerados os equipamentos cadastrados no MAN1460 do Logix.

par_pcp_parametros[150,150] = "3" : Recurso. Será considerado sempre 1.

1.15 Grupo Máquina x Modelo Turno

Programa Logix: MAN10006

Devido as diferenças conceituais de Turno entre APS e Logix, o modelo de turno conterá todos os turnos associados a cada centro de trabalho, conforme explicado no item 3.3 Turno e Turno Dia. Sendo assim, o GM x Turno será atualizado com o código do Centro de Trabalho do Logix e os GM associados aos CT´s.

Campo Dt-inicio
O campo dt-inicio é chave primária no APS, porém é um campo não obrigatório no Logix, dessa forma, caso o campo esteja vazio, o registro não será atualizado e será orientado ao usuário informar o campo no Logix.

GAP identificado

No Logix existe o conceito de Centro de Trabalho, que se refere a um agrupamento de Recursos (GM), o APS não possui um cadastro correspondente. O Turno no Logix é referenciado a esse Centro de Trabalho, que é composto por várias GMs. Pode ocorrer do mesmo GM possuir turnos diferentes em Centros de Trabalhos. Dessa forma, uma operação realizada em um GM poderá ser realizada somente no turno do Centro de Trabalho. No APS o sequenciamento não diferencia o Centro de Trabalho da operação, podendo alocar a operação em um turno que não é destinada a ela.

Exemplo:
Parametrização dos Centros Trabalho Logix x Turno

Operação utilizando recurso GM01 no Logix:

GM x Turno no APS:

Teoricamente, a operação “01” deveria ser sequenciada no turno 02, pois foi parametrizada no Logix para o Centro de Trabalho 002. Mas a atualização de dados considera o primeiro turno encontrado (01), já que o APS não permite dois turnos para o mesmo

GM. No momento esse GAP não é tratado.

1.16 Família de Material

Programa Logix: MAN10003

1.17 Família Material x Estabelecimento

Será criado automaticamente na atualização de dados na entidade família-dbr, de acordo com a família e estabelecimento.

1.18 Ferramentas da operação do item

Programa Logix: MAN10243

A rastreabilidade entre as ferramentas da operação e o cadastro de operações ocorre por meio do campo num-id-operacao, campo sequencial e único. O Logix envia o código da operação, e na atualização de dados, é gerada a ferramenta para todos os num-id-operacao encontrado na operac-engr, pois para cada op-codigo enviado pode existir “n” num-id-operacao.

Num-id-operacao
O Logix envia o campo seq_processo, que é o mesmo enviado para o campo operac-engr.op-codigo, que então é substituído pelo sequencial gerado pelo APS (operac-engr.num-id-operacao). Dessa forma, mantém-se a rastreabilidade entre as tabelas operac- engr e op-ferr-dbr.

log-principal e un-ciclo
Esses campos serão manutenidos no APS.

1.19 Operações do item

Programa Logix: MAN10243

A atualização das operações do item seguirá o conceito do cadastro de item, no que diz respeito a grades.

Conceito Roteiro Logix: O mesmo roteiro pode não ser compartilhado pelos itens. Ou seja, o mesmo código de roteiro pode possuir operações e componentes diferentes em itens diferentes.

Roteiro APS: O código do roteiro é reaproveitado em itens diferentes. Ou seja, um código de roteiro, terá sempre os mesmos processos e componentes, independente do item.

O roteiro de fabricação dos itens não é integrado, dessa forma não será utilizado o programa DB0108 onde possui o vínculo do roteiro com o item, e será utilizado o programa DB0109 onde é vinculado diretamente a operação dos itens.

Os dados do processo possuem algumas divergências entre Logix e APS.

O Logix controla as operações pelo código da operação enquanto o APS controla via número sequencial.

Item Beneficiado
O APS deve validar os itens fabricados, e caso não exista operações, será criado uma operação fictícia. Para o caso do item ser beneficiado é necessário também, calcular o tempo da operação fictícia, baseado no tempo de todos os campos de ressuprimento (Fornecedor, Compras e CQ Compras) do item multiplicado por 24 (no APS o tempo é dado em horas). Ou seja:
(item-dbr.res-for-comp + item-dbr.res-int-comp + item-dbr.res-cq-comp ) * 24

Será aplicada a seguinte regra entre as tabelas operac-engr e man-processo_item:
NUM-ID-OPERACAO
Quando utiliza o conceito grade, as operações podem ser cadastradas por composição no LOGIX. Se isso ocorrer às sequências da operações estarão repetidas e não podem ser passadas para o APS, pois o campo num-id-operacao é chave única.
Por isso, é criado um sequencial numérico na atualização de dados, de acordo com a ordenação dos registros enviados pelo Logix.
Para manter a rastreabilidade, esse mesmo código gerado na atualização é replicado para as seguintes tabelas:

• Op-ferr-dbr;
• Op-ord-dbr;
• Pert-ord-dbr;
• Rede-op-dbr.

OP-CODIGO
Será utilizado também o SEQ_PROCESSO da man_processo_item.
Para buscar o processo, será ordenado pela sequência da operação e PRIORIDADE, ficando sob responsabilidade do usuário cadastrar a prioridade que as operações serão executadas. Se a prioridade for igual para as duas à integração fará o ordenação via SEQ_PROCESSO.

NR-UNIDADES
O Logix sempre enviará valor 1, é deve ser sobrescrito na atualização, caso seja alterado no APS.

COD-OPERAC-ERP
Código da operação do ERP. Nas telas do APS, quando integrado ao Logix, será mostrado o valor desse campo.

NUM-SEQ
Código sequencial da operação, deve ser incrementado na ordem que as operações do item são enviadas ao APS. Será utilizado para ordenar as operações do item nas telas do APS, e gerar a rede pert.

IT-CODIGO

O item terá um tratamento especial, pois no LOGIX há possibilidade de usar a grade.
Quando usar a grade deverá enviar ao APS a grade e o conteúdo da grade para que o APS monte o código do item.
Se não controlar grade os valores da grade e conteúdo grade terão o conteúdo nulo.
Deve usar a mesma lógica descrita na atualização do ITEM, onde será concatenado as grades ao código do item.

GM-CODIGO

No APS é permitido apenas um grupo de máquina.
O Logix permite mais de um GM na mesma operação, dessa forma a regra será a seguinte:
Será utilizado o recurso do tipo equipamento que esteja cadastrado como crítico no Logix.
Se encontrar mais de um recurso, será considerado o primeiro recurso retornado pela query.
Não é considerado o Recurso do Tipo Mão de Obra.

TEMPO-MAQUIN

Será considerado o tempo do recurso (grupo máquina) enviado – man_recurso_processo.qtd_tempo. Se não existir ou for zero deverá considerar o tempo do processo man_processo_item.qtd_tempo.

TEMPO-HOMEM
É considerado o somatório dos tempos dos recursos de mão de obra da operação. Se o somatória for zero, então é enviado o tempo total da operação.

TEMPO-PREPAR
No Logix, para efeito de custo é proporcional a quantidade de produção, porém na atualização de dados será enviado o tempo informado na operação, não será executado nenhum cálculo, ou seja, não será considerado a quantidade de produção.

LOTEM-MIN, LOTE-MULTIPLO, LOTE-PADRAO, NR-PC-FERRAM e TEMPO-SIG
Esses campos estarão presente na query, porém para integração Logix, será enviado branco (‘ ‘), e na atualização de dados deve ser tratado:
Se = ‘ ‘ então mantém o valor no APS, senão atualiza com o valor enviado pelo Logix.

Importante:
O Logix permite que o item possua vários processos de fabricação, mas será enviado ao APS somente o processo do roteiro padrão informado no MAN10021 na aba Planejamento.

1.20 Rede de Operações

Não existe rede de operações no Logix, então foi adotada a regra de prioridade do Logix, e na query das operações do item, as informações serão enviadas em ordem pela sequência da operação e prioridade, ficando sob responsabilidade do usuário cadastrar a prioridade que as operações serão executadas, se a prioridade for à mesma para as duas ou mais operações, a integração fará o ordenação via SEQ_PROCESSO.

Dessa forma, a rede pert será gerada por meio de contador múltiplos de 10 (operac-engr.op-codigo), sequência em que as operações são enviadas pelo Logix.

1.21 Ordem Produção e Ordem Compra

Programa Logix: MAN0515 – Ordem Produção

               SUP21003 – Ordem Compra

A atualização da Ordem de Produção e Compra seguirá o conceito do cadastro de item, no que diz respeito a grades. Serão retornadas as ordens de produção ABERTAS e LIBERADAS e ordens de compra ABERTAS e REALIZADAS.

Nota: Não serão importadas ordens de produção FIRMES, pois nessa situação ainda não possuem operações e componentes. Também não serão importadas ordens com saldo zero.

O APS armazena as ordens de produção e documentos de compra na mesma tabela, diferenciando-as por meio do campo idi-tip- ord-dbr. A query deve ser uma Union das tabelas Ordem de Produção e de Ordem de Compra.

Modelo físico das entidades:

* Obrigatório

Ordem Compra de um item beneficiado.
Para efeito de planejamento, uma ordem de compra de um item beneficiado será considerada como Ordem de Produção. Então, na query, o Logix verifica o tipo do item, e sendo ele Beneficiado, enviará a Ordem de Compra como Ordem de Produção (idi-tip- ord-dbr = 2). Por outro lado, o APS ao receber uma OP, deve verificar se o item do documento é beneficiado e deve criar uma operação fictícia e calcular o tempo de produção (em horas) dessa operação baseada na data de referência da atualização de dados e data de entrega do documento.
Para evitar códigos de documentos iguais, o Código da Ordem de Compra convertida para Ordem de Produção, deve ser concatenada o caractere “B” ao final da codificação e gravada em ord-histor.cod-ord-alfa.

Regras aplicadas aos seguintes campos:
num-ord-dbr

No APS cria um valor sequencial para o código da Ordem e armazena o código da ordem Logix na tabela ord-histor.cod-ord-alfa.

nr-pedcli
Será enviado o num_docum, sendo que o documento pode ser, além de um pedido de venda, um plano de venda, plano mestre ou até mesmo um documento sem referência a outras entidades do Logix.

nr-sequencia

No Logix a sequência do item é parametrizada e armazenada no mesmo campo do número do documento (num_docum= PEDIDO/SEQUENCIA). Na query é necessário extrair essa informação utilizando os comandos INSTR e CHARINDEX. Pela ausência dessas funcionalidades ou de similares, não é possível obter a sequência no Banco de Dados Informix, nesse caso será enviado branco (‘ ‘).

idi-estado-op-dbr
1 – Não iniciada. Ordem Produção sem apontamento.
6 – Iniciada. Ordem Produção com apontamento.

idi-sit-oc-dbr
1 – Não confirmada. Ordem Compra Aberta.
2 – Confirmada. Ordem Compra Realizada.
3 – Cotado. Se já tiver fornecedor designado na ordem de compra (ordem_sup.cod_fornecedor) e número de cotação (ordem_sup.num_cotacao).
5 – Em Cotação. Se já tem a tabela ordem_sup_cot, quer dizer que a ordem de compra está em processo de cotação.

dat-inicio
A data de início de Ordem de Produção do Logix não é campo obrigatório, por isso, caso o campo dat_ini estiver vazio, é enviada a data de liberação da OP.

1.22 Operações da Ordem

Programa Logix: MAN0593 – Ordem Produção

A atualização das Operações da Ordem seguirá o conceito do cadastro de item, no que diz respeito a grades. Modelo físico das entidades.

* Obrigatório

GAP Identificado
No Logix existe a possibilidade de não apontar a ordem de produção por operação (MAN10021 – Planejamento – Aponta por Operação), dessa forma, o Logix não cria as operações da ordem em suas tabelas, logo, as operações da ordem não serão enviadas na atualização de dados. Deve-se criar as operações de acordo com a operac-engr do item. Porém, o centro de trabalho identificado para a operação poderá ser diferente, já que o APS fará o sequenciamento das operações novamente. Se não existir operac-engr do item, será criada uma operação fictícia. Na Confirmação do APS, a Ordem enviada para alteração não surtirá efeito no Logix, pois as operações da Ordem não existem. O Logix verificará que as operações não existem e retornará mensagem de erro.

Regras aplicadas aos seguintes campos:
OP-CODIGO
No código da operação “op-codigo”, é enviado o campo ord_oper.seq_processo, que é um sequencial da tabela de operações da ordem.

NUM-ID-OPERACAO
É enviado o número do processo que indica o número serial dessa operação na engenharia (ord_oper.num_processo), mesmo valor enviado para o campo operac-engr.op-codigo. Esse valor é substituído pelo sequencial gerado pelo APS (operac-engr.num- id-operacao). Dessa forma, mantem-se a rastreabilidade entre as tabelas operac-engr e op-ord-dbr.

GM-CODIGO
É enviado o campo MAN_RECURSO_OPERACAO_ORDEM.COD_RECURSO do tipo equipamento.
No APS é permitido apenas um grupo de máquina, enquanto no Logix os recursos (GM) podem se repetir. É enviado o recurso que esteja parametrizado como crítico. Porém, se não existir recurso parametrizado como crítico, é considerado o primeiro recurso encontrado.

TEMPO-HOMEM
É utilizado o tempo dos recursos de mão de obra alocados na operação multiplicado pela quantidade de recursos de mão de obra.
No Logix o tempo pode ser Horas, Minutos ou Segundos e no APS o tempo é medido em Horas. O Logix enviará o tempo convertido.
São considerados todos os recursos do tipo homem, onde é enviado o tempo HOMEM da tabela man_recurso_operacao_ordem se este existir e for maior que zero. Senão é considerado o tempo total da operação da tabela ord_oper.

TEMPO-MAQUIN
É enviado o tempo do recurso (GM-CODIGO).
No Logix o tempo pode ser Horas, Minutos ou Segundos e no APS o tempo é medido em Horas. O Logix enviará o tempo convertido.
O APS permite apenas um GM, e dessa forma é considerado o tempo do recurso (GM) crítico (ou do primeiro que encontrar quando não possuir crítico).
O tempo pode vir da tabela man_recurso_operacao_ordem, se for maior que zero, ou o tempo da operação da tabela ord_oper quando o tempo não existir ou for igual a zero na man_recurso_operacao_ordem. O tempo máquina será multiplicado pela quantidade programada (saldo da operação).

COD-CTRAB
Considerar a máquina das tabelas man_prog_prod_eqpto_item e man_prog_prod_eqpto_detalhe para a ordem de produção.

TEMPO-REPORTADO
Envia o tempo reportado quando não tem nenhuma quantidade reportada, se existir quantidade reportada, o APS calcula de acordo com o saldo de produção. Serão enviados os apontamentos ativos de tempo (man_tempo_producao) da operação da ordem de produção.

SEQUENCIA
O Logix envia as operações ordenadas pela sequência e prioridade na atualização de dados, esse campo é auto incrementado respeitando a ordem de chegada dos registros.

1.23 Rede de Operações da OP

A rede de operações da Ordem Produção será criada automaticamente na atualização de dados, baseada na ordenação da operações da ordem (op-ord-dbr) enviada pelo Logix.

Modelo físico das entidades:

1.24 Reserva da OP

Programa Logix: MAN0585

A atualização da Reserva da OP seguirá o conceito do cadastro de item, no que diz respeito a grades.

Modelo físico das entidades:

* Obrigatório

Regras aplicadas aos seguintes campos:

Op-codigo
Seq_processo da tabela ord-oper.
Quando o componente (estrutura ou reserva) com operação em branco, o APS já vincula esse componente na primeira operação na explosão.
No Logix existe a possibilidade de não apontar a ordem de produção por operação, dessa forma, o Logix não cria as operações da ordem em suas tabelas, logo, as operações da ordem não serão enviadas na atualização de dados. Deve-se criar as operações de acordo com a operac-engr do item. Porém, o centro de trabalho identificado para a operação poderá ser diferente, já que o APS fará o sequenciamento das operações novamente. Se não existir operac-engr do item, será criada uma operação fictícia.

qtd-saldo
O Logix permite que o mesmo componente se repita na mesma operação, quando isso ocorrer, deve-se somar as quantidades.

1.25 Saldo Estoque

Programa Logix: SUP50001

O APS agrupa o estoque por estabelecimento, item, referência e lote. No Logix existe a tabela estoque_lote_ender, que detalha o estoque por empresa, item, lote, grades e dimensionais e a tabela estoque_lote que possui o agrupamento por lote. Como o APS não integra referência e não diferencia os dimensionais de estoque, a query deve ser a soma do campo quantidade agrupando por

Empresa, Item (item + grades) e lote, selecionando apenas o estoque liberado.

A atualização do Saldo Estoque seguirá o conceito do cadastro de item, no que diz respeito a grades.

No Logix é possível, por meio de parametrização, ter itens com estoque negativo. Nesse caso, a atualização de dados considera o estoque zerado, pois o APS não trabalha com estoque negativo.

Modelo físico das entidades:

* Obrigatório

Regras aplicadas aos seguintes campos:

dat-valid-lote
Se a data for igual a 01/01/1900, significa que o lote não possui validade.
No Logix a data de validade do lote faz parte da chave primária da tabela, dessa forma, caso exista quantidades em lotes iguais com datas de validade diferente, a query soma as quantidades e envia a menor das datas de validade.
No Logix, ainda existe a possibilidade de informar uma data de validade de estoque sem lote, nesses casos, na atualização de dados o APS considera o lote igual a branco (“ “).

qtd-entr-benef
Será considerado como quantidades de terceiro em poder da empresa.

qtd-remes-benef
Será considerado como quantidades da empresa em poder de terceiro.

qtd-sdo-estoq-dbr
Será considerada a quantidade disponível no estoque, ou seja, situação = ‘L’ – Liberado.

GAP identificado
No Logix, é permitido a inclusão de quantidade no estoque de um item com grade, onde a grade não esteja em uso (estrutura ou venda), dessa forma, na atualização de estoque, pode enviar um item que não existe no APS. Não influenciará nos processos do APS e devem ser ignorados. Porém, deve ser informado no log da atualização que o item foi ignorado.

1.26 Saldo Estoque Terceiro

Programa Logix: SUP50001

O estoque na tabela sdo-terc-dbr já está contido na tabela de estoque (sdo-estoq-dbr) de forma sumarizada e agrupado por tipo de estoque de terceiro.

O saldo de estoque de terceiro seguirá as mesmas regras da query de saldo de estoque, enviando somente os estoque de terceiros e estoque em poder de terceiros (tipo-sal-terc = 1 e 2).

Modelo físico das entidades:

* Obrigatório

Regras aplicadas aos seguintes campos:

quant-saldo
Será enviado os estoques em terceiros e de terceiros.

tipo-sal-terc
No Logix existe somente os tipos 1 e 2.

1.27 Pedido de Venda

Programa Logix: MAN10237

A atualização dos itens dos Pedidos de Venda seguirá o conceito do cadastro de item, no que diz respeito a grades.

Serão enviadas todas as demandas cadastradas no Logix, indiferentemente da origem (Pedido Venda, Plano Mestre, Plano Venda ou arquivo texto). Serão consideradas somente demandas com situação 1, ou seja, situações que não foram processadas por outras rotinas, e com saldo maior que zero. Caso seja necessário filtrar a origem, isso poderá ser feito manualmente no cadastro de query.

Importante:

O parâmetro para atualizar a demanda no faturamento deve ser acionado no Logix:

“Atualizar quantidade da necessidade ou da demanda no faturamento?” (atualiza_qtd_sai_necd_fat), do log2240.

Esse parâmetro irá atualizar o saldo da demanda quando ocorrer alguma alteração no pedido (faturamento/cancelamento, entre outros).

Modelo físico das entidades:

* Obrigatório

Regras aplicadas aos seguintes campos:

idi-sit-avaliac
O campo situação do pedido de venda, será enviado fixo como 3 – Aprovado, pois os documentos criados na demanda do Logix, são apenas de documentos sem restrições.

2. Mapeamento de Entidades Logix

Informações enviadas ao Logix por meio da Confirmação.

A confirmação no Painel de Controle (DB0201) é responsável por enviar os documentos de Ordem de Produção e Ordem de Compra para o Logix.

2.1 Ordem de Produção

Serão criadas com Situação 3 – Aberta.

Rastreabilidade
Será enviada a rastreabilidade entre Ordens de Produção, bem como a origem da Demanda (Pedido de Venda, Solicitação, Estoque Segurança, etc) e todas as entidades relacionadas as ordens de produção.
Serão enviadas as informações referentes a alocação dos equipamentos planejados.

2.2 Ordem de Compra

A situação da Ordem de Compra (ordem_sup.ies_situa_oc), irá depender do parâmetro “77” da tabela par_pcp (programa MAN4510). Se parâmetro igual a “S” cria Situação “A” (Aberta) senão cria com Situação “P” Planejada.

Como fazer

Para a integração com APS, são pré-requisitos os seguintes itens:

• Parametrizar os arquivos Totvsprofile.pro e TotvsAppServer.ini para habilitar o webservice Logix.
• Parametrização das conexões ao banco e URL do WebService Logix, por meio do programa DB1000 do TOTVS APS.
• Se a empresa utiliza grade, a importação e parametrização das grades por meio do programa DB0142 do TOTVS APS.

É recomendado a utilização do Wizard de Implantação APS (DB4000).

Checklist de suporte da aplicação

• Configuração do Webservice Logix nos arquivos Totvsprofile.pro e TotvsAppServer.ini
• Configuração de acesso ao banco de dados e URL Webservice do Logix nas parametrizações do APS (DB1000).
• Importação e configuração das grades de item no APS (DB0142).