7x Developer Portal & API Documentation

Overview

Registers the customer organisation (party) in Oracle AR — first-time onboarding. NEW only. Fired by EPG_TransactionUtils → EPG_OracleIntegrations('createorg').

Request builder

Create Organization

Reference details

Authorization

oicBasic

AuthorizationBasic <token>

Basic auth with the OIC integration user (Named Credential OracleIntg / me-dubai-1 creds).

In: header

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/EPGCREATEORGANIZATION/1.0/createOrganization" \  -H "Content-Type: application/json" \  -d '{    "OrganizationName": "ARAMEX EMIRATES (L.L.C)",    "PartyUsageCode": "SUPPLIER_CUSTOMER",    "SourceSystem": "EPG_SF",    "SourceSystemID": "001NM00000ABCDeYAN",    "TaxCountryCode": "AE",    "TaxRegistrationNumber": "100212963100003",    "Address": [      {        "AddressType": "BILL_TO",        "Address1": "Building and Warehouse No. 3, Um Rammool",        "City": "Dubai",        "State": "Dubai",        "Country": "AE",        "PostalCode": "95946"      }    ]  }'

{  "status": "Success",  "PartyId": "300000012345678",  "PartyNumber": "10012345",  "PartySiteId": "300000012345679",  "message": "Organization created successfully"}

{  "status": "Failed",  "errorCode": "AR-VAL-400",  "errorMessage": "BillToCustomerNumber '9099' does not exist in Oracle AR."}

{  "status": "401",  "error": "Unauthorized",  "message": "Invalid username or password for the OIC integration user."}

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",  "title": "CASDK-0033",  "detail": "faultName: {remoteFault} cause: Received a SOAPFault while invoking the Fusion service.",  "o:errorCode": "500",  "o:errorDetails": [    {      "type": "UnMappedFault",      "instance": "NA",      "o:errorCode": "CASDK-0033"    }  ]}

Overview

Creates the customer account and bill-to site in Oracle AR using the party id from Create Organization. NEW only. Chained from 'createorg' → EPG_OracleIntegrations('createaccount').

Request builder

Create Account

POST

/EPGCREATEACCOUNT/1.0/createAcountDetails

usernamestring

passwordstring

*

AccountName

StartDate

AccountEstablishedDate

PartyId

PartySiteId

SiteUseCode

SetId

AccoutType

CustomerClassCode

TradeLicenseNumber

TradeLicenseExpiryDate

CourierLicensingDistinctNumber

creditLimit

paymentTerms

CompanyCode

ContactPersonFirstName

ContactPersonLastName

TaxRegistrationNumber

TaxCountryCode

SourceSystem

SourceSystemID

Reference details

Authorization

oicBasic

AuthorizationBasic <token>

Basic auth with the OIC integration user (Named Credential OracleIntg / me-dubai-1 creds).

In: header

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/EPGCREATEACCOUNT/1.0/createAcountDetails" \  -H "Content-Type: application/json" \  -d '{    "AccountName": "ARAMEX EMIRATES (L.L.C)",    "StartDate": "2026-01-01",    "AccountEstablishedDate": "2014-05-03",    "PartyId": "300000012345678",    "PartySiteId": "300000012345679",    "SiteUseCode": "BILL_TO",    "SetId": "300000001127004",    "AccoutType": "R",    "CustomerClassCode": "LICENSING",    "TradeLicenseNumber": "233051",    "TradeLicenseExpiryDate": "2027-01-01",    "CourierLicensingDistinctNumber": "LIC-000123",    "creditLimit": "3000",    "paymentTerms": "IMMEDIATE",    "CompanyCode": "EPG",    "ContactPersonFirstName": "Mukesh",    "ContactPersonLastName": "Kharajani",    "TaxRegistrationNumber": "100212963100003",    "TaxCountryCode": "AE",    "SourceSystem": "EPG_SF",    "SourceSystemID": "001NM00000ABCDeYAN",    "Email": [      {        "PrimaryFlag": "Y",        "ContactPointType": "EMAIL",        "EmailAddress": "[email protected]"      }    ],    "Phone": [      {        "PrimaryFlag": "Y",        "ContactPointType": "PHONE",        "PhoneCountryCode": "971",        "PhoneNumber": "42303000"      }    ]  }'

{  "status": "Success",  "AccountNumber": "9099",  "SiteUseId": "300000012345680",  "PartySiteNumber": "101011",  "message": "Account created successfully"}

