Integrações / ERP / Exact

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

Este guia de integração do Exact Online explica aos parceiros Exact e às equipas de TI como ligar o Exact Online Manufacturing ao SkyPlanner APS. A integração entre o SkyPlanner e o Exact Online funciona nos dois sentidos:

  • As ordens de fabrico, etapas da gama operatória, planos de materiais, centros de trabalho, operações e listas de materiais são importados através da REST API do Exact Online.
  • São importados artigos, posições de stock, encomendas a fornecedores e encomendas de clientes, com webhooks do Exact Online para comunicar alterações.
  • As datas de início e fim planeadas são enviadas de volta para cada etapa da gama operatória e para a ordem de fabrico.
  • Os registos de tempo dos operadores são lançados como movimentos de horas, e as quantidades concluídas como entradas de produção das ordens de fabrico.
Cronograma de Gantt do SkyPlanner APS com tarefas programadas por centro de trabalho e uma lista de ordens em baixo.

Durante a implementação, a equipa SkyPlanner configura a integração de acordo com a configuração do seu Exact Online e presta apoio após a entrada em produção. Este guia destina-se a parceiros e programadores que queiram participar ou desenvolver a sua própria integração com base na REST API documentada do SkyPlanner (referência da API). No final, encontra uma breve secção sobre o Exact Globe+.

A REST API do Exact Online para a produção

O Exact Online disponibiliza os seus dados através de uma única REST API, com os 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 apresenta o serviço manufacturing com os seguintes recursos para a programação da produção:

RecursoDados incluídosMétodos
manufacturing/ShopOrdersNúmero da ordem de fabrico, artigo, PlannedQuantity, PlannedStartDate, PlannedDate, estado, indicador de libertaçãoGET, POST, PUT, DELETE
manufacturing/ShopOrderRoutingStepPlansEtapa da gama operatória por ordem de fabrico: operação, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHoursGET, POST, PUT, DELETE
manufacturing/ShopOrderMaterialPlansLinhas de materiais por ordem de fabricoGET, POST, PUT, DELETE
manufacturing/WorkcentersCódigo, tipo, área de produção, valor da capacidade, tarifasGET, POST, PUT, DELETE
manufacturing/Operations, OperationResourcesOperações e respetivos centros de trabalho, tempos de preparação e de execuçãoGET, POST, PUT, DELETE
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutingsVersões da BOM, componentes e gama operatóriaGET, POST, PUT, DELETE
manufacturing/TimeTransactionsHoras registadas por ordem de fabrico e etapa da gama operatóriaGET, POST, PUT, DELETE
manufacturing/ShopOrderReceiptsQuantidades de produtos acabados recebidas de uma ordem de fabricoGET, POST
manufacturing/MaterialIssuesMaterial fornecido a uma ordem de fabricoGET, POST
manufacturing/ShopOrderPrioritiesModo de prioridade por ordem de fabricoGET, PUT

Nos restantes serviços:

RecursoDados incluídos
logistics/ItemsDados mestre dos artigos
inventory/ItemWarehousesStock por artigo e armazém
purchaseorder/PurchaseOrders, PurchaseOrderLinesEncomendas a fornecedores em aberto e datas de receção
salesorder/SalesOrders, SalesOrderLinesProcura dos clientes e datas de entrega

Autenticação e acesso

O Exact Online utiliza 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, tem de registar a sua aplicação na App Store.) (Ajuda do Exact Online) Para registar aplicações, é necessária uma subscrição Exact Online Developer (Exact App Store).

  • A integração é registada como uma aplicação com um URI de redirecionamento.
  • Um utilizador do Exact Online com acesso à produção, ao inventário e às compras dá o seu consentimento uma única vez.
  • Cada pedido envia Authorization: Bearer <access_token> e inclui 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 se pode pedir um novo token, pelo que deve mantê-lo em cache até expirar.

A Exact também estabelece limites de chamadas por minuto e por dia para cada aplicação e empresa, e pede que as chamadas sejam sequenciais, em vez de paralelas. Os limites atuais constam do artigo da Exact sobre os limites da API. A integração foi concebida para respeitar estes limites: leituras filtradas com $filter e $select, e utilização da Sync API para alterações em massa.

No SkyPlanner, a REST API utiliza 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 explica como fazer as primeiras chamadas.

