Integrações / ERP / SYSPRO
Guia de integração do SYSPRO para programação da produção com SkyPlanner APS
Este guia de integração do SYSPRO mostra aos parceiros e às equipas de TI como ligar o SYSPRO 8 ao SkyPlanner APS. O SkyPlanner integra-se com o SYSPRO nos dois sentidos, através das interfaces do próprio SYSPRO:
- Importam-se ordens de fabrico, operações das ordens de fabrico, Structures and Routings, centros de trabalho, máquinas, Stock Codes, existências e encomendas de compra.
- As datas de início e fim planeadas são gravadas nas ordens de fabrico do SYSPRO.
- Se assim o pretender, os registos de tempos dos operadores podem ser enviados para o SYSPRO como registos de mão de obra.
- Os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
Durante a implementação inicial, a equipa SkyPlanner configura a integração de acordo com a sua instalação SYSPRO e presta assistência após a entrada em produção. Este guia destina-se a parceiros e programadores que queiram participar nesse processo ou desenvolver as suas próprias soluções com a REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do SYSPRO
O SYSPRO disponibiliza duas vias de acesso aos dados para um sistema externo de programação da produção:
- e.net Solutions Business Objects. Permitem invocar a lógica de negócio do SYSPRO a partir do exterior, com entrada e saída em XML. Existem três famílias: Query (por exemplo, WIPQBL, WIP Balance Query), Transaction ou Post (por exemplo, WIPTJB, WIP Job Creation and Maintenance) e Setup, para dados mestre. Os objetos de negócio aplicam as mesmas validações que os ecrãs do SYSPRO e mantêm a compatibilidade entre versões. O guia de boas práticas do SYSPRO é claro: “SYSPRO’s Business Objects are used to query and post data to SYSPRO.” (Os objetos de negócio do SYSPRO são utilizados para consultar e gravar dados no SYSPRO.)
- SYSPRO OData Service (OData v4). Disponibiliza acesso RESTful, apenas de leitura, às bases de dados da empresa e do sistema e às Business Activity Queries, que são vistas SQL definidas no SYSPRO. Está disponível a partir do SYSPRO 8 2021 R2. No SYSPRO Cloud ERP, “Syspro OData is the only mechanism available when applications need access to SYSPRO data.” (O Syspro OData é o único mecanismo disponível para as aplicações acederem aos dados do SYSPRO.)
Os objetos de negócio são invocados através do serviço e.net Communications, utilizando o SYSPRO WCF Service ou o SYSPRO Web Service.
O Master Data Take On (IMPIMP) importa folhas de cálculo através de objetos de negócio Setup, sendo útil para um carregamento pontual de dados mestre. O SYSPRO Harmony chega ao fim de vida em 31 de dezembro de 2026, pelo que não deve desenvolver novas soluções com base nele.
Autenticação e licenciamento
- Início de sessão no e.net. A integração inicia sessão como SYSPRO Operator numa empresa e recebe um GUID de sessão para as chamadas seguintes.
- Licenciamento. A licença SYSPRO tem de incluir, para o operador, as áreas funcionais dos objetos de negócio que este invoca.
- OData. O acesso é feito por HTTPS, através de operadores configurados para OData.
Do lado do SkyPlanner, a REST API utiliza um token de API para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração explica como efetuar as primeiras chamadas.
Eventos e consultas periódicas
O SYSPRO não envia webhooks. O Electronic Signature Transaction Setup pode desencadear ações, como o envio de um email ou a execução de um VBScript, quando uma transação é concluída com sucesso. No entanto, o SYSPRO esclarece: “It is not intended that triggers from e.net Business Objects fire VBScript triggers.” (Não está previsto que os acionadores dos e.net Business Objects ativem acionadores VBScript.)
Por isso, os dados do SYSPRO são consultados periodicamente. As consultas a objetos de negócio ou os pedidos OData, filtrados por ordens de fabrico em aberto e alterações recentes, permitem detetar novo trabalho. A frequência é definida por fábrica: pode ir de intervalos de poucos minutos para ordens de fabrico a consultas de hora a hora para existências.
O SkyPlanner envia webhooks quando o estado ou a programação mudam, pelo que a atualização dos dados no SYSPRO é acionada por eventos.
Mapeamento de dados
| Objeto SYSPRO (interface) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Stock Codes, unidades de medida (OData ou objetos de negócio Query) | Produtos e materiais | SYSPRO → SkyPlanner | Carregamento inicial, seguido de consultas periódicas |
| Structures (componentes, notional parts, coprodutos) | Estrutura do produto, subprodutos e materiais por produto | SYSPRO → SkyPlanner | Carregamento inicial e, depois, a cada alteração |
| Routings: centro de trabalho, tempos de preparação, execução, espera e movimentação, Maximum units | Etapas do processo com durações e tempos de preparação e desmontagem | SYSPRO → SkyPlanner | Carregamento inicial e, depois, a cada alteração |
| Work Centers (unidades produtivas, capacidade) e Machines | Centros de trabalho, grupos de centros de trabalho, eficiências | SYSPRO → SkyPlanner | Carregamento inicial; raramente depois |
| Capacity Calendar, Shift Patterns | Turnos e dias não úteis | SYSPRO → SkyPlanner | Diariamente, ou gestão dos turnos no SkyPlanner |
| Ordens e subordens de fabrico (WipMaster), operações e materiais das ordens | Encomendas e tarefas com prazos e necessidades de materiais | SYSPRO → SkyPlanner | Consultas periódicas a intervalos de poucos minutos |
| Existências em armazém por Stock Code | Saldos de existências | SYSPRO → SkyPlanner | Consultas de hora a hora ou a cada execução da programação |
| Encomendas de compra com prazos de entrega | Encomendas de compra, materiais a receber por data de entrega | SYSPRO → SkyPlanner | Consultas de hora a hora ou a cada execução da programação |
| Datas de início e fim planeadas da ordem de fabrico (WIPTJB, WIP Job Creation and Maintenance) | Início e fim planeados por tarefa | SkyPlanner → SYSPRO | Quando a programação muda, através de um webhook do SkyPlanner |
| Labor Posting: tempos de preparação e execução por operação da ordem de fabrico, máquina e trabalhador | Registos de tempos e confirmações dos operadores | SkyPlanner → SYSPRO | Por confirmação ou por turno, se essa opção for escolhida |
| Job Receipts (objeto de negócio WIP Job Receipts) | Quantidades concluídas | SkyPlanner → SYSPRO | Por confirmação, se essa opção for escolhida |
| Não consta do SYSPRO | Matriz de tempos de preparação, ferramentas como recursos de capacidade finita, máquinas e pessoal alternativos | Gerido no SkyPlanner | Configurado durante a implementação inicial |
Modelos de integração
1. Carregamento inicial de dados mestre. Leia Stock Codes, Structures and Routings, centros de trabalho, máquinas e calendários através de OData ou de objetos de negócio Query. Defina cuidadosamente a correspondência dos centros de trabalho no SkyPlanner: um centro de trabalho com quatro máquinas passa a ser um grupo de centros de trabalho ou quatro centros de trabalho.
2. Sincronização de ordens de fabrico. Leia as ordens de fabrico efetivas, com as respetivas operações e materiais, bem como as encomendas de compra em aberto. O SkyPlanner considera os materiais encomendados disponíveis na data de entrega da encomenda de compra e atualiza as existências quando esta é marcada como Delivered.
Programe apenas ordens de fabrico efetivas. As ordens sugeridas permanecem no snapshot do MRP até o MRP Job Review as converter em ordens de fabrico.
3. Gravação da programação no SYSPRO. Quando o motor agenda ou desloca uma tarefa, um webhook do SkyPlanner desencadeia uma chamada de gravação ao objeto de negócio WIP Job Creation and Maintenance (WIPTJB). Esta define as datas de início e fim planeadas da ordem de fabrico. O objeto de negócio valida a alteração exatamente como o Job Entry.
4. Confirmações na fábrica. Os operadores registam o trabalho com o SkyPlanner Mobile Confirmations ou o Production Timer, e os registos de tempos mantêm a programação atualizada. Cabe-lhe decidir se os tempos reais são enviados para o SYSPRO. Se optar pelo envio, os tempos de preparação e execução são enviados para o Labor Posting por operação da ordem de fabrico, e as quantidades concluídas para o Job Receipts. Caso contrário, a mão de obra continua a ser registada no SYSPRO como até aqui.
5. Responsabilidade pelos dados e regras de resolução de conflitos. Documente estas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Stock Codes, Structures and Routings, quantidades, estado da ordem de fabrico | SYSPRO |
| Sequência das operações, horas de início e fim, atribuição de máquinas | SkyPlanner |
| Matriz de tempos de preparação, necessidades de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Turnos e dias não úteis | Um único sistema, escolhido na definição do âmbito |
| Mão de obra, saídas e entradas de materiais | SYSPRO, com registo direto ou envio a partir dos registos de tempos do SkyPlanner |
Escolha um único sistema para gravar as datas das ordens de fabrico. O SkyPlanner não necessita de nenhum módulo de programação do SYSPRO, pelo que substitui o Factory Scheduling, o Visual APS ou o APS (Nexsys) na gravação das datas planeadas. Se algum destes módulos ainda atualizar as datas planeadas, desative essa função para as ordens programadas pelo SkyPlanner. No Factory Scheduling, a opção do Job Entry é “Update planned dates to scheduled dates.” (Atualizar as datas planeadas com as datas programadas.)
Etapas habituais do projeto
A implementação fica normalmente concluída em poucas semanas após o início do acompanhamento inicial. Antes disso, valide a programação durante o período de teste gratuito de 30 dias, com centros de trabalho, gamas operatórias e ordens de fabrico em aberto exportados do SYSPRO em CSV ou Excel.
- Mapeamento. Defina a tabela de correspondências, as regras de responsabilidade pelos dados, as frequências de sincronização e se os registos de mão de obra serão enviados para o SYSPRO.
- Acesso ao SYSPRO. Crie o operador de integração, confirme o licenciamento dos objetos de negócio e ative o OData onde for utilizado. Teste primeiro numa cópia da empresa.
- Carregamento inicial. Stock Codes, Structures and Routings, centros de trabalho, máquinas e calendários.
- Sincronização de ordens de fabrico e encomendas de compra. Consultas periódicas com filtros, paginação e novas tentativas em caso de falha.
- 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.
- Gravação da programação no SYSPRO. Chamadas de gravação WIPTJB acionadas por webhooks do SkyPlanner e envio de registos de mão de obra, se essa opção for escolhida.
- Testes em paralelo. Execute o SkyPlanner em paralelo com o plano atual, compare as datas e corrija os dados mestre.
- Entrada em produção. Ative a gravação dos dados no SYSPRO quando os dados coincidirem.
O que prever numa integração com o SYSPRO
- Ordens _TMP. As simulações de carga com capacidade finita no Job Entry podem criar ordens _TMP em WipMaster. Exclua-as através de filtros em todas as leituras.
- Operações iniciadas. O Forward Finite Scheduling gera erros quando as operações já iniciadas não cabem na capacidade disponível. Importe o progresso das operações para o SkyPlanner antes de cada execução, para que a programação tenha como ponto de partida o trabalho já realizado. O Running Time Lock fixa depois as tarefas das próximas horas.
- Unidades de tempo das gamas operatórias. Os tempos de preparação, execução, espera e movimentação exigem, cada um, a unidade e a base de cálculo corretas. Os tempos de espera e movimentação são tempos de espera, não de ocupação da máquina. Faça a conversão ao importar; caso contrário, todas as durações estarão erradas.
- Operações subcontratadas. Offsite Days e Dock to Stock Days representam tempo decorrido, não capacidade interna. Modele estas operações como etapas que apenas consomem tempo.
Quem configura e dá suporte à integração com o SYSPRO
- A equipa SkyPlanner configura a integração durante a implementação e assegura o suporte após a entrada em produção, abrangendo os objetos de negócio e as consultas OData acordados. Cada fábrica utiliza o SYSPRO de forma diferente, e é aqui que esse conhecimento faz a diferença.
- O seu parceiro SYSPRO pode participar. O parceiro conhece a sua configuração, os formulários personalizados e o licenciamento, e pode configurar o operador e o acesso OData em conjunto com a equipa SkyPlanner.
- Os seus próprios 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 apoio quando necessário. A documentação está disponível em 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, de acordo com os seus processos e necessidades. Consulte os preços, a programação da produção com o SYSPRO, respeitando a capacidade real das máquinas e das equipas, a página do SYSPRO 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 de planear a produção em folhas de cálculo Excel para otimizar a produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de abastecimento
UTU · Quadros elétricos e aparelhagem de manobra
O planeamento da produção permite poupar 2 horas de trabalho por semana, e uma nova fila de tarefas chega à linha de produção 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 a criação de um plano otimizado para três meses, abrangendo todos os centros de trabalho, demora menos de 30 minutos.
98%de fiabilidade das entregas, face a cerca de 50% anteriormente
“O SkyPlanner tem um papel decisivo na manutenção da fiabilidade das nossas entregas.”
Hannu Lahtinen, diretor-geral
KJH-Comp · Metalomecânica de chapa e fabrico por contrato
A fiabilidade das entregas passou de cerca de 50% para valores que chegam aos 98%, e a programação requer agora um supervisor em vez de dois.
99,2%de fiabilidade das entregas
“O SkyPlanner tornou os estrangulamentos mais fáceis de identificar e a gestão da produção mais clara.”
Toni Tuori, diretor de produção
Piristeel · Sistemas de segurança para coberturas e de águas pluviais
A fiabilidade das entregas atingiu 99,2% este ano, e a programação permite poupar até quatro horas de trabalho por dia.
Perguntas frequentes
O SYSPRO tem uma API para tarefas de produção?
Sim. Os e.net Solutions Business Objects permitem consultar e gravar dados no SYSPRO, incluindo o WIPTJB para criar e manter tarefas de produção. O serviço OData do SYSPRO acrescenta acesso RESTful apenas de leitura a tabelas e a Business Activity Queries.
O SYSPRO suporta webhooks?
Não dispõe de webhooks de saída. Os acionadores de Electronic Signature Transaction Setup não foram concebidos para serem ativados por chamadas a objetos de negócio. Por isso, a integração consulta periodicamente o SYSPRO, com uma frequência definida para cada fábrica. Os webhooks do próprio SkyPlanner enviam as alterações à programação à medida que ocorrem.
Como são gravadas no SYSPRO as datas planeadas?
Através do objeto de negócio WIP Job Creation and Maintenance (WIPTJB), que define as datas planeadas de início e fim da tarefa. O SYSPRO valida a gravação com as mesmas regras de Job Entry.
A integração funciona com o SYSPRO Cloud ERP?
Sim. O SkyPlanner lê os dados do Cloud ERP através do serviço OData do SYSPRO, que a SYSPRO identifica como a única via de acesso aos dados nesse ambiente. Durante a definição do âmbito, a equipa SkyPlanner configura a via de gravação de dados em conjunto consigo e com o seu parceiro SYSPRO.
Um parceiro SYSPRO deve propor o SYSPRO MOM Visual APS ou o SkyPlanner?
O SkyPlanner, quando o cliente pretende ter, em semanas, uma programação operacional que respeite a capacidade real das máquinas e das equipas. O Visual APS faz parte da solução SYSPRO MOM, tem licença própria e é instalado com ligação ao SQL Server do SYSPRO. Os utilizadores do MOM Workbench precisam de licenças por utilizador (ajuda do SYSPRO). O SkyPlanner liga-se através de e.net Business Objects e OData, replaneia automaticamente, planeia mudanças de série, ferramentas, equipas e materiais, e permite um número ilimitado de utilizadores, a partir de 199 € por mês.
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ções de ficheiros CSV ou Excel do SYSPRO, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipa comercial para definir o âmbito da integração.