{  "status": "Failed",  "errorCode": "AR-VAL-400",  "errorMessage": "BillToCustomerNumber '9099' does not exist in Oracle AR."}

{  "status": "401",  "error": "Unauthorized",  "message": "Invalid username or password for the OIC integration user."}

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",  "title": "CASDK-0033",  "detail": "faultName: {remoteFault} cause: Received a SOAPFault while invoking the Fusion service.",  "o:errorCode": "500",  "o:errorDetails": [    {      "type": "UnMappedFault",      "instance": "NA",      "o:errorCode": "CASDK-0033"    }  ]}

Overview

Raises the licence-fee invoice in Oracle AR once the payment advice is confirmed. Fired by EPG_TransactionTriggerHelper → 'createinvoiceonly' / 'createinvoiceMultiReceipts'.

Request builder

Create Invoice

POST

/EPGCREATEINVOICE/1.0/createInvoice

usernamestring

passwordstring

*

BillingDate

BillToCustomerName

BillToCustomerNumber

BillToSite

BusinessUnit

TransactionType

TransactionSource

TransactionDate

DueDate

InvoiceCurrencyCode

PaymentTerms

StructuredPaymentReference

Comments

SourceSystem

SourceSystemID

Reference details

Authorization

oicBasic

AuthorizationBasic <token>

Basic auth with the OIC integration user (Named Credential OracleIntg / me-dubai-1 creds).

In: header

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/EPGCREATEINVOICE/1.0/createInvoice" \  -H "Content-Type: application/json" \  -d '{    "BillingDate": "2026-01-01",    "BillToCustomerName": "ARAMEX EMIRATES (L.L.C)",    "BillToCustomerNumber": "9099",    "BillToSite": "300000012345680",    "BusinessUnit": "EPG Licensing BU",    "TransactionType": "Invoice",    "TransactionSource": "LICENSING_MANUAL",    "TransactionDate": "2026-01-01",    "DueDate": "2026-01-01",    "InvoiceCurrencyCode": "AED",    "PaymentTerms": "IMMEDIATE",    "StructuredPaymentReference": "LICNEW0000123",    "Comments": "Courier License Fee",    "SourceSystem": "EPG_SF",    "SourceSystemID": "a1INM0000001abcYAI",    "receivablesInvoiceLines": [      {        "LineNumber": 1,        "Description": "New Courier License Fee",        "Quantity": 1,        "UnitSellingPrice": 1600,        "TaxClassificationCode": "SR-AE"      }    ]  }'

{  "status": "Success",  "TransactionNumber": "30093870",  "CustomerTransactionId": "300000536214578",  "message": "Invoice created successfully"}

{  "status": "Failed",  "errorCode": "AR-VAL-400",  "errorMessage": "BillToCustomerNumber '9099' does not exist in Oracle AR."}

{  "status": "401",  "error": "Unauthorized",  "message": "Invalid username or password for the OIC integration user."}

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",  "title": "CASDK-0033",  "detail": "faultName: {remoteFault} cause: Received a SOAPFault while invoking the Fusion service.",  "o:errorCode": "500",  "o:errorDetails": [    {      "type": "UnMappedFault",      "instance": "NA",      "o:errorCode": "CASDK-0033"    }  ]}

Overview

Applies the payment receipt against the invoice in Oracle AR. Fired by 'createreceipt2' (License Request trigger / chained after invoice).

Request builder

Create Standard Receipt

POST

/EPGCREATESTANDARDRECEIPTS/1.0/createStandardReceipts

usernamestring

passwordstring

*

ReceiptNumber

ReceiptMethod

BusinessUnit

CustomerAccountNumber

CustomerSite

Amount

CurrencyCode

TransTimeStamp

ReceiptDate

AccountingDate

BankReferenceNumber

BankReferenceDate

StructuredPaymentReference

RemittanceBankAccountNumber

SourceSystem

SourceSystemID

Reference details

Authorization

oicBasic

AuthorizationBasic <token>

Basic auth with the OIC integration user (Named Credential OracleIntg / me-dubai-1 creds).