Webhooks e consultas periódicas

Os webhooks do Exact Online enviam um pedido POST para o seu URL de callback quando há uma alteração num tópico subscrito. O pedido é assinado com um hash HMAC SHA256 (webhooks). Os tópicos incluem Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders e SalesOrderLines. Estes webhooks enviam as alterações de stock, compras e procura para o SkyPlanner à medida que ocorrem.

As ordens de fabrico e as etapas da gama operatória são lidas periodicamente. Filtre ShopOrders e ShopOrderRoutingStepPlans pelo campo Modified e utilize a Sync API para leituras em massa (restrições da API).

O SkyPlanner envia os seus próprios webhooks quando a programação muda, pelo que os dados são enviados de volta para o Exact Online em resposta a eventos.

Mapeamento de dados

Recurso do Exact OnlineObjeto do SkyPlannerSentidoFrequência
ItemsProdutos e materiaisExact Online → SkyPlannerCarregamento inicial, depois por webhook
BillOfMaterialVersions, BillOfMaterialMaterialsEstrutura do produto, subprodutos, materiais por produtoExact Online → SkyPlannerQuando há alterações
Workcenters, OperationResourcesCentros de trabalho, grupos de centros de trabalhoExact Online → SkyPlannerCarregamento inicial
Operations, BillOfMaterialRoutingsEtapas do processo com tempos de preparação e de execuçãoExact Online → SkyPlannerQuando há alterações
ShopOrdersOrdens com quantidade e prazo de conclusãoExact Online → SkyPlannerA intervalos de poucos minutos
ShopOrderRoutingStepPlansTarefas com sequência, centro de trabalho e horas de preparação e de execuçãoExact Online → SkyPlannerA intervalos de poucos minutos
ShopOrderMaterialPlansMateriais por tarefaExact Online → SkyPlannerA intervalos de poucos minutos
ItemWarehouses, StockPositionSaldos de stockExact Online → SkyPlannerPor webhook
PurchaseOrderLinesEncomendas de compra com data de entrega previstaExact Online → SkyPlannerWebhook
SalesOrderLinesPrazos de entrega ao cliente e prioridadeExact Online → SkyPlannerWebhook
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT)Início, fim e centro de trabalho previstos para cada operaçãoSkyPlanner → Exact OnlineA cada alteração, via webhook
ShopOrders: PlannedStartDate, PlannedDate (PUT)Início e fim da ordem de fabricoSkyPlanner → Exact OnlineA cada alteração, via webhook
TimeTransactions (POST)Registos de tempos e confirmações dos operadoresSkyPlanner → Exact OnlinePor confirmação ou por turno
ShopOrderReceipts (POST)Quantidade concluída na última operaçãoSkyPlanner → Exact OnlinePor confirmação
Não armazenados no Exact OnlineMatriz de tempos de preparação, ferramentas como recursos de capacidade finita, operadores por tarefa, centros de trabalho alternativos, turnosGeridos no SkyPlannerConfiguração inicial

Modelos de integração

1. Carregamento inicial dos dados mestre. Leia Workcenters, Operations e OperationResources e, em seguida, os artigos e as versões das BOM com as respetivas gamas operatórias. Um centro de trabalho com três máquinas passa a corresponder a três centros de trabalho ou a um grupo de centros de trabalho. Os turnos, as ausências e as horas extraordinárias são configurados no SkyPlanner, porque o centro de trabalho do Exact tem um único valor de capacidade.

2. Sincronização das ordens. Leia as ShopOrders em aberto com os respetivos ShopOrderRoutingStepPlans e ShopOrderMaterialPlans, bem como as existências e as linhas das encomendas de compra. A programação tem em conta tanto as existências como as compras por receber. O MRP continua a gerar sugestões de ordens no Exact Online, e o SkyPlanner programa as ordens de fabrico que criar.

3. Envio da programação para o ERP. Por cada operação da gama operatória que o motor tenha programado ou deslocado, o SkyPlanner envia um pedido PUT para ShopOrderRoutingStepPlans com PlannedStartDate, PlannedEndDate e Workcenter. Os campos PlannedStartDate e PlannedDate da ordem de fabrico correspondem, respetivamente, ao início da primeira operação e ao fim da última. O Exact Online mantém as quantidades, os planos de materiais e o cálculo de custos.

