Conectar o Oracle Fusion ERP: receber pedidos e faturas
Preencha a URL da sua instância do Oracle Fusion no Integration e entre com um usuário e senha REST do Fusion ou com um token bearer OAuth obtido antes, teste, mapeie e ative.
O conector do Oracle Fusion ERP traz pedidos de venda e faturas do seu Oracle Fusion Cloud ERP para este sistema. Esse é todo o escopo desta conexão: não traz clientes, não consulta nem traz estoque e não devolve nada ao Oracle Fusion. O acesso funciona de uma de duas maneiras: um usuário e senha REST do Fusion, ou um token bearer OAuth que você obtém antes e cola; e se um token estiver preenchido, o token é usado primeiro. Uma conexão por instância do Oracle Fusion.
Pré-requisitos#
- Uma instância do Oracle Fusion Cloud à qual você consiga entrar e sua URL de instância, por exemplo https://fa-xxx.oraclecloud.com.
- Um conjunto de acesso completo, escolhido com antecedência: ou um usuário do Fusion com os papéis de integração, junto com sua senha, ou um token de acesso OAuth2 obtido antes no seu domínio de identidade OCI / IDCS. Meio conjunto não conecta.
- Se você pretende usar um token: uma forma de obter um token novo no seu domínio de identidade OCI / IDCS sempre que o colado parar de funcionar, porque esta conexão usa o token exatamente como colado e não busca um novo para você.
Obter credenciais#
- Anote a URL da sua instância, por exemplo https://fa-xxx.oraclecloud.com. É o único valor de que toda conexão precisa, seja qual for o conjunto de acesso escolhido.
- Opção A, acesso Basic: prepare um usuário do Fusion com os papéis de integração, por exemplo REST_USER, e deixe sua senha pronta. Usuário e senha devem ser preenchidos juntos; um sem o outro não conta como conjunto.
- Opção B, acesso com token: no seu domínio de identidade OCI / IDCS, obtenha antes um token de acesso OAuth2 e copie-o. Aqui você cola o token já obtido: não há salto de login nem troca de token dentro desta conexão.
- Escolha uma opção como seu conjunto de trabalho. Se depois você preencher um token numa conexão que usava usuário e senha, o token assume a partir daí.
Preencher no Integration#
- Abra Integration → Marketplace → Oracle Fusion ERP → Nova conexão.
- base_url, obrigatório, URL da instância: o endereço da sua instância do Oracle Fusion, por exemplo https://fa-xxx.oraclecloud.com.
- api_version, opcional, versão da API: deixe vazio para usar o padrão integrado 11.13.18.05. Preencha apenas quando seu ambiente executar outra versão.
- username, para o acesso Basic, usuário (autenticação Basic): o usuário REST do Fusion com os papéis de integração, por exemplo REST_USER. Preencha junto com password, ou deixe ambos vazios e use token.
- password, para o acesso Basic, senha (autenticação Basic): a senha desse mesmo usuário do Fusion. É um campo do tipo senha e é guardado como segredo.
- token, alternativa opcional, token bearer OAuth: cole o token de acesso OAuth2 que você obteve antes no seu domínio de identidade OCI / IDCS. É um campo do tipo senha e é guardado como segredo. Se token estiver preenchido, ele é usado antes de username e password.
Testar a conexão#
Clique em Testar a conexão. O teste primeiro verifica o preenchimento: se base_url estiver ausente, ou se nenhum conjunto de acesso estiver completo (sem usuário com sua senha e sem token), para com uma mensagem de valor ausente e não envia nada. Depois, faz uma solicitação real, leve e somente leitura com o conjunto escolhido (o token como acesso Bearer se um token estiver preenchido; caso contrário, o usuário e a senha como acesso Basic), pedindo um único registro ao recurso de faturas. Uma resposta 200 conta como aprovado. Uma resposta 401 ou 403 significa que o conjunto de acesso usado foi recusado: verifique esse conjunto, não o outro. O teste desiste após cerca de 12 segundos se a instância não responder.
Mapping / escolher modelo#
Escolha o mapping padrão do Oracle Fusion. Ele cobre os dois tipos de dados que esta conexão traz: pedidos de venda do recurso salesOrdersForOrderHub e faturas do recurso invoices. Depois que o teste aprovar, execute uma extração e confira um pedido real e uma fatura real lado a lado (números, referência do cliente, linhas e valores) antes de ativar. Não há mapping de clientes nem de estoque nesta conexão, porque esta conexão não traz clientes nem estoque.
Ativar#
Após ativar, a conexão traz pedidos de venda e faturas do Oracle Fusion para este sistema na frequência definida. Acompanhe as primeiras extrações em Runs / Logs e compare com o Oracle Fusion antes de deixar a conexão sem supervisão. Se você entra com um token, fique de olho nele: quando o token colado parar de funcionar, as extrações começarão a falhar até você colar um novo.
O que esta conexão não faz: não traz clientes do Oracle Fusion, não consulta nem traz estoque e não devolve estoque nem qualquer outra coisa ao Oracle Fusion. Continue cuidando de clientes e estoque no próprio Oracle Fusion, ou nos sistemas onde esse trabalho realmente acontece.
Perguntas frequentes#
O teste falha com 401 ou 403
O Oracle Fusion recusou o conjunto de acesso que o teste realmente usou. Se um token estiver preenchido, o token foi usado, então o que foi recusado foi o token, mesmo que username e password também estejam preenchidos. Sem token preenchido, o usuário e a senha foram recusados, ou esse usuário do Fusion não tem os papéis de integração de que os recursos REST precisam.
Trabalhe no conjunto que foi usado. Token em uso: obtenha um novo token de acesso OAuth2 no seu domínio de identidade OCI / IDCS e cole-o inteiro em token. Basic em uso: confira username e password juntos e confirme no Fusion que o usuário tem os papéis de integração. Depois teste novamente.
O teste para com uma mensagem de valor ausente antes de enviar qualquer coisa
O preenchimento está incompleto: ou base_url está vazio, ou nenhum conjunto de acesso está completo. Um usuário sem sua senha não é um conjunto, e uma senha sem seu usuário também não é; e sem token preenchido, o teste não tem nenhuma forma de entrar.
Preencha base_url com a URL completa da instância e depois complete exatamente um conjunto: username e password juntos, ou um token colado inteiro. Salve e teste novamente.
Conectava antes e depois as extrações começaram a falhar sozinhas
Se esta conexão entra com um token, o token colado parou de funcionar. Esta conexão usa o token exatamente como colado e não busca um novo, então um token que funcionava no teste pode parar de funcionar depois, enquanto todos os outros valores continuam certos.
Obtenha um novo token de acesso OAuth2 no seu domínio de identidade OCI / IDCS, cole-o inteiro no campo token, salve e teste. Se as falhas continuarem com um token novo, verifique o conjunto Basic, ou esvazie o campo token de propósito para voltar a usuário e senha.
Preenchi usuário e senha, mas o acesso se comporta como se eu não tivesse preenchido
Também há um token preenchido nesta conexão, e um token preenchido é usado antes de username e password. Os valores Basic não estão errados: simplesmente não são o conjunto em uso enquanto houver um valor de token presente.
Decida qual conjunto você quer. Para usar o token, mantenha-o válido e ignore os campos Basic. Para usar usuário e senha, esvazie por completo o campo token, salve e teste novamente.
Conectado, mas clientes ou estoque nunca aparecem
Isso é o escopo desta conexão, não uma falha: ela traz apenas pedidos de venda e faturas. Clientes e estoque não são trazidos por esta conexão, então nenhuma mudança de mapping, frequência ou credenciais fará com que apareçam aqui.
Continue cuidando de clientes e estoque no próprio Oracle Fusion, ou no sistema onde esses dados realmente vivem. Use esta conexão para pedidos e faturas, e confira esses dois em Runs / Logs ao verificá-la.
Conectado, mas nenhum pedido ou fatura chega
A conexão está funcionando (o teste leu de verdade o recurso de faturas), mas não há nada novo para trazer: a instância não tem pedidos de venda nem faturas novos no intervalo de extração. Um valor de api_version errado pode causar o mesmo resultado vazio se seu ambiente não executar essa versão.
Crie ou confirme um pedido de venda e uma fatura no Oracle Fusion, deixe api_version vazio, a menos que saiba que seu ambiente executa outra versão diferente do padrão integrado, execute uma extração manual e confirme que ambos aparecem na prévia ou em Runs / Logs.