Integrações / ERP / Lemonsoft
Guia de integração do Lemonsoft para programação da produção com o SkyPlanner APS
Este guia de integração do Lemonsoft mostra aos parceiros e às equipas de TI como ligar o Lemonsoft ERP ao SkyPlanner APS. O SkyPlanner integra-se com o Lemonsoft nos dois sentidos através da REST API do Lemonsoft:
- São importados números de trabalho (työnumero), fases de trabalho (työvaihe), máquinas, estruturas de produto, materiais e turnos planeados.
- As horas de início e fim planeadas e a máquina escolhida são enviadas de volta para as fases de trabalho.
- As confirmações dos operadores são enviadas de volta como registos de conclusão.
- Os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
O Kaskea Group utiliza o SkyPlanner com uma integração bidirecional com o Lemonsoft. Durante a implementação inicial, a equipa do SkyPlanner configura a integração de acordo com a sua instalação do Lemonsoft e presta apoio após a entrada em produção. Os parceiros e programadores também podem desenvolver soluções com a REST API documentada do SkyPlanner (referência da API).
REST API do Lemonsoft
A API de integração do Lemonsoft é a LemonRest, documentada em Swagger 2.0, versão v1. A compilação “LemonRest 2026.10 release-2026.10.2” lista 422 caminhos. (Swagger)
- O URL base é específico de cada ambiente. Encontra-o na gestão de utilizadores, em gestão de ambientes e endereços de serviço, no campo Rest API. Na plataforma Azure do Lemonsoft, o URL base é
https://rest.lemon.fi. - Disponibilidade. Para os clientes do serviço de plataforma do Lemonsoft (Alustapalvelu), as REST APIs estão pré-instaladas e apenas é necessário atribuir permissões de utilizador. (fonte)
- Ambiente de teste. O cliente final solicita-o ao Lemonsoft Service Desk.
A API de registo de tempos Kellokortti, disponibilizada em separado, não é necessária para a programação.
Autenticação
A LemonRest utiliza uma sessão:
- Uma chamada a
POST /api/auth/logincom UserName, Password, Database e ApiKey devolve umsession_id. - Envie-o no cabeçalho
Session-Idem todas as chamadas. - Renove a sessão com
POST /api/auth/renew. UseGET /api/auth/alivepara verificar o estado do serviço.
POST /api/auth/login/token recebe um Token em vez do nome de utilizador e da palavra-passe. Crie um utilizador dedicado à integração, com uma chave de API e apenas as permissões necessárias à integração. (fonte)
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: consultas incrementais
A LemonRest não dispõe de endpoints de webhooks ou de subscrição. As alterações são lidas através de uma consulta incremental:
GET /api/production/main_ws/changed?updated_after=...devolve as tarefas alteradas desde a última execução.- Acrescente
optimization=true. Este parâmetro foi introduzido na versão 2026.6.3 para eliminar a dependência do log e acelerar a consulta. (notas da versão) GET /api/log/deletion_eventsdeteta as tarefas eliminadas, para que os trabalhos cancelados sejam retirados da programação.
Consulte as alterações de poucos em poucos minutos. O SkyPlanner envia webhooks quando o estado ou a programação mudam, pelo que o envio de dados de volta é acionado por eventos.
Mapeamento de dados
| Objeto do Lemonsoft (endpoint) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
Tuote, product_code (/api/products) | Produtos e materiais | Lemonsoft → SkyPlanner | Carga inicial e, depois, sempre que houver alterações |
Tuoterakenne com linhas Työvaiheet (/api/products/structure, all_levels) | Estrutura de produto, subprodutos, etapas do processo com tempos de preparação | Lemonsoft → SkyPlanner | Carga inicial e, depois, sempre que houver alterações |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Centros de trabalho, grupos de centros de trabalho | Lemonsoft → SkyPlanner | Carga inicial; raramente depois disso |
Työnumero como ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Ordens com datas de entrega e prioridade | Lemonsoft → SkyPlanner | Consulta incremental de poucos em poucos minutos |
Työvaihe como ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Tarefas (etapas do processo) por centro de trabalho | Lemonsoft → SkyPlanner | Consulta incremental de poucos em poucos minutos |
Necessidades de componentes (main_ws/{worknumber}/materials) | Necessidades de materiais por tarefa | Lemonsoft → SkyPlanner | Com cada tarefa |
Turnos planeados (/api/persons/plannedshifts) | Turnos, pessoal | Lemonsoft → SkyPlanner | Diariamente, ou turnos geridos no SkyPlanner |
Encomenda de cliente associada a um número de trabalho (/api/orders/work/{work_number}) | Informação sobre o cliente e a prioridade | Lemonsoft → SkyPlanner | Com cada tarefa |
start_time, end_time, machine_id de Työvaihe (PUT /api/production/workstage) | Início, fim e centro de trabalho planeados | SkyPlanner → Lemonsoft | Quando a programação muda, através de um webhook do SkyPlanner |
Registo de conclusão (POST main_ws/sub_ws/completion_entry) | Confirmações: quantidade produzida e rejeitada, horas, pessoa | SkyPlanner → Lemonsoft | Por confirmação |
| Regras de programação definidas no SkyPlanner | Centros de trabalho permitidos por tarefa, matriz de tempos de preparação, ferramentas | Geridos no SkyPlanner | Configurados durante a implementação inicial |
Modelos de integração
1. Carga inicial de dados mestre. Leia as máquinas e os grupos de máquinas, as estruturas de produto com as respetivas fases de trabalho e as fases de trabalho padrão. Associe cada máquina concreta a um centro de trabalho do SkyPlanner. Use as máquinas-mãe (Isäkone) apenas para agrupamento, pois somam a capacidade das máquinas subordinadas.
2. Sincronização dos números de trabalho. Leia os números de trabalho em aberto com as respetivas fases a partir de /api/production/workstage ou main_ws/sub_ws, com filtragem por estado e paginação. Mantenha-os depois atualizados com main_ws/changed. Mapeie work_amount_left, não work_amount, porque o Lemonsoft programa com base na quantidade restante. As encomendas a fornecedores alimentam a programação do SkyPlanner baseada na disponibilidade de materiais, pelo que cada fase aguarda a data de entrega da encomenda ao fornecedor.
3. Envio da programação de volta. Para cada fase que o motor tenha programado ou deslocado, o SkyPlanner envia PUT /api/production/workstage com a tarefa e as respetivas sub_workstages. Cada fase inclui start_time, end_time e, quando é transferida para uma máquina alternativa, machine_id.
4. Confirmações no chão de fábrica. Os operadores confirmam o trabalho com SkyPlanner Mobile Confirmations ou Production Timer. Cada confirmação é enviada para completion_entry com sub_workstage_id, person_number, done_amount, hours, failed_amount e job_done. Quando a fase consome material, envie também material_consumptions; o Lemonsoft efetua então um lançamento normal de conclusão (valmistuskirjaus).
5. Responsabilidade pelos dados e regras de conflito. Documente estas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Produtos, estruturas, fases de trabalho, quantidades, estado da tarefa | Lemonsoft |
| Sequência das fases, horas de início e fim, escolha da máquina | SkyPlanner |
| Centros de trabalho permitidos por tarefa, matriz de tempos de preparação, ferramentas | SkyPlanner |
| Turnos e ausências | Um único sistema, escolhido na definição do âmbito |
| Conclusões e movimentos de stock | Lemonsoft, com lançamentos a partir das confirmações do SkyPlanner |
As principais fontes de conflito são a programação automática do próprio Lemonsoft e a ação de atualização: ambas reposicionam as fases não bloqueadas. Mantenha AUTOTIMING em 0 enquanto o SkyPlanner for responsável pela programação. Se o mantiver ativo, aplique o bloqueio da programação a cada número de trabalho atualizado; esse bloqueio fixa todas as fases desse número. Só o Koneiden kapasiteetin lukitus não basta, porque a programação automática desloca as tarefas não bloqueadas para fora de um dia bloqueado. (fonte)
Etapas habituais do projeto
A implementação fica normalmente concluída em poucas semanas após o início do processo de integração. Antes disso, o período de avaliação gratuita de 30 dias utiliza os seus próprios dados, exportados para Excel: números de trabalho, fases e máquinas.
- Definição do âmbito. Estabeleça a tabela de mapeamento, as regras de responsabilidade pelos dados e o intervalo entre consultas.
- Acesso. O cliente final solicita um ambiente de teste ao Lemonsoft Service Desk e cria o utilizador de integração e a chave de API.
- Carga inicial. Máquinas, grupos, estruturas de produto e fases de trabalho.
- Sincronização dos números de trabalho. Consultas incrementais, eventos de eliminação e renovação da sessão.
- Configuração das restrições no SkyPlanner. Centros de trabalho permitidos por tarefa, matriz de tempos de preparação e ferramentas.
- Escrita de dados no Lemonsoft. Horários das fases e registos de conclusão, testados no ambiente de testes.
- Funcionamento em paralelo e entrada em produção. Compare com o Gantt atual, corrija os dados mestre e, em seguida, ative a escrita de dados no Lemonsoft em produção.
O que prever numa integração com o Lemonsoft
- Uma máquina por fase. Cada fase do Lemonsoft tem uma máquina associada. Durante a implementação, as máquinas permitidas para cada produto são definidas a partir de uma lista ou das propriedades do produto. O SkyPlanner escolhe depois entre essas alternativas.
- Capacidade diária. A capacidade fixa é expressa numa quantidade diária e os desvios não têm uma hora associada. Modele os turnos reais no SkyPlanner ou leia os turnos planeados.
- Quantidade restante. Mapeie
work_amount_left. As definições STARTJOB_AUTOTIMENOW e JOBDONE_AUTOTIMENOW também deslocam a carga do próprio Lemonsoft. - As sessões expiram. Renove a sessão antes de sincronizações demoradas e preveja o tratamento de um novo início de sessão obrigatório.
- Regras de confirmação. Valide cada confirmação face ao estado da fase antes de a enviar e distribua no tempo as chamadas feitas em rajada.
- Duas aplicações cliente. O LemonOnline e a versão para Windows partilham a mesma base de dados, pelo que a integração serve ambas as aplicações.
- Estruturas de grande dimensão. Use
/api/async/product/structurecom/api/async/status/{jobId}para importações de grande volume.
Integração com o Lemonsoft: quem a configura e lhe presta suporte
O trabalho inclui o mapeamento das suas máquinas, fases de trabalho e configuração do Lemonsoft. Abrange também as regras de programação que mantém no SkyPlanner: centros de trabalho permitidos por tarefa, matriz de tempos de preparação e ferramentas.
- A equipa do SkyPlanner configura a integração durante a implementação e presta suporte após a entrada em produção. Cada fábrica utiliza o Lemonsoft de forma diferente, e esse conhecimento é aplicado nesta configuração.
- O seu parceiro Lemonsoft pode participar. O parceiro conhece a sua configuração e pode tratar do utilizador da API, das permissões e do ambiente de testes. O SkyPlanner disponibiliza a REST API, a documentação Swagger/OpenAPI e os webhooks.
- Os seus próprios programadores podem desenvolver soluções usando a mesma REST API documentada e um token de API. Basta um token de API para começar, e a equipa do SkyPlanner presta assistência quando necessário.
Uma vez estabelecida a ligação, o motor Arcturus faz a programação com base nos dados atualizados das ordens de trabalho do Lemonsoft, e os horários planeados são gravados nas respetivas fases de trabalho. 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, 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.
Veja como o planeamento do próprio Lemonsoft se compara em Programação da produção com o Lemonsoft, tendo em conta a capacidade real das máquinas e das equipas. Encontra uma visão geral na página do Lemonsoft e outros sistemas na área de integrações com ERP.
Opiniões de fabricantes sobre o SkyPlanner
Lemonsoftintegração bidirecional com o SkyPlanner
Kaskea Group
Fabrico por subcontratação: maquinagem CNC, estruturas de aço e montagem
A produção é planeada no SkyPlanner, com uma integração bidirecional com o Lemonsoft.
Menosparagens por falta de materiais
“O valor que o SkyPlanner nos traz é ser uma ferramenta que funciona no dia a dia, sobretudo para definir datas de entrega.”
Tommi Männistö, Responsável pelo Planeamento da Produção
Eskomatic · Maquinagem por subcontratação
A programação automática da carga permite definir datas de entrega mais precisas, e as paragens de produção causadas por falta de materiais diminuíram acentuadamente.
2 hpoupadas por semana
“Com o SkyPlanner, passámos de planear a produção em folhas de cálculo Excel para otimizar a 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 permite poupar 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 de TI
Laboratory & Allied · Fabrico de produtos farmacêuticos
A eficiência na produção aumentou 90%, e criar um plano otimizado para três meses, abrangendo todos os centros de trabalho, demora menos de 30 minutos.
Perguntas frequentes
O Lemonsoft tem uma API para dados de produção?
Sim. O LemonRest disponibiliza tarefas de produção e fases de trabalho, máquinas, estruturas de produtos, materiais, turnos e registo de conclusões. Está pré-instalado para os clientes Alustapalvelu e requer uma chave de API e permissões de utilizador.
O Lemonsoft suporta webhooks?
O LemonRest não apresenta endpoints de webhooks. As alterações são lidas através da consulta incremental main_ws/changed e dos eventos de eliminação, consultados periodicamente a cada poucos minutos. Os webhooks do próprio SkyPlanner enviam as alterações à programação assim que ocorrem.
Como são gravados os horários planeados no Lemonsoft?
Através de PUT /api/production/workstage, que atualiza uma tarefa e as respetivas fases de trabalho com a hora de início, a hora de fim e a máquina. Mantenha a programação automática do Lemonsoft desativada enquanto o SkyPlanner for responsável pela programação, ou ative o bloqueio da programação em cada ordem de trabalho atualizada, para manter os horários definidos pelo SkyPlanner.
As confirmações dos operadores no SkyPlanner podem ser enviadas para o Lemonsoft?
Sim. Cada confirmação é enviada como um registo de conclusão com as quantidades concluídas e rejeitadas, as horas e a pessoa. Esta operação é executada diariamente em projetos de clientes.
Quem desenvolve a integração com o Lemonsoft?
A equipa do SkyPlanner configura a integração bidirecional de acordo com a sua configuração do Lemonsoft durante a implementação e presta suporte após a entrada em produção. O seu parceiro Lemonsoft ou os seus próprios programadores também podem desenvolver com base na 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 utilizar até 20 centros de trabalho, com importações de Excel ou CSV a partir do Lemonsoft, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipa comercial para definir o âmbito da integração.
