Integrações / ERP / Monitor ERP
Guia de integração do Monitor ERP para programação da produção com o SkyPlanner APS
Este guia de integração do Monitor ERP mostra aos parceiros e às equipas de TI como ligar o Monitor ERP (Monitor G5) ao SkyPlanner APS. O SkyPlanner integra-se com o Monitor ERP nos dois sentidos através da Monitor ERP API:
- São importadas ordens de fabrico, operações, centros de trabalho, gamas operatórias e materiais.
- O início previsto, o fim previsto e o centro de trabalho de cada operação são escritos no Monitor.
- Os tempos e as quantidades registados mantêm os dois sistemas sincronizados.
- Os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
Durante a implementação inicial, a equipa do SkyPlanner configura a integração de acordo com a configuração do seu Monitor G5 e presta suporte após a entrada em produção. Este guia destina-se a parceiros e programadores que pretendam participar ou desenvolver as suas próprias soluções com a REST API documentada do SkyPlanner (referência da API).
A Monitor ERP API
A interface de integração documentada do Monitor G5 é a Monitor ERP API v1. Combina CQRS e REST, com JSON sobre HTTPS. (Monitor ERP API)
- As consultas leem dados com GET. Aceitam opções ao estilo OData:
$filter,$select,$expand,$orderby,$tope$skip. - Os comandos escrevem dados com POST, por exemplo
Manufacturing/ManufacturingOrderOperations/Update. - O Batch executa vários comandos numa única transação através de
POST /api/v1/Batch: ou são todos aplicados, ou nenhum é aplicado. Acrescente/Simulateou/Validatepara testar um lote e reverter a transação. Esta é a forma segura de escrever toda a programação. (Batch)
O URL base é https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. O número da empresa combina o número da base de dados com o identificador da empresa, por exemplo 004.1.
Sobre o licenciamento, a Monitor afirma: “It is free to query and extract information from the API for all our customers. However, in order to use commands and write data to the ERP system, you need to purchase Monitor ERP API.” (Todos os clientes podem consultar e extrair informação da API gratuitamente. No entanto, para utilizar comandos e escrever dados no sistema ERP, é necessário adquirir a Monitor ERP API.) Preveja a licença de escrita no projeto desde o primeiro dia. (api.monitor.se)
Autenticação
- Início de sessão. Um pedido
POST /{languageCode}/{companyNumber}/logincom o nome de utilizador e a palavra-passe de um utilizador do Monitor devolve um cabeçalhoX-Monitor-SessionIdpara as chamadas seguintes. Está disponível um fluxo com token MFA. - OIDC. A partir do Monitor 25.8, também é possível iniciar sessão através do Microsoft Entra ID com Authorization Code e PKCE. (Autenticação)
- Utilizador dedicado à API. Crie um utilizador para a integração. Aplicam-se as permissões do próprio Monitor, como Show manufacturing orders e Replan existing manufacturing order.
No SkyPlanner, a REST API utiliza um token de API para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração explica passo a passo as primeiras chamadas.
Deteção de alterações e polling
A referência da Monitor ERP API não documenta webhooks nem subscrições de eventos. As alterações são detetadas por polling:
Common/EntityChangeLogs(a partir da versão 2.33) devolveChangeType(Update, Create, Delete),EntityTypeId,EntityIdeModifiedTimestamp. Consulte este recurso em intervalos de poucos minutos e obtenha apenas os registos alterados. (EntityChangeLog)- Filtre as consultas de ordens de fabrico para incluir apenas ordens em aberto e utilize
$tope$skippara paginar os resultados.
O SkyPlanner envia webhooks quando o estado ou a programação mudam, pelo que a escrita de dados no Monitor é acionada por eventos.
Mapeamento de dados
| Objeto do Monitor ERP (API) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
Part (Inventory/Parts) | Produtos e materiais | Monitor → SkyPlanner | Carregamento inicial; depois, através do registo de alterações |
BOM e gama operatória: Manufacturing/MaterialRows, Manufacturing/OperationRows | Estrutura do produto; etapas do processo com tempos de preparação e tempos unitários | Monitor → SkyPlanner | Carregamento inicial; depois, sempre que houver alterações |
Manufacturing/AlternativeOperationRows | Centros de trabalho alternativos por etapa | Monitor → SkyPlanner | Carregamento inicial; depois, sempre que houver alterações |
Centro de trabalho (Manufacturing/WorkCenters): Type, TimePrecision, BasicTime, NumberOfPlanningUnits, AvailabilityFactor | Centros de trabalho, grupos de centros de trabalho e eficiências | Monitor → SkyPlanner | Carregamento inicial; raramente depois |
Manufacturing/ProductionCalendarExceptions, TimeRecording/Schedules | Turnos e ausências | Monitor → SkyPlanner | Diariamente, ou com turnos próprios no SkyPlanner |
Manufacturing/ManufacturingOrders, ManufacturingOrderNodes | Ordens com prazos e estado | Monitor → SkyPlanner | Polling do registo de alterações em intervalos de poucos minutos |
Manufacturing/ManufacturingOrderOperations: Priority, WorkCenterId, PlannedQuantity, RestQuantity, PlannedSetupTime, PlannedUnitTime | Trabalhos com duração e quantidade restante | Monitor → SkyPlanner | Polling do registo de alterações em intervalos de poucos minutos |
Manufacturing/ManufacturingOrderMaterials | Necessidades de materiais por ordem | Monitor → SkyPlanner | Polling do registo de alterações |
Inventory/PartLocations (Balance), Purchase/PurchaseOrderRows (DeliveryDate, RestQuantity) | Existências; materiais a receber na respetiva data de entrega | Monitor → SkyPlanner | Polling de hora a hora ou ao executar a programação |
ManufacturingOrderOperations/Update: PlannedStartDate, PlannedFinishDate (24.5+) | Início e fim previstos por operação | SkyPlanner → Monitor | Quando a programação muda, através de um webhook do SkyPlanner |
ManufacturingOrderOperations/SetWorkCenter | Centro de trabalho escolhido pelo motor | SkyPlanner → Monitor | Quando a programação muda |
ReportManufacturingOrderOperation / ManufacturingOrderOperationReportings | Registos de tempos e quantidades | Um canal, escolhido na definição do âmbito | Por confirmação ou por turno |
| Não existe no Monitor | Matriz de tempos de preparação, ferramentas como recursos finitos, trabalhos com vários operadores | Gerido no SkyPlanner | Configurado durante a implementação inicial |
Modelos de integração
1. Carregamento inicial dos dados mestre. Leia os centros de trabalho, as linhas de operações, as linhas de operações alternativas, as linhas de materiais, os artigos e os horários. Defina criteriosamente a correspondência entre cada centro de trabalho e um centro de trabalho do SkyPlanner. Um centro de trabalho do tipo Pool passa a ser um grupo de centros de trabalho. Os centros de trabalho que o integram passam a ser os centros de trabalho entre os quais o motor escolhe.
2. Sincronização de ordens. Leia as ordens de fabrico em aberto com os respetivos nós, operações e materiais, bem como as existências e as encomendas de compra em aberto. 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. Após o primeiro carregamento, as atualizações incrementais baseiam-se em Common/EntityChangeLogs.
3. Escrita da programação no Monitor. Para cada operação que o motor programou ou deslocou, o SkyPlanner envia ManufacturingOrderOperations/Update com PlannedStartDate e PlannedFinishDate. Quando o motor desloca uma operação para outra máquina de um grupo, SetWorkCenter é enviado primeiro. Os comandos de uma ordem são enviados num único Batch, pelo que o Monitor os aceita todos ou não aceita nenhum. Durante os testes, execute o lote através de /Validate.
Nas versões do Monitor anteriores à 24.5, não é possível escrever as datas previstas através de Update. Em alternativa, utilize ManufacturingOrders/ReplanOperation (a partir da versão 2.40) com StartDate e FinishDate e configure RestrictToOrderBounds de acordo com as suas regras.
4. Confirmações na fábrica. Mantenha um único canal de registo:
- O Monitor continua a ser o canal de registo. Os operadores registam o trabalho no Recording terminal ou através da integração com as máquinas, como fazem atualmente. O SkyPlanner lê
ManufacturingOrderOperationReportingspara acompanhar o progresso e reprograma a produção. - O SkyPlanner passa a ser o canal de registo. Os operadores registam o trabalho com Mobile Confirmations ou Production Timer, e o SkyPlanner envia
ReportManufacturingOrderOperationpara o Monitor.
Registar o trabalho nos dois sistemas duplica os tempos e as quantidades.
5. Responsabilidade pelos dados e regras de conflito. Documente-as antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Artigos, BOM e gama operatória, quantidades, estado das ordens | Monitor |
| Sequência das operações, início e fim planeados, centro de trabalho dentro de um grupo | SkyPlanner |
| Matriz de tempos de preparação, ferramentas, número de operadores, recursos alternativos | SkyPlanner |
| Turnos e ausências | Um sistema, escolhido na definição do âmbito |
| Registo de operações | Um canal, escolhido na definição do âmbito |
A principal fonte de conflitos é os responsáveis pelo planeamento continuarem a alterar o plano de prioridades. A função Rescheduling according to New finish e o arrastamento de linhas em Priority planning substituem as datas gravadas pelo SkyPlanner. Quando o SkyPlanner passa a gerir a sequência, Priority planning serve apenas para consulta. Com Autopilot, o SkyPlanner reprograma automaticamente sempre que 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 do acompanhamento inicial. Antes disso, pode usar os seus próprios dados no período de teste gratuito de 30 dias. Exporte do Monitor para Excel as operações das ordens de fabrico em aberto e os centros de trabalho, importe-os e valide a programação antes de iniciar qualquer trabalho de integração.
O projeto em si inclui:
- Definição do âmbito. Defina a tabela de correspondências, as regras sobre o sistema responsável por cada dado, os intervalos de consulta, o canal de registo e a versão do Monitor.
- Acesso. Crie o utilizador da API, adquira a licença de escrita da Monitor ERP API e permita o acesso de rede à porta 8001.
- Carregamento inicial. Artigos, centros de trabalho, linhas de operações, alternativas, materiais e horários de produção.
- Sincronização de ordens e encomendas de compra com base no registo de alterações.
- Configuração das restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, número de operadores e máquinas ou pessoal alternativos.
- Escrita da programação no sistema de origem por lotes, testada com
/Validate. - Testes em paralelo. Execute o SkyPlanner em paralelo com o plano de prioridades, compare datas e corrija os dados mestre.
- Entrada em produção. Ative a escrita no sistema de origem quando os dados coincidirem.
O que acautelar numa integração com o Monitor ERP
- Fator de disponibilidade. O Monitor aplica o fator de disponibilidade para converter a capacidade bruta em líquida. O valor predefinido para um novo centro de trabalho é 80 %. Aplique-o uma única vez: como eficiência no SkyPlanner ou através de turnos mais curtos, nunca das duas formas.
- Precisão dos horários. Os centros de trabalho em Day planning expressam a capacidade como tempo base por dia, sem horários de turnos. Configure no SkyPlanner os turnos reais a partir dos horários de produção, para que os trabalhos sejam programados dentro do horário de trabalho.
- Tempo de espera e sobreposição. As linhas de operações incluem o tempo de espera e a sobreposição em %. Decida, na definição do âmbito, como cada um será representado no SkyPlanner; caso contrário, os prazos de produção mudarão após a entrada em produção.
- Grupos. Os centros de trabalho agrupados são planeados em Pool planning, não em Priority planning. Leia os centros de trabalho que compõem o grupo, não apenas a linha do grupo.
- Requisitos de versão. A escrita de datas planeadas através de Update exige a versão 24.5. Os campos de capacidade dos centros de trabalho na API exigem a versão 24.3, e OIDC exige a versão 25.8. Verifique a compilação antes da definição do âmbito.
- Rede e certificado. Numa instalação local, o Monitor disponibiliza a API na porta 8001 com um certificado autoassinado. O SkyPlanner funciona na nuvem, por isso preveja uma regra de firewall ou um retransmissor e configure explicitamente a confiança no certificado.
- Licenças. Cada aplicação de terceiros que escreva dados precisa dos seus próprios utilizadores com licença de API. Todos os sistemas incluem um utilizador de API apenas de leitura.
Integração com o Monitor ERP: quem a configura e presta suporte
O trabalho inclui mapear os seus centros de trabalho, linhas de operações e fluxo de ordens, bem como configurar as restrições que o Monitor não guarda: matriz de tempos de preparação, ferramentas, número de operadores e recursos alternativos.
- A equipa SkyPlanner configura a integração durante o acompanhamento inicial e presta suporte após a entrada em produção, tanto do lado do SkyPlanner como nas chamadas acordadas à Monitor ERP API. Cada fábrica utiliza o Monitor G5 de forma diferente, e é aqui que esse conhecimento é aplicado.
- O seu parceiro Monitor pode participar. O parceiro conhece a sua configuração, versão e permissões e pode preparar o utilizador da API, a licença e o acesso de rede. O SkyPlanner disponibiliza a REST API, documentação Swagger/OpenAPI e webhooks.
- Os seus próprios programadores também podem desenvolver a integração com a mesma REST API documentada, usando um token de API. Basta um token de API para começar, e a equipa SkyPlanner presta apoio quando necessário. A documentação pública está disponível na documentação do SkyPlanner.
Após a ligação, o motor Arcturus programa a produção com base nas ordens atualizadas do Monitor, e as datas planeadas são gravadas nas operações das ordens de fabrico. O SkyPlanner está disponível a partir de 199 € por mês, com 5 centros de trabalho incluídos e faturação mensal. A integração é orçamentada antecipadamente em função do seu processo e das suas necessidades, juntamente com o seu plano, para que conheça o custo total antes de começar. Consulte os preços, compare com o planeamento do próprio Monitor em programação da produção no Monitor ERP com capacidade real de máquinas e pessoal, veja a apresentação geral na página do Monitor ERP e descubra outros ERP na área de integrações ERP.
Opiniões de fabricantes sobre o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, passámos do planeamento da produção em folhas de Excel para a otimização da produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de abastecimento
UTU · Quadros elétricos e aparelhagem de manobra
O planeamento da produção poupa 2 horas de trabalho por semana, e uma nova fila de trabalhos chega à linha em segundos.
+90%de eficiência na produção
“A eficiência na produção aumentou 90%.”
Abdul Rucyinga, responsável de TI
Laboratory & Allied · Fabrico de produtos farmacêuticos
A eficiência na produção aumentou 90%, e criar um plano otimizado de três meses para todos os centros de trabalho demora menos de 30 minutos.
1.000+ ordens de fabrico programadas automaticamente
“A forma como controlamos a produção mudou, e o nosso conhecimento da capacidade está num nível completamente diferente.”
Hannu Ryynänen, diretor executivo
Mamec · Misturadores industriais, bombas e fabrico por contrato de alta tecnologia
Milhares de ordens de fabrico são programadas automaticamente, com uma visão da produção em tempo real para toda a organização.
6 mesesde capacidade disponível visível para a equipa comercial
“O SkyPlanner dá a base e a fiabilidade necessárias a todo o planeamento da produção.”
Anu Järvinen, responsável de produção
Fredman Operations · Papéis de embalagem próprios para contacto com alimentos
A equipa comercial vê a capacidade disponível com seis meses de antecedência, e os pedidos de alteração da programação que antes demoravam uma hora ou mais têm agora resposta em segundos.
Perguntas frequentes
O Monitor ERP tem uma API para ordens de fabrico?
Sim. A Monitor ERP API disponibiliza Manufacturing/ManufacturingOrders, ManufacturingOrderNodes, ManufacturingOrderOperations e ManufacturingOrderMaterials para consulta. Comandos como ManufacturingOrderOperations/Update e ReplanOperation permitem gravar as datas planeadas no Monitor.
A escrita no Monitor através da API exige uma licença adicional?
Sim. A leitura através da API é gratuita para todos os clientes Monitor. Os comandos que escrevem dados exigem a Monitor ERP API, comercializada pela Monitor. O seu parceiro Monitor ou a equipa comercial da Monitor fornece o orçamento.
A Monitor ERP API suporta webhooks?
Não existem webhooks documentados. A integração consulta Common/EntityChangeLogs de poucos em poucos minutos e obtém apenas os registos alterados. No sentido inverso, os webhooks do próprio SkyPlanner enviam as alterações à programação à medida que ocorrem.
De que versão do Monitor precisamos?
A escrita do início e do fim planeados através de ManufacturingOrderOperations/Update exige o Monitor 24.5 ou posterior. As compilações G5 mais antigas, a partir da 2.40, usam ReplanOperation. Confirmamos a opção adequada à sua compilação durante a definição do âmbito.
Quem desenvolve a integração com o Monitor ERP?
A equipa SkyPlanner configura a integração bidirecional para a sua instalação do Monitor G5 durante o acompanhamento inicial e presta suporte após a entrada em produção. O seu parceiro Monitor ou os seus próprios programadores também podem desenvolver a integração com a REST API documentada do SkyPlanner. Basta um token de API para começar.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O teste gratuito de 30 dias permite usar até 20 centros de trabalho, com importações de Excel ou CSV do Monitor, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipa comercial para definir o âmbito da integração.
