Guia de integração do Sylob ERP para programação da produção com o SkyPlanner APS

A documentação do Sylob descreve duas REST APIs públicas: “L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \”webservices\”) qui autorise la lecture et l’écriture de données.” (O Sylob ERP disponibiliza dois tipos de REST APIs públicas, também designadas «webservices», que permitem ler e escrever dados.) (Base de conhecimento da Forterro)

1. API REST Système d’information (leitura). Executa uma consulta guardada (requête), criada na atividade “Interroger le système d’information”. O URL de chamada da própria consulta obtém-se em “Autres actions” > “Afficher le web service” e tem o formato /rest/query/{identifiantQuery}/resultat. Os parâmetros definem o limite de resultados, o formato dos números, as variáveis da consulta e a estrutura dos resultados. Por predefinição, os resultados são devolvidos em XML, ou em JSON se for utilizado o cabeçalho Accept: application/json. Esta API está incluída no ERP.
2. API REST Action (leitura e escrita). Executa uma ação definida na atividade “Gérer les actions web service”, o catálogo de ações do Sylob. Disponibiliza duas operações: GET /rest/v2/action/{code}/describe devolve o esquema de dados de uma ação e POST /rest/v2/action/{code}/execute executa-a com um corpo em JSON. Os tipos de ação incluem:

– Modification de données: altera um ou mais campos de um registo através do mecanismo de edição rápida do Sylob. Describe lista os campos editáveis. – Message EDI: cria, altera ou elimina registos através de uma mensagem EDI. – Scénario de saisie: executa um cenário de introdução de dados, pergunta a pergunta. O exemplo do próprio Sylob é “Déclarer un début ou une fin”, que declara o início ou o fim de uma operação (Sylob_Action_006). – Publicação, carregamento e transferência de documentos.

1. Mensagens EDI. O motor EDI do Sylob trata das exportações e importações. Uma mensagem padrão, Sylob_Recup_Decl_Pro, permite obter as declarações de produção. (Forterro)
2. Ficheiros e ETL. O Sylob ERP Cloud oferece “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Integração de ficheiros via SFTP para facilitar a migração das integrações existentes.) (Sylob) Os resultados das consultas também podem ser exportados para Excel, uma forma rápida de começar a experimentar o SkyPlanner.

A base de conhecimento pública do Sylob não documenta qualquer mecanismo de subscrição de webhooks de saída. As alterações chegam ao SkyPlanner através da execução periódica de consultas guardadas que filtram as OFs em aberto e as alterações recentes, com a frequência que definir.

O Sylob protege o ERP contra cargas elevadas de consultas. Desde a versão 2025.Q2, o parâmetro de empresa “Protection des API” ativa a limitação de pedidos por utilizador e a paginação de resultados extensos. O Sylob anuncia a aplicação sistemática desta proteção a partir da versão 2026.Q2. As respostas incluem cabeçalhos RateLimit, e uma chamada que ultrapasse a quota devolve HTTP 429 Too Many Requests com um valor Retry-After. (Forterro) Prepare a sincronização para estas condições: consultas incrementais, paginação e aumento do intervalo entre tentativas em caso de resposta 429.

No sentido inverso, o SkyPlanner envia webhooks quando o estado ou a programação mudam, pelo que a escrita de retorno no Sylob é desencadeada por eventos.

1. Carga inicial de dados mestre. Crie uma consulta guardada por objeto (artigos, nomenclatures, gammes, centros de trabalho, colaboradores) e leia os dados através da API Système d’information, ou carregue-os uma única vez a partir de uma exportação Excel. Defina cuidadosamente o mapeamento dos centros de trabalho. Um centre de charge do Sylob é um grupo de recursos, pelo que um centro com três máquinas corresponde normalmente a um grupo de centros de trabalho com três centros de trabalho no SkyPlanner.

2. Sincronização de ordens. Leia as OFs firmes com as respetivas operações, bem como as existências e as encomendas de compra em aberto. 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. Assim, a programação verifica tanto as existências como as compras a receber.

Programe OFs firmes, não sugestões do CBN. As sugestões mudam na próxima execução do cálculo de necessidades líquidas.

3. Escrita da programação no Sylob. Para cada operação que o motor tenha posicionado ou deslocado, a integração chama uma ação Modification de données na operação da OF (Opération d’ordre de fabrication), com o início planeado, o fim planeado e o centro de trabalho. A ação utiliza a lógica de edição rápida do próprio Sylob, tal como quando um planeador edita a operação. Describe devolve os campos editáveis, permitindo à integração validar os dados a enviar antes da primeira chamada. Se um utilizador estiver a editar o registo, a chamada devolve uma falha prevista; repita a tentativa na próxima alteração.

4. Declarações do chão de fábrica. Os operadores registam o trabalho com SkyPlanner Mobile Confirmations ou Production Timer. O início e o fim são enviados de volta através do cenário “Déclarer un début ou une fin”. Os registos de tempo e as quantidades dão origem a declarações de produção na mesma operação da OF: tempo de preparação, tempo de execução, quantidade produzida, refugo e operação concluída. Se a sua fábrica já faz declarações através de Sylob Apps ou de terminais no chão de fábrica, mantenha um único canal de declaração para evitar registos duplicados.

5. Responsabilidade pelos dados e regras de conflito. Documente estas regras antes da entrada em produção:

O SkyPlanner não precisa do CADPLAN nem das atividades de programação da produção do Sylob que respeitam a capacidade real das máquinas e do pessoal. Deixe a gestão das datas das operações a cargo do SkyPlanner: se dois sistemas de programação alterarem as mesmas datas, as alterações de um sobrepõem-se às do outro. Quando o SkyPlanner passa a gerir essas datas, o Autopilot reprograma automaticamente a produção a cada alteração relevante e as novas datas são enviadas para o Sylob.

• Licença da Action API. A leitura através de consultas guardadas está incluída. A escrita através do catálogo de ações exige o módulo “Webservice” do Sylob ou uma licença de API no MyForterro. Trate deste ponto com o seu contacto Sylob antes da fase de escrita no sistema.
• As consultas são o contrato da integração. A leitura depende das consultas guardadas. Dê-lhes nomes claros, passe os filtros como atributos variáveis em tempo de execução e mantenha o controlo de versões das consultas a par do da integração.
• Grupos de centros de trabalho. Um centro de trabalho do Sylob pode conter várias máquinas. Decida, para cada centro, se o SkyPlanner o representa como um grupo de centros de trabalho ou como máquinas individuais.
• Programação regressiva e cálculos de carga. O Sylob programa para trás a partir das datas de necessidade, e um cálculo de carga agendado pode reprogramar OFs em atraso. Defina de comum acordo se alguma atividade continuará a escrever as datas das operações depois de o SkyPlanner assumir a sua gestão e, em caso afirmativo, qual.
• Unidades dos tempos de preparação e execução. Antes da importação, verifique as unidades e se a preparação é definida por OF ou por peça. Unidades erradas distorcem todas as durações.
• Calendários. Os horários semanais e as exceções dos centros de trabalho têm de abranger todo o horizonte de programação; caso contrário, essa capacidade desaparece do plano.
• Limitação de chamadas. O Sylob limita as chamadas por utilizador e divide os resultados extensos em páginas. A consulta periódica incremental mantém a utilização bem abaixo da quota.
• CORS e navegadores. As chamadas entre servidores evitam as restrições de CORS. Para clientes no navegador, é necessário configurar as origens permitidas no Sylob.