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

O Fulcrum é um único produto na nuvem com arquitetura multi-inquilino, pelo que todos os clientes utilizam a mesma API. O portal de programadores descreve-a como uma API pública para “REST API calls directly into your Fulcrum site.” (chamadas REST API diretamente à sua instância Fulcrum).

• Especificação. OpenAPI “Fulcrum PublicAPI” v1, disponível para transferência em https://api.fulcrumpro.com/swagger/v1/swagger.json. O Fulcrum sugere gerar um cliente tipado a partir desta especificação. A página History apresenta todas as alterações com as respetivas datas.
• Servidores. https://api.fulcrumpro.com para instâncias padrão. As instâncias ITAR utilizam api.fulcrumpro.us, e os tokens ITAR recebem uma resposta 401 no servidor .com.
• Convenções. As listagens usam POST .../list, com os filtros no corpo do pedido, paginação por Skip e Take e ordenação por Sort.Field / Sort.Dir. Muitos objetos aceitam PUT, e as tarefas também aceitam JSON Patch.

Endpoints utilizados numa integração para programação da produção:

A própria página de integrações do Fulcrum é clara quanto ao trabalho necessário: “Every system is a little bit different and requires some configuration.” (Cada sistema é um pouco diferente e exige alguma configuração.) É precisamente essa configuração que a equipa SkyPlanner assume durante a implementação.

O Fulcrum suporta webhooks, configurados por um administrador. Desde setembro de 2026, os webhooks com falhas são suspensos e testados novamente todos os dias, em vez de repetirem as tentativas indefinidamente. O histórico da API indica eventos como PurchaseOrderUpdated e ItemUpdated.

A integração lê os dados do Fulcrum da seguinte forma:

• Consulta as tarefas em aberto a cada poucos minutos, filtradas pelos estados scheduled e inProgress, com hasIncompleteOperations: true. Este é o filtro que o próprio Fulcrum indica para obter os mesmos resultados da sua página de programação.
• Lê as encomendas de compra e as existências antes de cada execução da programação ou ao receber um webhook PurchaseOrderUpdated, quando este está configurado.
• Lê os artigos, as gamas operatórias, os equipamentos e os turnos quando há alterações ou todas as noites.

No sentido inverso, os webhooks do SkyPlanner enviam as alterações à programação à medida que ocorrem. A escrita de dados no Fulcrum é, assim, acionada por eventos.

1. Carga inicial de dados mestre. Importe os artigos, materiais, gamas operatórias, centros de trabalho e equipamentos e, depois, os turnos dos departamentos e as paragens. Cada centro de trabalho do Fulcrum passa a ser um grupo de centros de trabalho no SkyPlanner, composto pelos respetivos equipamentos. Os equipamentos selecionados em cada operação da gama operatória passam a ser os centros de trabalho permitidos para essa operação. Os equipamentos com Unlimited Capacity, como fornos e cabinas de pintura, são representados por tarefas em lote.

2. Sincronização de ordens. Leia as tarefas em aberto com os respetivos artigos a fabricar e operações, bem como as encomendas de compra em aberto e as existências. 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. Em cada reprogramação, verifica as existências e as compras a receber.

3. Escrita da programação no Fulcrum. O próprio Fulcrum calcula scheduledStartUtc, scheduledEndUtc e scheduledEquipmentId e devolve-os como campos só de leitura. A atualização da operação aceita customFields. O SkyPlanner escreve o início previsto, o fim previsto e o centro de trabalho em campos personalizados de cada operação da tarefa, e o fim previsto num campo personalizado da tarefa. As equipas de vendas e compras veem as datas do SkyPlanner na tarefa no Fulcrum.

4. Confirmações no chão de fábrica. Os operadores registam o trabalho no SkyPlanner com Mobile Confirmations, Production Timer ou Quick Log Mode. O SkyPlanner envia os tempos para o Fulcrum através de /api/job-tracking-timers/start e /stop, ou como um bloco concluído através de /api/timers. As quantidades são enviadas através de add-quantity-completed e a contagem final, incluindo o refugo, através de complete. O cálculo de custos das tarefas no Fulcrum mantém-se atualizado.

5. Responsabilidade pelos dados e regras de conflito. O motor de programação do Fulcrum “dictates the order of operations in Job Tracking.” (determina a ordem das operações em Job Tracking). Por isso, escolha um único canal de atribuição de trabalho por operação: a fila do operador no SkyPlanner ou o Fulcrum Job Tracking. Documente as regras antes da entrada em produção:

• A mão de obra reflete-se nos efetivos por turno. No Fulcrum, o valor de Max Equipment por turno “is usually determined by how many people you have working in a certain area at that time.” (é normalmente determinado pelo número de pessoas a trabalhar numa determinada área nesse momento). Os operadores identificados pelo nome e os respetivos turnos são configurados no SkyPlanner. Os nomes são obtidos a partir dos registos de utilizadores em /api/users.
• A programação é feita por equipamento. Os centros de trabalho do Fulcrum são grupos de equipamentos intercambiáveis. Mantenha correta a seleção de equipamentos na gama operatória, pois estes serão as alternativas entre as quais o motor escolhe.
• As ordens de fabrico agrupam tarefas. Uma ordem de fabrico agrupa operações de várias tarefas, por exemplo, um conjunto de peças para corte na mesma chapa. Ao iniciar um temporizador numa operação agrupada, é iniciado o temporizador da ordem de fabrico, que abrange todas as operações das tarefas do grupo.
• Limites dos temporizadores. Os registos de tempo retroativos em /api/timers “may not be in the future, older than 30 days, or longer than 7 days.” (não podem ter datas futuras nem exceder os limites indicados de antiguidade ou duração). Envie os tempos à medida que os operadores os registam.
• Os formatos de hora variam. Os turnos usam valores HHmm na hora local, as paragens e as datas programadas usam UTC e as estimativas das operações são fornecidas em segundos.
• As atualizações de equipamentos substituem o registo completo. Um pedido PUT de equipamento limpa qualquer campo que não inclua. O SkyPlanner lê os dados dos equipamentos e nunca os altera.
• Instalações ITAR. Utilize o servidor .us e um token ITAR.