4. Confirmações no chão de fábrica. Os operadores registam o trabalho com SkyPlanner Mobile Confirmations ou Production Timer, e os registos de tempos mantêm a programação atualizada. As horas registadas são lançadas como TimeTransactions, associadas à ordem de fabrico e à operação da gama operatória, como preparação ou execução. A confirmação final lança um registo ShopOrderReceipts com a quantidade concluída. Se a sua fábrica já regista tempos no Shop Floor Control, escolha um único canal de registo.

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

DadosSistema responsável
Artigos, BOM, quantidades das ordens de fabrico, planos de materiais, custosExact Online
Sequência das operações da gama operatória, horas de início e de fim, atribuição do centro de trabalhoSkyPlanner
Matriz de tempos de preparação, ferramentas, operadores por tarefa, recursos alternativos, turnosSkyPlanner
Registos de tempos e entradas de produto acabadoExact Online, com dados enviados pelo SkyPlanner

A principal fonte de conflitos são as alterações manuais de datas. Se os responsáveis pelo planeamento continuarem a alterar as datas das ordens de fabrico no Exact Online, as datas ficam sob o controlo de dois sistemas. Deixe a gestão das datas das operações da gama operatória a cargo do SkyPlanner. Com Autopilot, o SkyPlanner reprograma automaticamente quando há alterações na produção.

Etapas habituais do projeto

A implementação fica normalmente concluída em poucas semanas após o início da configuração inicial. Antes disso, valide a programação durante o período de avaliação gratuita de 30 dias, com uma exportação em CSV ou Excel das ordens de fabrico em aberto e das operações das gamas operatórias. O projeto segue depois estas etapas:

  1. Definição do âmbito. Confirme a edição, as divisões, as frequências de sincronização, o canal de registo de tempos e o lançamento das entradas de produto acabado.
  2. Aplicação e consentimento. Registe a aplicação. Em seguida, um utilizador do Exact Online concede o consentimento OAuth para cada divisão.
  3. Carregamento inicial. Centros de trabalho, operações, artigos, versões das BOM e gamas operatórias.
  4. Sincronização das ordens. Ordens de fabrico, planos das operações das gamas operatórias e planos de materiais a intervalos definidos; existências e compras via webhook.
  5. Configuração das restrições no SkyPlanner. Turnos, matriz de tempos de preparação, ferramentas, número de operadores por tarefa e máquinas ou pessoal alternativos.
  6. Envio da programação para o ERP. Envio das datas previstas das operações das gamas operatórias para o Exact Online, seguido dos registos de tempos e das entradas de produto acabado.
  7. Testes em paralelo e entrada em produção. Compare as datas com o plano atual, corrija os dados mestre e, em seguida, ative o envio de dados para o ERP.

O que prever numa integração com o Exact Online

  • Tempos das operações. Os valores de PlannedSetupHours e PlannedRunHours vêm da gama operatória da BOM. Comece por compará-los com os tempos reais de execução.
  • Agrupamento de centros de trabalho. O Exact guarda um único valor de capacidade por centro de trabalho. Decida, para cada centro, se vai corresponder a um centro de trabalho no SkyPlanner, a vários ou a um grupo.
  • Calendários. Os turnos, os feriados e as ausências são geridos no SkyPlanner. Configure-os antes de gerar a primeira programação.
  • Limites de chamadas. O Exact limita as chamadas por aplicação e empresa e exige chamadas sequenciais. Utilize webhooks quando existirem tópicos disponíveis, $filter sobre Modified e a Sync API para leituras em massa.
  • Várias divisões. Cada divisão do Exact Online é uma empresa com um caminho e um consentimento próprios. Associe cada fábrica à respetiva divisão.
  • Ordens de fabrico lançadas. Acorde em que estados o SkyPlanner pode alterar as datas: ordens em aberto e lançadas, ou apenas ordens em aberto.
  • Um único responsável pelas datas. Deixe de alterar manualmente as datas no Exact Online assim que o SkyPlanner passar a gerir as datas das operações das gamas operatórias.

Exact Globe+

