Oracle Fusion Cloud: Crear Adjustment en AR con SOAP API (Ejemplo Completo)

En Oracle Fusion Cloud Financials es común necesitar generar Adjustments (autoajustes) en Accounts Receivable (AR) cuando una factura debe cancelarse, corregirse o ajustarse por motivos fiscales o contables.

En este artículo te muestro un caso real de integración utilizando la SOAP API de Oracle Fusion Cloud para crear un Adjustment en AR desde Postman, incluyendo el endpoint utilizado, el payload XML completo y cómo obtener los IDs necesarios.

📌 Escenario funcional

Necesitamos crear un autoajuste sobre una factura existente debido a una cancelación fiscal en México. El ajuste debe:

Aplicarse a una factura específica
Registrar motivo de cancelación
Impactar contablemente en la fecha correcta (GL Date)
Actualizar campos fiscales mediante DFF

🔗 Endpoint SOAP utilizado

La integración fue ejecutada desde Postman utilizando el siguiente endpoint:

https://servername.oraclecloud.com:443/fscmService/AdjustmentService

Operación SOAP: createAdjustment

Método: POST

Autenticación: Basic Auth (según configuración del entorno)

Este servicio pertenece al módulo de Receivables dentro de Oracle Fusion Financials.

📦 Payload XML completo (valores dummy)

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:typ="http://xmlns.oracle.com/apps/financials/receivables/transactions/adjustments/adjustmentService/types/"
xmlns:adj="http://xmlns.oracle.com/apps/financials/receivables/transactions/adjustments/adjustmentService/"
xmlns:adj1="http://xmlns.oracle.com/apps/financials/receivables/transactions/adjustments/model/flex/AdjustmentsDff/"
xmlns:adj2="http://xmlns.oracle.com/apps/flex/financials/receivables/transactions/adjustments/AdjustmentGdf/">

<soapenv:Header/>
<soapenv:Body>
<typ:createAdjustment>
<typ:adjustment>

<adj:AdjustmentType>M</adj:AdjustmentType>

<adj:Amount currencyCode="MXN">-1000.00</adj:Amount>

<adj:ApplyDate>2026-01-01</adj:ApplyDate>

<adj:CustomerTrxId>300000000000001</adj:CustomerTrxId>

<adj:GlDate>2026-01-01</adj:GlDate>

<adj:OrgId>300000000000002</adj:OrgId>

<adj:PaymentScheduleId>300000000000003</adj:PaymentScheduleId>

<adj:ReasonCode>REEMPLAZO</adj:ReasonCode>

<adj:ReceivablesTrxId>300000000000004</adj:ReceivablesTrxId>  

<adj:SetOfBooksId>300000000000005</adj:SetOfBooksId>

<adj:CurrencyCode>MXN</adj:CurrencyCode>

<adj:TransactionAdjustmentType>INVOICE</adj:TransactionAdjustmentType>

<adj:AdjustmentFLEX>
<adj1:__FLEX_Context>Context_name</adj1:__FLEX_Context>
<adj1:__FLEX_Context_DisplayValue>context</adj1:__FLEX_Context_DisplayValue>
<adj1:_FLEX_NumOfSegments>2</adj1:_FLEX_NumOfSegments>
<adj1:motivo>01</adj1:motivo>
<adj1:notas>cancelarfacturaprueaba</adj1:notas>

</adj:AdjustmentFLEX>

</typ:adjustment>
</typ:createAdjustment>
</soapenv:Body>
</soapenv:Envelope>

🔎 ¿Cómo obtener los IDs necesarios?

Para que el payload funcione correctamente, es necesario obtener los IDs técnicos desde Oracle Fusion.

Los principales campos requeridos son:

CustomerTrxId → ID interno de la factura
PaymentScheduleId → Schedule asociado
ReceivablesTrxId → Tipo de transacción AR
OrgId → Business Unit
SetOfBooksId → Ledger

📊 Ejemplo de consulta SQL

SELECT
    rcta.CUSTOMER_TRX_ID,
    rcta.TRX_NUMBER,
    apsa.PAYMENT_SCHEDULE_ID,
    rcta.ORG_ID
FROM
    RA_CUSTOMER_TRX_ALL rcta
JOIN
    AR_PAYMENT_SCHEDULES_ALL apsa
ON
    rcta.CUSTOMER_TRX_ID = apsa.CUSTOMER_TRX_ID
WHERE
    rcta.TRX_NUMBER = 'TU_NUMERO_FACTURA';

Esta consulta permite obtener los IDs necesarios antes de enviar el request SOAP.

⚠️ Errores comunes al crear Adjustments vía API

Periodo contable cerrado
PaymentScheduleId incorrecto
ReasonCode no configurado
Business Unit incorrecta
DFF no habilitado en el entorno

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.oraclecloud.com:443/fscmService/AdjustmentService
Después agrega tus credenciales en la sección Authorization y en Body selecciona raw → XML.

🔗 Ver también

Si necesitas actualizar campos adicionales mediante DFF en Oracle AR, revisa también esta guía:

Oracle Fusion: Actualizar DFF en AR usando API SOAP

🚀 Automatización empresarial

Este tipo de integración puede escalarse mediante procesos batch, middleware o integraciones externas, reduciendo errores manuales y mejorando la trazabilidad financiera.

En entornos corporativos, automatizar ajustes en AR mediante API permite mayor control, auditoría y eficiencia operativa.

Cómo crear un Dashboard de Tenis con JavaScript usando Tennis API