Integrações / ERP / Senior ERP
Guia de integração do Senior ERP para planejamento da produção com SkyPlanner APS
Este guia de integração do Senior ERP mostra a parceiros e equipes de TI como conectar o Senior ERP, da Senior Sistemas (Gestão Empresarial | ERP XT com Senior X), ao SkyPlanner APS. A integração entre o SkyPlanner e o Senior ERP é bidirecional e usa as próprias interfaces da Senior:
- O SkyPlanner recebe ordens de produção (OPs) com seus estágios, roteiros, recursos e centros de recurso, além de SKUs, estruturas de produtos, estoques e ordens de compra.
- O início e o fim planejados de cada estágio, assim como o recurso escolhido para executá-lo, são enviados de volta à OP.
- Se você optar, os registros de tempo dos operadores são enviados de volta como apontamentos de produção.
- O Senior X Events Hub avisa o SkyPlanner quando um estágio da OP muda de status, e os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
Durante a implantação, a equipe SkyPlanner configura a integração de acordo com o seu ambiente Senior ERP e continua dando suporte após a entrada em produção. Este guia é voltado a parceiros e desenvolvedores que querem participar desse trabalho ou desenvolver por conta própria usando a REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do Senior ERP
O ERP XT é híbrido. A documentação da Senior afirma que o Gestão Empresarial XT “becomes a hybrid system: an on-premises (local) system with integration of cloud solutions” (torna-se um sistema híbrido: um sistema local integrado a soluções em nuvem) (documentação da Senior, traduzida). Um sistema de programação da produção usa três interfaces da Senior:
- Web services G5 (SOAP). São serviços no seu servidor Senior, nomeados por módulo (com.senior.g5.co.<module>…). Cada um é publicado em três versões de WSDL: sapiens_Sync, sapiens_Async e sapiens_Scheduled. Os serviços de produção incluem com.senior.g5.co.mpr.pcp.ordemproducao, que “calls the same production order generation routine” (chama a mesma rotina de geração de ordens de produção) usada pela tela do ERP (documentação da Senior, traduzida), além de serviços para produtos (com.senior.g5.co.ger.cad.produto) e apontamentos de produção.
- REST APIs da Senior X Platform em api.senior.com.br, para os domínios do ERP que a Senior disponibiliza no Senior X, como produtos e pedidos de venda (documentação da Senior).
- Webhooks do Events Hub. São criados no Senior X em Tecnologia > Customização > Events Hub > Webhooks. A área de manufatura publica o evento erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus quando um estágio da OP muda de status (documentação da Senior).
Autenticação e acesso
- Senior X Platform. A integração faz login com uma requisição POST para platform.senior.com.br no caminho /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login, com o usuário no formato user@tenant. A resposta contém um token de acesso Bearer e um token de atualização. Também é possível autenticar com chaves de aplicação usando loginWithKey (chave de acesso, segredo e tenant). As chamadas REST levam o cabeçalho authorization e o cabeçalho client_id, que identifica a aplicação conectada, registrada no portal de APIs da Senior e vinculada a um papel no ERP.
- Web services G5. As chamadas levam parâmetros de usuário, senha e criptografia. Ao usar um token do Senior X, ele substitui a senha (documentação da Senior).
- Permissões. Crie um usuário Senior exclusivo para a integração, com acesso aos dados de PCP, engenharia, estoque e compras que ela lê e grava.
No SkyPlanner, a REST API usa um token de API no cabeçalho Authorization-Token para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração orienta as primeiras chamadas.
Eventos e consultas periódicas
O Events Hub cobre o chão de fábrica: quando um estágio da OP muda de status, o webhook chega ao SkyPlanner e a programação é atualizada. Os demais dados são obtidos por consultas periódicas. Consultas filtradas por OPs firmes e liberadas e por alterações recentes identificam novas demandas de produção. A frequência é definida por fábrica: de poucos minutos para OPs a uma hora para estoques.
O SkyPlanner envia webhooks quando há mudanças de estado ou na programação. Assim, o envio de atualizações de volta é acionado por eventos.
Mapeamento de dados
| Objeto do Senior ERP (interface) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| SKU: produto e derivação, unidades de medida (web services G5 ou entidades do Senior X) | Produtos e materiais | Senior → SkyPlanner | Carga inicial e, depois, consultas periódicas |
| Estrutura do produto (engenharia do SKU) | Estrutura do produto, subprodutos, materiais por produto | Senior → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Roteiro com estágios: sequência e dependência do estágio anterior | Etapas do processo em sequência | Senior → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Centros de trabalho, durações, tempos de preparação e desmontagem, eficiências | Senior → SkyPlanner | Carga inicial; raramente após isso |
| Centro de recurso | Grupos de centros de trabalho | Senior → SkyPlanner | Carga inicial; raramente depois |
| Calendário: Feriados, calendário de produção por turno | Turnos e dias não úteis | Senior → SkyPlanner | Diariamente, ou turnos próprios no SkyPlanner |
| Ordens de produção (Firme, Liberada) com estágios e materiais | Ordens e operações com prazos de entrega e necessidades de materiais | Senior → SkyPlanner | Consultas a cada poucos minutos |
| Status do estágio da OP (Events Hub orderProductionStageChangeStatus) | Andamento da operação | Senior → SkyPlanner | Em tempo real, via webhook |
| Estoque por SKU | Saldos de estoque | Senior → SkyPlanner | Consultas a cada hora ou ao executar a programação |
| Ordens de compra com datas de entrega | Ordens de compra, materiais a receber por data de entrega | Senior → SkyPlanner | Consultas a cada hora ou ao executar a programação |
| Estágio da OP: início e fim planejados, recurso | Início e fim planejados por operação, centro de trabalho atribuído | SkyPlanner → Senior | Ao alterar a programação, via webhook do SkyPlanner |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, datas e horários de início e fim | Registros de tempo e confirmações dos operadores | SkyPlanner → Senior | Por confirmação ou por turno, se essa opção for escolhida |
| Não consta no Senior ERP | Matriz de tempos de preparação, ferramentas como recursos de capacidade finita, operações com vários operadores, máquinas e pessoal alternativos | Mantidos no SkyPlanner | Configurados durante a implantação |
Padrões de integração
1. Carga inicial de dados mestres. Leia SKUs, estruturas, roteiros, recursos, centros de recurso e o calendário de produção. Defina com cuidado o mapeamento dos centros de recurso: um centro de recurso com quatro máquinas se torna um grupo de centros de trabalho ou quatro centros de trabalho. Converta o Fator de carga em eficiência do centro de trabalho no SkyPlanner ou em turnos, não em ambos.
2. Sincronização de OPs. Leia as OPs nas situações Firme e Liberada com seus estágios e materiais, além das ordens de compra em aberto. As OPs na situação Planejada ainda podem ser alteradas ou excluídas pelo MRP; portanto, programe-as somente se quiser uma visão antecipada. O SkyPlanner considera o material comprado disponível na data de entrega da ordem de compra e atualiza o estoque quando ela é marcada como Delivered.
3. Retorno da programação ao ERP. Quando o mecanismo de programação aloca ou move um estágio, um webhook do SkyPlanner aciona a gravação no ERP. Esse retorno define o início e o fim planejados de cada estágio da OP e o recurso escolhido para executá-lo, os mesmos campos que o planejador edita em Programação de produção. Durante a definição de escopo, a equipe SkyPlanner combina com você e seu parceiro Senior qual web service será usado.
4. Confirmações do chão de fábrica. Os operadores registram o trabalho com SkyPlanner Mobile Confirmations ou Production Timer, e os registros de tempo mantêm a programação atualizada. Você decide se os tempos reais serão enviados de volta ao Senior. Se optar pelo envio, cada confirmação se torna um apontamento de produção no estágio da OP, com quantidade produzida, refugo e horários de início e fim. O Senior aceita apontamentos de produção apenas em OPs nas situações Liberada ou Andamento. Se os apontamentos forem feitos pelo Fábrica ao Vivo, o SkyPlanner passa a ler o andamento pelo Events Hub.
5. Responsabilidade pelos dados e regras de conflito. Documente essas regras antes da entrada em produção:
| Dados | Responsável |
|---|---|
| SKUs, estruturas, roteiros, quantidades e situação das OPs | Senior ERP |
| Sequência dos estágios, horários de início e fim, atribuição de recursos | SkyPlanner |
| Matriz de tempos de preparação, requisitos de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Calendário de produção e turnos | Um sistema, escolhido na definição de escopo |
| Apontamentos, movimentações de estoque, custeio | Senior ERP, com lançamento direto ou envio dos registros de tempo do SkyPlanner |
Defina um único sistema para gravar as datas dos estágios. Se os planejadores ainda sequenciam as mesmas OPs em Programação de produção ou no gráfico de Gantt, combinem quais OPs ficam sob responsabilidade do SkyPlanner.
Etapas típicas do projeto
A implementação normalmente é concluída em poucas semanas após o início da implantação. Antes disso, valide a programação no teste gratuito de 30 dias, com recursos, roteiros e OPs em aberto exportados do Senior em CSV ou Excel.
- Mapeamento. Defina a tabela de mapeamento, as regras de responsabilidade, as frequências de sincronização e se os apontamentos serão enviados de volta ao ERP.
- Acesso ao Senior. Crie o usuário de integração, registre a aplicação no portal de APIs da Senior e habilite os web services G5 e o webhook do Events Hub. Teste primeiro em uma base de homologação.
- Carga inicial. SKUs, estruturas, roteiros, recursos, centros de recurso e calendário.
- Sincronização de OPs e ordens de compra. Consultas periódicas com filtros e novas tentativas em caso de falha, além do webhook de status dos estágios.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, número de operadores por operação e máquinas ou pessoal alternativos.
- Retorno da programação ao ERP. Datas e recursos dos estágios enviados pelos webhooks do SkyPlanner, além de apontamentos, se essa opção for escolhida.
- Testes em paralelo. Execute o SkyPlanner em paralelo ao plano atual, compare as datas e corrija os dados mestres.
- Entrada em produção. Ative o envio de dados de volta quando os dados coincidirem.
O que considerar ao planejar uma integração com o Senior ERP
- Quatro tempos por recurso. O cadastro de Recurso contém os tempos de processo, setup, carga e descarga e transferência. Os tempos de carga e transferência podem corresponder à movimentação de materiais, não ao uso da máquina. Defina o mapeamento de cada tempo por recurso; caso contrário, todas as durações ficarão incorretas.
- Um tempo de setup por recurso. O campo Tempo setup da Senior contém um único valor. Durante a implantação, monte a matriz de tempos de preparação no SkyPlanner com base nas trocas reais da sua produção.
- Derivações. No Senior, um SKU é composto por um produto e uma derivação, e os roteiros podem variar por derivação. Inclua o código da derivação nas chaves de produto do SkyPlanner.
- Situações das OPs. Somente OPs nas situações Liberada e Andamento aceitam apontamentos de produção. Mantenha as mudanças de situação no Senior e deixe o SkyPlanner acompanhá-las pelo Events Hub.
- Implantação híbrida. Os web services G5 são executados no seu servidor Senior, e o Events Hub é executado no Senior X. Planeje o acesso de rede para ambos.
- Formato dos números. Os web services da Senior rejeitam números com separadores de milhar e exigem vírgula decimal. Envie os números nesse formato.
Quem configura e dá suporte à integração com o Senior ERP
- A equipe SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em operação, abrangendo os web services, as APIs do Senior X e os webhooks do Events Hub acordados no projeto. Cada fábrica usa o Senior ERP de uma forma diferente, e é aqui que esse conhecimento é aplicado.
- Seu parceiro Senior pode participar. Ele conhece sua configuração, suas customizações e seu licenciamento e pode configurar o usuário de integração, o cadastro no portal de APIs e os web services junto com a equipe SkyPlanner.
- Seus próprios desenvolvedores podem ampliar a integração usando a REST API do SkyPlanner com um token de API. Basta um token de API para começar, e a equipe SkyPlanner auxilia quando necessário. Consulte a documentação de integração do SkyPlanner.
O SkyPlanner custa a partir de 199 € por mês, com 5 centros de trabalho incluídos e cobrança mensal. A integração é orçada antecipadamente junto com seu plano, de acordo com seu processo e suas necessidades. Consulte os preços, a programação com capacidade finita para o Senior ERP, a página do Senior ERP e a central de integrações com ERP.
Avaliações de fabricantes sobre o SkyPlanner
2 heconomizadas por semana
“Com o SkyPlanner, nosso planejamento da produção saiu das planilhas do Excel para a otimização da produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de suprimentos
UTU · Quadros elétricos e equipamentos de manobra
O planejamento da produção economiza 2 horas de trabalho por semana, e uma nova fila de operações chega à linha em segundos.
+90%de eficiência na produção
“A eficiência na produção aumentou 90%.”
Abdul Rucyinga, responsável por TI
Laboratory & Allied · Indústria farmacêutica
A eficiência na produção aumentou 90%, e gerar um plano otimizado de três meses para todos os centros de trabalho leva menos de 30 minutos.
1.000 ou mais ordens de produção programadas automaticamente
“Hoje temos outro controle da produção, e nossa compreensão da capacidade está em um patamar completamente diferente.”
Hannu Ryynänen, CEO
Mamec · Misturadores industriais, bombas e fabricação sob contrato de alta tecnologia
Milhares de ordens de produção são programadas automaticamente, com uma visão da produção em tempo real para toda a organização.
Menosparadas por falta de material
“O valor que o SkyPlanner nos traz é ser uma ferramenta que funciona no dia a dia, especialmente para definir datas de entrega.”
Tommi Männistö, gerente de planejamento da produção
Eskomatic · Usinagem sob contrato
A programação automática da carga de trabalho permite definir datas de entrega mais precisas, e as paradas de produção por falta de material diminuíram muito.
Perguntas frequentes
O Senior ERP tem uma API para ordens de produção?
Sim. O web service G5 com.senior.g5.co.mpr.pcp.ordemproducao gera OPs com a mesma rotina da tela do ERP, e outros serviços G5 atendem a produtos e apontamentos de produção. A Senior X Platform acrescenta APIs REST com autenticação por token Bearer e webhooks do Events Hub.
O Senior ERP oferece suporte a webhooks?
Sim. O Senior X Events Hub envia webhooks, incluindo orderProductionStageChangeStatus quando uma etapa da OP muda de status. O SkyPlanner usa esse evento para acompanhar o avanço no chão de fábrica em tempo real, e seus próprios webhooks enviam as alterações do planejamento de volta ao ERP.
Como as datas planejadas são gravadas de volta no Senior ERP?
O SkyPlanner define o início e o término planejados de cada etapa da OP e o recurso escolhido para ela, nos mesmos campos que o planejador edita em Programação de produção. Sempre que o planejamento muda, um webhook do SkyPlanner aciona a gravação de volta no ERP pela rota que a equipe SkyPlanner define para sua instalação Senior durante a definição de escopo da implantação.
A integração funciona com Senior X e ERP XT?
Sim. O ERP XT é executado no seu servidor, com serviços em nuvem no Senior X. A integração usa web services G5 no servidor e APIs do Senior X e Events Hub na nuvem.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O teste grátis de 30 dias permite usar até 20 centros de trabalho com importações de dados do Senior em CSV ou Excel, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipe de vendas para definir o escopo da integração.
