Financials Cloud

Setup
Reference

What You'll Need

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

Overview

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

Financials

General Ledger, Accounts Payable/Receivable

Users & Security

User profiles, roles, access

Prerequisites

Setup access in . These steps require , or a colleague with equivalent permissions who can create credentials for you.If that is not you, ask your administrator.

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

Setup Guide

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.

Create Integration User

For best practices, create a dedicated integration user:

Navigate to Security Console → Users
Create a new user: parable_integration
Assign required roles (see permissions below)

Assign Required Roles

The integration user needs these roles:

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

Grant only the minimum roles required for your use case.

Note Your Credentials

Credential	Value
Username	`parable_integration`
Password	(your secure password)
Instance URL	`https://your-instance.fa.us6.oraclecloud.com`

Enter values in the form

Enter Username, Password, Host, Port, Service Name, and Base URL in the connector form.
Click Save & test connection.

Verify Your Setup

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

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

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

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())

For , use your email address as the username and the API token as the password.

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.

API Endpoints Reference

Service	Base Path
HCM	`/hcmRestApi/resources/`
Financials	`/fscmRestApi/resources/`
ERP Common	`/erpRestApi/resources/`

Rate Limits: enforces rate limits of .Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.

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

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.

Additional Resources

Oracle REST API

Financials REST API documentation

Release Notes

Connectors

Financials Cloud

What You'll Need

Overview

Financials

Users & Security

Prerequisites

Setup Guide

Verify Your Setup

API Endpoints Reference

Troubleshooting

User locked out

API version mismatch

Additional Resources

Oracle REST API

What You'll Need

​Overview

Financials

Users & Security

​Prerequisites

​Setup Guide

​Verify Your Setup

​API Endpoints Reference

​Troubleshooting

​User locked out

​API version mismatch

​Additional Resources

Oracle REST API

Overview

Prerequisites

Setup Guide

Verify Your Setup

API Endpoints Reference

Troubleshooting

User locked out

API version mismatch

Additional Resources