Integrações / ERP / SAP Business ByDesign
Guia de integração do SAP Business ByDesign para programação da produção com o SkyPlanner APS
Este guia de integração do SAP Business ByDesign mostra aos parceiros e às equipas de TI como ligar o ByDesign ao SkyPlanner APS. A integração entre o SkyPlanner e o ByDesign é bidirecional e utiliza os serviços Web disponibilizados pela SAP:
- O SkyPlanner recebe ordens de produção lançadas com as respetivas operações, Production Models, Bills of Material e Bills of Operations, recursos de equipamento e mão de obra, materiais, existências e encomendas de compra.
- O início planeado de cada ordem de produção e o recurso principal de cada operação são enviados de volta para o ByDesign.
- As quantidades confirmadas, a sucata e as tarefas concluídas podem ser registadas nos lotes de produção.
- 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 com o seu tenant ByDesign através da REST API e presta suporte 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 base na REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do SAP ByDesign
Para cada versão, o ByDesign publica os serviços Web A2X SOAP disponibilizados na lista de API de serviços Web. Uma integração para programação da produção utiliza os seguintes serviços:
- Manage Production Orders (ManageProductionOrderIn). READ_PROD_ORDER devolve as datas de início e fim solicitadas, mínimas e máximas, os recursos com as durações planeadas e realizadas, a prioridade, o estado de execução e o estado de programação. MAINTAIN_BUNDLE_V2 atualiza EarliestStartPeriod ou LatestEndPeriod e MainResourceID da operação (ajuda da SAP).
- Manage Production Lots (ManageProductionLotsIn). MaintainBundle cria ou atualiza tarefas de produção: quantidade confirmada, sucata e indicador de confirmação concluída por ponto de reporte, conclusão da tarefa com o colaborador executante e o tempo de execução, e utilização dos recursos (ajuda da SAP).
- Serviços de consulta. Query Production Orders, Query Production Lots, Query Production Model, Query Production Bill of Materials, Query Production Bill of Operations (também por recurso), Query Materials, Read Equipment Resources, Query Labour Resource, Query Purchase Orders, Query Identified Stocks e Determine Availability of Products.
- OData. Serviços OData personalizados para objetos de negócio, além de OData para fontes de dados e relatórios analíticos. Segundo a SAP, as empresas decidem quais os objetos de negócio expostos: “companies are fully empowered to decide which business objects” (as empresas têm plena autonomia para decidir quais os objetos de negócio) (cenários de integração da SAP).
Utilize os serviços Query ou OData para leitura e os dois serviços Manage para todas as operações de escrita.
Autenticação e licenciamento
No ByDesign, crie um sistema de comunicação para o SkyPlanner e uma configuração de comunicação para os serviços que utiliza. Cada configuração tem o seu próprio utilizador técnico. O guia de segurança da SAP indica a autenticação da integração de aplicações com “user ID plus password, and the X.509 client certificate” (ID de utilizador e palavra-passe, e o referido certificado de cliente) (Guia de segurança). É possível configurar OAuth 2.0 para OData. Pode descarregar o WSDL de cada serviço a partir da configuração de comunicação ou do Service Explorer.
No SkyPlanner, cada chamada inclui um token de API no cabeçalho Authorization-Token. Crie o token no SkyPlanner em Settings > API. Basta um token de API para começar a desenvolver.
Eventos e consultas periódicas
O SkyPlanner envia webhooks sempre que a programação muda, pelo que as atualizações são enviadas de volta para o ByDesign à medida que o plano é alterado.
Para obter as alterações no ByDesign, consulte periodicamente os serviços Query. Leia as ordens de produção lançadas e os lotes de produção a cada poucos minutos, e os materiais, as existências e as encomendas de compra com menor frequência. Os resultados das consultas são paginados com QueryHitsMaximumNumberValue e LastReturnedObjectID; a SAP documenta o tamanho predefinido das páginas na sua página de serviços Web.
Mapeamento de dados
| Objeto ByDesign (interface) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Materiais (Query Materials) | Produtos e materiais | ByDesign → SkyPlanner | Carga inicial, seguida de consultas periódicas |
| Production Bill of Material (Query Production Bill of Materials) | Estrutura do produto, materiais por produto | ByDesign → SkyPlanner | Carregamento inicial e, depois, a cada alteração |
| Production Bill of Operations: operações e atividades Setup, Produce e Tear down (Query Production Bill of Operations) | Etapas do processo com durações e tempos de preparação e desmontagem | ByDesign → SkyPlanner | Carga inicial e, depois, sempre que houver alterações |
| Production Model (Query Production Model) | Gama operatória do produto por unidade de produção | ByDesign → SkyPlanner | Carga inicial e, depois, sempre que houver alterações |
| Recursos de equipamento e grupos de recursos (Read Equipment Resources) | Centros de trabalho, grupos de centros de trabalho, ferramentas | ByDesign → SkyPlanner | Carga inicial, raramente depois |
| Recursos de mão de obra, horários de trabalho (Query Labour Resource) | Pessoal e turnos | ByDesign → SkyPlanner | Diariamente, ou turnos próprios no SkyPlanner |
| Ordens de produção lançadas e operações (Query Production Orders, READ_PROD_ORDER) | Ordens e tarefas com datas-limite e necessidades de materiais | ByDesign → SkyPlanner | Consultas a cada poucos minutos |
| Lotes e tarefas de produção (Query Production Lots) | Progresso das tarefas | ByDesign → SkyPlanner | Consultas a cada poucos minutos |
| Existências identificadas, disponibilidade de produtos (Query Identified Stocks, Determine Availability of Products) | Saldos de existências | ByDesign → SkyPlanner | Consultas de hora a hora ou a cada execução da programação |
| Encomendas de compra (Query Purchase Orders) | Encomendas de compra, materiais a receber por data de entrega | ByDesign → SkyPlanner | Consultas de hora a hora ou a cada execução da programação |
| EarliestStartPeriod, MainResourceID da operação (Manage Production Orders, MAINTAIN_BUNDLE_V2) | Início planeado, centro de trabalho atribuído | SkyPlanner → ByDesign | A cada alteração da programação, via webhook do SkyPlanner |
| Quantidade confirmada, sucata, conclusão da tarefa (Manage Production Lots, MaintainBundle) | Registos de tempos e confirmações dos operadores | SkyPlanner → ByDesign | Por confirmação ou por turno, se essa opção for escolhida |
| Não existe no ByDesign | Matriz de tempos de preparação, necessidades de vários operadores, máquinas e pessoal alternativos | Gerido no SkyPlanner | Configurado durante a implementação inicial |
Modelos de integração
1. Carga inicial dos dados mestre. Leia os materiais, Production Models, Bills of Material e Bills of Operations, e os recursos de equipamento e mão de obra. Defina criteriosamente o mapeamento dos recursos: um grupo de recursos com quatro máquinas passa a ser um grupo de centros de trabalho ou quatro centros de trabalho. Os recursos de equipamento que são ferramentas passam a ser ferramentas com disponibilidade limitada no SkyPlanner.
2. Sincronização das ordens de produção. Leia as ordens de produção lançadas com as respetivas operações e materiais, bem como as encomendas de compra em aberto. O SkyPlanner considera os materiais encomendados disponíveis na data de entrega da encomenda de compra e atualiza as existências quando esta é marcada como Delivered. As propostas de produção permanecem no ByDesign Supply Planning até se tornarem ordens de produção.
3. Envio da programação para o ByDesign. Quando o motor programa ou desloca uma ordem, um webhook do SkyPlanner aciona MAINTAIN_BUNDLE_V2 em Manage Production Orders. Esta chamada define EarliestStartPeriod e MainResourceID da operação escolhida pelo SkyPlanner.
4. Confirmações no chão de fábrica. Os operadores registam o trabalho com SkyPlanner Mobile Confirmations ou Production Timer, e os registos de tempos mantêm a programação atualizada. Cabe-lhe decidir se os dados reais são enviados de volta. Se optar pelo envio, MaintainBundle em Manage Production Lots regista a quantidade confirmada, a sucata e a tarefa concluída com o colaborador executante. Caso contrário, as confirmações continuam a ser introduzidas no ByDesign como antes.
5. Responsabilidade pelos dados e regras de conflito. Documente estas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Materiais, Production Models, quantidades, estado das ordens e dos lotes | ByDesign |
| Sequência das operações, horas de início e fim, atribuição de recursos | SkyPlanner |
| Matriz de tempos de preparação, requisitos de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Turnos e dias não úteis | Um sistema, escolhido na definição do âmbito |
| Confirmações, movimentos de mercadorias, cálculo de custos | ByDesign, com introdução direta ou envio a partir dos registos de tempos do SkyPlanner |
Escolha um único sistema para escrever as datas das ordens. Não execute Load Leveling nos recursos cuja programação é gerida pelo SkyPlanner e verifique se a execução do planeamento não desloca ordens lançadas sob responsabilidade do SkyPlanner.
Etapas habituais do projeto
A implementação fica normalmente concluída em poucas semanas após o início da configuração. Antes disso, valide a programação durante o período experimental gratuito de 30 dias, com recursos, Bills of Operations e ordens de produção em aberto exportados do ByDesign em CSV ou Excel.
- Mapeamento. Defina a tabela de mapeamento, as regras de responsabilidade, as frequências de sincronização e se as confirmações serão enviadas de volta.
- Acesso ao ByDesign. Crie o sistema de comunicação e as configurações de comunicação, e descarregue os WSDL. Faça os primeiros testes no seu tenant de testes do ByDesign.
- Carga inicial. Materiais, Production Models, Bills of Material e Bills of Operations, recursos e horários de trabalho.
- Sincronização de ordens e encomendas de compra. Consultas periódicas com paginação, 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.
- Envio da programação para o ByDesign. Chamadas MAINTAIN_BUNDLE_V2 acionadas por webhooks do SkyPlanner e confirmações de lotes, se essa opção for escolhida.
- Testes em paralelo. Execute o SkyPlanner em paralelo com o plano atual, compare as datas e corrija os dados mestre.
- Entrada em produção. Ative o envio de dados para o ByDesign quando os dados coincidirem.
O que ter em conta numa integração com o SAP ByDesign
- Uma data por chamada. “The EarliestStartPeriod and the LatestEndPeriod cannot be updated together.” (Os campos EarliestStartPeriod e LatestEndPeriod não podem ser atualizados em simultâneo.) Use a data de início como referência para a escrita de dados no ByDesign.
- Sem bloqueio. Os serviços A2X não mantêm estado, pelo que, segundo a SAP, não é possível impor bloqueios transacionais ou lógicos. Volte a ler a ordem antes de cada escrita e trate os conflitos.
- A conclusão é definitiva. “Confirmation Finished Indicator cannot be unchecked once it is set.” (Depois de ativado, o indicador Confirmation Finished Indicator não pode ser desmarcado.) Registe a conclusão apenas quando o operador encerrar a tarefa.
- Recursos principais e adicionais. A programação no ByDesign considera os recursos principais. No SkyPlanner, modele os operadores e as ferramentas dos recursos adicionais como recursos com capacidade limitada, para que a programação também os tenha em conta.
- Preparação e desmontagem. As Bills of Operations incluem a preparação e a desmontagem como atividades. Transfira os tempos de mudança de produção que dependem da sequência para a matriz de tempos de preparação.
Quem configura e dá suporte à integração com o SAP ByDesign
- A equipa SkyPlanner configura a integração durante a implementação e presta suporte após a entrada em produção, abrangendo os serviços web e as consultas OData acordados. Cada empresa utiliza o ByDesign de forma diferente, e esse conhecimento é aplicado nesta fase.
- O seu parceiro SAP ByDesign pode participar. O parceiro conhece o seu tenant, a definição do âmbito e as extensões, e pode configurar os acordos de comunicação em conjunto com a equipa SkyPlanner.
- Os seus próprios programadores podem desenvolver soluções com base nesta integração utilizando a REST API do SkyPlanner, com um token de API no cabeçalho
Authorization-Token. A equipa SkyPlanner presta apoio 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, em conjunto com o seu plano, de acordo com o seu processo e as suas necessidades. Consulte os preços, a programação da produção para SAP ByDesign, que respeita a capacidade real das máquinas e das equipas, a página do SAP Business ByDesign e a área de integrações com ERP. Outros sistemas SAP têm guias próprios: SAP Business One e SAP S/4HANA.
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 poupa 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 · Indústria farmacêutica
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 demora menos de 30 minutos.
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 tem sido de 100% durante todo o período de utilização do SkyPlanner, desde 2021.
Menosparagens por falta de materiais
“O valor que o SkyPlanner nos traz está no facto de ser uma ferramenta que funciona no dia a dia, sobretudo para definir datas de entrega.”
Tommi Männistö, responsável pelo planeamento da produção
Eskomatic · Maquinação por subcontratação
A programação automática da carga permite definir datas de entrega mais precisas, e as paragens de produção por falta de materiais diminuíram acentuadamente.
Perguntas frequentes
Que APIs do SAP ByDesign utiliza o SkyPlanner?
Os serviços web A2X disponibilizados pela SAP. Para a leitura, são utilizados os serviços Query, como Query Production Orders e Query Purchase Orders, ou OData personalizado. Para a escrita, são utilizados Manage Production Orders e Manage Production Lots.
Que dados escreve o SkyPlanner no ByDesign?
O EarliestStartPeriod e o MainResourceID da operação em cada ordem de produção. Se optar por essa funcionalidade, as quantidades confirmadas, as rejeições e as tarefas concluídas são registadas no lote de produção.
O ByDesign envia eventos para o SkyPlanner?
O SkyPlanner consulta os serviços Query do ByDesign a intervalos de poucos minutos para obter ordens e lotes. O próprio SkyPlanner envia webhooks sempre que há uma alteração à programação, desencadeando a escrita de dados no ByDesign.
Como se autentica o SkyPlanner no ByDesign?
Através de um sistema de comunicação e de um acordo de comunicação com um utilizador técnico, conforme descrito no guia de segurança da SAP. A API do próprio SkyPlanner utiliza um token de API no cabeçalho Authorization-Token.
As propostas de produção são enviadas para o SkyPlanner?
O SkyPlanner programa ordens de produção libertadas. As propostas permanecem no ByDesign Supply Planning até se tornarem ordens de produção.
Quem desenvolve a integração?
A equipa SkyPlanner configura a integração durante a implementação e presta suporte após a entrada em produção. O seu parceiro SAP ByDesign ou os seus próprios programadores também podem desenvolver a integração utilizando a REST API do SkyPlanner, com um token de API.
