Integrações / ERP / Exact
Guia de integração do Exact Online para planejamento da produção com SkyPlanner APS
Este guia de integração do Exact Online mostra aos parceiros da Exact e às equipes de TI como conectar o Exact Online Manufacturing ao SkyPlanner APS. A integração entre SkyPlanner e Exact Online funciona nos dois sentidos:
- Ordens de produção, etapas do roteiro de produção, planos de materiais, centros de trabalho, operações e listas de materiais são importados pela REST API do Exact Online.
- Itens, posições de estoque, pedidos de compra e pedidos de venda são importados, com webhooks do Exact Online para informar alterações.
- As datas planejadas de início e término são enviadas de volta para cada etapa do roteiro de produção e para a ordem de produção.
- Os apontamentos de horas dos operadores são lançados como transações de tempo, e as quantidades concluídas, como recebimentos de ordens de produção.
Durante a implantação, a equipe do SkyPlanner configura a integração conforme o seu ambiente do Exact Online e presta suporte após a entrada em produção. Este guia é voltado a parceiros e desenvolvedores que desejam participar desse trabalho ou desenvolver a integração por conta própria usando a REST API documentada do SkyPlanner (referência da API). Ao final, há uma breve seção sobre o Exact Globe+.
A REST API do Exact Online para manufatura
O Exact Online disponibiliza seus dados por uma única REST API, com recursos agrupados por serviço. O caminho base é /api/v1/{division}/<service>/<resource>, em que a divisão corresponde à empresa no Exact Online. A referência da REST API lista os seguintes recursos do serviço de manufatura para programação da produção:
| Recurso | Dados disponíveis | Métodos |
|---|---|---|
manufacturing/ShopOrders | Número da ordem de produção, item, PlannedQuantity, PlannedStartDate, PlannedDate, status, indicador de liberação | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | Etapa do roteiro por ordem de produção: operação, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | Linhas de materiais por ordem de produção | GET, POST, PUT, DELETE |
manufacturing/Workcenters | Código, tipo, área de produção, valor de capacidade, taxas | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | Operações e o centro de trabalho em que cada uma é executada, tempos de preparação e execução | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | Versões da BOM, componentes e roteiro de produção | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | Horas apontadas por ordem de produção e etapa do roteiro | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | Quantidades concluídas recebidas de uma ordem de produção | GET, POST |
manufacturing/MaterialIssues | Material baixado para uma ordem de produção | GET, POST |
manufacturing/ShopOrderPriorities | Modo de prioridade por ordem de produção | GET, PUT |
Recursos dos demais serviços:
| Recurso | Dados disponíveis |
|---|---|
logistics/Items | Cadastro de itens |
inventory/ItemWarehouses | Estoque por item e depósito |
purchaseorder/PurchaseOrders, PurchaseOrderLines | Pedidos de compra em aberto e datas de recebimento |
salesorder/SalesOrders, SalesOrderLines | Demanda dos clientes e datas de entrega |
Autenticação e acesso
O Exact Online usa OAuth 2.0 com o fluxo de código de autorização e tokens de atualização. Segundo a Exact: “Before you can start integration with Exact Online, you must first register your app in the App Store.” (Antes de iniciar a integração com o Exact Online, você precisa registrar seu aplicativo na App Store.) (Ajuda do Exact Online) Para registrar aplicativos, é necessária uma assinatura do Exact Online Developer (Exact App Store).
- A integração é registrada como um aplicativo com uma URI de redirecionamento.
- Um usuário do Exact Online com acesso a manufatura, estoque e compras concede o consentimento uma única vez.
- Cada requisição envia
Authorization: Bearer <access_token>e a divisão no caminho. - Os tokens de acesso são renovados com o token de atualização. A Exact limita a frequência com que um novo token pode ser solicitado, portanto mantenha o token em cache até que expire.
A Exact também limita as chamadas por minuto e por dia para cada aplicativo e empresa, e solicita chamadas sequenciais em vez de paralelas. Os limites atuais estão no artigo da Exact sobre limites da API. A integração foi projetada para respeitá-los: leituras filtradas com $filter e $select, além da Sync API para alterações em massa.
No SkyPlanner, a REST API usa um token de API no cabeçalho Authorization-Token para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração orienta as primeiras chamadas.
Webhooks e consultas periódicas
Os webhooks do Exact Online enviam uma requisição POST à sua URL de callback quando há alterações em um tópico em que você se inscreveu. A requisição é assinada com um hash HMAC SHA256 (webhooks). Os tópicos incluem Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders e SalesOrderLines. Eles enviam as alterações de estoque, compras e demanda ao SkyPlanner assim que ocorrem.
As ordens de produção e as etapas do roteiro são lidas periodicamente. Filtre ShopOrders e ShopOrderRoutingStepPlans pelo campo Modified e use a Sync API para leituras em massa (restrições da API).
O SkyPlanner envia seus próprios webhooks quando a programação muda, de modo que a gravação de retorno no Exact Online é acionada por eventos.
Mapeamento de dados
| Recurso do Exact Online | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
Items | Produtos e materiais | Exact Online → SkyPlanner | Carga inicial, depois via webhook |
BillOfMaterialVersions, BillOfMaterialMaterials | Estrutura do produto, subprodutos, materiais por produto | Exact Online → SkyPlanner | A cada alteração |
Workcenters, OperationResources | Centros de trabalho, grupos de centros de trabalho | Exact Online → SkyPlanner | Carga inicial |
Operations, BillOfMaterialRoutings | Etapas do processo com tempos de preparação e execução | Exact Online → SkyPlanner | A cada alteração |
ShopOrders | Ordens com quantidade e prazo de entrega | Exact Online → SkyPlanner | A cada poucos minutos |
ShopOrderRoutingStepPlans | Operações com sequência, centro de trabalho e horas de preparação e execução | Exact Online → SkyPlanner | A cada poucos minutos |
ShopOrderMaterialPlans | Materiais por operação | Exact Online → SkyPlanner | A cada poucos minutos |
ItemWarehouses, StockPosition | Saldos de estoque | Exact Online → SkyPlanner | Webhook |
PurchaseOrderLines | Pedidos de compra com data de entrega prevista | Exact Online → SkyPlanner | Webhook |
SalesOrderLines | Prazos de entrega e prioridade dos clientes | Exact Online → SkyPlanner | Webhook |
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT) | Início, término e centro de trabalho planejados por etapa | SkyPlanner → Exact Online | A cada alteração, via webhook |
ShopOrders: PlannedStartDate, PlannedDate (PUT) | Início e término da ordem | SkyPlanner → Exact Online | A cada alteração, via webhook |
TimeTransactions (POST) | Apontamentos de horas e confirmações dos operadores | SkyPlanner → Exact Online | A cada confirmação ou por turno |
ShopOrderReceipts (POST) | Quantidade concluída na última etapa | SkyPlanner → Exact Online | A cada confirmação |
| Não armazenados no Exact Online | Matriz de tempos de preparação, ferramentas como recursos finitos, operadores por operação, centros de trabalho alternativos, turnos | Mantidos no SkyPlanner | Implantação |
Fluxos de integração
1. Carga inicial de dados mestres. Leia Workcenters, Operations e OperationResources; em seguida, os itens e as versões de BOM com seus roteiros de produção. Um centro de trabalho com três máquinas passa a ser representado por três centros de trabalho ou por um grupo de centros de trabalho. Turnos, ausências e horas extras são configurados no SkyPlanner, pois o centro de trabalho do Exact contém um único valor de capacidade.
2. Sincronização de ordens. Leia os registros de ShopOrders em aberto com seus ShopOrderRoutingStepPlans e ShopOrderMaterialPlans, além do estoque e das linhas dos pedidos de compra. A programação verifica tanto o estoque quanto as compras a receber. O MRP continua gerando recomendações de ordens no Exact Online, e o SkyPlanner programa as ordens de produção que você cria.
3. Gravação da programação no Exact Online. Para cada etapa do roteiro que o mecanismo programou ou moveu, o SkyPlanner envia uma requisição PUT para ShopOrderRoutingStepPlans com PlannedStartDate, PlannedEndDate e Workcenter. Os campos PlannedStartDate e PlannedDate da ordem de produção acompanham a primeira e a última etapa. O Exact Online mantém as quantidades, os planos de materiais e o custeio.
4. Confirmações do chão de fábrica. Os operadores registram o trabalho com SkyPlanner Mobile Confirmations ou Production Timer, e os apontamentos de horas mantêm a programação atualizada. As horas registradas são lançadas como TimeTransactions, vinculadas à ordem de produção e à etapa do roteiro, como preparação ou execução. A confirmação final gera um registro em ShopOrderReceipts com a quantidade concluída. Se sua fábrica já registra horas no Shop Floor Control, escolha um único canal de apontamento.
5. Responsabilidades e regras para conflitos. Documente essas regras antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Itens, BOMs, quantidades das ordens de produção, planos de materiais, custos | Exact Online |
| Sequência das etapas do roteiro, horários de início e término, alocação aos centros de trabalho | SkyPlanner |
| Matriz de tempos de preparação, ferramentas, operadores por operação, recursos alternativos, turnos | SkyPlanner |
| Apontamentos de horas e recebimentos da produção | Exact Online, com dados enviados pelo SkyPlanner |
A principal fonte de conflitos é a alteração manual de datas. Se os planejadores continuarem alterando as datas das ordens de produção no Exact Online, dois sistemas passam a controlar as mesmas datas. Deixe o SkyPlanner controlar as datas das etapas do roteiro. Com Autopilot, o SkyPlanner reprograma automaticamente quando há mudanças na produção.
Etapas típicas do projeto
A implementação normalmente é concluída em semanas após o início da implantação. Antes disso, valide a programação durante o teste gratuito de 30 dias com uma exportação em CSV ou Excel das ordens de produção em aberto e das etapas dos roteiros. Depois, o projeto segue estas etapas:
- Definição de escopo. Confirme a edição, as divisões, as frequências de sincronização, o canal de apontamento de horas e o lançamento dos recebimentos da produção.
- Aplicativo e consentimento. Registre o aplicativo. Em seguida, um usuário do Exact Online concede o consentimento OAuth para cada divisão.
- Carga inicial. Centros de trabalho, operações, itens, versões de BOM e roteiros de produção.
- Sincronização de ordens. Ordens de produção, planos das etapas dos roteiros e planos de materiais em intervalos programados; estoque e compras via webhook.
- Configuração de restrições no SkyPlanner. Turnos, matriz de tempos de preparação, ferramentas, quantidade de operadores por operação e máquinas ou pessoas alternativas.
- Gravação da programação no Exact Online. Envio das datas planejadas das etapas dos roteiros ao Exact Online, seguido dos apontamentos de horas e dos recebimentos da produção.
- Testes em paralelo e entrada em produção. Compare as datas com o plano atual, corrija os dados mestres e, em seguida, ative a gravação dos dados no Exact Online.
O que considerar ao planejar a integração com o Exact Online
- Tempos das etapas do roteiro.
PlannedSetupHoursePlannedRunHoursvêm do roteiro de produção da BOM. Primeiro, compare esses valores com os tempos reais de execução. - Agrupamento de centros de trabalho. O Exact armazena um único valor de capacidade por centro de trabalho. Defina, para cada centro, se ele será representado por um centro de trabalho, por vários ou por um grupo.
- Calendários. Turnos, feriados e ausências são mantidos no SkyPlanner. Configure-os antes de gerar a primeira programação.
- Limite de chamadas. O Exact limita as chamadas por aplicativo e empresa e exige que sejam sequenciais. Use webhooks quando houver tópicos disponíveis,
$filteremModifiede a Sync API para leituras em massa. - Múltiplas divisões. Cada divisão do Exact Online é uma empresa com caminho e consentimento próprios. Mapeie cada fábrica para sua divisão.
- Ordens de produção liberadas. Defina em quais status o SkyPlanner pode alterar as datas: ordens em aberto e liberadas ou apenas ordens em aberto.
- Um único responsável pelas datas. Pare de alterar datas manualmente no Exact Online assim que o SkyPlanner assumir o controle das datas das etapas dos roteiros.
Exact Globe+
Exact Globe+ é o ERP da Exact vendido e implementado por parceiros Exact Globe+. Segundo a Exact, ele “koppelt eenvoudig en snel met andere systemen” (conecta-se de forma simples e rápida a outros sistemas) (Exact Globe+). O SkyPlanner programa as ordens de produção do Exact Globe+ da mesma forma: recebe ordens de produção, roteiros de produção, recursos e estoque, e devolve datas planejadas e horas registradas. Seu parceiro Exact Globe+ e a equipe SkyPlanner definem a interface e os objetos que receberão os dados de retorno durante a definição de escopo.
Integração com o Exact Online: quem configura e dá suporte
- A equipe SkyPlanner configura a integração durante a implantação e oferece suporte após a entrada em produção.
- Seu parceiro Exact pode participar. Ele conhece suas edições, divisões e configurações de manufatura.
- Seus próprios desenvolvedores podem ampliar a integração usando a REST API documentada do SkyPlanner. Um token de API basta para começar, e a equipe SkyPlanner ajuda quando necessário.
Com a conexão estabelecida, o mecanismo Arcturus programa a produção com base nas ordens atualizadas do Exact Online, e cada etapa do roteiro recebe suas datas planejadas. 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, de acordo com seu processo e suas necessidades, junto com o plano contratado. Assim, você conhece o custo total antes de começar. Consulte os preços, os recursos e veja como o planejamento nativo do Exact Online se compara na página sobre programação com capacidade finita no Exact Online. A visão geral está na página do Exact Online, e você encontra outros ERPs na central de integrações com ERP.
Avaliações do SkyPlanner por fabricantes
Menos paradas por falta de materiais
“O valor que o SkyPlanner nos traz é ser uma ferramenta que funciona no dia a dia, especialmente para definir datas de entrega.”
Tommi Männistö, gerente de planejamento da produção
Eskomatic · Usinagem sob encomenda
A programação automática da carga de trabalho proporciona datas de entrega mais precisas, e as paradas de produção por falta de materiais caíram drasticamente.
1.000 ou mais ordens de produção programadas automaticamente
“Temos um novo nível de controle da produção, e nossa compreensão da capacidade está em um patamar completamente diferente.”
Hannu Ryynänen, CEO
Mamec · Misturadores industriais, bombas e fabricação sob encomenda de alta tecnologia
Milhares de ordens de produção são programadas automaticamente, com uma visão da produção em tempo real para toda a organização.
Perguntas frequentes
A API do Exact Online inclui ordens de produção e etapas do roteiro de produção?
Sim. O serviço de manufatura oferece os recursos ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters, Operations e BOM, todos com acesso de leitura e gravação. Os apontamentos de tempo são registrados por meio de TimeTransactions, e as quantidades concluídas, por meio de ShopOrderReceipts.
Como as datas planejadas são gravadas no Exact Online?
O SkyPlanner envia uma requisição PUT para ShopOrderRoutingStepPlans com PlannedStartDate, PlannedEndDate e Workcenter para cada etapa que programa ou move. Os campos PlannedStartDate e PlannedDate da ordem de produção são atualizados para refletir essas datas.
Quem desenvolve a integração com o Exact Online?
Durante a implantação, a equipe do SkyPlanner configura a integração bidirecional de acordo com a configuração do seu Exact Online e oferece suporte após a entrada em produção. Seu parceiro Exact pode participar. Seus próprios desenvolvedores também podem criar a integração usando a REST API documentada do SkyPlanner. Basta um token de API para começar.
O Exact Online pode enviar alterações em tempo real?
Os webhooks do Exact Online enviam alterações em itens, posições de estoque, pedidos de compra e pedidos de venda. As ordens de produção e as etapas do roteiro de produção são consultadas em intervalos curtos, com requisições filtradas. No sentido inverso, os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O teste gratuito de 30 dias permite usar até 20 centros de trabalho e importar suas ordens de produção por arquivos 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.