👉 Oracle API Tutorial: Actualizar Descriptive Flexfields (DFF) con Postman paso a paso

Cómo Actualizar un Descriptive Flexfield (DFF) en Oracle usando Postman y SOAP Web Services

Si necesitas actualizar un campo de un Descriptive Flexfield (DFF) en Oracle, puedes hacerlo fácilmente utilizando Postman junto con SOAP Web Services.

En esta guía paso a paso aprenderás cómo actualizar el valor de un DFF a nivel factura de Accounts Receivable (AR) o Cuentas por Cobrar consumiendo un API de Oracle.

Este tipo de integración es muy utilizada en proyectos empresariales donde se requiere automatizar procesos financieros sin intervención manual.

¿Qué es un Descriptive Flexfield (DFF) en Oracle?

Los Descriptive Flexfields permiten extender la funcionalidad estándar de Oracle agregando campos personalizados sin modificar la estructura base del sistema.

Son ampliamente utilizados para almacenar información adicional en facturas, clientes, proveedores y múltiples módulos financieros.

Cómo encontrar un API de Oracle

Primero debemos ir a la documentación oficial de Oracle:

https://docs.oracle.com/en/cloud/saas/sales/oesws/Sample-Payloads-for-CustomerAccount-Webservice-Requests-Landingpage.html

Desde esa pantalla identificaremos la URL del servicio:

Service WSDL URL: https://servername/fscmService/ErpObjectDFFUpdateService?WSDL

Configurar la petición en Postman

Ahora entraremos a Postman para construir nuestro request SOAP.

Guía para ejecutar el API desde Postman

Selecciona el método POST y utiliza la URL del servicio reemplazando servername por tu servidor:

https://servername/crmService/fscmService/ErpObjectDFFUpdateService

Después agrega tus credenciales en la sección Authorization y en Body selecciona raw → XML.

XML para actualizar un DFF en Oracle

Utiliza el siguiente XML como base para ejecutar la actualización:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
 xmlns:typ="http://xmlns.oracle.com/apps/financials/commonModules/shared/model/erpIntegrationService/types/"
 xmlns:erp="http://xmlns.oracle.com/apps/financials/commonModules/shared/model/erpIntegrationService/">
   <soapenv:Header/>
   <soapenv:Body>
      <typ:updateDffEntityDetails>
         <typ:operationMode>SINGLE</typ:operationMode>
         <typ:object>
            <erp:EntityName>Receivables Invoice</erp:EntityName>
            <erp:ContextValue>Contexto</erp:ContextValue>
            <erp:UserKeyA>{{TransactionNumber}}</erp:UserKeyA>
            <erp:UserKeyB>#NULL</erp:UserKeyB>
            <erp:UserKeyC>#NULL</erp:UserKeyC>
            <erp:UserKeyD>{{TransactionID}}</erp:UserKeyD>
            <erp:UserKeyE>#NULL</erp:UserKeyE>
            <erp:DFFAttributes>{"ATTRIBUTE1":"valor","ATTRIBUTE2":"valor2"}</erp:DFFAttributes>
         </typ:object>
      </typ:updateDffEntityDetails>
   </soapenv:Body>
</soapenv:Envelope>

Valores que debes modificar

• Contexto: valor del contexto donde está el DFF.
• TransactionNumber: número de factura o transacción.
• TransactionID: identificador interno de Oracle.
• ATTRIBUTE1 / ATTRIBUTE2: campos que deseas actualizar.

Query para obtener los IDs

select
   rca.CUSTOMER_TRX_ID,
   rca.TRX_NUMBER
from RA_CUSTOMER_TRX_ALL rca;

Conclusión

Actualizar un DFF en Oracle mediante APIs permite automatizar procesos financieros, reducir errores manuales y mejorar la integración entre sistemas empresariales.

Si trabajas con Oracle Cloud o implementaciones ERP, dominar este tipo de integraciones puede ahorrarte muchas horas de operación.