Integrações / ERP / Senior ERP
Guia de integração do Senior ERP para programação da produção com SkyPlanner APS
Este guia de integração do Senior ERP mostra a parceiros e equipas de TI como ligar o Senior ERP da Senior Sistemas (Gestão Empresarial | ERP XT com Senior X) ao SkyPlanner APS. O SkyPlanner integra-se com o Senior ERP nos dois sentidos, através das interfaces da própria Senior:
- São importadas as ordens de produção (OPs) com as respetivas fases, roteiros, recursos e centros de recurso, bem como SKUs, estruturas de produto, existências e encomendas de compra.
- O início e o fim previstos de cada fase da OP, bem como o recurso escolhido para a executar, são enviados de volta para a OP.
- Se assim o pretender, os registos de tempos dos operadores são enviados de volta como apontamentos de produção.
- O Senior X Events Hub avisa o SkyPlanner quando uma fase da OP muda de estado, e os webhooks do SkyPlanner enviam as alterações à programação à medida que ocorrem.
Durante a implementação inicial, a equipa SkyPlanner configura a integração de acordo com a sua instalação do Senior ERP e assegura o suporte após a entrada em produção. Este guia destina-se a parceiros e programadores que queiram participar no processo ou desenvolver a integração por conta própria com 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 instalado localmente com integração de soluções na nuvem) (documentação da Senior, traduzida). Um sistema de programação utiliza três interfaces da Senior:
- Serviços web G5 (SOAP). São serviços no seu servidor Senior, com nomes por módulo (com.senior.g5.co.<module>…). Cada serviço é publicado em três variantes WSDL: sapiens_Sync, sapiens_Async e sapiens_Scheduled. Os serviços de produção incluem o 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) que o ecrã do ERP (documentação da Senior, traduzida), bem como serviços para produtos (com.senior.g5.co.ger.cad.produto) e registos 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 encomendas de venda (documentação da Senior).
- Webhooks do Events Hub. São criados no Senior X em Tecnologia > Customização > Events Hub > Webhooks. O módulo Manufacturing publica o evento erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus quando uma fase da OP muda de estado (documentação da Senior).
Autenticação e acesso
- Senior X Platform. A integração autentica-se através de um POST para platform.senior.com.br, no caminho /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login, com o utilizador no formato user@tenant. A resposta contém um token de acesso Bearer e um token de renovação. A autenticação com chaves de aplicação pode ser feita através de loginWithKey (access key, secret, tenant). As chamadas REST incluem o cabeçalho authorization e um cabeçalho client_id que identifica a aplicação que estabelece a ligação, registada no portal de APIs da Senior e associada a um perfil no ERP.
- Serviços web G5. As chamadas incluem parâmetros de utilizador, palavra-passe e encriptação. Quando se utiliza um token Senior X, este substitui a palavra-passe (documentação da Senior).
- Permissões. Crie um utilizador Senior dedicado à integração, com acesso aos dados de PCP, engenharia, existências e compras que a integração lê e escreve.
Do lado do SkyPlanner, a REST API utiliza 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 explica passo a passo as primeiras chamadas.
Eventos e consultas periódicas
O Events Hub cobre a atividade no chão de fábrica: quando uma fase da OP muda de estado, o webhook chega ao SkyPlanner e a programação é atualizada. Os restantes dados são obtidos por consulta periódica. As leituras, filtradas por OPs firmes e libertadas e por alterações recentes, detetam novo trabalho. A frequência é definida por unidade fabril: de poucos em poucos minutos para as OPs e de hora a hora para as existências.
O SkyPlanner envia webhooks quando o estado ou a programação se alteram, pelo que o envio de dados de volta é desencadeado por eventos.
Mapeamento de dados
| Objeto do Senior ERP (interface) | Objeto SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| SKU: produto e derivação, unidades de medida (serviços web G5 ou entidades Senior X) | Produtos e materiais | Senior → SkyPlanner | Carga inicial, seguida de consultas periódicas |
| Estrutura de produto (engenharia do SKU) | Estrutura do produto, subprodutos, materiais por produto | Senior → SkyPlanner | Carga inicial, depois a cada alteração |
| Roteiro com estágios: sequência, dependência da fase anterior | Etapas do processo por ordem | Senior → SkyPlanner | Carga inicial, 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 depois |
| Centro de recurso | Grupos de centros de trabalho | Senior → SkyPlanner | Carga inicial; raramente após essa fase |
| Calendário: Feriados, calendário de produção por turno | Turnos e dias não úteis | Senior → SkyPlanner | Diariamente, ou turnos geridos no SkyPlanner |
| Ordens de produção (Firme, Liberada) com fases e materiais | Ordens e tarefas com prazos de entrega e necessidades de materiais | Senior → SkyPlanner | Consultas de poucos em poucos minutos |
| Estado da fase da OP (Events Hub orderProductionStageChangeStatus) | Progresso da tarefa | Senior → SkyPlanner | Em tempo real, por webhook |
| Estoque por SKU | Saldos de existências | Senior → SkyPlanner | Consultas de hora a hora ou ao executar a programação |
| Ordens de compra com datas de entrega | Encomendas de compra, entradas de material por data de entrega | Senior → SkyPlanner | Consulta periódica, de hora a hora ou ao executar a programação |
| Fase da OP: início e fim previstos, recurso | Início e fim previstos por tarefa, centro de trabalho atribuído | SkyPlanner → Senior | Quando a programação muda, por webhook do SkyPlanner |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, data e hora de início e de fim | Registos de tempos e confirmações dos operadores | SkyPlanner → Senior | Por confirmação ou por turno, se essa opção for escolhida |
| Não existe no Senior ERP | Matriz de tempos de preparação, ferramentas como recursos de capacidade limitada, tarefas com vários operadores, máquinas e pessoal alternativos | Mantido no SkyPlanner | Configurado durante a implementação inicial |
Modelos de integração
1. Carga inicial de dados mestre. Leia os SKUs, as estruturas, os roteiros, os recursos, os centros de recurso e o calendário de produção. Defina cuidadosamente o mapeamento dos centros de recurso: um centro de recurso com quatro máquinas passa a ser 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, mas não em ambos.
2. Sincronização de OPs. Leia as OPs nas situações Firme e Liberada, com as respetivas fases e materiais, bem como as encomendas de compra em aberto. As OPs na situação Planejada ainda podem ser alteradas ou eliminadas pelo MRP, por isso programe-as apenas se pretender uma visão antecipada. O SkyPlanner considera o material encomendado disponível na data de entrega da encomenda de compra e atualiza as existências quando esta é marcada como Delivered.
3. Envio da programação para o ERP. Quando o motor programa ou desloca uma fase, um webhook do SkyPlanner desencadeia o envio de volta para o ERP. Este envio define o início e o fim previstos de cada fase da OP e o recurso escolhido para a executar: são os mesmos campos que o responsável pelo planeamento edita em Programação de produção. Durante a definição do âmbito, a equipa SkyPlanner acorda consigo e com o seu parceiro Senior o serviço web específico a utilizar.
4. Confirmações no chão de fábrica. Os operadores registam o trabalho com SkyPlanner Mobile Confirmations ou Production Timer, e os registos de tempos mantêm a programação atualizada. Cabe-lhe decidir se os tempos reais são enviados de volta para o Senior. Se optar por esse envio, cada confirmação torna-se um apontamento de produção na fase da OP, com a quantidade produzida, a quantidade de refugo e as horas de início e de fim. O Senior só aceita registos de produção em OPs nas situações Liberada ou Andamento. Se registar a produção através do Fábrica ao Vivo, o SkyPlanner obtém o progresso através do Events Hub em vez de enviar esses registos.
5. Responsabilidade pelos dados e regras de conflito. Documente estas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| SKUs, estruturas, roteiros, quantidades e situação das OPs | Senior ERP |
| Sequência das fases, horas de início e de 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 durante a definição do âmbito |
| Apontamentos, movimentos de existências, apuramento de custos | Senior ERP, com introdução direta ou envio a partir dos registos de tempos do SkyPlanner |
Escolha um único sistema para escrever as datas das fases. Se os responsáveis pelo planeamento continuarem a sequenciar as mesmas OPs em Programação de produção ou no diagrama de Gantt, acordem quais as OPs que ficam sob o controlo do SkyPlanner.
Etapas típicas do projeto
A implementação fica normalmente concluída em poucas semanas após o início do processo. Antes disso, valide a programação durante o período de avaliação gratuita 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 sobre os dados, as frequências de sincronização e se os apontamentos serão enviados de volta.
- Acesso ao Senior. Crie o utilizador da integração, registe a aplicação no portal de APIs da Senior e ative os serviços web G5 e o webhook do Events Hub. Teste primeiro numa base de homologação.
- Carga inicial. SKUs, estruturas, roteiros, recursos, centros de recurso, calendário.
- Sincronização de OPs e encomendas de compra. Consulta periódica com filtros e novas tentativas, juntamente com o webhook de estado das fases.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, número de operadores por tarefa e máquinas ou pessoal alternativos.
- Envio da programação para o ERP. Datas e recursos das fases a partir dos webhooks do SkyPlanner, bem como apontamentos, se essa opção for escolhida.
- Testes em paralelo. Execute o SkyPlanner em paralelo com o plano atual, compare datas e corrija os dados mestre.
- Entrada em produção. Ative o envio de dados de volta para o ERP quando os dados coincidirem.
O que ter em conta numa integração com o Senior ERP
- Quatro tempos por recurso. O Recurso contém os tempos de processo, preparação, carga e descarga e transferência. Os tempos de carga e transferência podem corresponder a manuseamento, e não a tempo de máquina. Defina o mapeamento de cada tempo para cada recurso; caso contrário, todas as durações estarão erradas.
- Um tempo de preparação por recurso. O campo Tempo setup do Senior contém um único valor. Durante a implementação inicial, construa a matriz de tempos de preparação no SkyPlanner com base nas mudanças reais de produção.
- Derivações. No Senior, um SKU corresponde a um produto mais uma derivação, e os roteiros podem variar consoante a derivação. Inclua o código da derivação nas chaves dos produtos no SkyPlanner.
- Situações das OPs. Só as OPs nas situações Liberada e Andamento aceitam registos de produção. Mantenha as alterações de situação no Senior e deixe que o SkyPlanner as acompanhe através do Events Hub.
- Instalação híbrida. Os serviços web G5 são executados no seu servidor Senior e o Events Hub é executado no Senior X. Preveja o acesso de rede a ambos.
- Formato dos números. Os serviços web da Senior rejeitam números com separadores de milhares e exigem a vírgula como separador decimal. Envie os números nesse formato.
Quem configura e dá suporte à integração com o Senior ERP
- A equipa SkyPlanner configura a integração durante a implementação e dá suporte após a entrada em produção, abrangendo os serviços web, as APIs do Senior X e os webhooks do Events Hub acordados. Cada fábrica utiliza o Senior ERP de forma diferente, e é aqui que esse conhecimento se aplica.
- O seu parceiro Senior pode participar. O parceiro conhece a sua configuração, as personalizações e o licenciamento, e pode configurar o utilizador de integração, o registo no portal de APIs e os serviços web em conjunto com a equipa SkyPlanner.
- Os seus programadores podem desenvolver a integração através da REST API do SkyPlanner, com um token de API. Basta um token de API para começar, e a equipa SkyPlanner presta assistência quando necessário. Consulte a documentação de integração do SkyPlanner.
O SkyPlanner está disponível a partir de 199 € por mês, com 5 centros de trabalho incluídos e faturação mensal. O orçamento da integração é apresentado antecipadamente, em conjunto com o seu plano, tendo em conta o seu processo e as suas necessidades. Consulte os preços, a programação da produção com o Senior ERP, respeitando a capacidade real das máquinas e das equipas, a página do Senior ERP e a página de integrações com ERP.
Opiniões de fabricantes sobre o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, passámos do planeamento da produção em folhas de cálculo Excel para a otimização da produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de abastecimento
UTU · Quadros elétricos e aparelhagem de comutação
O planeamento da produção permite poupar 2 horas de trabalho por semana, e uma nova fila de tarefas chega à linha em segundos.
+90%de eficiência na produção
“A eficiência na produção aumentou 90%.”
Abdul Rucyinga, responsável de TI
Laboratory & Allied · Produção farmacêutica
A eficiência na produção aumentou 90%, e criar um plano otimizado para três meses que abranja todos os centros de trabalho demora menos de 30 minutos.
Mais de 1.000 ordens de fabrico programadas automaticamente
“Temos um controlo diferente sobre a produção, e a nossa compreensão da capacidade está num patamar completamente diferente.”
Hannu Ryynänen, diretor executivo
Mamec · Misturadores industriais, bombas e fabrico por contrato de alta tecnologia
Milhares de ordens de fabrico são programadas automaticamente, com uma visão da produção em tempo real para toda a organização.
Menosparagens por falta de materiais
“O valor do SkyPlanner para nós está em ser uma ferramenta que funciona no dia a dia, sobretudo para definir datas de entrega.”
Tommi Männistö, responsável pelo planeamento da produção
Eskomatic · Maquinação por subcontratação
A programação automática da carga de trabalho permite definir datas de entrega mais precisas, e as paragens de produção por falta de materiais diminuíram acentuadamente.
Perguntas frequentes
O Senior ERP tem uma API para ordens de fabrico?
Sim. O serviço web G5 com.senior.g5.co.mpr.pcp.ordemproducao gera OPs com a mesma rotina utilizada no ecrã do ERP, e outros serviços G5 abrangem os produtos e o registo da produção. A Senior X Platform acrescenta REST APIs com autenticação por token Bearer e webhooks do Events Hub.
O Senior ERP suporta webhooks?
Sim. O Senior X Events Hub envia webhooks, incluindo orderProductionStageChangeStatus quando uma etapa de uma OP muda de estado. O SkyPlanner utiliza-o para acompanhar o progresso no chão de fábrica em tempo real, e os seus próprios webhooks enviam as alterações à programação de volta para o ERP.
Como são gravadas as datas planeadas no Senior ERP?
O SkyPlanner define o início e o fim planeados de cada etapa da OP e o recurso escolhido para a executar, nos mesmos campos que o responsável pelo planeamento edita em Programação de produção. Sempre que a programação muda, um webhook do SkyPlanner desencadeia a gravação no ERP, pela via que a equipa SkyPlanner define para a sua instalação Senior durante a definição do âmbito da implementação.
A integração funciona com o Senior X e o ERP XT?
Sim. O ERP XT é executado no seu servidor, com serviços na nuvem no Senior X. A integração utiliza os serviços web G5 no servidor e as APIs do Senior X e o Events Hub na nuvem.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O teste gratuito de 30 dias permite utilizar até 20 centros de trabalho, com importação de dados do Senior em CSV ou Excel, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipa comercial para definir o âmbito da integração.
