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

# Oracle JD Edwards EnterpriseOne

> Client-mode REST API connector for the JD Edwards EnterpriseOne AIS Server: token login and validation plus Orchestrator calls and data service queries

Technical Preview

## Overview

Client-mode REST API connector for the JD Edwards EnterpriseOne AIS Server: token login and validation plus Orchestrator calls and data service queries. `BASE_ADDRESS` defaults to `https://YOUR_AIS_SERVER:PORT`. Topics use `erp/jd-edwards/<object>/<verb>`.

| Event | Request | Source topic |
| - | - | - |
| `JdeLogin` | `POST /jderest/v3/orchestrator/jde-login` | `erp/jd-edwards/auth/login` |
| `JdeValidateSession` | `GET /jderest/v3/orchestrator/jde-validate-session` | `erp/jd-edwards/auth/validate` |
| `JdeLogout` | `POST /jderest/v3/orchestrator/jde-logout` | `erp/jd-edwards/auth/logout` |
| `OrchestrationRun` | `POST /jderest/v3/orchestrator/{value.json.orchestration}` | `erp/jd-edwards/orchestration/run` |
| `OrchestrationGet` | `GET /jderest/v3/orchestrator/{value.json.orchestration}?{value.json.query}` | `erp/jd-edwards/orchestration/get` |
| `DataServiceQuery` | `POST /jderest/v2/dataservice` | `erp/jd-edwards/dataservice/query` |

## Authentication

AIS token. JdeLogin sends HTTP Basic (Authorization: \{value.json.authorization}, i.e. "Basic base64(user:password)") with optional jde-AIS-Auth-Environment / -Role / -Device headers and returns userInfo.token. All other events send that token as jde-AIS-Auth: \{value.json.ais\_token}. Tools 9.2.4+ for header authentication.

> [!WARNING]
>
> Keep credentials in broker secrets and never retain topics that carry tokens or client secrets.

## Notes

* The AIS Server is customer-hosted (on-premises or OCI); replace BASE\_ADDRESS with your AIS URL. Orchestrations are built by the customer in Orchestrator Studio, so the orchestration name and its inputs are site-specific.
* If the token was requested with jde-AIS-Auth-Device, every later call must send the same device; add the header in a fork if you use it.
* Call JdeLogout when done; AIS sessions also hold an HTML Server session until timeout.

## Basic Syntax

```lot wrap theme={"theme":"css-variables","languages":{"custom":["/languages/lot.json"]}}
DEFINE ROUTE OracleJdEdwardsRestApi WITH TYPE REST_API
    ADD REST_API_CONFIG
        WITH BASE_ADDRESS "https://YOUR_AIS_SERVER:PORT"
        WITH ENABLE_CLIENT "true"
        WITH USE_SSL "true"
        WITH REQUEST_TIMEOUT '120'
        WITH DEFAULT_CONTENT_TYPE "application/json"
    ADD EVENT JdeLogin
        WITH SOURCE_TOPIC "erp/jd-edwards/auth/login"
        WITH DESTINATION_TOPIC "erp/jd-edwards/auth/login/response"
        WITH METHOD "POST"
        WITH ENDPOINT "/jderest/v3/orchestrator/jde-login"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "Content-Type" "application/json"
            ADD "Authorization" "{value.json.authorization}"
            ADD "jde-AIS-Auth-Environment" "{value.json.environment}"
            ADD "jde-AIS-Auth-Role" "{value.json.role}"
        WITH BODY ""
    ADD EVENT JdeValidateSession
        WITH SOURCE_TOPIC "erp/jd-edwards/auth/validate"
        WITH DESTINATION_TOPIC "erp/jd-edwards/auth/validate/response"
        WITH METHOD "GET"
        WITH ENDPOINT "/jderest/v3/orchestrator/jde-validate-session"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "jde-AIS-Auth" "{value.json.ais_token}"
    ADD EVENT JdeLogout
        WITH SOURCE_TOPIC "erp/jd-edwards/auth/logout"
        WITH DESTINATION_TOPIC "erp/jd-edwards/auth/logout/response"
        WITH METHOD "POST"
        WITH ENDPOINT "/jderest/v3/orchestrator/jde-logout"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "Content-Type" "application/json"
            ADD "jde-AIS-Auth" "{value.json.ais_token}"
        WITH BODY ""
    ADD EVENT OrchestrationRun
        WITH SOURCE_TOPIC "erp/jd-edwards/orchestration/run"
        WITH DESTINATION_TOPIC "erp/jd-edwards/orchestration/run/response"
        WITH METHOD "POST"
        WITH ENDPOINT "/jderest/v3/orchestrator/{value.json.orchestration}"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "Content-Type" "application/json"
            ADD "jde-AIS-Auth" "{value.json.ais_token}"
        WITH BODY "{value.json.body}"
    ADD EVENT OrchestrationGet
        WITH SOURCE_TOPIC "erp/jd-edwards/orchestration/get"
        WITH DESTINATION_TOPIC "erp/jd-edwards/orchestration/get/response"
        WITH METHOD "GET"
        WITH ENDPOINT "/jderest/v3/orchestrator/{value.json.orchestration}?{value.json.query}"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "jde-AIS-Auth" "{value.json.ais_token}"
    ADD EVENT DataServiceQuery
        WITH SOURCE_TOPIC "erp/jd-edwards/dataservice/query"
        WITH DESTINATION_TOPIC "erp/jd-edwards/dataservice/query/response"
        WITH METHOD "POST"
        WITH ENDPOINT "/jderest/v2/dataservice"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "Content-Type" "application/json"
            ADD "jde-AIS-Auth" "{value.json.ais_token}"
        WITH BODY "{value.json.body}"
```

## Sources

* [https://docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/index.html](https://docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/index.html)
* [https://docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/Authentication.html](https://docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/Authentication.html)
* [https://docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/api-orchestrator-service.html](https://docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/api-orchestrator-service.html)
* [https://docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/op-v3-orchestrator-jde-login-post.html](https://docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/op-v3-orchestrator-jde-login-post.html)
* [https://docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/op-v3-orchestrator-orchestration-post.html](https://docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/op-v3-orchestrator-orchestration-post.html)
* [https://docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/op-v2-dataservice-post.html](https://docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/op-v2-dataservice-post.html)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.