Integrações / ERP / Visma Net ERP
Guia de integração do Visma Net para programação da produção com SkyPlanner APS
Este guia de integração do Visma Net mostra aos parceiros e às equipas de TI como ligar o Visma Net (Visma.net ERP) ao SkyPlanner APS. A integração entre o SkyPlanner e o Visma Net é bidirecional e utiliza a Visma Net API:
- O SkyPlanner recebe Stock items, Kit specifications, encomendas de clientes, níveis de stock e encomendas a fornecedores.
- As tarefas programadas dão origem a Kit assemblies, que são libertadas quando o trabalho fica concluído.
- As horas dos operadores são devolvidas como Employee time cards.
- 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 configuração do Visma Net e presta apoio após a entrada em produção. Este guia destina-se a parceiros e programadores que queiram participar ou desenvolver as suas próprias soluções com a REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do Visma Net
- Visma Net ERP API. Interface REST com uma especificação OpenAPI ainda intitulada “Visma.net ERP API v1”, com caminhos v1 e v2. O URL base é
https://api.finance.visma.net. O antigo domíniointegration.visma.netestá sujeito a limitação de tráfego desde 1 de fevereiro de 2026 e está a ser desativado (aviso). - SalesOrder service v3 em
https://salesorder.visma.net. Os endpoints v1 e v2 para encomendas de clientes chegaram ao fim de vida. - Webhooks através do Visma Developer Portal.
- Background API. O cabeçalho
erp-api-backgroundcoloca as chamadas demoradas em fila, devolve 202 com um ID de tarefa e envia uma notificação quando o resultado está pronto. - Cenários de importação e exportação no Visma Net, com fornecedores de dados CSV, Excel ou SQL, para carregamentos pontuais de dados mestre.
A API não tem endpoints para ordens de produção, gamas operatórias ou centros de trabalho, porque estes objetos não existem no Visma Net. Os dados para a programação provêm dos artigos, kits, encomendas e stocks:
GET /v1/inventory: artigos com e sem gestão de stock, incluindo o indicador de kit e a classe do artigoGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: linhas de componentes por revisãoGET /v1/kitassembly: montagens existentes, com filtros por tipo e estado- SalesOrder service v3: procura com datas solicitadas e linhas de encomenda
GET /v1/inventorysummary/{inventoryNumber}: quantidades em stock e disponíveis por armazémGET /v1/purchaseordereGET /v2/PurchaseReceipt: materiais a receber e receções
Todos os endpoints de listagem aceitam lastModifiedDateTime com lastModifiedDateTimeCondition, bem como pageNumber e pageSize, pelo que cada sincronização pode ser incremental.
Autenticação e limites
O Visma Net utiliza o Visma Connect (OpenID Connect e OAuth 2.0):
- Registe uma Service Integration no Visma Developer Portal.
- O administrador do tenant Visma Net do cliente aprova a integração.
- Peça tokens através do fluxo de credenciais do cliente em
https://connect.visma.com/connect/token, passando otenant_ide âmbitos da API comovisma_api:read. Os tokens são válidos durante 3.600 segundos.
Os limites de pedidos aplicam-se por empresa e cliente, numa janela horária fixa. As respostas incluem X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Quando o limite é excedido, a API devolve 429 com Retry-After (limites de pedidos). Os cabeçalhos ETag e If-Match protegem as atualizações.
Os parceiros realizam testes numa empresa de demonstração através do Integrator Programme gratuito da Visma. Do lado do 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 as primeiras chamadas, passo a passo.
Eventos, webhooks e consultas periódicas
Os webhooks do Visma Developer Portal abrangem os eventos relevantes para a programação:
- Inventory Item Created, Updated e Changed
- Purchase Order Changed e Status Changed
- Sales Order Changed e Status Changed, em migração para o publicador SalesOrderService
Não existem eventos para Kit assembly ou Kit specifications. O SkyPlanner consulta estes objetos periodicamente com filtros lastModifiedDateTime. As quantidades em stock são consultadas a cada execução da programação. No sentido inverso, o SkyPlanner envia webhooks quando o estado ou a programação muda.
Mapeamento de dados
| Objeto do Visma Net (endpoint) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
Stock items, Non-stock items (/v1/inventory) | Produtos e materiais | Visma Net → SkyPlanner | Carregamento inicial, depois por webhook |
Kit specifications (/v1/KitSpecifications) | Estrutura do produto, materiais por produto | Visma Net → SkyPlanner | Carregamento inicial, depois por consulta periódica |
| Encomendas de clientes (SalesOrder service v3) | Encomendas com datas de entrega e prioridade do cliente | Visma Net → SkyPlanner | Webhook |
Kit assembly, com estado On hold (/v1/kitassembly), se as montagens forem criadas no Visma Net | Tarefas | Visma Net → SkyPlanner | Consulta periódica |
Inventory summary (/v1/inventorysummary) | Quantidades em stock por armazém | Visma Net → SkyPlanner | Consulta a cada execução da programação |
Encomendas a fornecedores, receções de compras (/v1/purchaseorder, /v2/PurchaseReceipt) | Materiais a receber com data de entrega; atualização do stock quando a encomenda ao fornecedor é entregue | Visma Net → SkyPlanner | Webhook, seguido de leitura |
| Não existe no Visma Net | Etapas do processo, centros de trabalho, turnos, matriz de tempos de preparação, ferramentas, recursos alternativos | Geridos no SkyPlanner | Configurados durante a implementação inicial |
Criação e atualização de Kit assembly (POST/PUT /v1/kitassembly) | Tarefa programada: artigo kit, quantidade, data de conclusão prevista | SkyPlanner → Visma Net | Quando a programação muda, através de um webhook do SkyPlanner |
Libertação de Kit assembly (/v1/kitassembly/{type}/{refNo}/action/release) | Tarefa concluída: produção obtida e consumo de componentes | SkyPlanner → Visma Net | Na conclusão |
Inventory receipt, Inventory issue (/v1/inventoryReceipt, /v1/inventoryissue, libertação) | Produção obtida e consumo de materiais quando não se utilizam kits | SkyPlanner → Visma Net | Na conclusão |
Employee time card (/v1/timeCard) | Horas registadas por operador | SkyPlanner → Visma Net | Semanal |
Modelos de integração
1. Carregamento inicial de dados mestre. Leia os Stock items, as classes de artigos e a revisão mais recente de Kit specification de cada kit. Associe cada linha de componente a um material do SkyPlanner. Em seguida, crie os dados que o Visma Net não contém: centros de trabalho, turnos, etapas do processo com tempos de preparação e execução, matriz de tempos de preparação e necessidades de ferramentas. Importe-os em formato CSV ou Excel. Esta é a componente de maior dimensão do projeto.
2. Sincronização de encomendas. Escolha um modelo de procura:
- Baseado em encomendas de clientes. As linhas em aberto de encomendas de clientes para artigos kit dão origem a encomendas no SkyPlanner, com a data solicitada como data de entrega.
- Baseado em montagens. As Kit assemblies criadas no Visma Net com o estado On hold dão origem a tarefas no SkyPlanner.
As encomendas em aberto a fornecedores são importadas com as respetivas datas. O SkyPlanner considera o material encomendado disponível na data de entrega da encomenda ao fornecedor e atualiza o stock quando esta é marcada como Delivered. Ao calcular a programação, utiliza também o resumo de inventário para verificar tanto o stock como as compras a receber.
3. Escrita da programação no Visma Net. Numa configuração baseada em encomendas de clientes, o SkyPlanner cria uma Kit assembly do tipo Production para cada tarefa programada. Define o artigo kit, a revisão, o armazém, a quantidade e os componentes, e associa a montagem à linha da encomenda do cliente. A data da montagem corresponde à conclusão prevista. Quando o Autopilot desloca a tarefa, um PUT atualiza a data antes da libertação.
A Kit assembly tem um único campo Date, pelo que os horários de cada operação permanecem no SkyPlanner e o Visma Net recebe a data relevante para as vendas e o stock.
4. Confirmações no chão de fábrica. Os operadores registam o trabalho com Mobile Confirmations ou Production Timer, e os registos de tempo mantêm a programação atualizada. Quando a última etapa fica concluída, o SkyPlanner invoca a ação de libertação da Kit assembly. A libertação regista a produção obtida e o consumo de componentes, seguindo-se o lote de lançamentos no razão geral. As horas são agregadas em Employee time cards semanais ou em transações de projeto, no caso de trabalho baseado em projetos.
5. Responsabilidade pelos dados e regras de conflito. Documente estas regras antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Artigos, Kit specifications, encomendas de clientes, encomendas a fornecedores, existências, custo | Visma Net |
| Etapas do processo, centros de trabalho, turnos, preparações, ferramentas | SkyPlanner |
| Sequência das tarefas, horas de início e fim, atribuição a centros de trabalho | SkyPlanner |
| Data do Kit assembly antes da libertação | SkyPlanner |
| Kit assemblies libertados e folhas de horas | Visma Net, com lançamento a partir do SkyPlanner |
Uma alteração a uma Kit specification cria uma nova revisão. Leia novamente a revisão mais recente e refaça o mapeamento, pois só a última revisão pode ser usada na montagem. As alterações manuais aos componentes de uma montagem continuam válidas no Visma Net, pelo que o SkyPlanner volta a ler a montagem antes da libertação.
Etapas habituais do projeto
A implementação fica normalmente concluída em poucas semanas após o início do acompanhamento inicial. Antes disso, o período experimental gratuito de 30 dias utiliza os seus próprios dados, obtidos através de um cenário de exportação do Visma Net e importados em CSV ou Excel.
- Definição do âmbito. Defina o modelo de procura, a tabela de mapeamento, as regras de responsabilidade pelos dados e onde serão gravados os dados enviados de volta ao Visma Net (Kit assembly ou entradas de inventário).
- Configuração do Visma Connect. Registe a Service Integration e obtenha a aprovação do administrador do tenant. Teste primeiro numa empresa de demonstração.
- Modelo de produção. Centros de trabalho, turnos, etapas do processo, preparações e ferramentas no SkyPlanner.
- Carregamento inicial. Artigos de inventário, classes de artigos, Kit specifications, armazéns e existências.
- Sincronização de encomendas de clientes e a fornecedores. Webhooks para encomendas de clientes, encomendas a fornecedores e artigos; consultas periódicas para kits e existências. Esta etapa inclui a renovação de tokens e o tratamento de respostas 429.
- Envio de dados para o Visma Net. Criação, atualização e libertação de Kit assembly, bem como folhas de horas.
- Testes em paralelo. Utilize o SkyPlanner em paralelo com o plano atual e compare as datas.
- Entrada em produção. Ative o envio de dados para o Visma Net quando os dados coincidirem.
O que prever numa integração com o Visma Net
- Não há gamas operatórias para importar. Todas as etapas do processo e os tempos de preparação e execução são definidos de raiz no SkyPlanner. Preveja o trabalho necessário e quem ficará responsável.
- Advanced logistics. O Kit assembly requer o grupo Advanced logistics. Com Standard logistics, registe a produção através de Inventory receipt e Inventory issue.
- Revisões bloqueadas. Uma revisão de Kit specification já utilizada não pode ser editada, e só a revisão mais recente pode ser usada na montagem.
- Unidades de medida. O Kit assembly tem a sua própria unidade de medida. Na importação, compatibilize-a com as quantidades do SkyPlanner.
- Consultas periódicas sem eventos. Os kits não têm webhooks. Consulte apenas as alterações com base em
lastModifiedDateTime, em vez de recarregar todos os dados, para respeitar o limite horário de pedidos. - Endpoints atuais. Desenvolva a integração apenas com
api.finance.visma.nete SalesOrder service v3. - Aprovação do tenant. As credenciais de cliente não funcionam enquanto o administrador do tenant não aprovar a aplicação. Agende esta etapa com antecedência.
- Folhas de horas semanais. As folhas de horas requerem Advanced financials e são semanais. Agregue as horas dos operadores por semana ou registe-as em transações de projeto.
Quem configura e presta suporte à integração com o Visma Net
- A equipa SkyPlanner configura a integração durante o acompanhamento inicial e presta suporte após a entrada em produção. Este trabalho abrange a componente do SkyPlanner, o modelo de produção que falta ao Visma Net e as chamadas acordadas à API do Visma Net. Cada fábrica utiliza o Visma Net de forma diferente, e é nesta fase que esse conhecimento é aplicado.
- O seu parceiro Visma Net pode participar. A Visma disponibiliza o Visma Net através de parceiros certificados pela Visma, que conhecem a sua configuração e podem rever o mapeamento e a aplicação Visma Connect. O SkyPlanner disponibiliza a REST API, documentação Swagger/OpenAPI e webhooks.
- A sua própria equipa de desenvolvimento pode criar a integração com a mesma REST API documentada e um token de API. Basta um token de API para começar, e a equipa SkyPlanner ajuda quando necessário. A documentação pública está disponível na documentação do SkyPlanner.
Depois de estabelecida a ligação, o motor Arcturus programa a produção com base nas encomendas atualizadas do Visma Net, e o trabalho concluído é registado no Visma Net como Kit assemblies libertados. Os preços começam nos 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, em conjunto com o seu plano, para que conheça o custo total antes de começar.
Consulte os preços e descubra por que razão o Visma Net precisa de uma ferramenta de programação em programação da produção com o Visma Net, onde se explica como programar a produção respeitando a capacidade real das máquinas e das equipas. Encontre uma visão geral na página do Visma Net e outros ERP na área de integrações com ERP.
Opiniões de fabricantes sobre o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, passámos das folhas de cálculo Excel no planeamento da produção 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 permite poupar 2 horas de trabalho por semana, e uma nova fila de tarefas 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.
98%de fiabilidade das entregas, face a cerca de 50% anteriormente
“O SkyPlanner tem um papel decisivo na manutenção da fiabilidade das nossas entregas.”
Hannu Lahtinen, diretor-geral
KJH-Comp · Construção mecânica em chapa e fabrico por contrato
A fiabilidade das entregas passou de cerca de 50% para valores que chegam aos 98%, e a programação requer agora um supervisor em vez de dois.
6 mesesde capacidade disponível visível para a equipa comercial
“O SkyPlanner dá uma base sólida e fiabilidade a todo o planeamento da produção.”
Anu Järvinen, diretora de produção
Fredman Operations · Papéis de embalagem aptos para contacto alimentar
A equipa comercial vê a capacidade disponível com seis meses de antecedência, e os pedidos de alteração da programação que demoravam uma hora ou mais recebem agora resposta em segundos.
Perguntas frequentes
A API do Visma Net tem ordens de produção?
Não. O Visma Net não tem objetos de ordens de produção, gamas operatórias ou centros de trabalho, pelo que a API também não os tem. O documento de produção é o Kit assembly em /v1/kitassembly, e as gamas operatórias e os centros de trabalho ficam no SkyPlanner.
Que autenticação utiliza a integração?
Utiliza o Visma Connect com o fluxo client credentials do OAuth 2.0, com registo como Service Integration no Visma Developer Portal. O administrador do tenant aprova a integração, e os tokens são válidos durante uma hora.
O Visma Net pode enviar alterações em tempo real?
Para artigos, encomendas de clientes e encomendas a fornecedores, sim, através dos webhooks do Visma Developer Portal. Os Kit assemblies e as Kit specifications não têm eventos e são obtidos através de consultas periódicas incrementais. Os webhooks do próprio SkyPlanner enviam as alterações à programação assim que ocorrem.
Como é registada a produção concluída no Visma Net?
O SkyPlanner cria um Kit assembly para cada tarefa programada, mantém a respetiva data atualizada e chama a ação release quando a tarefa está concluída. Esta ação regista a produção e o consumo de componentes. Sem kits, Inventory receipt e Inventory issue cumprem a mesma função.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O período experimental gratuito de 30 dias permite utilizar até 20 centros de trabalho, com importações em CSV ou Excel a partir do Visma Net, sem necessidade de cartão de crédito. Inicie o período experimental ou fale com a equipa comercial para definir o âmbito da integração.
