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 a parceiros e equipes de TI como conectar o SYSPRO 8 ao SkyPlanner APS. A integração é bidirecional e usa as interfaces do próprio SYSPRO:
- O SkyPlanner recebe ordens de produção e suas operações, Structures and Routings, centros de trabalho, máquinas, Stock Codes, estoques e pedidos de compra.
- As datas planejadas de início e término são gravadas de volta nas ordens de produção.
- Se você optar por isso, os registros de tempo dos operadores podem retornar como apontamentos de mão de obra.
- Os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
A equipe SkyPlanner configura a integração de acordo com o seu ambiente SYSPRO durante a implantação e oferece suporte após a entrada em produção. Este guia é voltado a parceiros e desenvolvedores que desejam participar desse processo ou desenvolver suas próprias soluções com a REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do SYSPRO
O SYSPRO oferece duas vias de acesso a dados para um sistema externo de programação:
- e.net Solutions Business Objects. Permitem chamar a lógica de negócios do SYSPRO externamente, com entrada e saída em XML. Há 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 mestres. Os objetos de negócio aplicam as mesmas validações das telas do SYSPRO e mantêm a compatibilidade entre versões. O guia de boas práticas do SYSPRO é direto: “SYSPRO’s Business Objects are used to query and post data to SYSPRO.” (Os objetos de negócio do SYSPRO são usados para consultar e gravar dados no SYSPRO.)
- SYSPRO OData Service (OData v4). Oferece acesso RESTful, somente para leitura, aos bancos de dados da empresa e do sistema e às Business Activity Queries, que são views 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 aplicações que precisam acessar dados do SYSPRO.)
Os objetos de negócio são chamados por meio do serviço e.net Communications, usando o SYSPRO WCF Service ou o SYSPRO Web Service.
Master Data Take On (IMPIMP) importa planilhas por meio de objetos de negócio Setup, o que é útil para uma carga pontual de dados mestres. O SYSPRO Harmony chega ao fim de sua vida útil em 31 de dezembro de 2026, portanto não desenvolva nada novo com ele.
Autenticação e licenciamento
- Login no e.net. A integração faz login como um SYSPRO Operator em uma empresa e recebe um GUID de sessão para as chamadas seguintes.
- Licenciamento. Sua licença do SYSPRO precisa incluir as áreas funcionais dos objetos de negócio que o operador chama.
- OData. O acesso é feito por HTTPS, com operadores configurados para OData.
No SkyPlanner, a REST API usa um token de API 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 SYSPRO não envia webhooks. O Electronic Signature Transaction Setup pode acionar gatilhos, como o envio de um e-mail ou a execução de um VBScript, quando uma transação é concluída com sucesso. Porém, o SYSPRO esclarece: “It is not intended that triggers from e.net Business Objects fire VBScript triggers.” (Os gatilhos dos e.net Business Objects não foram concebidos para acionar gatilhos VBScript.)
Por isso, os dados do SYSPRO são consultados periodicamente. Consultas a objetos de negócio ou requisições OData, filtradas por ordens de produção abertas e alterações recentes, identificam novas demandas de produção. A frequência é definida por fábrica: de intervalos de poucos minutos para ordens de produção a consultas de hora em hora para estoques.
O SkyPlanner envia webhooks quando há alterações de estado ou na programação. Assim, a gravação de dados de volta no SYSPRO é orientada a eventos.
Mapeamento de dados
| Objeto do SYSPRO (interface) | Objeto no SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Stock Codes, unidades de medida (OData ou objetos de negócio Query) | Produtos e materiais | SYSPRO → SkyPlanner | Carga inicial, depois consultas periódicas |
| Structures (componentes, itens virtuais, coprodutos) | Estrutura do produto, subprodutos e materiais por produto | SYSPRO → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Routings: centro de trabalho, tempos de preparação, execução, fila e movimentação, Maximum units | Etapas do processo com durações e tempos de preparação e desmontagem | SYSPRO → SkyPlanner | Carga 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 | Carga inicial, raramente depois |
| Capacity Calendar, Shift Patterns | Turnos e dias não úteis | SYSPRO → SkyPlanner | Diariamente, ou gestão dos turnos no SkyPlanner |
| Ordens de produção e subordens (WipMaster), operações e materiais das ordens | Ordens e operações com prazos e necessidades de materiais | SYSPRO → SkyPlanner | Consultas a cada poucos minutos |
| Estoque físico por armazém e Stock Code | Saldos de estoque | SYSPRO → SkyPlanner | Consultas de hora em hora ou a cada execução da programação |
| Pedidos de compra com datas de entrega | Pedidos de compra, materiais a receber por data de entrega | SYSPRO → SkyPlanner | Consultas de hora em hora ou a cada execução da programação |
| Datas planejadas de início e término da ordem de produção (WIPTJB, WIP Job Creation and Maintenance) | Início e término planejados por operação | SkyPlanner → SYSPRO | A cada alteração na programação, via webhook do SkyPlanner |
| Labor Posting: tempos de preparação e execução por operação da ordem, máquina e funcionário | Registros de tempo 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 existe no SYSPRO | Matriz de tempos de preparação, ferramentas como recursos finitos, 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 Stock Codes, Structures and Routings, centros de trabalho, máquinas e calendários por meio de OData ou de objetos de negócio Query. Defina com cuidado como mapear os 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 produção. Leia as ordens efetivas com suas operações e materiais, além dos pedidos de compra em aberto. O SkyPlanner considera o material encomendado disponível na data de entrega do pedido de compra e atualiza o estoque quando o pedido é marcado como Delivered.
Programe apenas ordens de produção efetivas. As ordens sugeridas permanecem no snapshot do MRP até que o MRP Job Review as converta em ordens de produção.
3. Gravação da programação no SYSPRO. Quando o mecanismo de programação aloca ou move uma operação, um webhook do SkyPlanner aciona a gravação no objeto de negócio WIP Job Creation and Maintenance (WIPTJB). Essa chamada define as datas planejadas de início e término da ordem de produção. O objeto de negócio valida a alteração exatamente como o Job Entry.
4. Confirmações no chão de fábrica. Os operadores registram o trabalho com o SkyPlanner Mobile Confirmations ou o Production Timer, e os registros de tempo mantêm a programação atualizada. Você decide se os tempos reais serão gravados de volta no SYSPRO. Se optar pelo envio, os tempos de preparação e execução vão para Labor Posting por operação da ordem, e as quantidades concluídas vão para Job Receipts. Caso contrário, a mão de obra continua sendo apontada no SYSPRO como antes.
5. Responsabilidade pelos dados e regras de conflito. Documente essas definições antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Stock Codes, Structures and Routings, quantidades, status da ordem de produção | SYSPRO |
| Sequência das operações, horários de início e término, alocação de máquinas | SkyPlanner |
| Matriz de tempos de preparação, requisitos de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Turnos e dias não úteis | Um único sistema, escolhido na definição de escopo |
| Mão de obra, saídas de materiais e recebimentos | SYSPRO, com lançamentos feitos no próprio sistema ou enviados a partir dos registros de tempo do SkyPlanner |
Escolha um único sistema para gravar as datas das ordens de produção. O SkyPlanner não exige nenhum módulo de programação do SYSPRO, portanto substitui Factory Scheduling, Visual APS ou APS (Nexsys) na gravação das datas planejadas. Se algum deles ainda atualizar essas datas, desative essa atualizaçã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 planejadas para as datas programadas.)
Etapas típicas do projeto
A implementação normalmente é concluída nas semanas seguintes ao início da implantação. Antes disso, valide a programação no teste gratuito de 30 dias com centros de trabalho, roteiros de produção e ordens abertas exportados do SYSPRO em CSV ou Excel.
- Mapeamento. Defina a tabela de mapeamento, as regras de responsabilidade pelos dados, as frequências de sincronização e se os apontamentos de mão de obra serão enviados de volta.
- Acesso ao SYSPRO. Crie o operador da integração, confirme o licenciamento dos objetos de negócio e habilite o OData onde for usado. Teste primeiro em uma cópia da empresa.
- Carga inicial. Stock Codes, Structures and Routings, centros de trabalho, máquinas e calendários.
- Sincronização de ordens de produção e pedidos de compra. Consultas periódicas com filtros, paginação e novas tentativas.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, quantidade de operadores por operação e máquinas ou pessoal alternativos.
- Gravação da programação no SYSPRO. Gravações via WIPTJB acionadas por webhooks do SkyPlanner, além dos apontamentos de mão de obra, 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 a gravação de retorno quando os dados coincidirem.
O que prever na integração com o SYSPRO
- Ordens _TMP. As simulações de carga com capacidade finita no Job Entry podem criar ordens _TMP no WipMaster. Exclua essas ordens com filtros em todas as leituras.
- Operações iniciadas. O Forward Finite Scheduling apresenta erros quando 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 considere o trabalho já realizado. O Running Time Lock então mantém fixa a programação das próximas horas.
- Unidades de tempo dos roteiros de produção. Os tempos de preparação, execução, fila e movimentação precisam ter a unidade e a base de cálculo corretas. Os tempos de fila e movimentação são tempos de espera, não de uso da máquina. Faça a conversão na importação; caso contrário, todas as durações ficarão incorretas.
- Operações terceirizadas. Offsite Days e Dock to Stock Days representam tempo decorrido, não uso da sua capacidade. Modele essas operações como etapas que consideram apenas o tempo.
Quem configura e dá suporte à integração com o SYSPRO
- A equipe do SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em produção, abrangendo os objetos de negócio e as consultas OData acordados. Cada fábrica usa o SYSPRO de um jeito, e é nessa etapa que esse conhecimento é aplicado.
- Seu parceiro SYSPRO pode participar. Ele conhece sua configuração, seus formulários personalizados e seu licenciamento, e pode configurar o operador e o acesso OData junto com a equipe do SkyPlanner.
- Seus 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 do SkyPlanner ajuda 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. O orçamento da integração é apresentado antecipadamente, junto com seu plano, de acordo com seus processos e necessidades. Consulte os preços, a programação da produção com SYSPRO, respeitando a capacidade real de máquinas e equipes, a página do SYSPRO e a central de integrações com ERP.
O que os fabricantes dizem sobre o SkyPlanner
2 heconomizadas por semana
“Com o SkyPlanner, nosso planejamento da produção passou 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 · Fabricação de produtos farmacêuticos
A eficiência na produção aumentou 90%, e a elaboração de um plano otimizado para três meses, abrangendo todos os centros de trabalho, leva menos de 30 minutos.
98%de pontualidade de entrega, antes em cerca de 50%
“O SkyPlanner tem um papel decisivo na manutenção da nossa pontualidade de entrega.”
Hannu Lahtinen, diretor-geral
KJH-Comp · Fabricação de peças em chapa metálica e manufatura sob contrato
A pontualidade de entrega passou de cerca de 50% para até 98%, e a programação agora exige um supervisor em vez de dois.
99,2%de pontualidade de entrega
“O SkyPlanner tornou os gargalos mais visíveis e a gestão da produção mais clara.”
Toni Tuori, gerente de produção
Piristeel · Sistemas de segurança para telhados e de escoamento de águas pluviais
A pontualidade de entrega atingiu 99,2% neste ano, e a programação economiza até quatro horas de trabalho por dia.
Perguntas frequentes
O SYSPRO tem uma API para ordens de produção?
Sim. Os e.net Solutions Business Objects consultam e gravam dados no SYSPRO, incluindo o WIPTJB para criação e manutenção de ordens de produção. O serviço OData do SYSPRO oferece também acesso RESTful somente para leitura a tabelas e Business Activity Queries.
O SYSPRO oferece suporte a webhooks?
Não há webhooks de saída. Os gatilhos em Electronic Signature Transaction Setup não foram projetados para disparar a partir de chamadas a objetos de negócio. Por isso, a integração consulta o SYSPRO periodicamente, em intervalos definidos para cada fábrica. Os webhooks do próprio SkyPlanner enviam as alterações na programação assim que elas ocorrem.
Como as datas planejadas são gravadas de volta no SYSPRO?
Por meio do objeto de negócio WIP Job Creation and Maintenance (WIPTJB), que define as datas planejadas de início e término da ordem de produção. 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 pelo serviço OData do SYSPRO, que o próprio SYSPRO indica como a única via de acesso aos dados nesse ambiente. Durante a definição de escopo, a equipe do SkyPlanner configura com você e seu parceiro SYSPRO a via para gravar os dados de volta no sistema.
Um parceiro SYSPRO deve propor o SYSPRO MOM Visual APS ou o SkyPlanner?
O SkyPlanner, quando o cliente quer ter em semanas uma programação da produção em funcionamento que respeite a capacidade real de máquinas e equipes. O Visual APS faz parte da suíte SYSPRO MOM, tem licença própria e é instalado com conexão ao SYSPRO SQL Server. Os usuários do MOM Workbench precisam de licenças por usuário (ajuda do SYSPRO). O SkyPlanner se conecta por e.net Business Objects e OData, reprograma automaticamente, planeja trocas de produção, ferramentas, equipes e materiais e permite usuários ilimitados, a partir de 199 € por mês.
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 SYSPRO em CSV ou Excel, sem precisar de cartão de crédito. Inicie o teste ou fale com a equipe de vendas para definir o escopo da integração.