Integrações / ERP / Comarch ERP XL
Guia de integração do Comarch ERP XL para planejamento da produção com SkyPlanner APS
Este guia de integração do Comarch ERP XL mostra a parceiros e equipes de TI como conectar o Comarch ERP XL ao SkyPlanner APS. A integração entre SkyPlanner e Comarch ERP XL é bidirecional e usa as interfaces da própria Comarch:
- O SkyPlanner recebe ordens de produção (zlecenia produkcyjne) com seus processos e operações, tecnologias, centros de trabalho, recursos, itens, estoques e pedidos de compra.
- Os horários planejados de início e término são gravados no ERP XL em cada operação da ordem de produção, por meio da XL API.
- Se você optar por isso, os apontamentos de tempo dos operadores são enviados de volta como registros de execução das operações.
- Os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
Durante a implantação, a equipe SkyPlanner configura a integração de acordo com o seu ambiente Comarch ERP XL e continua dando suporte após a entrada em produção. Este guia é para parceiros e desenvolvedores que querem participar desse trabalho ou desenvolver por conta própria com a REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do Comarch ERP XL
A Comarch lista três formas de comunicação com o ERP XL: “DCOM, direct database connection (SQL Client), REST API” (DCOM, conexão direta com o banco de dados via SQL Client, REST API) (Comarch, tradução). Para um sistema de programação da produção, duas delas atendem à 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.” (Essas funções estão reunidas na biblioteca CDN_API.DLL, instalada junto com todo o sistema Comarch ERP XL.) (Ajuda da Comarch, tradução) Um programa externo inicia a sessão com XLLogin, chama funções que compartilham essa sessão e a encerra 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 sua própria documentação interativa no endpoint /swagger.) (Ajuda da Comarch, tradução)
A conexão direta via SQL Client permite consultar dados mestres e ordens no banco de dados do ERP XL, conforme acordado com sua equipe de TI e seu parceiro Comarch.
Funções da XL API para produção
A Comarch documenta estas 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 em uma operação ou um material ou produto em uma operação |
| Ordens de produção | XLNoweZlecenieProd | Cria uma ordem de produção |
| Ordens de produção | XLZamknijZlecenieProd | Planeja, replaneja, apura ou encerra uma ordem de produção, conforme o código de ação selecionado |
| 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 registro de execução de operação à ordem e altera a quantidade realizada |
| Documentos | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Gera documentos RW e PW para objetos de produção |
Autenticação e acesso
- XL API. A integração se conecta a um banco de dados como um operador do ERP XL usando XLLogin e recebe uma sessão para as chamadas seguintes. A DLL é executada em uma máquina Windows com o ERP XL instalado. Por isso, o serviço que grava os dados de volta no ERP XL é executado na sua rede, junto ao ERP XL.
- REST API. O acesso é configurado para cada instalação do ERP XL Web. A página Swagger de cada microsserviço documenta suas chamadas.
- Leitura via SQL. Um usuário de banco de dados com acesso somente de leitura, aprovado pela sua equipe de TI.
No SkyPlanner, a REST API usa 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 você nas primeiras chamadas.
Eventos e consultas periódicas
A documentação consultada do Comarch ERP XL não apresenta webhooks de saída. O próprio APS da Comarch busca os dados quando o planejador clica em “Aktualizuj dane z ERP” (Atualizar dados do ERP) (Ajuda do Comarch APS).
Por isso, os dados do ERP XL são consultados periodicamente. As consultas filtram ordens de produção em aberto e alterações recentes para identificar novos trabalhos. A frequência é definida para cada fábrica: de consultas a cada poucos minutos para ordens de produção a consultas de hora em hora para estoques.
O SkyPlanner envia webhooks quando há mudanças de estado ou na programação. Assim, a gravação de dados de volta no ERP XL é acionada por eventos.
Mapeamento de dados
| Objeto do Comarch ERP XL (interface) | Objeto do SkyPlanner | Direção | Frequência |
|---|---|---|---|
| Karty towarów, unidades de medida (REST ou leitura via 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, a cada alteração |
| Operações de Technologia: centros de trabalho, recursos e tempos | Etapas do processo com durações, tempos de setup e de desmontagem | ERP XL → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Gniazda robocze e zasoby (máquinas, ferramentas e funcionários) | Centros de trabalho, grupos de centros de trabalho, ferramentas e pessoal | ERP XL → SkyPlanner | Carga inicial, com atualizações pouco frequentes depois |
| Kalendarze i okresy, przestoje i awarie | Turnos, períodos não trabalhados e paradas | ERP XL → SkyPlanner | Diariamente, ou com turnos próprios no SkyPlanner |
| Zlecenia produkcyjne (ZP) com processos, operações, materiais, prazo de entrega e prioridade | Ordens e operações com prazos de entrega e necessidades de materiais | ERP XL → SkyPlanner | Consultas a cada poucos minutos |
| Estoque por depósito | Saldos de estoque | ERP XL → SkyPlanner | Consultas de hora em hora ou a cada execução da programação |
| Zamówienia zakupu (ZZ) com datas de entrega | Pedidos de compra e materiais a receber por data de entrega | ERP XL → SkyPlanner | Consultas de hora em hora ou a cada execução da programação |
| Datas das operações: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Início e término planejados por operação | SkyPlanner → ERP XL | A cada alteração na programação, via webhook do SkyPlanner |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Apontamentos de tempo e confirmações dos operadores | SkyPlanner → ERP XL | Por confirmação ou por turno, se essa opção for escolhida |
| Não consta no ERP XL | Matriz de tempos de preparação e transição, ferramentas como recursos de capacidade finita, operações com vários operadores, máquinas e pessoal alternativos | Mantidos no SkyPlanner | Configurados durante a implantação |
Padrões de integração
1. Carga inicial de dados mestres. Leia itens, tecnologias, centros de trabalho, recursos e calendários. Defina com cuidado como mapear os centros de trabalho no SkyPlanner: um centro de trabalho com quatro máquinas se torna um grupo de centros de trabalho ou quatro centros de trabalho. As ferramentas cadastradas como recursos no ERP XL passam a ser ferramentas de capacidade finita no SkyPlanner, e os funcionários passam a compor o pessoal com seus respectivos turnos.
2. Sincronização de ordens e pedidos. Leia as ordens de produção com suas operações e materiais, além dos pedidos de compra em aberto. O SkyPlanner considera o material comprado disponível na data de entrega do pedido de compra e atualiza o estoque quando o pedido é marcado como Delivered.
3. Gravação da programação no ERP. Quando o mecanismo agenda ou move uma operação, um webhook do SkyPlanner aciona o serviço de gravação no ERP. O serviço chama XLDodajTerminDoProcesuProd com os valores TerminOd e TerminDo da operação, para que cada operação de ZP tenha o início e o fim planejados pelo SkyPlanner.
4. Apontamentos de chão de fábrica. Os operadores registram o trabalho com SkyPlanner Mobile Confirmations ou Production Timer, e os registros de tempo mantêm a programação atualizada. Você escolhe se os tempos reais serão enviados ao ERP. Se optar pelo envio, o serviço adiciona os apontamentos com XLDodajRealizacjeOperacjiProd, e os documentos RW e PW seguem as regras do seu ERP XL. Se você usa Comarch MES em alguns centros de trabalho, mantenha uma única fonte de apontamento por operação.
5. Responsabilidade pelos dados e regras de conflito. Documente essas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Itens, tecnologias, quantidades, status de ZP, custeio | Comarch ERP XL |
| Sequência das operações, horários de início e fim, alocação de recursos | SkyPlanner |
| Matriz de tempos de preparação e transição, requisitos de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Turnos, calendários e paradas | Um único sistema, escolhido na definição de escopo |
| Apontamentos, documentos RW e PW | Comarch ERP XL, com lançamento direto ou envio a partir dos registros de tempo do SkyPlanner |
Defina um único sistema para gravar as datas das operações. Se o replanejamento automático do ERP XL ou o Comarch APS ainda gravar datas nas mesmas ordens de produção, desative essa função para as ordens programadas pelo SkyPlanner.
Etapas típicas do projeto
A implementação normalmente é concluída em semanas após o início da implantação. Antes disso, valide a programação no teste grátis 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 mapeamento, as regras de responsabilidade pelos dados, as frequências de sincronização e se os apontamentos serão enviados ao ERP.
- Acesso ao ERP XL. Crie o operador de integração, configure a conexão de leitura e instale o serviço de gravação em um servidor com ERP XL instalado. Faça os primeiros testes em uma cópia do banco de dados.
- Carga inicial. Itens, tecnologias, centros de trabalho, recursos e calendários.
- Sincronização de ordens de produção e pedidos de compra. Consultas periódicas com filtros e novas tentativas.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação e transição, ferramentas, quantidade de operadores por operação e máquinas ou pessoal alternativos.
- Gravação da programação no ERP. Chamadas a XLDodajTerminDoProcesuProd acionadas por webhooks do SkyPlanner, além dos apontamentos, se essa opção for escolhida.
- Testes em paralelo. Execute o SkyPlanner em paralelo ao plano atual, compare as datas e corrija os dados mestres.
- Entrada em produção. Ative a gravação no ERP assim que os dados coincidirem.
O que considerar ao planejar uma integração com Comarch ERP XL
- Capacidade informada manualmente. No ERP XL, a capacidade do centro de trabalho é um número definido pelo usuário, com um percentual de carga permitido. Já o SkyPlanner calcula a capacidade a partir dos turnos e recursos reais. Por isso, configure os turnos com cuidado e deixe de lado o percentual.
- Recursos ilimitados. O ERP XL não verifica a ocupação dos recursos marcados com capacidade ilimitada. Decida, para cada um deles, se será um centro de trabalho com capacidade finita no SkyPlanner.
- Ordens liberadas. O ERP XL exclui do replanejamento as operações liberadas para produção, a menos que a opção “Przesuń na zwolnionych” esteja marcada. Defina como as datas do SkyPlanner serão aplicadas às ordens liberadas e use Running Time Lock para congelar a programação das próximas horas de trabalho.
- Versões das estruturas. As estruturas da XL API contêm um campo Wersja. Configure-o de acordo com a versão do seu ERP XL e repita os testes após cada atualização anual.
- Unidades e tempos no sistema polonês. Os tempos das operações e as unidades dos calendários devem ser convertidos com exatidão na importação. Caso contrário, todas as durações estarão erradas.
Quem configura e dá suporte à integração com Comarch ERP XL
- A equipe do SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em produção, cobrindo as leituras e chamadas à XL API acordadas. Cada fábrica usa o Comarch ERP XL de uma maneira, e é nessa etapa que esse conhecimento é aplicado.
- Seu parceiro Comarch pode participar. Ele conhece sua configuração, seu licenciamento e a XL API, e pode configurar o operador, a conexão de leitura e o servidor de gravação no ERP junto com a equipe do SkyPlanner.
- Seus próprios desenvolvedores podem ampliar a integração usando a REST API do SkyPlanner com um token de API. Um token de API é suficiente para começar, e a equipe do SkyPlanner ajuda quando necessário. A documentação está disponível em Documentação de integração do SkyPlanner.
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. Consulte os preços, a página de programação com capacidade finita para Comarch ERP XL, a página do Comarch ERP XL e a central de integrações com ERP.
Avaliações do SkyPlanner por fabricantes
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 · 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 operações 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.
6 mesesde visibilidade da capacidade disponível para a equipe de vendas
“O SkyPlanner oferece a base e a confiabilidade para todo o planejamento da produção.”
Anu Järvinen, gerente de produção
Fredman Operations · Papéis para embalagens adequados ao contato com alimentos
A equipe de vendas enxerga a capacidade disponível com seis meses de antecedência, e as solicitações de alteração da programação que levavam uma hora ou mais são respondidas em segundos.
100%de pontualidade de entrega desde 2021
“O SkyPlanner nos dá visibilidade da capacidade e torna o planejamento previsível.”
Dan Berglund, COO/CFO
Opes Corporation · Fabricação de produtos químicos e alimentos
A pontualidade de entrega se mantém em 100% durante todo o período de uso do SkyPlanner, desde 2021.
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, faz o planejamento e o replanejamento com XLZamknijZlecenieProd, adiciona datas às operações com XLDodajTerminDoProcesuProd e registra apontamentos com XLDodajRealizacjeOperacjiProd. O Comarch ERP XL Web acrescenta microsserviços REST documentados no Swagger.
Como as datas planejadas são gravadas no Comarch ERP XL?
Por meio de XLDodajTerminDoProcesuProd, que adiciona um intervalo de datas (TerminOd, TerminDo) a cada operação da ordem de produção. Um webhook do SkyPlanner aciona a chamada sempre que o planejamento da produção muda.
O Comarch ERP XL oferece suporte a webhooks?
Não há webhooks de saída documentados. Por isso, a integração consulta o ERP XL periodicamente, em intervalos definidos para cada fábrica. Os próprios webhooks do SkyPlanner enviam as alterações no planejamento da produção assim que elas ocorrem.
Um parceiro Comarch deve propor Comarch APS ou SkyPlanner?
SkyPlanner, quando o cliente quer ter, em semanas, um planejamento da produção que respeite a capacidade real de máquinas e pessoal e se mantenha atualizado. O Comarch APS é uma aplicação separada, com banco de dados PostgreSQL, integrador e chave de licença próprios. A sincronização ocorre quando o planejador clica, e o tempo de setup é um valor fixo por operação (ajuda do Comarch APS). O SkyPlanner é um software em nuvem que replaneja automaticamente e planeja trocas de produção, ferramentas, equipes e materiais, a partir de 199 € por mês.
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 ERP XL em CSV ou Excel, sem cartão de crédito. Inicie o teste ou fale com a equipe de vendas para definir o escopo da integração.
