Integrações / ERP / SAP Business ByDesign
Guia de integração do SAP Business ByDesign para planejamento da produção com SkyPlanner APS
Este guia de integração do SAP Business ByDesign mostra a parceiros e equipes de TI como conectar o ByDesign ao SkyPlanner APS. A integração entre SkyPlanner e ByDesign é bidirecional e utiliza os serviços web liberados pela SAP:
- O SkyPlanner recebe ordens de produção liberadas com suas operações, Production Models, Bills of Material e Bills of Operations, recursos de equipamento e mão de obra, materiais, estoques e pedidos de compra.
- O início planejado de cada ordem de produção e o recurso principal de cada operação são enviados de volta ao ByDesign.
- Quantidades confirmadas, refugos e tarefas concluídas podem ser registrados nos lotes de produção.
- Os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
Durante a implantação inicial, a equipe SkyPlanner configura a integração com seu tenant do ByDesign por meio da REST API e oferece suporte após a entrada em produção. Este guia é destinado a parceiros e desenvolvedores que desejam participar desse trabalho ou desenvolver suas próprias soluções com a REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do SAP ByDesign
A cada versão, o ByDesign publica os serviços web A2X SOAP liberados na lista de APIs 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 retorna os horários solicitados, mais antecipados e mais tardios de início e término, os recursos com duração planejada e realizada, a prioridade, o status de execução e o status de programação. MAINTAIN_BUNDLE_V2 atualiza EarliestStartPeriod ou LatestEndPeriod e o MainResourceID da operação (ajuda da SAP).
- Manage Production Lots (ManageProductionLotsIn). MaintainBundle cria ou atualiza tarefas de produção: quantidade confirmada, refugo e indicador de confirmação concluída por ponto de apontamento, conclusão da tarefa com o funcionário executor e o tempo de execução, além da 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. Sobre a escolha dos objetos de negócio expostos, a SAP afirma: “companies are fully empowered to decide which business objects” (as empresas têm plena autonomia para decidir quais objetos de negócio) (cenários de integração da SAP).
Use os serviços Query ou OData para leitura e os dois serviços Manage para todas as gravações.
Autenticação e licenciamento
No ByDesign, crie um sistema de comunicação para o SkyPlanner e um acordo de comunicação para os serviços utilizados. Cada acordo tem seu próprio usuário técnico. O guia de segurança da SAP descreve a autenticação da integração de aplicações com “user ID plus password, and the X.509 client certificate” (ID de usuário e senha, além do certificado de cliente mencionado) (Guia de segurança). É possível configurar OAuth 2.0 para OData. Baixe o WSDL de cada serviço no acordo de comunicação ou no Service Explorer.
No SkyPlanner, cada chamada envia um token de API no cabeçalho Authorization-Token. Crie o token no SkyPlanner em Settings > API. Um token de API é suficiente para começar a desenvolver.
Eventos e consultas periódicas
O SkyPlanner envia webhooks a cada alteração na programação, para que as atualizações sejam gravadas no ByDesign conforme o plano muda.
Para identificar alterações no ByDesign, consulte periodicamente os serviços Query. Leia as ordens de produção liberadas e os lotes de produção a cada poucos minutos; para materiais, estoques e pedidos de compra, use intervalos maiores. Os resultados das consultas são paginados com QueryHitsMaximumNumberValue e LastReturnedObjectID; a SAP documenta o tamanho padrão da página em sua página de serviços web.
Mapeamento de dados
| Objeto do ByDesign (interface) | Objeto no SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Materiais (Query Materials) | Produtos e materiais | ByDesign → SkyPlanner | Carga inicial, depois consultas periódicas |
| Production Bill of Material (Query Production Bill of Materials) | Estrutura do produto, materiais por produto | ByDesign → SkyPlanner | Carga 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, depois a cada alteração |
| Production Model (Query Production Model) | Roteiro de produção do produto por unidade | ByDesign → SkyPlanner | Carga inicial, depois a cada alteração |
| 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 gestão dos turnos no SkyPlanner |
| Ordens de produção liberadas e operações (Query Production Orders, READ_PROD_ORDER) | Ordens e operações com prazos de entrega e necessidades de materiais | ByDesign → SkyPlanner | Consultas a cada poucos minutos |
| Lotes e tarefas de produção (Query Production Lots) | Andamento das operações | ByDesign → SkyPlanner | Consultas a cada poucos minutos |
| Estoque identificado, disponibilidade de produtos (Query Identified Stocks, Determine Availability of Products) | Saldos de estoque | ByDesign → SkyPlanner | Consultas a cada hora ou ao executar a programação |
| Pedidos de compra (Query Purchase Orders) | Pedidos de compra, materiais a receber por data de entrega | ByDesign → SkyPlanner | Consultas a cada hora ou ao executar a programação |
| EarliestStartPeriod, MainResourceID da operação (Manage Production Orders, MAINTAIN_BUNDLE_V2) | Início planejado, centro de trabalho atribuído | SkyPlanner → ByDesign | A cada alteração na programação, via webhook do SkyPlanner |
| Quantidade confirmada, refugo, conclusão de tarefa (Manage Production Lots, MaintainBundle) | Apontamentos de tempo e confirmações dos operadores | SkyPlanner → ByDesign | Por confirmação ou por turno, se essa opção for escolhida |
| Não consta no ByDesign | Matriz de tempos de preparação, requisitos de múltiplos operadores, máquinas e pessoal alternativos | Mantidos no SkyPlanner | Configurados durante a implantação inicial |
Padrões de integração
1. Carga inicial de dados mestres. Leia materiais, Production Models, Bills of Material e Bills of Operations, além dos recursos de equipamento e mão de obra. Defina o mapeamento dos recursos com cuidado: um grupo de recursos com quatro máquinas torna-se um grupo de centros de trabalho ou quatro centros de trabalho. Recursos de equipamento que são ferramentas tornam-se ferramentas com capacidade finita no SkyPlanner.
2. Sincronização de ordens de produção. Leia as ordens de produção liberadas com suas operações e materiais, além dos pedidos de compra em aberto. O SkyPlanner considera o material encomendado disponível na data de entrega do pedido de compra e atualiza o estoque quando o pedido recebe o status Delivered. As propostas de produção permanecem no Supply Planning do ByDesign até se tornarem ordens de produção.
3. Gravação da programação no ByDesign. Quando o mecanismo de programação aloca ou move uma ordem, um webhook do SkyPlanner aciona MAINTAIN_BUNDLE_V2 em Manage Production Orders. Essa chamada define EarliestStartPeriod e MainResourceID da operação escolhida pelo SkyPlanner.
4. Confirmações no chão de fábrica. Os operadores registram o trabalho com SkyPlanner Mobile Confirmations ou Production Timer, e os apontamentos de tempo mantêm a programação atualizada. Você decide se os dados realizados serão enviados de volta. Se sim, MaintainBundle em Manage Production Lots registra a quantidade confirmada, o refugo e a tarefa concluída com o funcionário executor. Caso contrário, as confirmações continuam sendo inseridas no ByDesign como antes.
5. Responsabilidade pelos dados e regras de conflito. Documente essas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Materiais, Production Models, quantidades, status de ordens e lotes | ByDesign |
| Sequência das operações, horários de início e término, atribuição de recursos | SkyPlanner |
| Matriz de tempos de preparação e troca, requisitos de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Turnos e dias não úteis | Um sistema, escolhido na definição de escopo |
| Confirmações, movimentações de mercadorias, cálculo de custos | ByDesign, com entrada direta ou envio a partir dos apontamentos de tempo do SkyPlanner |
Defina um único sistema responsável por gravar as datas das ordens. Não execute Load Leveling nos recursos programados pelo SkyPlanner e verifique se a execução do planejamento não move as ordens liberadas sob responsabilidade do 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 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 pelos dados, 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 os acordos de comunicação e baixe os WSDLs. Faça os primeiros testes no seu tenant de teste 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 pedidos de compra. Consultas periódicas com paginação, filtros e novas tentativas.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, quantidade de operadores por operação e máquinas ou profissionais alternativos.
- Gravação da programação no ERP. Chamadas MAINTAIN_BUNDLE_V2 acionadas por webhooks do SkyPlanner, além de confirmações de lote, se você optar por incluí-las.
- Testes em paralelo. Execute o SkyPlanner em paralelo com o plano atual, compare as datas e corrija os dados mestres.
- Entrada em produção. Ative a gravação de retorno quando os dados estiverem consistentes entre os sistemas.
O que considerar ao planejar uma integração com o SAP ByDesign
- Uma data por chamada. “The EarliestStartPeriod and the LatestEndPeriod cannot be updated together.” (EarliestStartPeriod e LatestEndPeriod não podem ser atualizados juntos.) Use a data de início como referência para a gravação no ERP.
- Sem bloqueio. Os serviços A2X não mantêm estado; por isso, segundo a SAP, não é possível impor bloqueios transacionais ou lógicos. Leia a ordem novamente antes de cada gravação e trate os conflitos.
- A conclusão é definitiva. “Confirmation Finished Indicator cannot be unchecked once it is set.” (O indicador Confirmation Finished Indicator não pode ser desmarcado depois de marcado.) Registre a conclusão somente quando o operador encerrar a tarefa.
- Recursos principais e adicionais. A programação do ByDesign considera os recursos principais. No SkyPlanner, modele os operadores e as ferramentas dos recursos adicionais como recursos de capacidade finita, para que a programação também verifique sua disponibilidade.
- Preparação e desmontagem. Em Bills of Operations, a preparação e a desmontagem são registradas como atividades. Transfira os tempos de troca 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 equipe do SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em operação, abrangendo os serviços web e as consultas OData acordados. Cada empresa usa o ByDesign de uma forma, e é nessa configuração que esse conhecimento é aplicado.
- Seu parceiro SAP ByDesign pode participar. Ele conhece seu tenant, sua definição de escopo e suas extensões, e pode configurar os arranjos de comunicação 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 no cabeçalho
Authorization-Token. A equipe do 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 seu plano, de acordo com seus processos e necessidades. Consulte os preços, a programação com capacidade finita para SAP ByDesign, a página do SAP Business ByDesign e a central de integrações com ERP. Outros sistemas SAP têm guias próprios: SAP Business One e SAP S/4HANA.
Avaliações de fabricantes sobre o SkyPlanner
2 heconomizadas por semana
“Com o SkyPlanner, nosso planejamento da produção saiu das planilhas do 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 trabalho 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 · Indústria farmacêutica
A eficiência na produção aumentou 90%, e um plano otimizado de três meses para todos os centros de trabalho fica pronto em menos de 30 minutos.
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 · Indústria química e alimentícia
A pontualidade de entrega se mantém em 100% durante todo o período de uso do SkyPlanner, desde 2021.
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 trabalho permite definir datas de entrega mais precisas, e as paradas de produção por falta de materiais diminuíram bastante.
Perguntas frequentes
Quais APIs do SAP ByDesign o SkyPlanner usa?
Os serviços web A2X disponibilizados pela SAP. As leituras usam os serviços Query, como Query Production Orders e Query Purchase Orders, ou OData personalizado. As gravações usam Manage Production Orders e Manage Production Lots.
Quais dados o SkyPlanner grava de volta no ByDesign?
O EarliestStartPeriod e o MainResourceID da operação em cada ordem de produção. Se você optar por isso, as quantidades confirmadas, os refugos e as tarefas concluídas são registrados no lote de produção.
O ByDesign envia eventos ao SkyPlanner?
O SkyPlanner consulta os serviços Query do ByDesign a cada poucos minutos para obter ordens e lotes. O próprio SkyPlanner envia webhooks a cada alteração no planejamento da produção, acionando a gravação de volta no ERP.
Como o SkyPlanner se autentica no ByDesign?
Por meio de um sistema de comunicação e de um arranjo de comunicação com um usuário técnico, conforme descrito no guia de segurança da SAP. A API do próprio SkyPlanner usa um token de API no cabeçalho Authorization-Token.
As propostas de produção são enviadas ao SkyPlanner?
O SkyPlanner faz o planejamento da produção com ordens de produção liberadas. As propostas permanecem no ByDesign Supply Planning até se tornarem ordens de produção.
Quem desenvolve a integração?
A equipe do SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em operação. Seu parceiro SAP ByDesign ou seus próprios desenvolvedores também podem desenvolver usando a REST API do SkyPlanner com um token de API.