In: header

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/EPGCREATESTANDARDRECEIPTS/1.0/createStandardReceipts" \  -H "Content-Type: application/json" \  -d '{    "ReceiptNumber": "RCPT-LICNEW-0000123",    "ReceiptMethod": "EPG Online Payment",    "BusinessUnit": "EPG Licensing BU",    "CustomerAccountNumber": "9099",    "CustomerSite": "101011",    "Amount": 1600,    "CurrencyCode": "AED",    "TransTimeStamp": "2026-01-01",    "ReceiptDate": "2026-01-01",    "AccountingDate": "2026-01-01",    "BankReferenceNumber": "FT26010112345",    "BankReferenceDate": "2026-01-01",    "StructuredPaymentReference": "LICNEW0000123",    "RemittanceBankAccountNumber": "EPG-AED-001",    "SourceSystem": "EPG_SF",    "SourceSystemID": "a1INM0000001abcYAI"  }'

{  "status": "Success",  "ReceiptNumber": "RCPT-LICNEW-0000123",  "ReceiptId": "300000536299001",  "AppliedAmount": 1600,  "message": "Receipt applied successfully"}

{  "status": "Failed",  "errorCode": "AR-VAL-400",  "errorMessage": "BillToCustomerNumber '9099' does not exist in Oracle AR."}

{  "status": "401",  "error": "Unauthorized",  "message": "Invalid username or password for the OIC integration user."}

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",  "title": "CASDK-0033",  "detail": "faultName: {remoteFault} cause: Received a SOAPFault while invoking the Fusion service.",  "o:errorCode": "500",  "o:errorDetails": [    {      "type": "UnMappedFault",      "instance": "NA",      "o:errorCode": "CASDK-0033"    }  ]}

Overview

Issues a credit memo for adjustments / reversals. Transaction-triggered (EPG_TransactionTriggerHelper → 'creditMemo'); rare on a New request.

Request builder

Create Credit Memo (conditional)

POST

/EPGCREATECREDITMEMO/1.0/createcreditmemo

usernamestring

passwordstring

*

BillToCustomerNumber

BillToSite

PayingCustomerSite

BusinessUnit

TransactionType

TransactionSource

TransactionDate

InvoiceCurrencyCode

OriginalTransactionNumber

Comments

SourceSystem

SourceSystemID

Reference details

Authorization

oicBasic

AuthorizationBasic <token>

Basic auth with the OIC integration user (Named Credential OracleIntg / me-dubai-1 creds).

In: header

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/EPGCREATECREDITMEMO/1.0/createcreditmemo" \  -H "Content-Type: application/json" \  -d '{    "BillToCustomerNumber": "9099",    "BillToSite": "300000012345680",    "PayingCustomerSite": "300000012345680",    "BusinessUnit": "EPG Licensing BU",    "TransactionType": "Credit Memo",    "TransactionSource": "LICENSING_MANUAL",    "TransactionDate": "2026-01-05",    "InvoiceCurrencyCode": "AED",    "OriginalTransactionNumber": "30093870",    "Comments": "Adjustment against overpaid licence fee",    "SourceSystem": "EPG_SF",    "SourceSystemID": "a1INM0000009xyzYAI",    "creditMemoLines": [      {        "LineNumber": 1,        "Description": "Licence fee adjustment",        "Quantity": 1,        "UnitSellingPrice": -200,        "TaxClassificationCode": "SR-AE"      }    ]  }'

{  "status": "Success",  "CreditMemoNumber": "CM-30093870",  "CustomerTransactionId": "300000536300777",  "message": "Credit memo created successfully"}

{  "status": "Failed",  "errorCode": "AR-VAL-400",  "errorMessage": "BillToCustomerNumber '9099' does not exist in Oracle AR."}

{  "status": "401",  "error": "Unauthorized",  "message": "Invalid username or password for the OIC integration user."}

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",  "title": "CASDK-0033",  "detail": "faultName: {remoteFault} cause: Received a SOAPFault while invoking the Fusion service.",  "o:errorCode": "500",  "o:errorDetails": [    {      "type": "UnMappedFault",      "instance": "NA",      "o:errorCode": "CASDK-0033"    }  ]}

Overview

Looks up the account's bill-to site id when it isn't cached on the Account. Called inside Create Invoice / Create Credit Memo (EPG_OracleIntegrations.getBillToSiteId).

Request builder

Get Bill To Site (conditional)

Reference details

Authorization

oicBasic

AuthorizationBasic <token>

Basic auth with the OIC integration user (Named Credential OracleIntg / me-dubai-1 creds).

In: header

Query Parameters

q*string

Oracle LOV filter. Example: SetName=Licensing;AccountNumber=9099

Response Body