O Exact Globe+ é o ERP da Exact comercializado e implementado através de parceiros Exact Globe+. A Exact afirma que o produto “koppelt eenvoudig en snel met andere systemen” (liga-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, gamas operatórias, recursos e existências, e devolve datas previstas e horas registadas. O seu parceiro Exact Globe+ e a equipa SkyPlanner acordam a interface e os objetos a atualizar no ERP durante a definição do âmbito.

Integração com o Exact Online: quem a configura e presta suporte

  1. A equipa SkyPlanner configura a integração durante a fase de arranque e presta suporte após a entrada em produção.
  2. O seu parceiro Exact pode participar. O parceiro conhece as suas edições, divisões e configuração de fabrico.
  3. Os seus programadores podem desenvolver soluções com base nesta integração utilizando a REST API documentada do SkyPlanner. Basta um token de API para começar, e a equipa SkyPlanner presta assistência quando necessário.

Depois de estabelecida a ligação, o motor Arcturus programa a produção com base nas ordens de fabrico atualizadas do Exact Online, e as datas previstas são registadas em cada operação da gama operatória. O SkyPlanner está disponível a partir de 199 € por mês, com 5 centros de trabalho incluídos e faturação mensal. O orçamento da integração é apresentado antecipadamente, de acordo com o seu processo e as suas necessidades, juntamente com o seu plano, para que conheça o custo total antes de começar. Consulte os preços, as funcionalidades e veja como o planeamento do próprio Exact Online se compara em programação da produção no Exact Online com respeito pela capacidade real das máquinas e do pessoal. Encontra uma visão geral na página do Exact Online e outros ERP na área de integrações com ERP.

Opiniões de fabricantes sobre o SkyPlanner

Menos paragens por falta de materiais

“O valor que o SkyPlanner nos traz está em ser uma ferramenta que funciona no dia a dia, sobretudo na definição de datas de entrega.”

Tommi Männistö, responsável pelo planeamento da produção
Eskomatic · Maquinação por subcontratação

A programação automática da carga permite definir datas de entrega mais precisas, e as paragens de produção por falta de materiais diminuíram acentuadamente.

Ler o testemunho da Eskomatic

Hannu Ryynänen, diretor executivo da Mamec, no pavilhão de produção da empresa em Lohja

Milhares (1.000s) de ordens de fabrico programadas automaticamente

“Temos agora outro controlo sobre a produção, e a nossa compreensão da capacidade está num patamar completamente diferente.”

Hannu Ryynänen, diretor executivo
Mamec · Misturadores industriais, bombas e fabrico de alta tecnologia por subcontratação

Milhares de ordens de fabrico são programadas automaticamente, com uma visão da produção em tempo real para toda a organização.

Ler o testemunho da Mamec

Perguntas frequentes

A API do Exact Online inclui ordens de fabrico e operações das gamas operatórias?

Sim. O serviço de fabrico disponibiliza ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters, Operations e recursos BOM, todos com acesso de leitura e escrita. Os tempos são registados através de TimeTransactions e as quantidades concluídas através de ShopOrderReceipts.

Como são gravadas as datas planeadas no Exact Online?

O SkyPlanner envia um pedido PUT para ShopOrderRoutingStepPlans com PlannedStartDate, PlannedEndDate e Workcenter para cada operação que programa ou desloca. Os campos PlannedStartDate e PlannedDate da ordem de fabrico são atualizados em conformidade.

Quem desenvolve a integração com o Exact Online?

Durante a implementação, a equipa do SkyPlanner configura a integração bidirecional de acordo com a sua configuração do Exact Online e presta suporte após a entrada em produção. O seu parceiro Exact pode participar. Os seus próprios programadores também podem desenvolver a integração com base na 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 relativas a artigos, posições de stock, encomendas de compra e encomendas de venda. As ordens de fabrico e as operações das gamas operatórias são consultadas a intervalos curtos, através de pedidos filtrados. No sentido inverso, os webhooks do SkyPlanner enviam as alterações à programação à medida que ocorrem.

Podemos testar o SkyPlanner antes de desenvolver a integração?

Sim. O período de teste gratuito de 30 dias permite utilizar até 20 centros de trabalho e importar as suas ordens de fabrico em CSV ou Excel, sem necessidade de cartão de crédito. Comece o teste ou fale com a equipa comercial para definir o âmbito da integração.