Integrações / ERP / Oracle Fusion Cloud
Guia de integração do Oracle Fusion Cloud para planejamento da produção com SkyPlanner APS
Este guia de integração do Oracle Fusion Cloud mostra a parceiros e equipes de TI como conectar o Oracle Fusion Cloud Manufacturing ao SkyPlanner APS. O SkyPlanner se integra ao Oracle Fusion Cloud nos dois sentidos, usando os recursos REST da própria Oracle:
- O SkyPlanner recebe ordens de produção e suas operações, definições de trabalho, centros de trabalho, recursos de produção, calendários, itens, estruturas de itens, saldos em estoque e pedidos de compra.
- As datas planejadas de início e conclusão são enviadas de volta para cada operação da ordem de produção.
- As confirmações dos operadores são enviadas de volta como transações de operações e de recursos.
- 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 Oracle Fusion Cloud e oferece suporte após a entrada em produção. Este guia é destinado a parceiros e desenvolvedores que queiram participar ou desenvolver por conta própria usando a REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do Oracle Fusion Cloud
O Oracle Fusion Cloud oferece três caminhos para a troca de dados com um sistema externo de programação da produção:
- REST API para Oracle Fusion Cloud SCM. O caminho base é
/fscmRestApi/resources/11.13.18.05/. Os recursos usados por um sistema de programação sãoworkOrders(com os recursos filhosWorkOrderOperation,WorkOrderOperationResourceeWorkOrderOperationMaterial),processWorkOrders,workDefinitions,workCenters,productionResources,calendars,itemsV2,itemStructureseinventoryOnhandBalances. O andamento da produção é registrado emoperationTransactions,resourceTransactionsematerialTransactions. Os pedidos de compra vêm depurchaseOrders, na Procurement REST API. (Endpoints REST) - File-Based Data Import (FBDI). O processo Import Work Orders cria ou atualiza ordens de produção com suas operações e os recursos dessas operações a partir de um modelo. Já o Import Work Order Resource Transactions carrega os apontamentos de recursos. A Oracle é clara quanto ao tempo de atualização: “This option isn’t suitable for importing manufacturing data on a real-time basis.” (Esta opção não é adequada para importar dados de manufatura em tempo real.) (fonte)
- Oracle Integration (OIC). A plataforma de integração da Oracle executa fluxos entre o Fusion e outros sistemas. Uma receita do Oracle Integration monitora o evento Work Order Status Change no Oracle Fusion Cloud Manufacturing (fonte). Use essa opção se a sua empresa já utiliza OIC.
Para programar a produção em tempo real, REST é o principal caminho. O FBDI é adequado para a carga inicial de dados mestres.
Autenticação e acesso
- Segurança REST da Oracle. “Fusion Applications REST APIs use a global Oracle Web Services Manager (OWSM) security policy called Multi Token Over SSL RESTful Service Policy.” (As REST APIs do Fusion Applications usam uma política global de segurança do Oracle Web Services Manager (OWSM) chamada Multi Token Over SSL RESTful Service Policy.) Ela aceita autenticação básica via SSL e autenticação baseada em tokens, como um token bearer SAML 2.0. (Início rápido)
- Usuário de integração. Crie um usuário Oracle exclusivo para a integração, com funções que concedam os privilégios necessários para ordens de produção, definições de trabalho, estoque e transações. Limite o acesso às organizações de manufatura incluídas no escopo.
- Paginação. A Oracle limita a quantidade de registros retornados por uma única chamada REST do SCM. Por isso, faça a leitura com
limiteoffsete filtre por organização e status (fonte)
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 as primeiras chamadas.
Eventos e consultas periódicas
Os dados da Oracle são consultados periodicamente. Consultas REST com filtros identificam ordens de produção novas e alteradas, mudanças para o status de liberação, saldos em estoque e pedidos de compra. A frequência é definida por fábrica: a cada poucos minutos para ordens de produção e a cada hora para estoque. Se você utiliza o Oracle Integration, o evento Work Order Status Change pode disparar uma leitura imediata.
O SkyPlanner envia webhooks quando há mudanças de estado ou na programação. Assim, o envio de dados de volta à Oracle é orientado a eventos.
Mapeamento de dados
| Objeto do Oracle Fusion Cloud (recurso REST) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
Itens (itemsV2), unidades de medida | Produtos e materiais | Oracle → SkyPlanner | Carga inicial, seguida de consultas periódicas |
Estruturas de itens (itemStructures) | Estrutura do produto, subprodutos, materiais por produto | Oracle → SkyPlanner | Carga inicial e, depois, a cada alteração |
Definições de trabalho (workDefinitions): operações, recursos das operações, uso, Basis Type | Etapas do processo com duração e tempos de preparação e desmontagem | Oracle → SkyPlanner | Carga inicial e, depois, a cada alteração |
Centros de trabalho (workCenters), recursos de produção (productionResources) para equipamentos e mão de obra | Centros de trabalho, grupos de centros de trabalho, pessoal, índices de eficiência | Oracle → SkyPlanner | Carga inicial e, depois, raramente |
Calendários e turnos (calendars, exceções de turno) | Turnos e dias não úteis | Oracle → SkyPlanner | Diariamente, ou turnos próprios no SkyPlanner |
| Organizações de manufatura | Grupos de centros de trabalho por fábrica | Oracle → SkyPlanner | Carga inicial |
Ordens de produção (workOrders, processWorkOrders) com WorkOrderOperation e WorkOrderOperationMaterial | Ordens e operações com prazos e necessidades de materiais | Oracle → SkyPlanner | Consultas a cada poucos minutos |
Saldos em estoque (inventoryOnhandBalances) | Saldos de estoque | Oracle → SkyPlanner | Consultas a cada hora ou ao executar a programação |
Pedidos de compra (purchaseOrders) com datas prometidas | Pedidos de compra, materiais a receber por data de entrega | Oracle → SkyPlanner | Consultas a cada hora ou ao executar a programação |
WorkOrderOperation PlannedStartDate, PlannedCompletionDate (PATCH) | Início e término planejados por operação | SkyPlanner → Oracle | A cada alteração na programação, via webhook do SkyPlanner |
Datas de WorkOrderOperationResource (PATCH) | Alocação de recursos por operação | SkyPlanner → Oracle | A cada alteração na programação, se essa opção for escolhida |
operationTransactions (POST) | Quantidades concluídas por operação | SkyPlanner → Oracle | A cada confirmação |
resourceTransactions (POST) | Apontamentos de tempo: mão de obra e máquina | SkyPlanner → Oracle | A cada confirmação ou por turno, se essa opção for escolhida |
| Não consta no Oracle Fusion Cloud | Matriz de tempos de preparação, ferramentas como recursos de capacidade finita, 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, estruturas de itens, definições de trabalho, centros de trabalho, recursos de produção e calendários via REST, ou faça uma carga única a partir de extrações FBDI. Defina com cuidado o mapeamento dos centros de trabalho: um centro com quatro máquinas do mesmo recurso se torna um grupo de centros de trabalho ou quatro centros de trabalho. Cada organização de manufatura se torna um grupo de centros de trabalho, reunindo todas as fábricas em um único plano.
2. Sincronização de ordens de produção. Leia as ordens de produção liberadas e não liberadas, 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.
Programe ordens de produção, não ordens planejadas do Supply Planning. As ordens planejadas devem primeiro ser convertidas em ordens de produção no Oracle.
3. Gravação da programação no Oracle. Quando o motor de programação aloca ou move uma operação, um webhook do SkyPlanner dispara um PATCH em workOrders/{WorkOrderId}/child/WorkOrderOperation/{WorkOrderOperationId} com PlannedStartDate e PlannedCompletionDate. Aplica-se a regra do Oracle: “The planned start date must not occur before the start date of the work order or after the finish date of the work order.” (A data de início planejada não pode ser anterior à data de início nem posterior à data de término da ordem de produção.) (fonte) Por isso, quando a nova programação ultrapassa essas datas, a integração atualiza primeiro as datas do cabeçalho da ordem de produção e depois as operações.
4. Apontamentos no chão de fábrica. Os operadores registram o trabalho pelo SkyPlanner Mobile Confirmations ou pelo Production Timer, e os registros de tempo mantêm a programação atualizada. As quantidades concluídas são enviadas para operationTransactions, e os tempos de mão de obra e de máquina, para resourceTransactions. Se a fábrica já faz os apontamentos no Oracle, o SkyPlanner lê esse progresso diretamente de lá.
5. Regras de responsabilidade pelos dados e de tratamento de conflitos. Documente essas regras antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Itens, estruturas de itens, definições de trabalho, quantidades e status das ordens de produção | Oracle Fusion Cloud |
| Sequência das operações, horários de início e conclusão e alocação de recursos | SkyPlanner |
| Matriz de tempos de preparação, requisitos de ferramentas e operadores e recursos alternativos | SkyPlanner |
| Turnos e dias não úteis | Um único sistema, escolhido na definição de escopo |
| Transações de recursos, operações e materiais | Oracle, com registros feitos diretamente nele ou enviados a partir dos registros de tempo do SkyPlanner |
Escolha um único sistema para gravar as datas das operações. O SkyPlanner não precisa de uma área de trabalho de programação no Oracle e, por isso, substitui o Production Scheduling na gravação das datas planejadas. Se o Production Scheduling ainda liberar programações, mantenha as organizações que ele atende separadas daquelas programadas pelo SkyPlanner.
Etapas típicas do projeto
A implantação normalmente é concluída em semanas após o início do onboarding, mesmo em grandes empresas. Antes disso, valide a programação no teste gratuito de 30 dias com centros de trabalho, definições de trabalho e ordens de produção em aberto exportados do Oracle em CSV ou Excel.
- Mapeamento. Defina a tabela de mapeamento, as regras de responsabilidade pelos dados, as organizações incluídas no escopo, as frequências de sincronização e se as transações serão enviadas de volta ao Oracle.
- Acesso ao Oracle. Crie o usuário de integração e os perfis de acesso. Teste primeiro em um ambiente Oracle que não seja o de produção.
- Carga inicial. Itens, estruturas de itens, definições de trabalho, centros de trabalho, recursos de produção e calendários.
- Sincronização de ordens de produção e pedidos de compra. Consultas periódicas com filtros, paginação e novas tentativas.
- Configuração de 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 Oracle. PATCH acionado por webhooks do SkyPlanner, além das transações, 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 mestres.
- Entrada em produção. Ative a gravação no Oracle, fábrica por fábrica, assim que os dados coincidirem.
O que considerar ao planejar a integração com o Oracle Fusion Cloud
- Comportamento padrão do sistema de programação. O motor de programação sem restrições do Oracle é executado na criação e em “certain update actions.” (determinadas ações de atualização) Teste no seu ambiente quais atualizações recalculam as datas e mantenha o SkyPlanner como o último sistema a gravar as datas das operações.
- Intervalo das ordens de produção. As datas das operações devem estar entre as datas de início e conclusão da ordem de produção. Atualize o cabeçalho primeiro.
- Basis Type. O uso do recurso só é calculado por unidade quando Basis Type é Variable. A opção Fixed corresponde a um tempo fixo por operação. Faça a conversão na importação; caso contrário, todas as durações ficarão incorretas.
- Manufatura discreta e por processo. Fábricas de manufatura discreta usam
workOrders; as de manufatura por processo usamprocessWorkOrders. Mapeie ambos se você trabalhar com os dois modelos. - Paginação. O Oracle limita o número de registros por chamada REST. Use paginação em todas as consultas e filtre por organização e status.
- Atualizações trimestrais. A Oracle atualiza o Fusion a cada trimestre. Fixe a versão REST no caminho e repita os testes após cada atualização.
- Regras de status. Ordens de produção com status Pending Approval ou encerradas não devem receber novas datas. Exclua-as com filtros na leitura.
Quem configura e dá suporte à integração com o Oracle Fusion Cloud
- A equipe do SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em produção, abrangendo os recursos REST e as organizações acordados. Cada fábrica usa o Oracle Fusion Cloud de uma forma, e é nessa etapa que esse conhecimento é aplicado.
- Seu parceiro Oracle pode participar. Ele conhece suas organizações, perfis de acesso e extensões e pode configurar o usuário de integração, os perfis de acesso e os fluxos necessários do Oracle Integration 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 basta 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 seus processos e necessidades. Consulte os preços, a programação com capacidade finita para Oracle Fusion Cloud, a página do Oracle Fusion Cloud e a central de integrações com ERP. Usa NetSuite? Consulte o guia de integração com NetSuite.
Avaliações de fabricantes sobre o SkyPlanner
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 · 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, diretor de TI
Laboratory & Allied · Fabricação de produtos farmacêuticos
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.
99,2%de pontualidade de entrega
“O SkyPlanner trouxe visibilidade para identificar gargalos e tornou a gestão da produção mais clara.”
Toni Tuori, gerente de produção
Piristeel · Sistemas de segurança para telhados e de drenagem de águas pluviais
A pontualidade de entrega chegou a 99,2% neste ano, e a programação economiza até quatro horas de trabalho por dia.
Mais de 1.000 ordens de produção programadas automaticamente
“Agora temos outro controle sobre a produção, e nossa compreensão da capacidade está em um patamar completamente diferente.”
Hannu Ryynänen, CEO
Mamec · Misturadores industriais, bombas e fabricação sob contrato de alta tecnologia
Milhares de ordens de produção são programadas automaticamente, com uma visão da produção em tempo real para toda a organização.
Perguntas frequentes
O Oracle Fusion Cloud tem uma API para ordens de produção?
Sim. A REST API do Oracle Fusion Cloud SCM oferece workOrders com recursos filhos de operações, recursos e materiais, além de processWorkOrders para manufatura por processo. Ela permite GET, POST e PATCH.
Como as datas planejadas são enviadas de volta ao Oracle Fusion Cloud?
Por meio de um PATCH no recurso filho WorkOrderOperation da ordem de produção, definindo PlannedStartDate e PlannedCompletionDate. As datas das operações devem permanecer dentro do intervalo de datas da ordem de produção. Por isso, o cabeçalho é atualizado primeiro quando necessário.
Como os apontamentos dos operadores chegam ao Oracle?
As quantidades concluídas são enviadas para operationTransactions, e os tempos de mão de obra e de máquina, para resourceTransactions. Ambos são recursos REST que recebem POST no Fusion Manufacturing.
O Oracle Fusion Cloud oferece suporte a webhooks?
O Fusion publica eventos de negócio, como Work Order Status Change, que podem ser assinados pelo Oracle Integration. Sem o Oracle Integration, a integração consulta a REST API em intervalos definidos por fábrica. Os webhooks do próprio SkyPlanner enviam as alterações no planejamento assim que elas ocorrem.
Um parceiro Oracle deve recomendar o Oracle Production Scheduling ou o SkyPlanner?
O SkyPlanner, quando o cliente quer um planejamento da produção único para várias fábricas, que respeite a capacidade real dos recursos e se mantenha atualizado automaticamente. O Production Scheduling é habilitado na oferta Supply Chain Planning, calcula a programação por organização de planejamento e aplica regras de troca de produção apenas a equipamentos de unidade única (documentação da Oracle). O SkyPlanner se conecta pela SCM REST API, refaz o planejamento automaticamente e planeja trocas de produção, ferramentas, equipes e materiais, com usuários ilimitados, 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 usar até 20 centros de trabalho com importações de arquivos CSV ou Excel do Oracle, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipe comercial para definir o escopo da integração.
