> ## 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.

# Financials Cloud

> Connect Parable to Oracle Financials Cloud

export const platform_2 = "Oracle Cloud"

export const limit_0 = "varies by service; monitor response headers"

export const platform_1 = "Oracle"

export const platform_0 = "Oracle Cloud"

export const role_0 = undefined

<Tabs>
  <Tab title="Setup">
    <Card title="What You'll Need" icon="key">
      | Credential       | What it is                                                             |
      | ---------------- | ---------------------------------------------------------------------- |
      | **Username**     | Oracle Cloud username                                                  |
      | **Password**     | Oracle Cloud password                                                  |
      | **Host**         | Oracle Cloud host (e.g., `fa-abcd-saasfaprod1.fa.ocs.oraclecloud.com`) |
      | **Port**         | Database port (e.g., `1521`)                                           |
      | **Service Name** | Oracle service name (e.g., `ORCL`)                                     |
      | **Base URL**     | Oracle REST API base URL                                               |
    </Card>

    ## Overview

    Connect Parable to Oracle Financials Cloud (ERP) for financial and operational data.

    <CardGroup cols={2}>
      <Card title="Financials" icon="money-bill">
        General Ledger, Accounts Payable/Receivable
      </Card>

      <Card title="Users & Security" icon="users">
        User profiles, roles, access
      </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>

    * **Integration Specialist** or equivalent role
    * REST API access enabled for your instance
    * Understanding of Oracle Cloud data model

    ## Setup Guide

    <Steps>
      <Step title="Identify Your Instance URL">
        Your Oracle Cloud instance URL format:

        ```
        https://server-instance.fa.us6.oraclecloud.com
        ```

        Find this in your browser when logged into Oracle Cloud.
      </Step>

      <Step title="Create Integration User">
        For best practices, create a dedicated integration user:

        1. Navigate to **Security Console** → **Users**
        2. Create a new user: `parable_integration`
        3. Assign required roles (see permissions below)
      </Step>

      <Step title="Assign Required Roles">
        The integration user needs these roles:

        | Role                     | Purpose             |
        | ------------------------ | ------------------- |
        | `Financial Analyst`      | Read financial data |
        | `Integration Specialist` | API access          |
        | `Employee`               | Basic data access   |

        <Warning>
          Grant only the minimum roles required for your use case.
        </Warning>
      </Step>

      <Step title="Note Your Credentials">
        | Credential   | Value                                          |
        | ------------ | ---------------------------------------------- |
        | Username     | `parable_integration`                          |
        | Password     | (your secure password)                         |
        | Instance URL | `https://your-instance.fa.us6.oraclecloud.com` |
      </Step>

      <Step title="Enter values in the form">
        1. Enter **Username**, **Password**, **Host**, **Port**, **Service Name**, and **Base URL** in the connector form.
        2. Click **Save & test connection**.
      </Step>
    </Steps>
  </Tab>

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

    The API uses **Basic authentication**. Combine your credentials and Base64 encode them:

    ```
    username:password  →  Base64 encode  →  Authorization: Basic {encoded}
    ```

    <CodeGroup>
      ```bash cURL theme={null}
      # The -u flag handles Base64 encoding automatically
      curl -X GET "https://your-instance.fa.us6.oraclecloud.com/hcmRestApi/resources/11.13.18.05/emps?limit=5" \
        -u "your-email@company.com:YOUR_API_TOKEN" \
        -H "Content-Type: application/json"
      ```

      ```python Python theme={null}
      import requests
      import base64

      # Encode credentials
      credentials = "your-email@company.com:YOUR_API_TOKEN"
      encoded = base64.b64encode(credentials.encode()).decode()

      response = requests.get(
          "https://your-instance.fa.us6.oraclecloud.com/hcmRestApi/resources/11.13.18.05/emps?limit=5",
          headers={
              "Authorization": f"Basic {encoded}",
              "Content-Type": "application/json"
          }
      )
      print(response.json())
      ```
    </CodeGroup>

    <Tip>
      For {platform_1}, use your **email address** as the username and the **API token** as the password.
    </Tip>

    <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                 |
    | ---------- | ------------------------- |
    | HCM        | `/hcmRestApi/resources/`  |
    | Financials | `/fscmRestApi/resources/` |
    | ERP Common | `/erpRestApi/resources/`  |

    <Tip>
      **Rate Limits:** {platform_2} enforces rate limits of **{limit_0}**.

      Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.
    </Tip>

    ## Troubleshooting

    | Error                       | Meaning             | Solution                     |
    | --------------------------- | ------------------- | ---------------------------- |
    | `401 Unauthorized`          | Invalid credentials | Verify username and password |
    | `403 Forbidden`             | Missing role        | Add required role to user    |
    | `404 Not Found`             | Wrong endpoint      | Check API path and version   |
    | `500 Internal Server Error` | Server issue        | Contact Oracle support       |

    <Accordion title="Common Issues">
      ### User locked out

      After multiple failed attempts, accounts may lock. Use Oracle Security Console to unlock.

      ### API version mismatch

      Oracle Cloud APIs have version-specific paths. Verify you're using the correct version for your instance.
    </Accordion>

    ## Additional Resources

    <CardGroup cols={2}>
      <Card title="Oracle REST API" icon="book" href="https://docs.oracle.com/en/cloud/saas/financials/23a/farfa/">
        Financials REST API documentation
      </Card>
    </CardGroup>
  </Tab>
</Tabs>