Integrações / ERP / Monitor ERP
Guia de integração do Monitor ERP para programação da produção com SkyPlanner APS
Este guia de integração do Monitor ERP mostra a parceiros e equipes de TI como conectar o Monitor ERP (Monitor G5) ao SkyPlanner APS. O SkyPlanner se integra ao Monitor ERP nos dois sentidos por meio da Monitor ERP API:
- Ordens de produção, operações, centros de trabalho, roteiros de produção e materiais são importados para o SkyPlanner.
- O início planejado, o término planejado e o centro de trabalho de cada operação são gravados de volta no Monitor.
- Os tempos e as quantidades apontados mantêm os dois sistemas sincronizados.
- Os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
A equipe do SkyPlanner configura a integração de acordo com o seu ambiente Monitor G5 durante a implantação e oferece suporte após a entrada em produção. Este guia é para parceiros e desenvolvedores que querem participar desse trabalho ou desenvolver a integração por conta própria usando 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. Ela combina CQRS e REST, com JSON sobre HTTPS. (Monitor ERP API)
- Consultas leem dados com GET. Elas aceitam opções no estilo OData:
$filter,$select,$expand,$orderby,$tope$skip. - Comandos gravam dados com POST, por exemplo,
Manufacturing/ManufacturingOrderOperations/Update. - Batch executa vários comandos em uma única transação do tipo tudo ou nada por meio de
POST /api/v1/Batch. Acrescente/Simulateou/Validatepara testar um lote e reverter a transação. Essa é a forma segura de gravar toda a programação. (Batch)
A URL base é https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. O número da empresa combina o número do banco de dados e o ID da empresa, por exemplo, 004.1.
Sobre o licenciamento, a Monitor informa: “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 nossos clientes podem consultar e extrair informações da API gratuitamente. Porém, para usar comandos e gravar dados no sistema ERP, é necessário adquirir a Monitor ERP API.) Inclua a licença de gravação no planejamento do projeto desde o primeiro dia. (api.monitor.se)
Autenticação
- Login de sessão. Uma chamada a
POST /{languageCode}/{companyNumber}/logincom o nome de usuário e a senha de um usuário do Monitor retorna um cabeçalhoX-Monitor-SessionIdpara as chamadas seguintes. Também está disponível um fluxo com token de MFA. - OIDC. A partir do Monitor 25.8, o login também pode ser feito pelo Microsoft Entra ID com Authorization Code e PKCE. (Autenticação)
- Usuário exclusivo para a API. Crie um usuário para a integração. As permissões do próprio Monitor se aplicam a ele, como Show manufacturing orders e Replan existing manufacturing order.
No SkyPlanner, a REST API usa um token de API para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração orienta você nas primeiras chamadas.
Detecção de alterações e consultas periódicas
A documentação de referência da Monitor ERP API não apresenta webhooks nem assinaturas de eventos. As alterações são identificadas por consultas periódicas:
Common/EntityChangeLogs(a partir da versão 2.33) retornaChangeType(Update, Create, Delete),EntityTypeId,EntityIdeModifiedTimestamp. Consulte esse endpoint a cada poucos minutos e busque apenas os registros alterados. (EntityChangeLog)- Filtre as consultas de ordens de produção para buscar apenas as ordens em aberto e faça a paginação com
$tope$skip.
O SkyPlanner envia webhooks quando há alterações de estado ou na programação. Assim, a gravação de dados de volta 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 | Carga inicial; depois, pelo registro de alterações |
BOM e roteiro de produção: Manufacturing/MaterialRows, Manufacturing/OperationRows | Estrutura do produto; etapas do processo com tempos de preparação e por unidade | Monitor → SkyPlanner | Carga inicial; depois, a cada alteração |
Manufacturing/AlternativeOperationRows | Centros de trabalho alternativos por etapa | Monitor → SkyPlanner | Carga inicial; depois, a cada alteração |
Centro de trabalho (Manufacturing/WorkCenters): Type, TimePrecision, BasicTime, NumberOfPlanningUnits, AvailabilityFactor | Centros de trabalho, grupos de centros de trabalho e eficiências | Monitor → SkyPlanner | Carga inicial; raramente depois disso |
Manufacturing/ProductionCalendarExceptions, TimeRecording/Schedules | Turnos e ausências | Monitor → SkyPlanner | Diariamente, ou com turnos próprios no SkyPlanner |
Manufacturing/ManufacturingOrders, ManufacturingOrderNodes | Ordens com prazos de entrega e status | Monitor → SkyPlanner | Consulta ao registro de alterações a cada poucos minutos |
Manufacturing/ManufacturingOrderOperations: Priority, WorkCenterId, PlannedQuantity, RestQuantity, PlannedSetupTime, PlannedUnitTime | Tarefas com duração e quantidade restante | Monitor → SkyPlanner | Consulta ao registro de alterações a cada poucos minutos |
Manufacturing/ManufacturingOrderMaterials | Necessidades de materiais por ordem | Monitor → SkyPlanner | Consulta periódica ao registro de alterações |
Inventory/PartLocations (Balance), Purchase/PurchaseOrderRows (DeliveryDate, RestQuantity) | Estoque; materiais a receber na respectiva data de entrega | Monitor → SkyPlanner | Consulta a cada hora ou ao executar a programação |
ManufacturingOrderOperations/Update: PlannedStartDate, PlannedFinishDate (24.5+) | Início e término planejados por operação | SkyPlanner → Monitor | A cada alteração na programação, via webhook do SkyPlanner |
ManufacturingOrderOperations/SetWorkCenter | Centro de trabalho escolhido pelo motor de programação | SkyPlanner → Monitor | A cada alteração na programação |
ReportManufacturingOrderOperation / ManufacturingOrderOperationReportings | Apontamentos de tempo e quantidades | Um único canal, escolhido na definição de escopo | A cada confirmação ou por turno |
| Não consta no Monitor | Matriz de tempos de preparação, ferramentas como recursos finitos, tarefas com vários operadores | Mantidos no SkyPlanner | Configurados durante a implantação |
Padrões de integração
1. Carga inicial de dados mestres. Leia os centros de trabalho, as linhas de operações, as linhas de operações alternativas, as linhas de materiais, os itens e as escalas de trabalho. Defina com cuidado o mapeamento de cada centro de trabalho para um centro de trabalho do SkyPlanner. Um centro de trabalho do tipo Pool se torna um grupo de centros de trabalho, e os centros de trabalho que ele reúne se tornam as opções entre as quais o motor de programação escolhe.
2. Sincronização de ordens. Leia as ordens de produção em aberto com seus nós, operações e materiais, além do estoque e dos pedidos de compra em aberto. O SkyPlanner considera o material encomendado disponível na data de entrega do pedido de compra e atualiza o estoque quando o pedido é marcado como Delivered. Após a primeira carga, as atualizações incrementais são baseadas em Common/EntityChangeLogs.
3. Gravação da programação de volta no Monitor. Para cada operação alocada ou movida pelo motor de programação, o SkyPlanner envia ManufacturingOrderOperations/Update com PlannedStartDate e PlannedFinishDate. Quando o motor move uma operação para outra máquina de um grupo, SetWorkCenter é enviado primeiro. Os comandos de uma mesma ordem são enviados em um único Batch, para que o Monitor aceite todos ou nenhum. Durante os testes, execute o lote por meio de /Validate.
Nas versões do Monitor anteriores à 24.5, não é possível gravar as datas planejadas por meio de Update. Em vez disso, use ManufacturingOrders/ReplanOperation (a partir da versão 2.40) com StartDate e FinishDate, e configure RestrictToOrderBounds de acordo com suas regras.
4. Confirmações do chão de fábrica. Mantenha um único canal de apontamento:
- O Monitor continua sendo o canal. Os operadores fazem os apontamentos no Recording terminal ou pela integração com as máquinas, como já fazem hoje. O SkyPlanner lê
ManufacturingOrderOperationReportingspara acompanhar o avanço da produção e refazer a programação. - O SkyPlanner passa a ser o canal. Os operadores registram o trabalho com Mobile Confirmations ou Production Timer, e o SkyPlanner envia
ReportManufacturingOrderOperationao Monitor.
Fazer apontamentos nos dois sistemas duplica os tempos e as quantidades.
5. Responsabilidade pelos dados e regras de conflito. Documente essas definições antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Itens, BOM e roteiro de produção, quantidades, status das ordens | Monitor |
| Sequência das operações, início e término planejados, centro de trabalho dentro de um grupo | SkyPlanner |
| Matriz de tempos de preparação, ferramentas, quantidade de operadores, recursos alternativos | SkyPlanner |
| Turnos e ausências | Um sistema, escolhido na definição de escopo |
| Apontamento das operações | Um canal, escolhido na definição de escopo |
A principal fonte de conflitos é a continuidade das alterações no plano de prioridades pelos planejadores. Usar Rescheduling according to New finish ou arrastar linhas em Priority planning sobrescreve as datas gravadas pelo SkyPlanner. Quando o SkyPlanner passa a controlar a sequência, Priority planning se torna uma tela de consulta. Com o Autopilot, o SkyPlanner reprograma automaticamente quando há mudanças na produção.
Etapas típicas do projeto
A implementação normalmente é concluída em poucas semanas após o início da implantação. Antes disso, você pode usar seus próprios dados no teste gratuito de 30 dias. Exporte do Monitor para o Excel as operações das ordens de produção em aberto e os centros de trabalho, importe esses dados e valide a programação antes de iniciar qualquer trabalho de integração.
O projeto em si inclui:
- Definição de escopo. Defina a tabela de mapeamento, as regras de responsabilidade pelos dados, os intervalos de consulta, o canal de apontamento e a versão do Monitor.
- Acesso. Crie o usuário da API, adquira a licença de escrita da Monitor ERP API e libere o acesso de rede à porta 8001.
- Carga inicial. Peças, centros de trabalho, linhas de operação, alternativas, materiais e escalas de trabalho.
- Sincronização de ordens e pedidos de compra com base no registro de alterações.
- Configuração das restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, quantidade de operadores e máquinas ou pessoal alternativos.
- Gravação da programação de volta no Monitor em lotes, testada com
/Validate. - Testes em paralelo. Execute o SkyPlanner em paralelo com o plano de prioridades, compare as datas e corrija os dados mestres.
- Entrada em produção. Ative a gravação de volta no Monitor quando os dados coincidirem.
O que considerar ao planejar uma integração com o Monitor ERP
- Fator de disponibilidade. O Monitor converte a capacidade bruta em líquida usando o fator de disponibilidade, cujo padrão para um novo centro de trabalho é 80 %. Aplique esse fator uma única vez: como eficiência no SkyPlanner ou como turnos mais curtos, nunca das duas formas.
- Precisão dos horários. Em Day planning, a capacidade dos centros de trabalho é expressa como tempo básico por dia, sem horários de turno. Mapeie os turnos reais no SkyPlanner com base nos calendários de produção para que os trabalhos sejam programados dentro do horário de trabalho.
- Tempo de fila e sobreposição. As linhas de operação contêm o tempo de fila e a sobreposição em %. Decida na definição de escopo como cada um será mapeado no SkyPlanner; caso contrário, os prazos de produção mudarão após a entrada em produção.
- Grupos de recursos. Os centros de trabalho agrupados são planejados 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. O uso de datas planejadas via Update exige a versão 24.5. Os campos de capacidade dos centros de trabalho na API exigem a versão 24.3, e o OIDC exige a 25.8. Verifique a compilação antes da definição de escopo.
- Rede e certificado. Na instalação local, o Monitor disponibiliza a API na porta 8001 com um certificado autoassinado. Como o SkyPlanner funciona na nuvem, planeje uma regra de firewall ou um relay e configure explicitamente a confiança no certificado.
- Licenças. Cada aplicação de terceiros que grava dados precisa de seus próprios usuários com licença de API. Todo sistema já inclui um usuário de API somente para leitura.
Integração com o Monitor ERP: quem configura e dá suporte
O trabalho abrange o mapeamento dos seus centros de trabalho, linhas de operação e fluxo de ordens, além das restrições que o Monitor não armazena: matriz de tempos de preparação, ferramentas, quantidade de operadores e recursos alternativos.
- A equipe do SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em produção, cobrindo o lado do SkyPlanner e as chamadas acordadas à Monitor ERP API. Cada fábrica usa o Monitor G5 de uma forma diferente, e é nesse trabalho que esse conhecimento é aplicado.
- Seu parceiro Monitor pode participar. Ele conhece sua configuração, versão e permissões e pode preparar o usuário da API, a licença e o acesso de rede. O SkyPlanner fornece a REST API, a documentação Swagger/OpenAPI e os webhooks.
- Seus próprios desenvolvedores também podem criar soluções usando a mesma REST API documentada, com um token de API. Basta um token de API para começar, e a equipe do SkyPlanner ajuda quando necessário. A documentação pública está disponível na documentação do SkyPlanner.
Após a conexão, o mecanismo Arcturus programa a produção com base nas ordens atualizadas do Monitor, e as datas planejadas são gravadas nas operações das ordens de produção. 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 junto com o seu plano, de acordo com seus processos e necessidades, para que você saiba o custo total antes de começar. Confira os preços, compare o planejamento nativo do Monitor em programação da produção no Monitor ERP considerando a capacidade real de máquinas e pessoal, veja a visão geral na página do Monitor ERP e conheça outros ERPs na central de integrações com ERP.
Avaliações de fabricantes sobre o SkyPlanner
2 heconomizadas por semana
“Com o SkyPlanner, nosso planejamento da produção saiu das planilhas do Excel para a otimização da produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de suprimentos
UTU · Quadros elétricos e equipamentos de manobra
O planejamento da produção economiza 2 horas de trabalho por semana, e uma nova fila de trabalho chega à linha em segundos.
+90%de eficiência na produção
“A eficiência na produção aumentou 90%.”
Abdul Rucyinga, responsável por TI
Laboratory & Allied · Fabricação de produtos farmacêuticos
A eficiência na produção aumentou 90%, e a criação de um plano otimizado de três meses para todos os centros de trabalho leva menos de 30 minutos.
Mais de 1.000 ordens de produção programadas automaticamente
“Temos um controle diferente da produção, e nossa compreensão da capacidade está em um nível completamente diferente.”
Hannu Ryynänen, CEO
Mamec · Misturadores industriais, bombas e fabricação sob contrato de alta tecnologia
Milhares de ordens de produção são programadas automaticamente, e toda a organização tem uma visão da produção em tempo real.
6 mesesde antecedência para a equipe de vendas consultar a capacidade disponível
“O SkyPlanner dá base e confiabilidade a todo o planejamento da produção.”
Anu Järvinen, gerente de produção
Fredman Operations · Papéis para embalagens adequados ao contato com alimentos
A equipe de vendas enxerga a capacidade disponível com seis meses de antecedência, e solicitações de mudança na programação que levavam uma hora ou mais são respondidas em segundos.
Perguntas frequentes
O Monitor ERP tem uma API para ordens de produção?
Sim. A Monitor ERP API disponibiliza Manufacturing/ManufacturingOrders, ManufacturingOrderNodes, ManufacturingOrderOperations e ManufacturingOrderMaterials para consulta. Comandos como ManufacturingOrderOperations/Update e ReplanOperation gravam as datas planejadas de volta no Monitor.
É preciso uma licença adicional para gravar dados no Monitor pela API?
Sim. A leitura pela API é gratuita para todos os clientes do Monitor. Os comandos que gravam dados exigem a Monitor ERP API, comercializada pelo Monitor. Seu parceiro Monitor ou a equipe de vendas do Monitor fornece o orçamento.
A Monitor ERP API oferece suporte a webhooks?
Não há webhooks documentados. A integração consulta Common/EntityChangeLogs em intervalos de poucos minutos e busca apenas os registros alterados. No sentido inverso, os próprios webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
De qual versão do Monitor precisamos?
A gravação do início e do término planejados por meio de ManufacturingOrderOperations/Update exige o Monitor 24.5 ou posterior. Compilações mais antigas do G5, a partir da 2.40, usam ReplanOperation. Confirmamos o método adequado à sua compilação durante a definição de escopo.
Quem desenvolve a integração com o Monitor ERP?
A equipe do SkyPlanner configura a integração bidirecional de acordo com o seu ambiente Monitor G5 durante a implantação e dá suporte após a entrada em produção. Seu parceiro Monitor ou seus próprios desenvolvedores também podem criar soluções usando a REST API documentada do SkyPlanner, e 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 do Monitor em Excel ou CSV, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipe de vendas para definir o escopo da integração.
