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.
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:
| Recurso | Dados incluídos | Métodos |
|---|---|---|
manufacturing/ShopOrders | Número da ordem de fabrico, artigo, PlannedQuantity, PlannedStartDate, PlannedDate, estado, indicador de libertação | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | Etapa da gama operatória por ordem de fabrico: operação, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | Linhas de materiais por ordem de fabrico | GET, POST, PUT, DELETE |
manufacturing/Workcenters | Código, tipo, área de produção, valor da capacidade, tarifas | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | Operações e respetivos centros de trabalho, tempos de preparação e de execução | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | Versões da BOM, componentes e gama operatória | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | Horas registadas por ordem de fabrico e etapa da gama operatória | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | Quantidades de produtos acabados recebidas de uma ordem de fabrico | GET, POST |
manufacturing/MaterialIssues | Material fornecido a uma ordem de fabrico | GET, POST |
manufacturing/ShopOrderPriorities | Modo de prioridade por ordem de fabrico | GET, PUT |
Nos restantes serviços:
| Recurso | Dados incluídos |
|---|---|
logistics/Items | Dados mestre dos artigos |
inventory/ItemWarehouses | Stock por artigo e armazém |
purchaseorder/PurchaseOrders, PurchaseOrderLines | Encomendas a fornecedores em aberto e datas de receção |
salesorder/SalesOrders, SalesOrderLines | Procura 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 Online | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
Items | Produtos e materiais | Exact Online → SkyPlanner | Carregamento inicial, depois por webhook |
BillOfMaterialVersions, BillOfMaterialMaterials | Estrutura do produto, subprodutos, materiais por produto | Exact Online → SkyPlanner | Quando há alterações |
Workcenters, OperationResources | Centros de trabalho, grupos de centros de trabalho | Exact Online → SkyPlanner | Carregamento inicial |
Operations, BillOfMaterialRoutings | Etapas do processo com tempos de preparação e de execução | Exact Online → SkyPlanner | Quando há alterações |
ShopOrders | Ordens com quantidade e prazo de conclusão | Exact Online → SkyPlanner | A intervalos de poucos minutos |
ShopOrderRoutingStepPlans | Tarefas com sequência, centro de trabalho e horas de preparação e de execução | Exact Online → SkyPlanner | A intervalos de poucos minutos |
ShopOrderMaterialPlans | Materiais por tarefa | Exact Online → SkyPlanner | A intervalos de poucos minutos |
ItemWarehouses, StockPosition | Saldos de stock | Exact Online → SkyPlanner | Por webhook |
PurchaseOrderLines | Encomendas de compra com data de entrega prevista | Exact Online → SkyPlanner | Webhook |
SalesOrderLines | Prazos de entrega ao cliente e prioridade | Exact Online → SkyPlanner | Webhook |
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT) | Início, fim e centro de trabalho previstos para cada operação | SkyPlanner → Exact Online | A cada alteração, via webhook |
ShopOrders: PlannedStartDate, PlannedDate (PUT) | Início e fim da ordem de fabrico | SkyPlanner → Exact Online | A cada alteração, via webhook |
TimeTransactions (POST) | Registos de tempos e confirmações dos operadores | SkyPlanner → Exact Online | Por confirmação ou por turno |
ShopOrderReceipts (POST) | Quantidade concluída na última operação | SkyPlanner → Exact Online | Por confirmação |
| Não armazenados no Exact Online | Matriz de tempos de preparação, ferramentas como recursos de capacidade finita, operadores por tarefa, centros de trabalho alternativos, turnos | Geridos no SkyPlanner | Configuraçã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:
| Dados | Sistema responsável |
|---|---|
| Artigos, BOM, quantidades das ordens de fabrico, planos de materiais, custos | Exact Online |
| Sequência das operações da gama operatória, horas de início e de fim, atribuição do centro de trabalho | SkyPlanner |
| Matriz de tempos de preparação, ferramentas, operadores por tarefa, recursos alternativos, turnos | SkyPlanner |
| Registos de tempos e entradas de produto acabado | Exact 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:
- 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.
- Aplicação e consentimento. Registe a aplicação. Em seguida, um utilizador do Exact Online concede o consentimento OAuth para cada divisão.
- Carregamento inicial. Centros de trabalho, operações, artigos, versões das BOM e gamas operatórias.
- 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.
- 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.
- 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.
- 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
PlannedSetupHoursePlannedRunHoursvê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,
$filtersobreModifiede 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
- A equipa SkyPlanner configura a integração durante a fase de arranque e presta suporte após a entrada em produção.
- O seu parceiro Exact pode participar. O parceiro conhece as suas edições, divisões e configuração de fabrico.
- 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.
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.
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.