Punchout Connections
punchoutConnections Based on 26C
Look up Punchout Connections. Actions include translate via exchange. Changes only through its actions.
The record key punchoutConnectionsUniqID is a generated hash. Take it from the record's links (rel self) in a GET response; never build it yourself.
- Operations
- GET (list)GET (one)1 action
- Record key
punchoutConnectionsUniqID- Required on create
- no create on this resource
- At a glance
- 5 fields1 finders0 children
Try it
Only attributes Oracle marks as searchable are offered.
GET /fscmRestApi/resources/11.13.18.05/punchoutConnections?fields=CatalogId,CatalogName,PunchoutErrorDetails,PunchoutItemId,PunchoutRedirectionURL&limit=25&onlyData=true
{
"items": [
{
"CatalogId": 0,
"CatalogName": "<string, max 30>",
"PunchoutErrorDetails": "<string>",
"PunchoutItemId": 0,
"PunchoutRedirectionURL": "<string>"
}
],
"count": 25,
"hasMore": true,
"limit": 25,
"offset": 0
}Shapes and placeholders, not real data. Replace https://<your-pod> and the login with your own: this site never sees them. Based on Oracle's 26C REST specification.
Fields 5
| Attribute | Type | Use |
|---|---|---|
CatalogId | number | Read-onlySearchable |
CatalogName | text · max 30 | Read-only |
PunchoutErrorDetails | text | |
PunchoutItemId | number | Read-onlySearchable |
PunchoutRedirectionURL | text |
Names, types, labels and flags from Oracle's REST specification (26C). Flexfield and custom attributes vary by pod: check /describe for yours.
Finders 1
Predefined searches: ?finder=Name;variable=value,variable2=value2. Pick one in Try it to build the call.
findBySourceApplication·DeliverToLocationIdParentReqLineIdRequisitionBuIdSourceApplication
Check a payload
Checked in your browser only; nothing you paste is sent anywhere. Checks names and flags, not values.
Actions 1
POST …/{punchoutConnectionsUniqID}/action/translateViaExchange·translate
Actions use Content-Type: application/vnd.oracle.adf.action+json. A path with a {key} runs on one record.
Use in AI Agent Studio
- Point a Business Object or REST tool at
/fscmRestApi/resources/11.13.18.05/punchoutConnectionsand ask only for the fields the agent needs withfields=. Big responses cost tokens and slow the agent. - Prefer a finder such as
findBySourceApplicationfor the agent's main search: its variables become clean tool parameters. - Narrow with
q=on searchable fields and a smalllimit; for a count usetotalResults=true&limit=1. - Call once and pass the result on to later steps rather than calling the same endpoint again.
- This resource can change data. Put a human approval step before any create, update, delete or action call.
More in For Builders.
Pitfalls
- Attribute names are case-sensitive in
q,fieldsand bodies:PunchoutErrorDetails, notpunchouterrordetails. onlyData=trueremoveslinks, and this resource's key only comes fromlinks. Leave it off when you need the key.- A list returns 25 rows unless you set
limit; readhasMoreand moveoffsetto page through.