> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parable.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Oracle Fusion Cloud

> Connect Parable to Oracle Fusion Cloud using Basic Authentication

export const platform_0 = "Oracle Fusion Cloud"

export const role_0 = undefined

<Tabs>
  <Tab title="Setup">
    <Card title="What You'll Need" icon="key">
      | Credential   | What it is                                                                                                      |
      | ------------ | --------------------------------------------------------------------------------------------------------------- |
      | **Username** | Oracle Fusion Cloud username                                                                                    |
      | **Password** | Oracle Fusion Cloud password                                                                                    |
      | **Base URL** | Full base URL of your Oracle Fusion Cloud instance (e.g., `https://fa-exix-saasfaprod1.fa.ocs.oraclecloud.com`) |
    </Card>

    ## Overview

    Connect Parable to Oracle Fusion Cloud to sync Payables audit history events. Parable queries the Oracle Fusion Cloud Audit REST service incrementally using 7-day date-range windows (UTC).

    <Warning>
      **Data sensitivity:** Audit payloads can include invoice identifiers, internal IDs, user login names, and field-level attribute changes (amounts, vendors, and related financial metadata). Limit Parable access to users who are authorized to view Payables audit data in your organization.
    </Warning>

    <CardGroup cols={2}>
      <Card title="Payables — Invoice Header" icon="file-invoice-dollar">
        AP Invoice Header audit history (InvoiceHeaderVO) — creates, updates, and deletes
      </Card>

      <Card title="Payables — Invoice Line" icon="list">
        AP Invoice Line audit history (InvoiceLineVO) — creates, updates, and deletes
      </Card>
    </CardGroup>

    ## Prerequisites

    <Info>
      **Setup access in {platform_0}.** These steps require **{role_0}**, or a colleague with equivalent permissions who can create credentials for you.

      If that is not you, ask your {platform_0} administrator.
    </Info>

    * Oracle Fusion Cloud user with access to the Financials Audit REST service
    * The `Financial Auditor` or equivalent role that permits calling `/fscmRestApi/fndAuditRESTService/audittrail/getaudithistory`
    * Audit trail enabled for the Payables product in Oracle Fusion Cloud

    ## Setup Guide

    <Steps>
      <Step title="Enable Audit Trail for Payables">
        In Oracle Fusion Cloud, navigate to **Setup and Maintenance** → **Manage Audit Policies**.

        Enable audit for the **Payables** product and confirm the following business objects are checked:

        | Business Object  | Internal Name     |
        | ---------------- | ----------------- |
        | Invoice (Header) | `InvoiceHeaderVO` |
        | Invoice Line     | `InvoiceLineVO`   |

        <Warning>
          If these objects are not enabled, Parable will receive empty results and no data will sync.
        </Warning>
      </Step>

      <Step title="Identify Your Instance Hostname">
        Your Oracle Fusion Cloud instance hostname looks like:

        ```
        fa-exix-saasfaprod1.fa.ocs.oraclecloud.com
        ```

        Find this in your browser address bar when logged into Oracle Fusion Cloud (without the `https://` prefix).
      </Step>

      <Step title="Create a Dedicated Integration User (Recommended)">
        For least-privilege access, create a dedicated integration user:

        1. Navigate to **Security Console** → **Users**
        2. Create a new user, e.g., `parable_integration`
        3. Assign the **Financial Auditor** role (or a custom role granting read access to the Audit REST service)

        <Warning>
          Grant only the minimum roles required. The integration user only needs read access to the Audit REST service.
        </Warning>
      </Step>

      <Step title="Enter credentials in Parable">
        Enter the following in the connector form:

        | Field        | Value                                                                                       |
        | ------------ | ------------------------------------------------------------------------------------------- |
        | **Username** | Your integration user username                                                              |
        | **Password** | Your integration user password                                                              |
        | **Base URL** | Full base URL of your instance (e.g., `https://fa-exix-saasfaprod1.fa.ocs.oraclecloud.com`) |

        Click **Save & test connection**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Reference">
    ## Verify Your Setup

    The Oracle Fusion Cloud Audit REST service requires a POST request with a JSON body. You can verify your credentials with curl:

    ```bash theme={null}
    curl -X POST \
      "https://<your-fusion-host>/fscmRestApi/fndAuditRESTService/audittrail/getaudithistory" \
      -H "Content-Type: application/json" \
      -u "<username>:<password>" \
      -d '{
        "product": "Payables",
        "businessObjectType": "oracle.apps.financials.payables.invoices.transactions.uiModel.view.InvoiceHeaderVO",
        "fromDate": "2026-01-01",
        "toDate": "2026-01-07",
        "timeZone": "UTC",
        "includeAttributes": true,
        "attributeDetailMode": true,
        "includeChildObjects": "true",
        "pageNumber": 1,
        "pageSize": 5
      }'
    ```

    Parable sends `pageNumber` and `pageSize` in the JSON body (not the query string) and caps each sync/backfill request to a **7-day** `fromDate`/`toDate` window.

    A `200 OK` response with `"status": "SUCCESS"` and an `auditData` array confirms your credentials and audit trail configuration are correct.

    <Check>
      **Success!** If you received a `200 OK` response with valid data, your credentials are configured correctly. You can now proceed to configure this connector in Parable.
    </Check>

    ## API Endpoints Reference

    | Service    | Base Path                                      |
    | ---------- | ---------------------------------------------- |
    | Audit REST | `/fscmRestApi/fndAuditRESTService/audittrail/` |

    ## Troubleshooting

    | Error                       | Meaning                     | Solution                                            |
    | --------------------------- | --------------------------- | --------------------------------------------------- |
    | `401 Unauthorized`          | Invalid credentials         | Verify username and password                        |
    | `403 Forbidden`             | Missing role                | Assign the Financial Auditor role                   |
    | `404 Not Found`             | Audit service not available | Confirm REST services are enabled for your instance |
    | `500 Internal Server Error` | Server issue                | Contact Oracle support                              |

    <Accordion title="Common Issues">
      ### No audit data returned

      Audit trail must be enabled for the Payables product in Oracle Fusion Cloud before Parable can sync data. Navigate to **Setup and Maintenance** → **Manage Audit Policies** and confirm Payables is enabled.

      ### Account locked out

      After multiple failed login attempts, Oracle Fusion Cloud may lock the account. Use the **Security Console** to unlock it.
    </Accordion>

    ## Additional Resources

    <CardGroup cols={2}>
      <Card title="Oracle Audit REST API" icon="book" href="https://docs.oracle.com/en/cloud/saas/financials/24a/farfa/op-audittrail-getaudithistory-post.html">
        Oracle Fusion Cloud Audit REST service documentation
      </Card>

      <Card title="Manage Audit Policies" icon="shield" href="https://docs.oracle.com/en/cloud/saas/financials/24a/fafar/manage-audit-policies.html">
        How to enable audit trail for Oracle Fusion Cloud products
      </Card>
    </CardGroup>
  </Tab>
</Tabs>