Integrações / ERP / Oracle Fusion Cloud
Guia de integração do Oracle Fusion Cloud para programação da produção com o SkyPlanner APS
Este guia de integração do Oracle Fusion Cloud mostra aos parceiros e às equipas de TI como ligar o Oracle Fusion Cloud Manufacturing ao SkyPlanner APS. O SkyPlanner integra-se com o Oracle Fusion Cloud nos dois sentidos, através dos recursos REST da própria Oracle:
- São importadas as ordens de fabrico e respetivas operações, definições de trabalho, centros de trabalho, recursos de produção, calendários, artigos, estruturas de artigos, existências e encomendas de compra.
- As datas de início e conclusão planeadas são enviadas de volta para cada operação da ordem de fabrico.
- 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 à programação assim que ocorrem.
Durante a implementação inicial, a equipa do SkyPlanner configura a integração de acordo com a sua configuração do Oracle Fusion Cloud e presta apoio após a entrada em produção. Este guia destina-se a parceiros e programadores que queiram participar ou desenvolver a integração por conta própria com base na REST API documentada do SkyPlanner (documentação de referência da API).
Interfaces de integração do Oracle Fusion Cloud
O Oracle Fusion Cloud disponibiliza três vias de acesso aos dados para 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/. Um sistema de programação da produção utiliza os recursosworkOrders(com os recursos subordinadosWorkOrderOperation,WorkOrderOperationResourceeWorkOrderOperationMaterial),processWorkOrders,workDefinitions,workCenters,productionResources,calendars,itemsV2,itemStructureseinventoryOnhandBalances. O progresso é registado emoperationTransactions,resourceTransactionsematerialTransactions. As encomendas de compra são obtidas empurchaseOrders, na Procurement REST API. (Endpoints REST) - File-Based Data Import (FBDI). O processo Import Work Orders cria ou atualiza ordens de fabrico com as respetivas operações e recursos de operação a partir de um modelo. O processo Import Work Order Resource Transactions carrega os registos de utilização de recursos. A Oracle é clara quanto à atualização dos dados: “This option isn’t suitable for importing manufacturing data on a real-time basis.” (Esta opção não é adequada para importar dados de fabrico em tempo real.) (fonte)
- Oracle Integration (OIC). A plataforma de integração da Oracle gere os fluxos entre o Fusion e outros sistemas. Uma receita do Oracle Integration deteta o evento Work Order Status Change no Oracle Fusion Cloud Manufacturing (fonte). Utilize esta via se a sua empresa já usar OIC.
Para a programação em tempo real, REST é a principal via. O FBDI é adequado para o carregamento inicial de dados mestre.
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 utilizam uma política de segurança global do Oracle Web Services Manager (OWSM) denominada Multi Token Over SSL RESTful Service Policy.) Esta política aceita autenticação Basic através de SSL e autenticação por token, como um token bearer SAML 2.0. (Guia de início rápido)
- Utilizador de integração. Crie um utilizador Oracle dedicado à integração, com perfis funcionais que concedam as permissões necessárias para ordens de fabrico, definições de trabalho, inventário e transações. Limite o acesso às organizações de fabrico abrangidas pelo projeto.
- Paginação. A Oracle limita o número de registos devolvidos por cada chamada SCM REST. Por isso, utilize
limiteoffsetna leitura e filtre por organização e estado (fonte)
Do lado do SkyPlanner, a REST API utiliza 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 explica como efetuar as primeiras chamadas.
Eventos e consultas periódicas
Os dados da Oracle são obtidos por consultas periódicas. As consultas REST filtradas recolhem ordens de fabrico novas e alteradas, alterações para o estado de libertação, existências e encomendas de compra. A frequência é definida por fábrica: de poucos em poucos minutos para as ordens de fabrico e de hora a hora para as existências. Se utilizar o Oracle Integration, o evento Work Order Status Change pode desencadear uma leitura imediata.
O SkyPlanner envia webhooks quando o estado ou a programação mudam, pelo que a gravação dos dados no Oracle é acionada por eventos.
Mapeamento de dados
| Objeto do Oracle Fusion Cloud (recurso REST) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
Artigos (itemsV2), unidades de medida | Produtos e materiais | Oracle → SkyPlanner | Carregamento inicial, depois consultas periódicas |
Estruturas de artigos (itemStructures) | Estrutura do produto, subprodutos, materiais por produto | Oracle → SkyPlanner | Carregamento inicial, depois a cada alteração |
Definições de trabalho (workDefinitions): operações, recursos de operação, utilização, Basis Type | Etapas do processo com durações e tempos de preparação e desmontagem | Oracle → SkyPlanner | Carregamento inicial, depois a cada alteração |
Centros de trabalho (workCenters), recursos de produção (productionResources) de equipamento e mão de obra | Centros de trabalho, grupos de centros de trabalho, pessoal, eficiências | Oracle → SkyPlanner | Carregamento inicial, raramente depois |
Calendários e turnos (calendars, exceções de turnos) | Turnos e dias não úteis | Oracle → SkyPlanner | Diariamente, ou turnos geridos no SkyPlanner |
| Organizações de fabrico | Grupos de centros de trabalho por fábrica | Oracle → SkyPlanner | Carregamento inicial |
Ordens de fabrico (workOrders, processWorkOrders) com WorkOrderOperation e WorkOrderOperationMaterial | Ordens e tarefas com prazos e necessidades de materiais | Oracle → SkyPlanner | Consultas de poucos em poucos minutos |
Existências (inventoryOnhandBalances) | Saldos de existências | Oracle → SkyPlanner | Consultas de hora a hora ou ao executar a programação |
Encomendas de compra (purchaseOrders) com datas de entrega acordadas | Encomendas de compra, materiais a receber por data de entrega | Oracle → SkyPlanner | Consultas de hora a hora ou ao executar a programação |
WorkOrderOperation PlannedStartDate, PlannedCompletionDate (PATCH) | Início e fim planeados por tarefa | SkyPlanner → Oracle | A cada alteração da programação, através de um webhook do SkyPlanner |
Datas de WorkOrderOperationResource (PATCH) | Atribuição de recursos por tarefa | SkyPlanner → Oracle | A cada alteração da programação, se essa opção for escolhida |
operationTransactions (POST) | Quantidades concluídas por operação | SkyPlanner → Oracle | A cada confirmação |
resourceTransactions (POST) | Registos de tempos: mão de obra e tempo de máquina | SkyPlanner → Oracle | A cada confirmação ou por turno, se essa opção for escolhida |
| Não existe no Oracle Fusion Cloud | Matriz de tempos de preparação, ferramentas como recursos de capacidade limitada, máquinas e pessoal alternativos | Gerido no SkyPlanner | Configurado durante a implementação inicial |
Padrões de integração
1. Carregamento inicial de dados mestre. Leia artigos, estruturas de artigos, definições de trabalho, centros de trabalho, recursos de produção e calendários através de REST, ou carregue-os uma única vez a partir de extrações FBDI. Defina com cuidado o mapeamento dos centros de trabalho: um centro de trabalho com quatro máquinas do mesmo recurso passa a ser um grupo de centros de trabalho ou quatro centros de trabalho. Cada organização de fabrico passa a ser um grupo de centros de trabalho, permitindo reunir todas as fábricas num único plano.
2. Sincronização de ordens de fabrico. Leia as ordens de fabrico, lançadas ou não, com as respetivas operações e materiais, bem como as encomendas de compra em aberto. O SkyPlanner considera o material encomendado disponível na data de entrega da encomenda de compra e atualiza o stock quando esta é marcada como Delivered.
Programe ordens de fabrico, não ordens planeadas do Supply Planning. As ordens planeadas têm de ser convertidas primeiro em ordens de fabrico no Oracle.
3. Gravação da programação no Oracle. Quando o motor programa ou desloca uma tarefa, um webhook do SkyPlanner desencadeia 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 planeada não pode ser anterior ao início da ordem de fabrico nem posterior ao seu fim.) (fonte) Por isso, quando a nova programação ultrapassa esses limites, a integração atualiza primeiro as datas do cabeçalho da ordem de fabrico e só depois as operações.
4. Confirmações na fábrica. Os operadores registam o trabalho com o SkyPlanner Mobile Confirmations ou o Production Timer, e os registos de tempos 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á registar o progresso no Oracle, o SkyPlanner lê esses dados em alternativa.
5. Responsabilidade pelos dados e regras de conflito. Documente estas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Artigos, estruturas de artigos, definições de trabalho, quantidades, estado das ordens de fabrico | Oracle Fusion Cloud |
| Sequência das operações, horas de início e de conclusão, 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 único sistema, escolhido na definição do âmbito |
| Transações de recursos, operações e materiais | Oracle, com registo direto ou envio a partir dos registos de tempos 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 do Oracle, pelo que substitui o Production Scheduling na gravação das datas planeadas. Se o Production Scheduling continuar a lançar programações, mantenha as suas organizações separadas das que são programadas pelo SkyPlanner.
Etapas habituais do projeto
A implementação fica normalmente concluída em poucas semanas após o início do processo de integração, mesmo em grandes empresas. Antes disso, valide a programação durante o período de teste gratuito de 30 dias, com centros de trabalho, definições de trabalho e ordens de fabrico em aberto exportados do Oracle em CSV ou Excel.
- Mapeamento. Defina a tabela de mapeamento, as regras de responsabilidade pelos dados, as organizações abrangidas, as frequências de sincronização e se as transações serão enviadas de volta ao Oracle.
- Acesso ao Oracle. Crie o utilizador de integração e as funções. Teste primeiro num ambiente Oracle que não seja de produção.
- Carregamento inicial. Artigos, estruturas de artigos, definições de fabrico, centros de trabalho, recursos de produção e calendários.
- Sincronização de ordens de fabrico e encomendas de compra. Consulta periódica com filtros, paginação 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.
- Gravação da programação no Oracle. PATCH a partir dos webhooks do SkyPlanner, bem como envio de transações, se essa opção tiver sido 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 a gravação no Oracle, fábrica a fábrica, assim que os dados coincidirem.
O que prever numa integração com o Oracle Fusion Cloud
- Comportamento predefinido do motor de programação. O motor do Oracle, que não considera restrições, é executado na criação e em “certain update actions” (determinadas ações de atualização). Teste no seu ambiente quais as atualizações que recalculam as datas e garanta que o SkyPlanner é o último sistema a gravar as datas das operações.
- Intervalos das ordens de fabrico. As datas das operações têm de ficar entre as datas de início e de conclusão da ordem de fabrico. Atualize primeiro o cabeçalho com PATCH.
- Basis Type. A utilização de recursos só é por unidade quando Basis Type é Variable. Com Fixed, o tempo é fixo por operação. Faça a conversão na importação; caso contrário, todas as durações estarão erradas.
- Produção discreta e por processos. As fábricas de produção discreta usam
workOrders; as de produção por processos usamprocessWorkOrders. Mapeie ambos se utilizar os dois tipos de produção. - Paginação. O Oracle limita o número de registos por chamada REST. Use paginação em todas as consultas e filtre por organização e estado.
- Atualizações trimestrais. A Oracle atualiza o Fusion todos os trimestres. Fixe a versão REST no caminho e repita os testes após cada atualização.
- Regras de estado. As ordens de fabrico em Pending Approval ou encerradas não devem receber novas datas. Exclua-as através de filtros na leitura.
Quem configura e dá suporte à integração com o Oracle Fusion Cloud
- A equipa SkyPlanner configura a integração durante a implementação e dá suporte após a entrada em produção, para os recursos REST e as organizações acordados. Cada fábrica utiliza o Oracle Fusion Cloud de forma diferente, e é aqui que esse conhecimento é aplicado.
- O seu parceiro Oracle pode participar. O parceiro conhece as suas organizações, funções e extensões e pode configurar o utilizador de integração, as funções e os fluxos do Oracle Integration necessários, em conjunto com a equipa SkyPlanner.
- Os seus programadores podem desenvolver a partir desta integração através da REST API do SkyPlanner, com um token de API. Basta um token de API para começar, e 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 com Oracle Fusion Cloud, que respeita a capacidade real das máquinas e das equipas, a página do Oracle Fusion Cloud e a área de integrações ERP. Utiliza o NetSuite? Consulte o guia de integração com o NetSuite.
Opiniões de fabricantes sobre o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, passámos do planeamento da produção em folhas de cálculo Excel 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 comutação
O planeamento da produção poupa 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 de TI
Laboratory & Allied · Produção farmacêutica
A eficiência na produção aumentou 90%, e criar um plano otimizado para três meses, abrangendo todos os centros de trabalho, demora menos de 30 minutos.
99,2%de fiabilidade das entregas
“O SkyPlanner deu-nos visibilidade para identificar estrangulamentos e tornou a gestão da produção mais clara.”
Toni Tuori, responsável de produção
Piristeel · Sistemas de segurança para coberturas e de águas pluviais
A fiabilidade das entregas atingiu 99,2% este ano, e a programação poupa até quatro horas de trabalho por dia.
Mais de 1.000ordens de fabrico programadas automaticamente
“Temos um controlo diferente sobre a produção, e a nossa compreensão da capacidade está a um nível completamente diferente.”
Hannu Ryynänen, diretor executivo
Mamec · Misturadores industriais, bombas e fabrico por contrato de alta tecnologia
Milhares de ordens de fabrico 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 fabrico?
Sim. A REST API do Oracle Fusion Cloud SCM disponibiliza workOrders com recursos subordinados de operações, recursos e materiais, bem como processWorkOrders para produção por processos. Suporta GET, POST e PATCH.
Como são gravadas as datas planeadas no Oracle Fusion Cloud?
Através de um PATCH no recurso subordinado WorkOrderOperation da ordem de fabrico, definindo PlannedStartDate e PlannedCompletionDate. As datas das operações têm de ficar dentro do intervalo de datas da ordem de fabrico, pelo que o cabeçalho é atualizado primeiro, quando necessário.
Como chegam ao Oracle as confirmações dos operadores?
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 aceitam POST no Fusion Manufacturing.
O Oracle Fusion Cloud suporta webhooks?
O Fusion publica eventos de negócio, como Work Order Status Change, que o Oracle Integration pode subscrever. Sem o Oracle Integration, a integração consulta periodicamente a REST API, com uma frequência definida para cada fábrica. Os webhooks do próprio SkyPlanner enviam as alterações à programação assim que ocorrem.
Um parceiro Oracle deve propor o Oracle Production Scheduling ou o SkyPlanner?
O SkyPlanner, quando o cliente pretende uma programação única para várias fábricas, que respeite a capacidade real das máquinas e das equipas e se mantenha atualizada automaticamente. O Production Scheduling é ativado na oferta Supply Chain Planning, calcula a programação por organização de programação e aplica regras de mudança de produção apenas a equipamentos de uma única unidade (documentação da Oracle). O SkyPlanner liga-se através da SCM REST API, reprograma automaticamente a produção e planeia mudanças de produção, ferramentas, equipas e materiais. Inclui utilizadores ilimitados, a partir de 199 € por mês.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O período de avaliação gratuita de 30 dias permite utilizar até 20 centros de trabalho com importações de ficheiros CSV ou Excel provenientes da Oracle, sem necessidade de cartão de crédito. Inicie a avaliação gratuita ou fale com a equipa comercial para definir o âmbito da integração.
