Integrações / ERP / Lemonsoft
Guia de integração do Lemonsoft para programação da produção com SkyPlanner APS
Este guia mostra a parceiros e equipes de TI como conectar o Lemonsoft ERP ao SkyPlanner APS. A integração entre SkyPlanner e Lemonsoft é bidirecional e usa a REST API do Lemonsoft:
- O SkyPlanner recebe números de ordem (työnumero), etapas de trabalho (työvaihe), máquinas, estruturas de produto, materiais e turnos planejados.
- Os horários planejados de início e término e a máquina escolhida são enviados de volta às etapas de trabalho.
- As confirmações dos operadores são enviadas de volta como apontamentos de conclusão.
- Os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
A Kaskea Group usa o SkyPlanner com uma integração bidirecional com o Lemonsoft. Durante a implantação, a equipe do SkyPlanner configura a integração de acordo com o seu ambiente Lemonsoft e continua oferecendo suporte após a entrada em produção. Parceiros e desenvolvedores também podem desenvolver soluções usando 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 build “LemonRest 2026.10 release-2026.10.2” lista 422 caminhos. (Swagger)
- A URL base varia conforme o ambiente. Ela fica no gerenciamento de usuários, em gerenciamento de ambientes e endereços de serviço, no campo Rest API. Na plataforma Azure do Lemonsoft, a base é
https://rest.lemon.fi. - Disponibilidade. Para clientes do serviço de plataforma do Lemonsoft (Alustapalvelu), as REST APIs já vêm instaladas e exigem apenas permissões de usuário. (fonte)
- Ambiente de teste. O cliente final deve solicitá-lo ao Lemonsoft Service Desk.
A API separada de controle de horas Kellokortti não é necessária para a programação.
Autenticação
A LemonRest usa uma sessão:
- A chamada
POST /api/auth/logincom UserName, Password, Database e ApiKey retorna umsession_id. - Envie esse valor no cabeçalho
Session-Idem todas as chamadas. - Renove a sessão com
POST /api/auth/renew. UseGET /api/auth/alivepara verificar seu funcionamento.
O endpoint POST /api/auth/login/token recebe um Token em vez de nome de usuário e senha. Crie um usuário exclusivo para a integração, com uma chave de API e apenas as permissões necessárias. (fonte)
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 as primeiras chamadas.
Detecção de alterações: consultas incrementais
A LemonRest não tem endpoints de webhook ou de assinatura. As alterações são lidas por meio de uma consulta incremental:
- O endpoint
GET /api/production/main_ws/changed?updated_after=...retorna as operações alteradas desde a última execução. - Adicione
optimization=true. Esse parâmetro foi incluído na versão 2026.6.3 para eliminar a dependência do log e acelerar a consulta. (notas da versão) - O endpoint
GET /api/log/deletion_eventsidentifica as operações excluídas, para que o trabalho cancelado seja removido da programação.
Consulte as alterações a cada poucos minutos. O SkyPlanner envia webhooks quando o estado ou a programação muda, portanto o envio de dados de volta é orientado a 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, a cada alteração |
Tuoterakenne com linhas Työvaiheet (/api/products/structure, all_levels) | Estrutura de produto, subprodutos e etapas de processo com tempos de preparação | Lemonsoft → SkyPlanner | Carga inicial e, depois, a cada alteração |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Centros de trabalho e grupos de centros de trabalho | Lemonsoft → SkyPlanner | Carga inicial; raramente depois |
Työnumero como ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Ordens com datas de entrega e prioridade | Lemonsoft → SkyPlanner | Consultas incrementais a cada poucos minutos |
Työvaihe como ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Operações (etapas de processo) por centro de trabalho | Lemonsoft → SkyPlanner | Consultas incrementais a cada poucos minutos |
Necessidade de componentes (main_ws/{worknumber}/materials) | Necessidades de materiais por operação | Lemonsoft → SkyPlanner | Junto com cada operação |
Turnos planejados (/api/persons/plannedshifts) | Turnos e pessoal | Lemonsoft → SkyPlanner | Diariamente, ou turnos mantidos no SkyPlanner |
Pedido de venda vinculado a um número de ordem (/api/orders/work/{work_number}) | Informações de cliente e prioridade | Lemonsoft → SkyPlanner | Junto com cada operação |
Campos start_time, end_time e machine_id de Työvaihe (PUT /api/production/workstage) | Início, término e centro de trabalho planejados | SkyPlanner → Lemonsoft | A cada alteração na programação, via webhook do SkyPlanner |
Apontamento de conclusão (POST main_ws/sub_ws/completion_entry) | Confirmações: quantidades produzida e rejeitada, horas e pessoa | SkyPlanner → Lemonsoft | A cada confirmação |
| Regras de programação definidas no SkyPlanner | Centros de trabalho permitidos por operação, matriz de tempos de preparação e ferramentas | Mantidos no SkyPlanner | Configurados durante a implantação |
Padrões de integração
1. Carga inicial de dados mestres. Leia as máquinas e seus grupos, as estruturas de produto com suas etapas de trabalho e as fases de trabalho padrão. Mapeie cada máquina física para um centro de trabalho do SkyPlanner. Use máquinas-pai (Isäkone) apenas para agrupamento, pois elas somam a capacidade das máquinas-filhas.
2. Sincronização dos números de ordem. Leia os números de ordem em aberto com suas etapas em /api/production/workstage ou main_ws/sub_ws, usando filtro por estado e paginação. Depois, mantenha esses dados atualizados com main_ws/changed. Mapeie work_amount_left, e não work_amount, pois o Lemonsoft programa com base na quantidade restante. Os pedidos de compra alimentam a programação do SkyPlanner orientada por materiais, de modo que uma etapa aguarda a data de entrega do pedido de compra.
3. Envio da programação de volta. Para cada etapa alocada ou movida pelo mecanismo de programação, o SkyPlanner envia PUT /api/production/workstage com a operação e suas sub_workstages. Cada etapa 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 a completion_entry com sub_workstage_id, person_number, done_amount, hours, failed_amount e job_done. Quando a etapa consumir material, envie também material_consumptions, e o Lemonsoft registrará um apontamento normal de conclusão (valmistuskirjaus).
5. Regras de responsabilidade e resolução de conflitos. Documente essas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Produtos, estruturas, etapas de trabalho, quantidades e estado da operação | Lemonsoft |
| Sequência das etapas, horários de início e término e escolha da máquina | SkyPlanner |
| Centros de trabalho permitidos por operação, matriz de tempos de preparação e ferramentas | SkyPlanner |
| Turnos e ausências | Um sistema, escolhido na definição de escopo |
| Apontamentos de conclusão e lançamentos de estoque | 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 realocam as etapas desbloqueadas. Mantenha AUTOTIMING em 0 enquanto o SkyPlanner for responsável pela programação. Se mantiver essa função ativa, aplique o bloqueio de programação a cada número de ordem atualizado; ele fixa todas as etapas desse número. Apenas Koneiden kapasiteetin lukitus não basta, pois a programação automática retira as operações desbloqueadas de um dia bloqueado. (fonte)
Etapas típicas do projeto
A implementação normalmente é concluída em poucas semanas após o início da implantação. Antes disso, o teste gratuito de 30 dias usa seus próprios dados, a partir de uma exportação em Excel dos números de ordem, etapas e máquinas.
- Definição de escopo. Defina 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 usuário de integração e a chave de API.
- Carga inicial. Máquinas, grupos, estruturas de produto e etapas de trabalho.
- Sincronização dos números de ordem. Consultas incrementais, eventos de exclusão e renovação da sessão.
- Configuração das restrições no SkyPlanner. Centros de trabalho permitidos por operação, matriz de tempos de preparação e ferramentas.
- Envio de dados ao Lemonsoft. Horários das etapas e apontamentos de conclusão, testados no ambiente de testes.
- Operação em paralelo e entrada em produção. Compare com o Gantt atual, corrija os dados mestres e, depois, ative o envio de dados ao Lemonsoft no ambiente de produção.
O que considerar ao planejar uma integração com o Lemonsoft
- Uma máquina por etapa. Cada etapa do Lemonsoft tem uma máquina associada. Durante a implantação, as máquinas aptas a produzir cada produto são definidas por uma lista ou pelas propriedades do produto. O SkyPlanner então escolhe entre as alternativas.
- Capacidade diária. A capacidade fixa é um total diário, e os desvios não têm horário definido. Modele os turnos reais no SkyPlanner ou leia os turnos planejados.
- Quantidade restante. Mapeie
work_amount_left. As configurações STARTJOB_AUTOTIMENOW e JOBDONE_AUTOTIMENOW também alteram a carga no próprio Lemonsoft. - As sessões expiram. Renove a sessão antes de sincronizações longas e trate os casos em que um novo login é exigido.
- Regras de confirmação. Valide cada confirmação de acordo com o estado da etapa antes de enviá-la e controle o ritmo das chamadas em rajada.
- Dois clientes. O LemonOnline e a versão para Windows compartilham o mesmo banco de dados, por isso a integração atende aos dois.
- Estruturas grandes. Use
/api/async/product/structurecom/api/async/status/{jobId}para importações de grande volume.
Integração com o Lemonsoft: quem configura e dá suporte
O trabalho inclui o mapeamento das suas máquinas, etapas de trabalho e configurações do Lemonsoft. Também abrange as regras de programação mantidas no SkyPlanner: centros de trabalho permitidos por operação, matriz de tempos de preparação e ferramentas.
- A equipe do SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em produção. Cada fábrica usa o Lemonsoft de uma forma, e é nessa configuração que esse conhecimento é aplicado.
- Seu parceiro Lemonsoft pode participar. Ele conhece suas configurações e pode cuidar do usuário da API, das permissões e do ambiente de testes. O SkyPlanner fornece a REST API, a documentação Swagger/OpenAPI e os webhooks.
- Seus próprios desenvolvedores podem criar soluções sobre essa base 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.
Com a conexão estabelecida, o mecanismo Arcturus faz a programação com base nas ordens de produção atualizadas do Lemonsoft, e os horários planejados são gravados nas etapas de trabalho. 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 plano, de acordo com seu processo e suas necessidades. Assim, você conhece o custo total antes de começar.
Veja como o planejamento do próprio Lemonsoft se compara em programação da produção no Lemonsoft com respeito à capacidade real de máquinas e equipes. A visão geral está na página do Lemonsoft, e os demais sistemas estão na central de integrações com ERP.
Depoimentos de fabricantes sobre o SkyPlanner
Lemonsoftintegração bidirecional com o SkyPlanner
Kaskea Group
Fabricação sob contrato: usinagem CNC, estruturas de aço e montagem
A produção é planejada no SkyPlanner, com integração bidirecional com o Lemonsoft.
Menosparadas por falta de materiais
“O valor que o SkyPlanner nos traz é ser uma ferramenta que funciona no dia a dia, especialmente para definir datas de entrega.”
Tommi Männistö, gerente de planejamento da produção
Eskomatic · Usinagem sob contrato
A programação automática da carga permite definir datas de entrega mais precisas, e as paradas de produção causadas pela falta de materiais diminuíram significativamente.
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 · Painéis 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 gerar um plano otimizado de três meses para todos os centros de trabalho leva menos de 30 minutos.
Perguntas frequentes
O Lemonsoft tem uma API para dados de produção?
Sim. O LemonRest disponibiliza ordens de produção e etapas de trabalho, máquinas, estruturas de produtos, materiais, turnos e envio de apontamentos de conclusão. Ele vem pré-instalado para clientes Alustapalvelu e exige uma chave de API e permissões de usuário.
O Lemonsoft oferece suporte a webhooks?
Não há endpoints de webhook listados no LemonRest. As alterações são lidas pela consulta incremental main_ws/changed e pelos eventos de exclusão, consultados a cada poucos minutos. Os webhooks do próprio SkyPlanner enviam as alterações na programação assim que elas ocorrem.
Como os horários planejados são gravados de volta no Lemonsoft?
Com PUT /api/production/workstage, que atualiza uma ordem e suas etapas de trabalho com horário de início, horário de término e máquina. Mantenha a programação automática do Lemonsoft desativada enquanto o SkyPlanner for responsável pela programação ou ative o bloqueio de programação em cada ordem atualizada. Assim, os horários permanecem como o SkyPlanner os definiu.
As confirmações dos operadores no SkyPlanner podem ser enviadas ao Lemonsoft?
Sim. Cada confirmação é enviada como um apontamento de conclusão, com as quantidades produzida e rejeitada, as horas e a pessoa responsável. Esse processo já é executado diariamente em projetos de clientes.
Quem desenvolve a integração com o Lemonsoft?
A equipe do SkyPlanner configura a integração bidirecional de acordo com suas configurações do Lemonsoft durante a implantação e dá suporte após a entrada em produção. Seu parceiro Lemonsoft ou seus próprios desenvolvedores também podem criar soluções usando 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 grátis de 30 dias permite usar até 20 centros de trabalho com importações do Lemonsoft em Excel ou CSV, sem precisar de cartão de crédito. Inicie o teste ou fale com a equipe comercial para definir o escopo da integração.
