Conectar Oracle Fusion ERP: recibir pedidos y facturas
Complete la URL de su instancia de Oracle Fusion en Integration e inicie sesión con un usuario y contraseña REST de Fusion o con un token bearer OAuth obtenido antes, pruebe, mapee y active.
El conector de Oracle Fusion ERP trae pedidos de venta y facturas de su Oracle Fusion Cloud ERP a este sistema. Ese es todo el alcance de esta conexión: no trae clientes, no consulta ni trae inventario y no devuelve nada a Oracle Fusion. El acceso funciona de una de dos maneras: un usuario y contraseña REST de Fusion, o un token bearer OAuth que usted obtiene antes y pega; y si hay un token completado, el token se usa primero. Una conexión por instancia de Oracle Fusion.
Requisitos previos#
- Una instancia de Oracle Fusion Cloud a la que pueda acceder y su URL de instancia, por ejemplo https://fa-xxx.oraclecloud.com.
- Un conjunto de acceso completo, elegido de antemano: o bien un usuario de Fusion con los roles de integración, junto con su contraseña, o bien un token de acceso OAuth2 obtenido antes en su dominio de identidad OCI / IDCS. Medio conjunto no conecta.
- Si planea usar un token: una forma de obtener un token nuevo en su dominio de identidad OCI / IDCS cada vez que el pegado deje de funcionar, porque esta conexión usa el token tal como se pegó y no obtiene uno nuevo por usted.
Obtener credenciales#
- Anote la URL de su instancia, por ejemplo https://fa-xxx.oraclecloud.com. Es el único valor que toda conexión necesita, elija el conjunto de acceso que elija.
- Opción A, acceso Basic: prepare un usuario de Fusion con los roles de integración, por ejemplo REST_USER, y tenga lista su contraseña. El usuario y la contraseña deben completarse juntos; uno sin el otro no cuenta como conjunto.
- Opción B, acceso con token: en su dominio de identidad OCI / IDCS, obtenga antes un token de acceso OAuth2 y cópielo. Aquí pega el token ya obtenido: no hay salto de inicio de sesión ni intercambio de token dentro de esta conexión.
- Elija una opción como su conjunto de trabajo. Si más tarde completa un token en una conexión que usaba usuario y contraseña, el token toma el relevo desde ese momento.
Completar en Integration#
- Abra Integration → Marketplace → Oracle Fusion ERP → Nueva conexión.
- base_url, obligatorio, URL de la instancia: la dirección de su instancia de Oracle Fusion, por ejemplo https://fa-xxx.oraclecloud.com.
- api_version, opcional, versión de la API: déjelo vacío para usar el valor predeterminado integrado 11.13.18.05. Complételo solo cuando su entorno ejecute otra versión.
- username, para el acceso Basic, usuario (autenticación Basic): el usuario REST de Fusion con los roles de integración, por ejemplo REST_USER. Complételo junto con password, o deje ambos vacíos y use token en su lugar.
- password, para el acceso Basic, contraseña (autenticación Basic): la contraseña de ese mismo usuario de Fusion. Es un campo de tipo contraseña y se guarda como secreto.
- token, alternativa opcional, token bearer OAuth: pegue el token de acceso OAuth2 que obtuvo antes en su dominio de identidad OCI / IDCS. Es un campo de tipo contraseña y se guarda como secreto. Si token está completado, se usa antes que username y password.
Probar la conexión#
Haga clic en Probar la conexión. La prueba primero revisa lo completado: si falta base_url, o si ningún conjunto de acceso está completo (sin usuario con su contraseña y sin token), se detiene con un mensaje de valor faltante y no envía nada. Después hace una solicitud real, ligera y de solo lectura con el conjunto elegido (el token como acceso Bearer si hay un token completado; si no, el usuario y la contraseña como acceso Basic), pidiendo un solo registro al recurso de facturas. Una respuesta 200 cuenta como aprobado. Una respuesta 401 o 403 significa que el conjunto de acceso usado fue rechazado: revise ese conjunto, no el otro. La prueba se rinde tras unos 12 segundos si la instancia no responde.
Mapping / elegir plantilla#
Elija el mapping estándar de Oracle Fusion. Cubre los dos tipos de datos que trae esta conexión: pedidos de venta del recurso salesOrdersForOrderHub y facturas del recurso invoices. Tras aprobar la prueba, ejecute una extracción y compare un pedido real y una factura real lado a lado (números, referencia de cliente, líneas e importes) antes de activar. No hay mapping de clientes ni de inventario en esta conexión, porque esta conexión no trae clientes ni inventario.
Activar#
Tras activar, la conexión trae pedidos de venta y facturas de Oracle Fusion a este sistema según la frecuencia definida. Vigile las primeras extracciones en Runs / Logs y compárelas con Oracle Fusion antes de dejar la conexión sin supervisión. Si accede con un token, vigílelo: cuando el token pegado deje de funcionar, las extracciones empezarán a fallar hasta que pegue uno nuevo.
Lo que esta conexión no hace: no trae clientes de Oracle Fusion, no consulta ni trae inventario y no devuelve inventario ni ninguna otra cosa a Oracle Fusion. Siga gestionando clientes e inventario en el propio Oracle Fusion, o en los sistemas donde ese trabajo ocurre realmente.
Preguntas frecuentes#
La prueba falla con 401 o 403
Oracle Fusion rechazó el conjunto de acceso que la prueba usó realmente. Si hay un token completado, se usó el token, así que lo rechazado fue el token, aunque username y password también estén completados. Sin token completado, fueron rechazados el usuario y la contraseña, o ese usuario de Fusion no tiene los roles de integración que necesitan los recursos REST.
Trabaje sobre el conjunto usado. Token en uso: obtenga un token de acceso OAuth2 nuevo en su dominio de identidad OCI / IDCS y péguelo entero en token. Basic en uso: vuelva a revisar username y password juntos y confirme en Fusion que el usuario tiene los roles de integración. Después pruebe de nuevo.
La prueba se detiene con un mensaje de valor faltante antes de enviar nada
Lo completado está incompleto: o base_url está vacío, o ningún conjunto de acceso está completo. Un usuario sin su contraseña no es un conjunto, y una contraseña sin su usuario tampoco lo es; y sin token completado, la prueba no tiene ninguna forma de iniciar sesión.
Complete base_url con la URL completa de la instancia y después complete exactamente un conjunto: username y password juntos, o un token pegado entero. Guarde y pruebe de nuevo.
Conectaba antes y después las extracciones empezaron a fallar solas
Si esta conexión accede con un token, el token pegado dejó de funcionar. Esta conexión usa el token tal como se pegó y no obtiene uno nuevo, así que un token que funcionaba en la prueba puede dejar de funcionar después mientras todos los demás valores siguen correctos.
Obtenga un token de acceso OAuth2 nuevo en su dominio de identidad OCI / IDCS, péguelo entero en el campo token, guarde y pruebe. Si los fallos continúan con un token nuevo, revise en su lugar el conjunto Basic, o vacíe el campo token a propósito para volver a usuario y contraseña.
Completé usuario y contraseña, pero el acceso se comporta como si no lo hubiera hecho
También hay un token completado en esta conexión, y un token completado se usa antes que username y password. Los valores Basic no están mal: simplemente no son el conjunto en uso mientras haya un valor de token presente.
Decida qué conjunto quiere. Para usar el token, manténgalo vigente e ignore los campos Basic. Para usar usuario y contraseña, vacíe por completo el campo token, guarde y pruebe de nuevo.
Conectado, pero los clientes o el inventario nunca aparecen
Eso es el alcance de esta conexión, no un fallo: trae solo pedidos de venta y facturas. Los clientes y el inventario no los trae esta conexión, así que ningún cambio de mapping, frecuencia o credenciales hará que aparezcan aquí.
Siga gestionando clientes e inventario en el propio Oracle Fusion, o en el sistema donde esos datos viven realmente. Use esta conexión para pedidos y facturas, y revise esos dos en Runs / Logs cuando la verifique.
Conectado, pero no llegan pedidos ni facturas
La conexión funciona (la prueba leyó de verdad el recurso de facturas), pero no hay nada nuevo que traer: la instancia no tiene pedidos de venta ni facturas nuevos en el rango de extracción. Un valor de api_version incorrecto puede causar el mismo resultado vacío si su entorno no ejecuta esa versión.
Cree o confirme un pedido de venta y una factura en Oracle Fusion, deje api_version vacío salvo que sepa que su entorno ejecuta otra versión distinta del valor predeterminado integrado, ejecute una extracción manual y confirme que ambos aparecen en la vista previa o en Runs / Logs.