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

O Sylob documenta 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 ERP Sylob expõe dois tipos de REST APIs públicas, também chamadas de webservices, que permitem ler e gravar dados.) (Base de conhecimento da Forterro)

1. API REST Système d’information (leitura). Executa uma consulta salva (requête), criada na atividade “Interroger le système d’information”. A URL de chamada da consulta é obtida em “Autres actions” > “Afficher le web service”, no formato /rest/query/{identifiantQuery}/resultat. Os parâmetros definem o limite de resultados, a formatação dos números, as variáveis da consulta e a estrutura do resultado. Por padrão, os resultados são retornados em XML, ou em JSON com o cabeçalho Accept: application/json. Essa API está incluída no ERP.
2. API REST Action (leitura e gravação). 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 retorna o esquema de dados de uma ação, e POST /rest/v2/action/{code}/execute executa a ação com um corpo JSON. Os tipos de ação incluem:

– Modification de données: altera um ou mais campos de um registro pelo mecanismo de edição rápida do Sylob. Describe lista os campos editáveis. – Message EDI: cria, altera ou exclui registros por meio de uma mensagem EDI. – Scénario de saisie: executa um cenário de entrada de dados, pergunta por pergunta. O exemplo do próprio Sylob é “Déclarer un début ou une fin”, que registra o início ou o término de uma operação (Sylob_Action_006). – Publicação, upload e download de documentos.

1. Mensagens EDI. O mecanismo EDI do Sylob processa exportações e importações. Uma mensagem padrão, Sylob_Recup_Decl_Pro, recupera os apontamentos de produção. (Forterro)
2. Arquivos e ETL. O Sylob ERP Cloud oferece “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Integração de arquivos 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 testar o SkyPlanner.

A base de conhecimento pública do Sylob não documenta assinaturas de webhooks de saída. As alterações chegam ao SkyPlanner pela execução periódica de consultas salvas, com filtros para OFs abertas e alterações recentes, na frequência que você definir.

O Sylob protege o ERP contra consultas excessivas. Desde a versão 2025.Q2, o parâmetro de empresa “Protection des API” ativa a limitação de chamadas por usuário e a paginação de resultados extensos. O Sylob anuncia a aplicação sistemática dessa proteção a partir da versão 2026.Q2. As respostas incluem cabeçalhos RateLimit, e uma chamada que ultrapassa a cota retorna HTTP 429 Too Many Requests com um valor Retry-After. (Forterro) Projete a sincronização para lidar com isso: use consultas incrementais, paginação e espera progressiva entre tentativas ao receber 429.

No sentido inverso, o SkyPlanner envia webhooks quando o estado ou a programação muda. Assim, a gravação de retorno no Sylob é acionada por eventos.

1. Carga inicial de dados mestres. Crie uma consulta salva para cada objeto (artigos, listas de materiais, roteiros, centros de trabalho e funcionários) e leia os dados pela API Système d’information, ou faça uma carga única a partir de uma exportação do Excel. Mapeie os centros de trabalho com cuidado. Um centre de charge do Sylob é um grupo de recursos. Por isso, um centro com três máquinas normalmente se torna um grupo com três centros de trabalho no SkyPlanner.

2. Sincronização de ordens. Leia as OFs firmes com suas operações, além do estoque e dos pedidos de compra em aberto. O SkyPlanner considera o material comprado disponível na data de entrega do pedido de compra e atualiza o estoque quando o pedido é marcado como Delivered. Assim, a programação verifica tanto o estoque quanto 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. Gravação da programação no ERP. Para cada operação que o mecanismo programou ou moveu, a integração chama uma ação Modification de données na operação da OF (Opération d’ordre de fabrication), com início planejado, término planejado e centro de trabalho. A ação usa a própria lógica de edição rápida do Sylob, como quando um planejador edita a operação. Describe retorna os campos editáveis, permitindo que a integração valide o payload antes da primeira chamada. Se um usuário estiver editando o registro, a chamada retornará uma falha prevista; tente novamente na próxima alteração.

4. Apontamentos do chão de fábrica. Os operadores registram o trabalho no SkyPlanner Mobile Confirmations ou no Production Timer. O início e o término são enviados de volta pelo cenário “Déclarer un début ou une fin”. Os registros de tempo e as quantidades se tornam apontamentos de produção na mesma operação da OF: tempo de setup, tempo de execução, quantidade produzida, refugo e operação concluída. Se sua fábrica já faz apontamentos pelo Sylob Apps ou por terminais no chão de fábrica, mantenha um único canal de apontamento para evitar registros duplicados.

5. Regras de responsabilidade e resolução de conflitos. Documente essas regras antes da entrada em produção:

O SkyPlanner não depende do CADPLAN nem das atividades de planejamento com capacidade finita do Sylob. Deixe o SkyPlanner controlar as datas das operações: quando dois sistemas de planejamento gravam as mesmas datas, um sobrescreve o outro. Com o SkyPlanner no controle, o Autopilot reprograma automaticamente a cada mudança relevante, e as novas datas são enviadas de volta ao Sylob.

• Licença da Action API. A leitura por consultas salvas está incluída. A gravação pelo catálogo de ações exige o módulo “Webservice” do Sylob ou uma licença de API no MyForterro. Acerte isso com seu contato no Sylob antes da etapa de gravação de retorno.
• As consultas são o contrato da integração. A leitura depende das consultas salvas. Dê nomes claros a elas, passe os filtros como atributos variáveis em tempo de execução e versione as consultas junto com a integração.
• Grupos de centros de trabalho. Um centro de trabalho do Sylob pode reunir várias máquinas. Defina, para cada centro, se o SkyPlanner deve enxergar um grupo de centros de trabalho ou máquinas individuais.
• Programação para trás e cálculos de carga. O Sylob programa de trás para frente a partir das datas de necessidade, e um cálculo de carga agendado pode replanejar OFs atrasadas. Defina se alguma atividade continuará gravando as datas das operações depois que o SkyPlanner assumir esse controle e, em caso positivo, qual.
• Unidades dos tempos de setup e execução. Antes da importação, confira as unidades e se o setup é por OF ou por peça. Unidades incorretas distorcem todas as durações.
• Calendários. Os padrões semanais e as exceções dos centros de trabalho devem cobrir todo o horizonte de programação. Caso contrário, a capacidade desaparece do plano.
• Limitação de chamadas. O Sylob limita as chamadas por usuário e pagina resultados extensos. A consulta periódica incremental mantém o uso bem abaixo da cota.
• CORS e navegadores. Chamadas entre servidores evitam as restrições de CORS. Clientes que rodam no navegador precisam ter as origens permitidas configuradas no Sylob.