A integração entre o Keepfy e o ERP TOTVS Moda tem como objetivo permitir que as equipes de manutenção utilizem o Keepfy para gestão e controle das demandas de manutenção dos equipamentos, sem comprometer o fluxo de estoque e o planejamento e controle de produção no TOTVS Moda. Além disso, possibilita que as paradas programadas de equipamentos, registradas nas ordens de serviço, sejam automaticamente sinalizadas para a área de produção dentro do TOTVS Moda, ao mesmo tempo em que as paradas reais informadas pela produção são enviadas ao Keepfy como Solicitações de Serviço.
Como configurar a integração?
Para que a integração funcione corretamente, algumas configurações são necessárias tanto no Keepfy quanto no ERP TOTVS Moda.
Antes de iniciar a configuração certifique-se das seguintes precondições:
Acesso aos dados de url, porta, usuário, senha, clientid e secret do ambiente ERP TOTVS Moda que deseja integrar;
Tenha em vista o tipos e as classificações de fornecedores que deseja integrar, além do tipo e classificações e o custo de material. Para requisições será necessário informar o código de finalidade e também um código de usuário padrão que seja o requerente.
⚠️ Importante:
Recomendamos que sejam feitos testes anteriores no ambiente de treino do ERP TOTVS Moda configurando uma filial Keepfy que também seja destinada a testes.
Configurar no Keepfy
O processo para habilitar é descomplicado, e está disponível para usuários com perfil de administrador. Basta seguir as instruções abaixo:
No Keepfy, acesse Minha Conta > Integrações;
Localize o contexto de integração Estoque;
No cartão TOTVS MODA, clique em Configurar Integração;
Passo 1: insira uma descrição para o grupo de filiais a ser habilitado (ex.: separar filiais de homologação e de produção);
Passo 2: informe os dados e credenciais de acesso ao ambiente desejado. O sistema fará a validação e, se estiverem corretos, permitirá prosseguir;
Passo 3: configure os parâmetros previamente carregados, conforme a necessidade. Eles garantem a sincronização correta dos cadastros e auxiliam no envio de requisições de material:
Fornecedor
Tipo: obrigatório, permite apenas uma seleção;
Classificações: obrigatórias, permite múltiplas seleções.
Material
Tipo: obrigatório, permite apenas uma seleção;
Classificações: obrigatórias, permitem múltiplas seleções.
Código do Custo do Material: obrigatório, exige apenas um código. No TOTVS MODA cada produto pode ter diferentes custos, e o código informado será usado como referência no custo sincronizado e agregado às ordens de serviço.
Requisição de Material
Código de Finalidade: cada requisição no TOTVS MODA requer um código de finalidade. O código informado aqui será utilizado para enviar a requisição.
Código do Usuário da Requisição: toda requisição precisa de um requerente. Informe o código de um usuário padrão para ser identificado na requisição.
Passo 4: selecione a filial do Keepfy a ser vinculada aos dados e parâmetros informados. Em seguida, informe o código da filial no TOTVS MODA, salve e clique em Validar Integração.
Segue a representação abaixo que apresenta os passos descritos:
Configurar no TOTVS Moda
O funcionamento correto da integração depende também de configurações realizadas diretamente no ERP TOTVS Moda.
Abaixo estão listadas as principais documentações que detalham essas configurações e explicam sobre o funcionamento no que se referente a paradas e reinicio de equipamento, além das requisições de material.
Em caso de dúvidas ou necessidade de suporte adicional, entre em contato com a equipe de atendimento da TOTVS, através deste link, acessando o caminho: Varejo > Moda > Atendimento.
Principais documentações:
Observações:
Em todas as documentações (1, 2 e 3), na Imagem 2, o valor do parâmetro DS_URLBASE deve ser configurado como: https://api.keepfy.com
Quais funcionalidades do Keepfy são afetadas?
Saiba como as funcionalidades do Keepfy são afetadas, quais possuem sincronismos o como será o fluxo de integração.
Centros de Custo
Foi identificada a necessidade de sincronizar os centros de custo cadastrados no ERP TOTVS Moda, de forma a apoiar os clientes no cadastro de equipamentos.
Uma vez configurada a integração, será possível realizar a carga inicial clicando no botão indicado na imagem abaixo. Além disso, o Keepfy executará automaticamente um job de atualização a cada 6 horas, garantindo que o cadastro permaneça sempre atualizado.
Fornecedores
Da mesma forma que o cadastro de centros de custo, os fornecedores também podem ser sincronizados a partir do ERP TOTVS Moda. Eles vão auxiliar no cadastro dos serviços de terceiro para vinculo correto.
Uma vez configurada a integração, é possível realizar a carga inicial através do botão indicado na imagem abaixo. Após isso, o Keepfy executará automaticamente a atualização a cada 6 horas, garantindo que a base de fornecedores permaneça sempre alinhada ao ERP.
Locais de Estoque
O cadastro de local de estoque é obrigatório para que a sincronização de materiais seja corretamente realizada. Como não há endpoint disponível para que façamos uma sincronização automática, é necessário que seja realizado o cadastro manual do local, informando descrição e código do tipo de saldo presente no ERP.
Materiais
Assim como nos demais cadastros apresentados, a sincronização de materiais pode ser feita manualmente e de forma automática a cada 6 horas, garantindo também a atualização das unidades de medida, do saldo e do custo.
Além disso, ao prever o material em uma OS, o saldo exibido será sempre o mais atualizado.
É fundamental registrar corretamente o tipo e as classificações dos materiais na configuração da integração, garantindo que os produtos sincronizados correspondam aos insumos consumíveis de manutenção.
Equipamentos
Não houveram alterações que impactam diretamente o cadastro. No entanto, é importante destacar que alguns processos do ERP TOTVS Moda dependem da existência de um identificador do equipamento. Esse identificador é necessário para que:
as solicitações de serviço com paradas sejam incluídas no Keepfy;
o TOTVS Moda possa consultar os períodos de indisponibilidade do equipamento.
O identificador utilizado é o campo Identificação.
No ERP TOTVS Moda, será um campo adicional no cadastro de máquina.
Processos Integrados
Neste tópico, apresentamos os processos integrados que compõem a integração e como eles se relacionam entre o TOTVS Moda e o Keepfy.
Os principais processos são:
Paradas de Equipamentos: inclusão e atualização de paradas no TOTVS Moda, com a respectiva criação e atualização de SS/OS no Keepfy.
Consulta de Paradas Previstas: requisição ao Keepfy das paradas planejadas dos equipamentos.
Requisições de Materiais: envio de requisições ao estoque do TOTVS Moda a partir das previsões de OSs registradas no Keepfy.
Baixas de Estoque: registro automático no estoque do TOTVS Moda, vinculado ao reporte de execução de OSs no Keepfy.
1. Paradas de Equipamentos: inclusão e atualização de paradas no TOTVS Moda, com a respectiva criação e atualização de SS/OS no Keepfy.
ERP TOTVS Moda → Keepfy → ERP TOTVS Moda
O objetivo deste processo é garantir que, ao incluir ou atualizar uma interrupção de partida no TOTVS Moda - utilizando um código de motivo previamente cadastrado - seja acionado o endpoint de Solicitações de Serviço no Keepfy. Dessa forma, ocorre a criação ou atualização da solicitação no Keepfy, e o sistema retorna o respectivo código da solicitação para registro no TOTVS Moda.
A atualização dos períodos de parada da OS relacionada à SS, quando houver, passa pelo mesmo endpoint. O sistema atualiza a SS e posteriormente replica para OS.
Para saber mais sobre o processo no TOTVS Moda, acesse a documentação neste link.
Este processo faz uso do endpoint rest de ServiceRequest.
2. Consulta de Paradas Previstas: requisição ao Keepfy das paradas planejadas dos equipamentos.
ERP TOTVS Moda → Keepfy → ERP TOTVS Moda
Neste processo, o objetivo do Keepfy é disponibilizar a programação de ordens de serviço que possuem períodos de parada programados para que o planejador possa acompanhar e gerenciar alocações de ordens de produção no TOTVS Moda, assim que requisitado.
Para saber mais sobre o processo no TOTVS Moda, acesse essa documentação.
O Keepfy disponibiliza para esse processo o endpoint rest de EquipmentDowntimeSchedule.
3. Requisições de Materiais: envio de requisições ao estoque do TOTVS Moda a partir das previsões de OSs registradas no Keepfy
Keepfy → ERP TOTVS Moda
Neste processo, quando integrado, ao realizar a previsão de material + local de estoque em ordens de serviço, uma solicitação de material será enviada ao TOTVS Moda.
A requisição de material será enviada com base no endpoint material-request, com o código de finalidade definido nos parâmetros de configuração.
Ajustes de quantidade, itens e remoções farão com que a requisição de material seja atualizada ou excluída.
4. Baixas de Estoque: registro automático no estoque do TOTVS Moda, vinculado ao reporte de execução de OSs no Keepfy.
ERP TOTVS Moda → Keepfy
O objetivo deste processo é garantir que as baixas de estoque realizadas no ERP TOTVS Moda - originadas a partir de requisições de materiais previstas em OSs do Keepfy - sejam atualizadas no Keepfy como materiais efetivamente reportados nas respectivas OSs de origem.
Este processo é necessário porque, pela regra de negócio definida, a baixa de estoque deve ser realizada exclusivamente no TOTVS Moda, mas ainda assim precisa ser registrada diretamente na OS correspondente no Keepfy.
O Keepfy disponibiliza para esse processo o endpoint rest de ReportServiceOrder.