Integrações / ERP / Comarch ERP XL
Guia de integração do Comarch ERP XL para programação da produção com o SkyPlanner APS
Este guia de integração do Comarch ERP XL mostra aos parceiros e às equipas de TI como ligar o Comarch ERP XL ao SkyPlanner APS. O SkyPlanner integra-se com o Comarch ERP XL nos dois sentidos, através das interfaces da própria Comarch:
- São importadas ordens de produção (zlecenia produkcyjne) com processos e operações, tecnologias, centros de trabalho, recursos, artigos, existências e encomendas de compra.
- As datas e horas de início e fim planeadas são devolvidas a cada operação da ordem de produção através da XL API.
- Se optar por essa funcionalidade, os registos de tempo dos operadores são devolvidos como registos de execução das operações.
- Os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
Durante a implementação inicial, a equipa do SkyPlanner configura a integração de acordo com a sua instalação do Comarch ERP XL e assegura o suporte após a entrada em produção. Este guia destina-se a parceiros e programadores que pretendam 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 Comarch ERP XL
A Comarch apresenta três formas de comunicar com o ERP XL: “DCOM, direct database connection (SQL Client), REST API” (DCOM, ligação direta à base de dados (SQL Client), REST API) (Comarch, tradução). Para a programação da produção, duas delas asseguram a integração:
- XL API (CDN_API.DLL). “These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.” (Estas funções estão reunidas na biblioteca CDN_API.DLL, instalada juntamente com todo o sistema Comarch ERP XL.) (Ajuda da Comarch, tradução) Um programa externo inicia sessão com XLLogin, chama funções que partilham a sessão e termina a sessão com XLLogout. Cada estrutura tem um campo Wersja que seleciona a versão do conjunto de parâmetros correspondente à sua versão do ERP XL.
- ERP XL Web REST API. O Comarch ERP XL Web 2026.0 disponibiliza microsserviços REST: “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Cada microsserviço RestAPI disponibiliza a sua própria documentação interativa no endpoint /swagger.) (Ajuda da Comarch, tradução)
A ligação direta por SQL Client permite ler dados mestre e ordens na base de dados do ERP XL, nos termos acordados com a sua equipa de TI e o parceiro Comarch.
Funções da XL API para a produção
A Comarch documenta as seguintes funções de produção (XL128):
| Área | Função | O que faz |
|---|---|---|
| Tecnologias | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Cria uma tecnologia, uma operação, um centro de trabalho numa operação ou um material ou produto numa operação |
| Ordens de produção | XLNoweZlecenieProd | Cria uma ordem de produção |
| Ordens de produção | XLZamknijZlecenieProd | Planeia, replaneia, apura ou encerra uma ordem de produção, conforme o código de ação escolhido |
| Operações | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Adiciona uma operação ou um recurso a um processo de produção |
| Programação | XLDodajTerminDoProcesuProd | Adiciona um intervalo de datas a uma operação: IdCzynnosci, TerminOd, TerminDo |
| Execução | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Adiciona um registo de execução de uma operação à ordem e altera a quantidade executada |
| Documentos | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Gera documentos RW e PW para objetos de produção |
Autenticação e acesso
- XL API. A integração inicia sessão numa base de dados como operador do ERP XL através de XLLogin e recebe uma sessão para as chamadas seguintes. A DLL é executada num sistema Windows com o ERP XL instalado, pelo que o serviço que devolve os dados funciona na sua rede, junto do ERP XL.
- REST API. O acesso é configurado para cada instalação do ERP XL Web; a página Swagger de cada microsserviço documenta as respetivas chamadas.
- Leitura SQL. Uma conta de acesso à base de dados apenas para leitura, aprovada pela sua equipa de TI.
No SkyPlanner, a REST API utiliza um token de API no cabeçalho Authorization-Token para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração orienta-o nas primeiras chamadas.
Eventos e consultas periódicas
Na documentação consultada, o Comarch ERP XL não disponibiliza webhooks de saída. O próprio APS da Comarch obtém os dados quando o responsável pela programação prime “Aktualizuj dane z ERP” (Atualizar dados do ERP) (Ajuda do Comarch APS).
Por isso, os dados do ERP XL são obtidos através de consultas periódicas. As leituras, filtradas por ordens de produção em aberto e alterações recentes, detetam novo trabalho. A frequência é definida para cada fábrica: de poucos em poucos minutos para as ordens de produção e de hora a hora para as existências.
O SkyPlanner envia webhooks quando o estado ou a programação muda, pelo que a devolução dos dados é acionada por eventos.
Mapeamento de dados
| Objeto do Comarch ERP XL (interface) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Karty towarów, unidades de medida (REST ou leitura SQL) | Produtos e materiais | ERP XL → SkyPlanner | Carga inicial, seguida de consultas periódicas |
| Technologia: operações, materiais, produtos semiacabados e produtos por operação | Estrutura do produto, subprodutos e materiais por etapa do processo | ERP XL → SkyPlanner | Carga inicial e, depois, sempre que houver alterações |
| Operações de Technologia: centros de trabalho, recursos e tempos | Etapas do processo com durações e tempos de preparação e desmontagem | ERP XL → SkyPlanner | Carga inicial e, depois, sempre que houver alterações |
| Gniazda robocze e zasoby (máquinas, ferramentas, trabalhadores) | Centros de trabalho, grupos de centros de trabalho, ferramentas e pessoal | ERP XL → SkyPlanner | Carga inicial e, depois, raramente |
| Kalendarze i okresy, przestoje i awarie | Turnos, períodos não laborais e paragens | ERP XL → SkyPlanner | Diariamente, ou com turnos definidos no SkyPlanner |
| Zlecenia produkcyjne (ZP) com processos, operações, materiais, prazo e prioridade | Ordens e tarefas com prazos e necessidades de materiais | ERP XL → SkyPlanner | Consultas de poucos em poucos minutos |
| Existências por armazém | Saldos de existências | ERP XL → SkyPlanner | Consultas de hora a hora ou ao executar a programação |
| Zamówienia zakupu (ZZ) com datas de entrega | Encomendas de compra e materiais a receber por data de entrega | ERP XL → SkyPlanner | Consultas de hora a hora ou ao executar a programação |
| Datas da operação: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Início e fim planeados por tarefa | SkyPlanner → ERP XL | Quando a programação muda, através de um webhook do SkyPlanner |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Registos de tempo e confirmações dos operadores | SkyPlanner → ERP XL | Por confirmação ou por turno, se optar por esta funcionalidade |
| Não existe no ERP XL | Matriz de tempos de preparação e transição, ferramentas como recursos de capacidade limitada, tarefas com vários operadores, máquinas e pessoal alternativos | Gerido no SkyPlanner | Configurado durante a implementação inicial |
Modelos de integração
1. Carga inicial de dados mestre. Leia artigos, tecnologias, centros de trabalho, recursos e calendários. Defina cuidadosamente a correspondência dos centros de trabalho no SkyPlanner: um centro de trabalho com quatro máquinas passa a ser um grupo de centros de trabalho ou quatro centros de trabalho. As ferramentas dos recursos do ERP XL passam a ser ferramentas com capacidade limitada no SkyPlanner, e os trabalhadores passam a ser pessoal com turnos atribuídos.
2. Sincronização de ordens e encomendas. Leia as ordens de produção com as respetivas operações e materiais, bem como as encomendas de compra em aberto. O SkyPlanner considera o material encomendado disponível na data de entrega da encomenda de compra e atualiza as existências quando esta é marcada como Delivered.
3. Gravação da programação no ERP. Quando o motor programa ou desloca uma operação, um webhook do SkyPlanner aciona o serviço de gravação no ERP. Este chama XLDodajTerminDoProcesuProd com os valores TerminOd e TerminDo da operação, para que cada operação ZP tenha o início e o fim planeados pelo SkyPlanner.
4. Confirmações na fábrica. Os operadores registam o trabalho com SkyPlanner Mobile Confirmations ou Production Timer, e os registos de tempo mantêm a programação atualizada. Cabe-lhe decidir se os tempos reais são enviados para o ERP. Em caso afirmativo, o serviço acrescenta registos de execução com XLDodajRealizacjeOperacjiProd, e os documentos RW e PW seguem as regras do seu ERP XL. Se utilizar Comarch MES em alguns centros de trabalho, mantenha uma única fonte de registo por operação.
5. Responsabilidade pelos dados e regras de conflito. Documente estas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Artigos, tecnologias, quantidades, estado ZP, cálculo de custos | Comarch ERP XL |
| Sequência das operações, horas de início e fim, afetação de recursos | SkyPlanner |
| Matriz de tempos de preparação, requisitos de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Turnos, calendários e paragens | Um único sistema, escolhido na definição do âmbito |
| Registos de execução, documentos RW e PW | Comarch ERP XL, com introdução direta ou envio a partir dos registos de tempo do SkyPlanner |
Escolha um único sistema para gravar as datas das operações. Se o replaneamento automático do ERP XL ou o Comarch APS continuar a gravar datas nas mesmas ordens de produção, desative essa função para as ordens programadas pelo SkyPlanner.
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, valide a programação durante o período de teste gratuito de 30 dias, com centros de trabalho, tecnologias e ordens de produção em aberto exportados do ERP XL em CSV ou Excel.
- Mapeamento. Defina a tabela de correspondências, as regras de responsabilidade pelos dados, as frequências de sincronização e se os registos de execução são enviados para o ERP.
- Acesso ao ERP XL. Crie o operador de integração, configure a ligação de leitura e instale o serviço de gravação numa máquina com o ERP XL instalado. Teste primeiro numa cópia da base de dados.
- Carregamento inicial. Artigos, tecnologias, centros de trabalho, recursos e calendários.
- Sincronização de ordens de produção e encomendas de compra. Consulta periódica com filtros e novas tentativas em caso de falha.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, número de operadores por tarefa e máquinas ou pessoal alternativos.
- Gravação da programação no ERP. Chamadas a XLDodajTerminDoProcesuProd acionadas pelos webhooks do SkyPlanner, além dos registos de execução, se essa opção tiver sido escolhida.
- Testes em paralelo. Execute o SkyPlanner em paralelo com o plano atual, compare datas e corrija os dados mestre.
- Entrada em produção. Ative a gravação no ERP quando os dados coincidirem.
O que prever numa integração com o Comarch ERP XL
- Capacidade introduzida manualmente. No ERP XL, a capacidade do centro de trabalho é um número definido pelo utilizador, com uma % de carga permitida. O SkyPlanner determina a capacidade a partir dos turnos e recursos reais. Por isso, configure os turnos com cuidado e deixe de usar a percentagem.
- Recursos ilimitados. Os recursos assinalados como tendo capacidade ilimitada não passam pela verificação de ocupação no ERP XL. Decida, para cada um, se deve tornar-se um centro de trabalho com capacidade limitada no SkyPlanner.
- Ordens lançadas. O ERP XL exclui do replaneamento as operações lançadas para produção, a menos que a opção “Przesuń na zwolnionych” esteja selecionada. Acorde como se aplicam as datas do SkyPlanner às ordens lançadas e utilize Running Time Lock para fixar a programação das próximas horas de trabalho.
- Versões das estruturas. As estruturas da XL API incluem um campo Wersja. Defina-o de acordo com a sua versão do ERP XL e volte a testar após cada atualização anual.
- Unidades e tempos polacos. Os tempos das operações e as unidades dos calendários têm de ser convertidos com exatidão na importação; caso contrário, todas as durações ficam erradas.
Quem configura e presta suporte à integração com o Comarch ERP XL
- A equipa SkyPlanner configura a integração durante a implementação e presta suporte após a entrada em produção, abrangendo as leituras e chamadas à XL API acordadas. Cada fábrica utiliza o Comarch ERP XL de forma diferente, e é aqui que esse conhecimento se aplica.
- O seu parceiro Comarch pode participar. O parceiro conhece a sua configuração, o licenciamento e a XL API, e pode configurar o operador, a ligação de leitura e o servidor de gravação no ERP em conjunto com a equipa SkyPlanner.
- Os seus programadores podem desenvolver funcionalidades adicionais através da REST API do SkyPlanner, com um token de API. Basta um token de API para começar, e a equipa SkyPlanner ajuda quando necessário. Consulte a documentação de integração do SkyPlanner.
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, juntamente com o seu plano, de acordo com os seus processos e necessidades. Consulte os preços, a programação da produção com o Comarch ERP XL respeitando a capacidade real de máquinas e pessoal, a página do Comarch ERP XL e a página de integrações ERP.
Opiniões de fabricantes sobre o SkyPlanner
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 · Indústria farmacêutica
A eficiência na produção aumentou 90%, e criar um plano otimizado para três meses que abrange todos os centros de trabalho demora menos de 30 minutos.
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 para embalagens 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 resposta em segundos.
100%de fiabilidade das entregas desde 2021
“O SkyPlanner dá-nos visibilidade sobre a capacidade e torna o planeamento previsível.”
Dan Berglund, COO/CFO
Opes Corporation · Indústria química e alimentar
A fiabilidade das entregas mantém-se nos 100% desde 2021, durante todo o período de utilização do SkyPlanner.
Perguntas frequentes
O Comarch ERP XL tem uma API para ordens de produção?
Sim. A XL API (CDN_API.DLL) cria ordens de produção, planeia-as e replaneia-as com XLZamknijZlecenieProd, acrescenta datas às operações com XLDodajTerminDoProcesuProd e grava registos de execução com XLDodajRealizacjeOperacjiProd. O Comarch ERP XL Web acrescenta microsserviços REST documentados no Swagger.
Como são gravadas no Comarch ERP XL as datas planeadas?
Através de XLDodajTerminDoProcesuProd, que acrescenta um intervalo de datas (TerminOd, TerminDo) a cada operação da ordem de produção. Um webhook do SkyPlanner aciona a chamada sempre que a programação muda.
O Comarch ERP XL suporta webhooks?
Não estão documentados webhooks de saída, pelo que a integração consulta periodicamente o ERP XL com uma frequência definida para cada fábrica. Os webhooks do próprio SkyPlanner enviam as alterações à programação assim que ocorrem.
Um parceiro Comarch deve propor o Comarch APS ou o SkyPlanner?
O SkyPlanner, quando o cliente pretende ter, em poucas semanas, uma programação que respeita a capacidade real de máquinas e pessoal e se mantém atualizada automaticamente. O Comarch APS é uma aplicação separada, com a sua própria base de dados PostgreSQL, integrador e chave de licença. A sincronização depende de um clique do planeador, e o tempo de preparação é um valor fixo por operação (ajuda do Comarch APS). O SkyPlanner é um software na nuvem que replaneia automaticamente e planeia mudanças de produção, ferramentas, equipas e materiais, a partir de 199 € por mês.
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 em CSV ou Excel a partir do ERP XL, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipa comercial para definir o âmbito da integração.
