Integrações / ERP / APplus
Guia de integração do APplus para planejamento da produção com SkyPlanner APS
Este guia de integração do APplus mostra a parceiros APplus e equipes de TI como conectar o APplus ao SkyPlanner APS. A integração entre SkyPlanner e APplus é bidirecional e usa as próprias interfaces da Asseco:
- O SkyPlanner recebe ordens de produção (Fertigungsaufträge) com suas operações (Arbeitsgänge), roteiros de produção (Arbeitspläne), listas de materiais (Stücklisten), unidades de capacidade (Kapazitätsstellen e Kapazitätseinheiten), ferramentas (Betriebsmittel), estoque e pedidos de compra.
- O início, o término e a unidade de capacidade planejados para cada operação são enviados de volta à ordem de produção.
- Se você optar por isso, os apontamentos de tempo dos operadores podem ser enviados de volta como mensagens BDE na ordem.
- Os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
Durante a implantação, a equipe do SkyPlanner configura a integração conforme o seu ambiente APplus e oferece suporte após a entrada em produção. Este guia é voltado a parceiros e desenvolvedores que querem participar desse trabalho ou desenvolver por conta própria usando a REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do APplus
O APplus oferece estas opções de conexão para um sistema externo de programação da produção:
- Web services do APplus. O APplus tem uma arquitetura baseada em web services. Segundo a Asseco, todas as funções necessárias à programação da produção podem ser acessadas diretamente pela internet e usadas pelos sistemas de TI de clientes e fornecedores (Asseco). Esta é a principal opção para ler dados de produção e gravar datas planejadas.
- Business Integration Framework. Desde o APplus 6.3, o framework conecta sistemas de terceiros sem programação, por meio de estruturas de dados adaptáveis (Asseco). Use-o para mapear os objetos do APplus para a REST API do SkyPlanner.
- Universal Cloud Connector. Introduzido no APplus 7.1 para conectar soluções de parceiros e ofertas SaaS ao APplus, com alto nível de segurança para os dados transferidos (Asseco).
No APplus 10, o Flow Mode inicia processos em horários definidos ou quando determinados eventos ocorrem, sem etapas manuais (Asseco). A opção de conexão usada para transferir cada objeto é escolhida na definição de escopo da implantação.
Autenticação e acesso
- No APplus. A integração usa um usuário técnico exclusivo no APplus, com permissões limitadas aos objetos que lê e grava. Seu parceiro APplus configura o usuário e o acesso aos web services.
- Rede. O APplus pode ser executado em infraestrutura local ou em uma versão hospedada (informações sobre o APplus). A integração o acessa pelo caminho permitido pela sua equipe de TI ou pelo provedor de hospedagem.
- No SkyPlanner. A REST API usa autenticação por token de API no cabeçalho
Authorization-Token. O token é criado em Settings > API. A API está documentada em Swagger/OpenAPI, e o tutorial de integração orienta as primeiras chamadas.
Eventos e consultas periódicas
No APplus, a integração consulta periodicamente os web services em busca de ordens de produção abertas e alterações recentes, ou o Business Integration Framework envia as alterações ao SkyPlanner. A frequência é definida por fábrica: de poucos minutos para ordens a uma hora para estoque.
O SkyPlanner envia webhooks quando há mudanças de estado ou na programação. Assim, o envio de atualizações de volta ao APplus é acionado por eventos.
Mapeamento de dados
| Objeto do APplus | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Itens (Artikel), unidades | Produtos e materiais | APplus → SkyPlanner | Carga inicial e, depois, consultas periódicas |
| Listas de materiais (Stücklisten, Strukturstücklisten) | Estrutura do produto, subprodutos, materiais por produto | APplus → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Roteiros de produção (Arbeitspläne) com operações e tempos de preparação e execução | Etapas do processo com durações e tempos de preparação e desmontagem | APplus → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Pontos e unidades de capacidade (Kapazitätsstellen, Kapazitätseinheiten) | Grupos de centros de trabalho, centros de trabalho e suas eficiências | APplus → SkyPlanner | Carga inicial; raramente após isso |
| Capacidade de pessoal | Pessoal e seus turnos | APplus → SkyPlanner | Diariamente, ou turnos próprios no SkyPlanner |
| Ferramentas e dispositivos de fixação (Betriebsmittel) | Ferramentas como recursos compartilhados de capacidade finita | APplus → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Ordens de produção (Fertigungsaufträge) com operações e materiais | Ordens e operações com prazos de entrega e necessidades de materiais | APplus → SkyPlanner | Consultas a cada poucos minutos |
| Estoque físico | Saldos de estoque | APplus → SkyPlanner | Consultas a cada hora ou ao executar a programação |
| Pedidos de compra (Bestellungen) com datas de entrega | Pedidos de compra, materiais a receber por data de entrega | APplus → SkyPlanner | Consultas a cada hora ou ao executar a programação |
| Início, término e unidade de capacidade planejados para cada operação da ordem de produção | Início e término programados por operação | SkyPlanner → APplus | A cada alteração na programação, via webhook do SkyPlanner |
| Mensagens BDE: tempo e quantidade por operação, funcionário | Apontamentos de tempo e confirmações dos operadores | SkyPlanner → APplus | Por confirmação ou por turno, se essa opção for escolhida |
| Não disponível no APplus | Matriz de tempos de preparação, número de operadores por operação, máquinas e pessoal alternativos | Mantido no SkyPlanner | Configurado durante a implantação |
Padrões de integração
1. Carga inicial de dados mestres. Leia itens, listas de materiais, roteiros de produção, pontos e unidades de capacidade, Betriebsmittel e capacidade de pessoal pelos web services do APplus. Faça o mapeamento com critério: uma Kapazitätsstelle com quatro Kapazitätseinheiten corresponde a um grupo de centros de trabalho com quatro centros de trabalho.
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. As propostas de compra permanecem no APplus Disposition até se tornarem pedidos.
3. Retorno da programação ao APplus. Quando o mecanismo de programação aloca ou move uma operação, um webhook do SkyPlanner aciona a atualização no APplus pela opção de conexão acordada na definição de escopo (web services ou Business Integration Framework). Essa atualização grava o início planejado, o término planejado e a unidade de capacidade da operação na ordem de produção. Assim, o quadro de planejamento do APplus exibe a sequência definida pelo SkyPlanner.
4. Liberação de ordens para o chão de fábrica. O planejador continua liberando as ordens para o chão de fábrica (Werkstattaufträge) no APplus, agora com as datas do SkyPlanner. As ordens liberadas e seus status retornam ao SkyPlanner na próxima sincronização.
5. Confirmações do chão de fábrica. Os operadores registram o trabalho no SkyPlanner Mobile Confirmations ou no Production Timer, e os apontamentos de tempo mantêm a programação atualizada. Você escolhe se os tempos reais devem ser enviados de volta ao APplus. Se sim, o tempo e a quantidade são registrados por operação como mensagens BDE na ordem. Se o BDE por código de barras continuar em uso, o SkyPlanner passa a ler as mensagens do APplus.
6. Responsabilidade pelos dados e regras de conflito. Documente essas regras antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Itens, listas de materiais, roteiros de produção, quantidades, status das ordens, liberação de ordens para o chão de fábrica | APplus |
| Sequência das operações, horários de início e término, alocação de unidades de capacidade | SkyPlanner |
| Matriz de tempos de preparação, número de operadores, recursos alternativos | SkyPlanner |
| Dados mestres de Betriebsmittel | APplus; disponibilidade ao longo do tempo planejada no SkyPlanner |
| Turnos e dias não úteis | Um único sistema, escolhido na definição de escopo |
| Mensagens BDE, saídas e entradas de materiais | APplus, com registros feitos diretamente nele ou enviados a partir dos apontamentos de tempo do SkyPlanner |
Escolha um único sistema para gravar as datas das operações. Se a programação PPS estiver ativa, ou se Feinplanung ou APplus APS gravar datas, desative essa função para as ordens programadas pelo 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, valide a programação no teste gratuito de 30 dias com unidades de capacidade, roteiros de produção e ordens de produção abertas exportados do APplus em CSV ou Excel.
- Mapeamento. Defina a tabela de mapeamento, as regras de responsabilidade pelos dados, as frequências de sincronização e se as mensagens BDE serão enviadas de volta ao APplus.
- Acesso ao APplus. Crie o usuário técnico, habilite os web services com seu parceiro APplus e faça os primeiros testes em um ambiente de testes.
- Carga inicial. Itens, listas de materiais, roteiros de produção, pontos e unidades de capacidade, Betriebsmittel e pessoal.
- Sincronização de ordens e pedidos de compra. Consultas periódicas com filtros, paginação e novas tentativas, ou envio pelo Business Integration Framework.
- Configuração das restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, número de operadores por operação e máquinas ou pessoal alternativos.
- Gravação da programação no APplus. Datas das operações recebidas pelos webhooks do SkyPlanner, além de mensagens BDE, se essa opção for escolhida.
- Testes em paralelo. Use o SkyPlanner em paralelo com o quadro de planejamento atual, compare as datas e corrija os dados mestres.
- Entrada em produção. Ative a gravação no APplus quando os dados estiverem consistentes entre os sistemas.
O que considerar ao planejar uma integração com o APplus
- Unidades com capacidade limitada e ilimitada. No APplus, algumas unidades podem ser planejadas com capacidade ilimitada. No SkyPlanner, todo centro de trabalho tem capacidade finita; por isso, confira os turnos e a eficiência de cada um na importação.
- Camadas de planejamento em uso. Verifique se o Feinplanung ou o APplus APS está licenciado e em uso, e defina um único sistema responsável por gravar as datas.
- Documentos de produção e códigos de barras. As mensagens BDE são registradas nas ordens que têm documentos de produção impressos. Combine se a liberação e a impressão continuarão no APplus, como hoje.
- Unidades dos tempos de preparação e execução. Na importação, converta os tempos de preparação e execução usando a unidade e a base corretas; caso contrário, todas as durações ficarão erradas.
- Operações externas. Operações terceirizadas representam tempo decorrido, não consumo da sua capacidade. Modele-as como etapas que consideram apenas o tempo.
- Instalações hospedadas. Se você usa a versão hospedada, combine desde o início com o provedor de hospedagem a rota de rede para acessar os web services.
Quem configura e dá suporte à integração com o APplus
- A equipe SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em produção, abrangendo os web services e mapeamentos acordados. Cada fábrica usa o APplus de uma forma, e é nessa etapa que esse conhecimento é aplicado.
- Seu parceiro APplus pode participar. Ele conhece suas customizações, permissões de usuário e configuração do Business Integration Framework, e pode liberar o acesso junto com a equipe SkyPlanner.
- Seus próprios desenvolvedores podem ampliar a integração usando a REST API do SkyPlanner com um token de API. Basta um token de API para começar, e a equipe SkyPlanner ajuda quando necessário. Consulte a 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, conforme seu processo e suas necessidades. Consulte os preços, a página sobre programação com capacidade finita no APplus, a página do APplus e a central de integrações com ERP.
O que os fabricantes dizem sobre o SkyPlanner
2 heconomizadas por semana
“Com o SkyPlanner, nosso planejamento da produção passou das planilhas do 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 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 a elaboração de um plano otimizado para três meses, abrangendo 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 próprios para contato com alimentos usados em embalagens
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 agora são respondidas em segundos.
Menosparadas por falta de materiais
“O valor que o SkyPlanner nos traz é ser uma ferramenta que funciona no dia a dia, especialmente para definir datas de entrega.”
Tommi Männistö, gerente de planejamento da produção
Eskomatic · Usinagem sob contrato
A programação automática da carga de produção permite definir datas de entrega mais precisas, e as paradas de produção por falta de materiais diminuíram significativamente.
Perguntas frequentes
O APplus tem uma API para ordens de produção?
Sim. O APplus foi desenvolvido com uma arquitetura de web services, e a Asseco afirma que suas funções de planejamento da produção podem ser usadas diretamente pelos sistemas de TI de clientes e fornecedores. O Business Integration Framework conecta sistemas de terceiros por meio de estruturas de dados adaptativas, e o Universal Cloud Connector conecta soluções SaaS ao APplus.
Como as datas planejadas são gravadas de volta no APplus?
A cada alteração no planejamento da produção, um webhook do SkyPlanner aciona a atualização do início planejado, do término planejado e da unidade de capacidade de cada operação da ordem de produção. A atualização é feita pelos web services do APplus ou pelo Business Integration Framework. O caminho é definido durante a definição de escopo da implantação.
O SkyPlanner pode enviar mensagens BDE ao APplus?
Sim, se você optar por isso. Os apontamentos de tempo dos operadores no SkyPlanner são enviados como mensagens BDE, com tempo e quantidade por operação da ordem. Nas fábricas que mantêm o BDE por código de barras, o SkyPlanner faz a leitura das mensagens em vez de enviá-las.
Um parceiro APplus deve propor o APplus APS ou o SkyPlanner?
O SkyPlanner, quando o cliente quer um planejamento da produção que respeite a capacidade real de máquinas e pessoal e esteja funcionando em semanas. O APplus APS é um produto de um parceiro integrado ao APplus, voltado a matrizes de preparação com várias ferramentas e ao planejamento de múltiplos recursos (Asseco). O SkyPlanner atende a esses casos, conecta-se pelos web services do APplus, replaneja automaticamente e oferece usuários ilimitados, a partir de 199 € por mês.
A integração funciona com o APplus hospedado?
Sim. O APplus pode ser executado em infraestrutura local ou como versão hospedada, e o SkyPlanner se conecta a ambas por web services. A rota de rede é acordada com sua equipe de TI ou seu provedor de hospedagem durante a definição de escopo.
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 CSV ou Excel do APplus e todos os recursos do plano Basic, sem cartão de crédito. Inicie o teste ou fale com a equipe de vendas para definir o escopo da integração.
