Integrações / ERP / Visma L7
Guia de integração APS com Visma L7 para programação da produção
Este guia de integração com Visma L7 mostra aos parceiros e às equipas de TI como ligar o Visma L7 ao SkyPlanner APS. A integração entre o SkyPlanner e o Visma L7 é bidirecional e utiliza a Visma L7 REST API:
- São importados números de trabalho (työnumero), fases de trabalho (työnvaihe), recursos, estruturas de produtos, componentes, materiais, saldos de stock, linhas de venda e linhas de compra.
- O recurso, a data de início, a prioridade, a pessoa e as horas por dia de cada ficha de trabalho são enviados de volta através de
PUT /manufphases/. - A capacidade no calendário de recursos é mantida sincronizada através de
POST /resourceupdates/. - Os eventos de produção registados nas filas de trabalho do L7 são lidos através de
GET /manufevents/. - Os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
Durante a implementação inicial, a equipa SkyPlanner configura a integração de acordo com a sua instalação do L7 e presta suporte 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 Visma L7
A API é a Visma L7 – REST API, documentada em OpenAPI 3.0.3 e acompanhada de um histórico de alterações (documentação). Funciona em Visma LTR.
- O caminho base é
/ltrws/REST/L7no seu servidor LTR, instalado localmente ou no serviço de alojamento de aplicações da Visma. - Licenciamento. Cada endpoint é licenciado separadamente. A escrita da programação exige a licença L7RMFPP para
PUT /manufphases/, e as atualizações de capacidade exigem a L7RMCAP. Os endpoints de leitura têm as suas próprias licenças. - Paginação. As listas são paginadas com
pageSizeerecAftere filtradas comqueryKey1,queryKey2equeryString.
Autenticação
Cada chamada ao L7 inclui dois tokens:
- hash seleciona a base de dados e a empresa.
- token identifica o utilizador da API.
O administrador do LTR cria o utilizador da API no Visma LTR, associa-o à empresa do L7, atribui-lhe perfis e cria o token de utilizador (primeiros passos). Utilize um utilizador dedicado à integração, apenas com as permissões de que esta necessita.
No SkyPlanner, a REST API utiliza um token de API enviado no cabeçalho Authorization-Token para autenticação. Crie-o em Settings > API. O tutorial de integração explica as primeiras chamadas passo a passo.
Deteção de alterações: modifiedAfter
A L7 REST API não tem webhooks. As alterações são lidas através de consultas periódicas:
- Ative o registo de alterações (DBLOG) na manutenção de ficheiros do L7 (Tiedostohuolto) para as tabelas que a integração lê, como as fichas de trabalho e os componentes.
- Chame os endpoints de leitura com
modifiedAfterdefinido para a última execução. Os registos eliminados são devolvidos com essa indicação, pelo que o trabalho cancelado é retirado da programação. - Faça consultas com intervalos de poucos minutos. O SkyPlanner envia webhooks quando o estado ou a programação mudam, pelo que o envio de dados de volta ao L7 é desencadeado por eventos.
Mapeamento de dados
| Objeto do Visma L7 (endpoint) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
Tuote (GET /products/) | Produtos e materiais | L7 → SkyPlanner | Carga inicial e, depois, a cada alteração |
Componentes de um número de trabalho (GET /manufcomponents/) | Subprodutos | L7 → SkyPlanner | Consulta periódica com modifiedAfter |
Necessidades de materiais (GET /manufmaterials/) | Necessidades de materiais por tarefa | L7 → SkyPlanner | Consulta periódica com modifiedAfter |
Árvore de recursos (KRYH) com o número de máquinas (GET /manufresources/) | Centros de trabalho e grupos de centros de trabalho | L7 → SkyPlanner | Carregamento inicial; raramente depois |
Ficha de trabalho (TSUUNR) por fase (GET /manufphases/) | Tarefas (etapas do processo) por centro de trabalho | L7 → SkyPlanner | Consulta periódica com intervalos de poucos minutos |
Saldos de stock (GET /stockbalances/) | Stock | L7 → SkyPlanner | Consulta periódica |
Linhas de compra (GET /purchaserows/) | Encomendas de compra com datas de entrega | L7 → SkyPlanner | Consulta periódica |
Encomendas de venda e respetivas linhas (GET /salesorders/, GET /salesrows/) | Datas de entrega, prioridade do cliente | L7 → SkyPlanner | Consulta periódica |
Eventos de produção (GET /manufevents/) | Progresso por tarefa | L7 → SkyPlanner | Consulta periódica |
Campos resource, startDate, priority, person e schedulingDays da ficha de trabalho (PUT /manufphases/) | Centro de trabalho, início, sequência e horas por dia planeados | SkyPlanner → L7 | Quando a programação muda, através de um webhook do SkyPlanner |
Capacidade no calendário de recursos (POST /resourceupdates/) | Capacidade dos turnos | SkyPlanner → L7 | Quando os turnos mudam |
| Regras de programação definidas no SkyPlanner | Centros de trabalho permitidos, matriz de tempos de preparação, ferramentas, pessoas | Mantidas no SkyPlanner | Configuradas durante a implementação inicial |
Modelos de integração
1. Carga inicial de dados mestre. Leia a árvore de recursos e associe cada máquina a um centro de trabalho próprio no SkyPlanner. Quando um recurso do L7 incluir várias máquinas, crie um centro de trabalho por máquina e um grupo de centros de trabalho para o recurso. Leia os produtos e as respetivas estruturas, incluindo as fases de trabalho.
2. Sincronização dos números de trabalho. Leia as fichas de trabalho em aberto com GET /manufphases/ e mantenha-as atualizadas com modifiedAfter. Leia os componentes e as necessidades de materiais de cada número de trabalho, bem como os saldos de stock e as linhas de compra, para que cada fase aguarde a data de entrega da respetiva linha de compra.
3. Escrita da programação no L7. Para cada fase que o motor programou ou deslocou, o SkyPlanner chama PUT /manufphases/. O corpo do pedido contém uma entrada workSheet por ficha de trabalho, com:
number, a ficha de trabalho, eresource, o recurso escolhidostartDateepriority, para que as filas de trabalho do L7 apresentem a sequência definida pelo SkyPlannerperson, quando está previsto um operador específicoschedulingDays, as horas planeadas para cada data
O L7 mantém inalterada a prioridade definida por um sistema externo (fonte), pelo que a sequência se mantém nas filas de trabalho.
4. Sincronização da capacidade. Quando os turnos, as férias ou as horas extraordinárias mudam no SkyPlanner, POST /resourceupdates/ grava a nova capacidade no calendário de recursos do L7. As vistas de carga do L7 passam assim a corresponder ao plano.
5. Progresso na fábrica. Os operadores continuam a efetuar registos nas filas de trabalho do L7 e no Visma LTR, e o SkyPlanner lê os eventos com GET /manufevents/. Os operadores também podem confirmar o trabalho em SkyPlanner Mobile Confirmations. O Autopilot reprograma com base em qualquer uma das fontes, e o envio seguinte para o L7 inclui os novos horários.
6. Responsabilidade pelos dados e regras de resolução de conflitos. Documente-as antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Produtos, estruturas, fases de trabalho, quantidades, estado do número de trabalho | Visma L7 |
| Sequência das fases, datas de início, horas por dia, escolha do recurso | SkyPlanner |
| Centros de trabalho permitidos, matriz de tempos de preparação, ferramentas, pessoas | SkyPlanner |
| Turnos e ausências | SkyPlanner, com escrita no calendário de recursos do L7 |
| Eventos de produção e movimentos de stock | Filas de trabalho do Visma L7 e LTR |
A principal fonte de conflitos é o próprio planeamento do L7. O cálculo de necessidades e o planeamento detalhado podem voltar a programar as fases não bloqueadas. Execute-os apenas para materiais e reservas, sem reprogramar as fases sob a responsabilidade do SkyPlanner.
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 utilizar a avaliação gratuita de 30 dias com os seus próprios dados, a partir de uma exportação para Excel dos números de trabalho, fases e recursos.
- Definição do âmbito. Defina a tabela de mapeamento, as regras de responsabilidade pelos dados e o intervalo entre consultas.
- Acesso e licenças. Obtenha as licenças dos endpoints REST abrangidos pelo projeto. O administrador do LTR cria o utilizador da API, o hash e o token, idealmente primeiro numa empresa de teste.
- Registo de alterações. Ative o DBLOG para as tabelas que vai ler.
- Carga inicial. Recursos, produtos, estruturas e fases de trabalho.
- Sincronização dos números de trabalho. Consultas periódicas com modifiedAfter, eliminações e paginação.
- Configuração de restrições no SkyPlanner. Centros de trabalho permitidos, matriz de tempos de preparação, ferramentas e pessoas.
- Escrita no L7.
PUT /manufphases/ePOST /resourceupdates/, testados na empresa de teste. - Execução em paralelo e entrada em produção. Compare com o plano atual, corrija os dados mestre e, em seguida, ative a escrita no ambiente de produção.
O que prever numa integração com o Visma L7
- Licenças por endpoint. Identifique todos os endpoints logo no início e obtenha as respetivas licenças antes dos testes.
- Número de máquinas. No L7, um recurso com várias máquinas distribui o trabalho entre elas (fonte). Divida esse recurso em centros de trabalho no SkyPlanner e envie de volta o recurso que o L7 espera receber.
- Horas por dia. O L7 guarda o plano em horas por data. O SkyPlanner envia
schedulingDayscuja soma corresponde à duração da fase. - Calendário da fábrica. Mantenha-o completo, pois as lacunas fazem com que as fases sejam programadas para datas passadas (fonte).
- Ordens para stock. Os campos
mainNumber,subNumber,rowNumberenewQuantityservem apenas para alterar a quantidade de uma ordem para stock. Não os inclua nos trabalhos para clientes. - O próximo ERP. A Visma deixou de desenvolver novas funcionalidades para o L7 e a utilização do produto termina no final de 2028 (comunicado da Visma). Mantenha as regras de programação no SkyPlanner, e não nos campos do L7, para que sejam mantidas quando mudar de ERP.
Integração com o Visma L7: quem a configura e presta suporte
O trabalho inclui o mapeamento dos seus recursos e fases de trabalho, tendo em conta a configuração do L7. Abrange também as regras de programação mantidas no SkyPlanner: centros de trabalho permitidos, matriz de tempos de preparação, ferramentas e pessoas.
- 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 L7 de forma diferente, e é nesta configuração que se aplica esse conhecimento.
- O seu parceiro Visma pode participar. O parceiro conhece a sua configuração do L7 e do LTR e pode tratar do utilizador da API, das licenças e da empresa de teste. O SkyPlanner disponibiliza a REST API, documentação Swagger/OpenAPI e webhooks.
- Os seus próprios programadores podem desenvolver a partir desta base, utilizando a mesma REST API documentada e um token de API. Basta um token de API para começar, e a equipa do SkyPlanner dá apoio quando necessário.
Quando substituir o L7, a mesma configuração do SkyPlanner liga-se ao novo ERP. Consulte as páginas de Business Central, Visma Net, Lemonsoft, Monitor ERP e Odoo.
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 plano de subscrição. Assim, conhece o custo total antes de começar.
Veja como o planeamento do próprio L7 se compara em O Visma L7 permite programar a produção respeitando a capacidade real das máquinas e das equipas? Encontra uma visão geral na página do Visma L7 e outros sistemas na área de integrações com ERP.
O que dizem os fabricantes sobre o SkyPlanner
Mais de 1.000ordens de fabrico programadas automaticamente
“Controlamos a produção de outra forma 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.
98%de fiabilidade das entregas, face a cerca de 50% anteriormente
“O SkyPlanner tem um papel decisivo para manter a fiabilidade das nossas entregas.”
Hannu Lahtinen, diretor-geral
KJH-Comp · Metalomecânica de chapa e fabrico por contrato
A fiabilidade das entregas passou de cerca de 50% para valores que chegam aos 98%, e a programação precisa agora de um supervisor em vez de dois.
2 hpoupadas por semana
“Com o SkyPlanner, o nosso planeamento da produção passou das folhas de cálculo 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 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 · Produção farmacêutica
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 Visma L7 tem uma API para dados de produção?
Sim. A REST API do Visma L7, no Visma LTR, disponibiliza fases de trabalho, recursos, peças, materiais, eventos de produção, produtos, saldos de stock, linhas de venda e linhas de compra. Cada endpoint tem uma licença separada, e o administrador do LTR cria o utilizador da API e os tokens.
Como é enviado o programa de produção de volta para o Visma L7?
Através de PUT /manufphases/, que atualiza o recurso, a data de início, a prioridade, a pessoa e as horas planeadas por data de cada ficha de trabalho. O pedido POST /resourceupdates/ grava a capacidade no calendário dos recursos. O L7 mantém a prioridade externa, pelo que as filas de trabalho seguem a sequência definida pelo SkyPlanner.
O Visma L7 suporta webhooks?
Não há webhooks documentados. Ative o registo de alterações nas tabelas abrangidas pela integração e consulte-as periodicamente com modifiedAfter. Os webhooks do próprio SkyPlanner enviam as alterações ao programa de produção à medida que ocorrem.
Que software de programação da produção se integra com o Visma L7?
O SkyPlanner APS integra-se com o Visma L7 nos dois sentidos através da REST API do L7, e a Visma apresenta a Skycode com o SkyPlanner na sua página de integrações do L7. A equipa do SkyPlanner configura a integração durante a implementação.
Quem desenvolve a integração com o Visma L7?
A equipa do SkyPlanner configura a integração bidirecional de acordo com a sua configuração do L7 durante a implementação e presta suporte após a entrada em produção. O seu parceiro Visma 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 do L7 em Excel ou CSV, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipa comercial para definir o âmbito da integração.