`application/json`

curl -X GET "https://example.com/EPGGETCUSTOMERACCOUNTSITESLOV/1.0/customerAccountSitesLOV?q=SetName%3DLicensing%3BAccountNumber%3D9099"

{  "items": [    {      "SiteUseId": "300000012345680",      "PartySiteNumber": "101011",      "SiteUseCode": "BILL_TO",      "LocationName": "ARAMEX DUBAI"    }  ],  "count": 1,  "hasMore": false}

{  "status": "Failed",  "errorCode": "AR-VAL-400",  "errorMessage": "BillToCustomerNumber '9099' does not exist in Oracle AR."}

{  "status": "401",  "error": "Unauthorized",  "message": "Invalid username or password for the OIC integration user."}

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",  "title": "CASDK-0033",  "detail": "faultName: {remoteFault} cause: Received a SOAPFault while invoking the Fusion service.",  "o:errorCode": "500",  "o:errorDetails": [    {      "type": "UnMappedFault",      "instance": "NA",      "o:errorCode": "CASDK-0033"    }  ]}

Overview

UAE PASS e-Seal signing of the issued licence PDF (proxied via OIC). Fired by docusignGen_And_API → ESealJob → EPG_eSealDocuments.sendESealDocuments_DET.

Request builder

E Seal — License Document

Reference details

Authorization

oicBasic

AuthorizationBasic <token>

Basic auth with the OIC integration user (Named Credential OracleIntg / me-dubai-1 creds).

In: header

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/UAEPASS_ESEAL_LIC_DOCUMENT/3.0/SignDocument" \  -H "Content-Type: application/json" \  -d '{    "Document_B64": "JVBERi0xLjYNCiXi48/TDQo1IDAgb2JqDQo8PC9UeXBlL0NhdGFsb2c...=="  }'

{  "status": "Success",  "errorMessage": "Null",  "Data": "JVBERi0xLjYNCiXi48/TDQpTSUdORUQtTElDRU5TRS1QREYtQkFTRTY0...=="}

{  "status": "Failed",  "errorMessage": "Document_B64 is empty or not a valid base64 PDF."}

{  "status": "401",  "error": "Unauthorized",  "message": "Invalid username or password for the OIC integration user."}

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",  "title": "CASDK-0033",  "detail": "faultName: {remoteFault} cause: Received a SOAPFault while invoking the Fusion service.",  "o:errorCode": "500",  "o:errorDetails": [    {      "type": "UnMappedFault",      "instance": "NA",      "o:errorCode": "CASDK-0033"    }  ]}

Overview

UAE PASS e-Seal signing of the NOC (No Objection Certificate) that accompanies a new licence. Same job path as the licence e-Seal, routed to the NOC endpoint for NOC document types.

Request builder

E Seal — NOC Document

Reference details

Authorization

oicBasic

AuthorizationBasic <token>

Basic auth with the OIC integration user (Named Credential OracleIntg / me-dubai-1 creds).

In: header

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/UAEPASS_ESEAL_LIC_NOC_DOCUMENT/3.0/SignDocument" \  -H "Content-Type: application/json" \  -d '{    "Document_B64": "JVBERi0xLjYNCiXi48/TDQpOT0MtRE9DVU1FTlQtUERGLUJBU0U2NA...=="  }'

{  "status": "Success",  "errorMessage": "Null",  "Data": "JVBERi0xLjYNCiXi48/TDQpTSUdORUQtTk9DLVBERi1CQVNFNjQ...=="}

{  "status": "Failed",  "errorMessage": "Document_B64 is empty or not a valid base64 PDF."}

{  "status": "401",  "error": "Unauthorized",  "message": "Invalid username or password for the OIC integration user."}

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",  "title": "CASDK-0033",  "detail": "faultName: {remoteFault} cause: Received a SOAPFault while invoking the Fusion service.",  "o:errorCode": "500",  "o:errorDetails": [    {      "type": "UnMappedFault",      "instance": "NA",      "o:errorCode": "CASDK-0033"    }  ]}

200application/json

400application/json

401application/json

500application/json

200application/json

400application/json

401application/json

500application/json

200application/json

400application/json

401application/json

500application/json

200application/json

400application/json

401application/json

500application/json

200application/json

400application/json

401application/json

500application/json

200application/json

400application/json

401application/json

500application/json

200application/json

400application/json

401application/json

500application/json

200application/json

400application/json

401application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`