Integrações / ERP / Visma L7
Guia de integração APS com Visma L7 para planejamento da produção
Este guia de integração com o Visma L7 mostra a parceiros e equipes de TI como conectar o Visma L7 ao SkyPlanner APS. O SkyPlanner troca dados com o Visma L7 nos dois sentidos pela Visma L7 REST API:
- São importados números de ordem (työnumero), etapas de trabalho (työnvaihe), recursos, estruturas de produto, peças, materiais, saldos de estoque e itens de pedidos de venda e de compra.
- O recurso, a data de início, a prioridade, a pessoa responsável e as horas por dia de cada ficha de trabalho são gravados de volta no L7 com
PUT /manufphases/. - A capacidade no calendário de recursos é mantida sincronizada com
POST /resourceupdates/. - Os eventos de produção registrados nas filas de trabalho do L7 são lidos com
GET /manufevents/. - Os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
A equipe do SkyPlanner configura a integração conforme o seu ambiente L7 durante a implantação e oferece suporte após a entrada em produção. Parceiros e desenvolvedores também podem criar integraçõ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, com histórico de alterações (documentação). Ela é executada no Visma LTR.
- O caminho base é
/ltrws/REST/L7no seu servidor LTR, em infraestrutura local ou no serviço de hospedagem de aplicações da Visma. - Licenciamento. Cada endpoint tem uma licença própria. Para gravar a programação, é necessária a licença L7RMFPP para
PUT /manufphases/; para atualizar a capacidade, a licença L7RMCAP. Os endpoints de leitura também exigem licenças específicas. - Paginação. As listas usam
pageSizeerecAfterpara paginação equeryKey1,queryKey2equeryStringpara filtragem.
Autenticação
Cada chamada ao L7 inclui dois tokens:
- hash seleciona o banco de dados e a empresa.
- token identifica o usuário da API.
O administrador do LTR cria o usuário da API no Visma LTR, vincula-o à empresa no L7, atribui perfis e gera o token do usuário (primeiros passos). Use um usuário exclusivo para a integração, apenas com as permissões necessárias.
No SkyPlanner, a autenticação na REST API usa um token de API enviado no cabeçalho Authorization-Token. Você o cria em Configurações > API. O tutorial de integração orienta as primeiras chamadas.
Detecção de alterações: modifiedAfter
A L7 REST API não tem webhooks. As alterações são lidas por consultas periódicas:
- Ative o registro de alterações (DBLOG) na manutenção de arquivos do L7 (Tiedostohuolto) para as tabelas lidas pela integração, como as de fichas de trabalho e peças.
- Chame os endpoints de leitura com
modifiedAfterdefinido para o momento da última execução. Os registros excluídos retornam marcados como excluídos, para que as operações canceladas sejam retiradas da programação. - Faça consultas em intervalos de poucos minutos. O SkyPlanner envia webhooks quando o estado ou a programação muda; assim, a gravação de volta no L7 é acionada 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 |
Peças vinculadas a um número de ordem (GET /manufcomponents/) | Subprodutos | L7 → SkyPlanner | Consultas periódicas com modifiedAfter |
Necessidades de materiais (GET /manufmaterials/) | Necessidades de materiais por operação | L7 → SkyPlanner | Consultas periódicas com modifiedAfter |
Árvore de recursos (KRYH) com quantidade de máquinas (GET /manufresources/) | Centros de trabalho e grupos de centros de trabalho | L7 → SkyPlanner | Carga inicial; raramente depois disso |
Ficha de trabalho (TSUUNR) por etapa (GET /manufphases/) | Operações (etapas do processo) por centro de trabalho | L7 → SkyPlanner | Consultas em intervalos de poucos minutos |
Saldos de estoque (GET /stockbalances/) | Estoque | L7 → SkyPlanner | Consultas periódicas |
Itens de pedidos de compra (GET /purchaserows/) | Pedidos de compra com datas de entrega | L7 → SkyPlanner | Consultas periódicas |
Pedidos de venda e seus itens (GET /salesorders/, GET /salesrows/) | Prazos de entrega, prioridade do cliente | L7 → SkyPlanner | Consultas periódicas |
Eventos de produção (GET /manufevents/) | Andamento por operação | L7 → SkyPlanner | Consultas periódicas |
Campos resource, startDate, priority, person e schedulingDays da ficha de trabalho (PUT /manufphases/) | Centro de trabalho, início, sequência e horas por dia planejados | SkyPlanner → L7 | A cada alteração na programação, via webhook do SkyPlanner |
Capacidade no calendário de recursos (POST /resourceupdates/) | Capacidade por turno | SkyPlanner → L7 | Quando os turnos mudam |
| Regras de programação definidas no SkyPlanner | Centros de trabalho permitidos, matriz de tempos de preparação, ferramentas e pessoas | Mantidos no SkyPlanner | Configurados durante a implantação |
Padrões de integração
1. Carga inicial de dados mestres. Leia a árvore de recursos e mapeie cada máquina para um centro de trabalho próprio no SkyPlanner. Quando um recurso do L7 tiver 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 estruturas de produto com suas etapas de trabalho.
2. Sincronização dos números de ordem. Leia as fichas de trabalho abertas com GET /manufphases/ e mantenha-as atualizadas com modifiedAfter. Leia as peças e as necessidades de materiais de cada número de ordem, além dos saldos de estoque e dos itens de pedidos de compra, para que cada etapa aguarde a data de entrega do item de compra correspondente.
3. Gravação da programação no L7. Para cada etapa alocada ou movida pelo motor de programação, o SkyPlanner chama PUT /manufphases/. O corpo da requisição 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 exibam a sequência definida pelo SkyPlannerperson, quando um operador específico é alocadoschedulingDays, as horas planejadas por data
O L7 mantém inalterada a prioridade definida por um sistema externo (fonte), preservando a sequência nas filas de trabalho.
4. Sincronização da capacidade. Quando há alterações de turnos, feriados ou horas extras no SkyPlanner, POST /resourceupdates/ grava a nova capacidade no calendário de recursos do L7. Assim, as visualizações de carga do L7 passam a corresponder ao plano.
5. Andamento no chão de fábrica. Os operadores continuam fazendo apontamentos nas filas de trabalho do L7 e no Visma LTR, e o SkyPlanner lê os eventos com GET /manufevents/. Eles também podem confirmar operações no SkyPlanner Mobile Confirmations. O Autopilot refaz a programação com base em qualquer uma das fontes, e a próxima gravação no L7 envia os novos horários.
6. Responsabilidade pelos dados e regras de conflito. Documente essas regras antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Produtos, estruturas, etapas de trabalho, quantidades e estado da ordem | Visma L7 |
| Sequência das etapas, datas de início, horas por dia e escolha do recurso | SkyPlanner |
| Centros de trabalho permitidos, matriz de tempos de preparação, ferramentas e pessoas | SkyPlanner |
| Turnos e ausências | SkyPlanner, com gravação no calendário de recursos do L7 |
| Eventos de produção e lançamentos de estoque | Filas de trabalho do Visma L7 e LTR |
A principal fonte de conflitos é o planejamento do próprio L7. O cálculo de necessidades e o planejamento detalhado podem realocar etapas não bloqueadas. Execute essas funções apenas para materiais e reservas, sem reprogramar as etapas sob responsabilidade do SkyPlanner.
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, exportados para Excel com números de ordem, etapas e recursos.
- Definição de escopo. Defina a tabela de mapeamento, as regras de responsabilidade pelos dados e o intervalo entre consultas.
- Acesso e licenças. Licencie os endpoints REST previstos no escopo. O administrador do LTR cria o usuário da API, o hash e o token, de preferência primeiro em uma empresa de teste.
- Registro de alterações. Ative o DBLOG para as tabelas que serão lidas.
- Carga inicial. Recursos, produtos, estruturas e etapas de trabalho.
- Sincronização dos números de ordem. Consultas periódicas com modifiedAfter, exclusões e paginação.
- Configuração de restrições no SkyPlanner. Centros de trabalho permitidos, matriz de tempos de preparação, ferramentas e pessoas.
- Gravação no L7.
PUT /manufphases/ePOST /resourceupdates/, testados na empresa de teste. - Operação em paralelo e entrada em produção. Compare com o plano atual, corrija os dados mestres e, então, ative a gravação de retorno no ambiente de produção.
O que considerar ao planejar a integração com o Visma L7
- Licenças por endpoint. Liste todos os endpoints logo no início e obtenha as licenças antes dos testes.
- Quantidade de máquinas. No L7, um recurso com várias máquinas divide o trabalho entre elas (fonte). Separe esse recurso em centros de trabalho no SkyPlanner e grave de volta o recurso que o L7 espera receber.
- Horas por dia. O L7 armazena o plano em horas por data. O SkyPlanner envia
schedulingDayscuja soma corresponde à duração da etapa. - Calendário da fábrica. Mantenha-o completo, pois lacunas deslocam as etapas para datas passadas (fonte).
- Ordens para estoque.
mainNumber,subNumber,rowNumberenewQuantitysão usados apenas para alterar a quantidade de uma ordem para estoque. Omita esses campos nas ordens de clientes. - O próximo ERP. A Visma encerrou o desenvolvimento de novas funcionalidades do L7, e o uso do produto termina no final de 2028 (comunicado da Visma). Mantenha as regras de programação no SkyPlanner, não nos campos do L7, para preservá-las quando trocar de ERP.
Integração com o Visma L7: quem configura e dá suporte
O trabalho inclui o mapeamento dos seus recursos, etapas de trabalho e configurações do L7. Também abrange as regras de programação mantidas no SkyPlanner: centros de trabalho permitidos, matriz de tempos de preparação, ferramentas e pessoas.
- 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 L7 de uma forma diferente, e é nessa configuração que esse conhecimento é aplicado.
- Seu parceiro Visma pode participar. Ele conhece suas configurações do L7 e do LTR e pode cuidar do usuário da API, das licenças e da empresa de teste. O SkyPlanner fornece a REST API, a documentação Swagger/OpenAPI e os webhooks.
- Seus próprios desenvolvedores podem criar soluções a partir dessa integração usando a mesma REST API documentada e um token de API. Basta um token de API para começar, e a equipe do SkyPlanner ajuda quando necessário.
Quando você substituir o L7, a mesma configuração do SkyPlanner se conecta ao novo ERP. Consulte as páginas de Business Central, Visma Net, Lemonsoft, Monitor ERP e Odoo.
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, de acordo com seu processo e suas necessidades, junto com o plano contratado. Assim, você conhece o custo total antes de começar.
Veja a comparação com o planejamento nativo do L7 em O Visma L7 oferece programação com capacidade finita? A visão geral está na página do Visma L7, e os demais sistemas estão na central de integrações com ERP.
Depoimentos de fabricantes sobre o SkyPlanner
1.000 ou mais ordens de produção programadas automaticamente
“Agora temos outro controle sobre a 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, com uma visão da produção em tempo real para toda a organização.
98%de pontualidade de entrega, ante cerca de 50%
“O SkyPlanner tem um papel decisivo na manutenção da nossa pontualidade de entrega.”
Hannu Lahtinen, diretor-geral
KJH-Comp · Fabricação de componentes em chapa metálica e fabricação sob contrato
A pontualidade de entrega passou de cerca de 50% para até 98%, e a programação agora exige um supervisor em vez de dois.
2 heconomizadas por semana
“Com o SkyPlanner, nosso planejamento da produção saiu das planilhas de 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.
Perguntas frequentes
O Visma L7 tem uma API para dados de produção?
Sim. A REST API do Visma L7 no Visma LTR disponibiliza etapas de trabalho, recursos, peças, materiais, eventos de produção, produtos, saldos de estoque, itens de venda e itens de compra. Cada endpoint tem uma licença separada, e o administrador do LTR cria o usuário da API e os tokens.
Como o planejamento é gravado de volta no Visma L7?
Por meio de PUT /manufphases/, que atualiza o recurso, a data de início, a prioridade, a pessoa e as horas planejadas por data de cada ficha de trabalho. POST /resourceupdates/ grava a capacidade no calendário do recurso. O L7 mantém a prioridade externa, de modo que as filas de trabalho seguem a ordem definida pelo SkyPlanner.
O Visma L7 oferece suporte a webhooks?
Não há webhooks documentados. Ative o registro de alterações nas tabelas incluídas no escopo e faça consultas periódicas com modifiedAfter. Os webhooks do próprio SkyPlanner enviam as alterações no planejamento assim que elas ocorrem.
Qual software de planejamento da produção se integra ao Visma L7?
O SkyPlanner APS se integra ao Visma L7 nos dois sentidos por meio da REST API do L7, e a Visma lista a Skycode com o SkyPlanner em sua página de integrações do L7. A equipe do SkyPlanner configura a integração durante a implantação.
Quem desenvolve a integração com o Visma L7?
A equipe do SkyPlanner configura a integração bidirecional conforme as configurações do seu L7 durante a implantação e dá suporte após a entrada em produção. Seu parceiro Visma 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 de arquivos Excel ou CSV do L7, sem cartão de crédito. Inicie o teste ou fale com a equipe comercial para definir o escopo da integração.
