// fusionrest agent · procurement

Draft Purchase Agreements

draftPurchaseAgreements Based on 26C

Create, change, delete and look up Draft Purchase Agreements, with business unit access, contract documents and lines. Actions include suggest category and add contract terms.

The record key draftPurchaseAgreementsUniqID is a generated hash. Take it from the record's links (rel self) in a GET response; never build it yourself.

Oracle documents an Effective-Of header and an effectiveDate parameter for this resource, used for date-effective reads and changes.

/fscmRestApi/resources/11.13.18.05/draftPurchaseAgreements
Operations
GET (list)GET (one)POST (create)PATCH (update)DELETE16 actions
Record key
draftPurchaseAgreementsUniqID
Required on create
BuyerIdDocumentStyleIdDocumentTypeCodeProcurementBUId
At a glance
129 fields0 finders17 children
Extra parameters
?effectiveDate=Effective-Of:
I want to…List the latest 25Count recordsGet one recordCreate oneUpdate one

Try it

Response fields ·
Filters (q)

Only attributes Oracle marks as searchable are offered.

Include children (expand)
Paging and options
limit
Endpoint and headers
GET /fscmRestApi/resources/11.13.18.05/draftPurchaseAgreements?fields=AcknowledgmentDueDate,AcknowledgmentWithinDays,AgingOnsetPoint,AgingOnsetPointCode,AgingPeriodDays&limit=25&onlyData=true
Response shape (placeholders)
{
  "items": [
    {
      "AcknowledgmentDueDate": "2026-01-31",
      "AcknowledgmentWithinDays": 0,
      "AgingOnsetPoint": "<string, max 80>",
      "AgingOnsetPointCode": "<string, max 30>",
      "AgingPeriodDays": 0
    }
  ],
  "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 129

AttributeTypeUse
AcknowledgmentDueDatedateRead-onlySearchable
AcknowledgmentWithinDaysnumberOptional on createUpdatable
AgingOnsetPointtext · max 80Optional on createUpdatableSearchable
AgingOnsetPointCodetext · max 30Optional on createUpdatableSearchable
AgingPeriodDaysnumberOptional on createUpdatableSearchable
AgreementAmountnumberOptional on createUpdatableSearchable
AgreementHeaderIdnumberRead-onlySearchable
AgreementNumbertext · max 30Optional on createUpdatableSearchable
AllowUnassignedSitesFlagyes/no · max 1Optional on createUpdatableSearchable
AmountLimitnumberOptional on createUpdatableSearchable
AutoSourcingFlagyes/no · max 1Optional on createUpdatableSearchable
AutomaticallyGenerateOrdersFlagyes/no · max 1Optional on createUpdatableSearchable
AutomaticallySubmitForApprovalFlagyes/no · max 1Optional on createUpdatableSearchable
BillingCycleClosingDatedateOptional on createUpdatableSearchable
Buyertext · max 240Optional on createUpdatableSearchable
BuyerEmailtext · max 240Optional on createUpdatableSearchable
BuyerFullNametext · max 240Read-only
BuyerIdnumberRequired on createUpdatableSearchable
BuyerManagedTransportFlagyes/no · max 1Optional on createUpdatableSearchable
CancelDocumentFlagyes/no · max 1Read-only
Carriertext · max 360Optional on createUpdatable
CarrierIdnumberOptional on createUpdatable
ChangeOrderCreationDatedate-timeRead-onlySearchable
ChangeOrderDescriptiontext · max 255Optional on createUpdatable
ChangeOrderInitiatingPartytext · max 255Optional on createUpdatable
ChangeOrderInitiatorIdnumberRead-onlySearchable
ChangeOrderInitiatorRoletext · max 255Read-onlySearchable
ChangeOrderNumbertext · max 80Read-onlySearchable
ChangeOrderSequencenumberRead-onlySearchable
ChangeOrderStatustext · max 255Read-onlySearchable
ChangeOrderStatusCodetext · max 25Read-onlySearchable
ChangeOrderTypetext · max 255Read-onlySearchable
ChangeOrderTypeCodetext · max 1Read-onlySearchable
ChangeRequestedBytext · max 360Read-only
Checklisttext · max 80Optional on createUpdatableSearchable
ChecklistIdnumberOptional on createUpdatable
ChecklistNumbertext · max 30Optional on createUpdatableSearchable
CommunicateRepricedOrdersFlagyes/no · max 1Optional on createUpdatableSearchable
ConfiguredItemFlagyes/no · max 1Read-only
ConfirmingOrderFlagyes/no · max 1Optional on createUpdatable
ConsignedItemsFlagyes/no · max 1Read-only
ConsumptionAdviceFrequencytext · max 80Optional on createUpdatableSearchable
ConsumptionAdviceFrequencyCodetext · max 30Optional on createUpdatableSearchable
ConsumptionAdviceSummarytext · max 80Optional on createUpdatableSearchable
ConsumptionAdviceSummaryCodetext · max 30Optional on createUpdatableSearchable
ContractTermsExiststext · max 1Optional on createUpdatableSearchable
CreatedBytext · max 64Read-only
CreationDatedate-timeRead-onlySearchable
Currencytext · max 80Optional on createUpdatableSearchable
CurrencyCodetext · max 15Optional on createUpdatableSearchable
DefaultConsignmentLineFlagyes/no · max 1Optional on createUpdatableSearchable
Descriptiontext · max 240Optional on createUpdatableSearchable
DocumentCreationMethodtext · max 30Optional on createUpdatable
DocumentStyletext · max 240Optional on createUpdatableSearchable
DocumentStyleIdnumberRequired on createUpdatableSearchable
DocumentTypetext · max 80Optional on createUpdatableSearchable
DocumentTypeCodetext · max 25Required on createUpdatableSearchable
EnableRetroactivePricingFlagyes/no · max 1Optional on createUpdatableSearchable
EndDatedateOptional on createUpdatableSearchable
EntityChangeTypeCodetext · max 1Read-onlySearchable
FOBtext · max 80Optional on createUpdatableSearchable
FOBCodetext · max 30Optional on createUpdatableSearchable
FreightTermstext · max 80Optional on createUpdatableSearchable
FreightTermsCodetext · max 30Optional on createUpdatableSearchable
GroupRequisitionLinesFlagyes/no · max 1Optional on createUpdatableSearchable
GroupRequisitionsFlagyes/no · max 1Optional on createUpdatableSearchable
IdentificationKeytext · max 255Read-onlySearchable
InitiateRetroactivePricingUponApprovalFlagyes/no · max 1Optional on createUpdatableSearchable
LastUpdateDatedate-timeRead-only
LastUpdatedBytext · max 64Read-only
LatestIdentificationKeytext · max 255Read-onlySearchable
MasterContractIdnumberOptional on createUpdatableSearchable
MasterContractNumbertext · max 120Optional on createUpdatableSearchable
MasterContractTypetextOptional on createUpdatableSearchable
MasterContractTypeIdnumberOptional on createUpdatableSearchable
MinimumReleaseAmountnumberOptional on createUpdatableSearchable
ModeOfTransporttext · max 80Optional on createUpdatable
ModeOfTransportCodetext · max 30Optional on createUpdatable
Negotiationtext · max 255Read-onlySearchable
NegotiationIdnumberRead-onlySearchable
NoteToAuthorizertext · max 1000Optional on createUpdatableSearchable
NoteToReceivertext · max 1000Optional on createUpdatable
NoteToSuppliertext · max 1000Optional on createUpdatable
OkcContractIdnumberRead-onlySearchable
OkcContractNumbertext · max 255Read-onlySearchable
OutsideProcessingFlagyes/no · max 1Read-only
PayOnReceiptFlagyes/no · max 25Optional on createUpdatable
PayOnUseFlagyes/no · max 1Optional on createUpdatableSearchable
PaymentTermstext · max 50Optional on createUpdatableSearchable
PaymentTermsIdnumberOptional on createUpdatableSearchable
PriceBreaksFlagyes/no · max 1Read-only
PriceUpdateTolerancenumberOptional on createUpdatable
PrioritynumberOptional on createUpdatableSearchable
ProcurementBUtext · max 240Optional on createUpdatableSearchable
ProcurementBUIdnumberRequired on createUpdatableSearchable
PunchoutRequestsOnlyFlagyes/no · max 1Optional on createUpdatableSearchable
ReferenceNumbertext · max 120Optional on createUpdatableSearchable
ReleasedAmountnumberRead-onlySearchable
RepriceOpenOrdersFlagyes/no · max 1Optional on createUpdatableSearchable
RequiredAcknowledgmenttext · max 80Optional on createUpdatable
RequiredAcknowledgmentCodetext · max 1Optional on createUpdatable
RequiresSignatureFlagyes/no · max 1Optional on createUpdatableSearchable
ScheduleGrouptext · max 30Optional on createUpdatableSearchable
ScheduleGroupMeaningtext · max 80Optional on createUpdatableSearchable
ServiceLeveltext · max 80Optional on createUpdatable
ServiceLevelCodetext · max 30Optional on createUpdatable
ShippingMethodtextOptional on createUpdatableSearchable
StartDatedateOptional on createUpdatableSearchable
Statustext · max 80Read-onlySearchable
StatusCodetext · max 40Read-onlySearchable
Suppliertext · max 360Optional on createUpdatableSearchable
SupplierAgreementtext · max 25Optional on createUpdatable
SupplierCommunicationMethodCodetext · max 25Optional on createUpdatable
SupplierContacttext · max 4000Optional on createUpdatable
SupplierContactFullNametextRead-only
SupplierContactIdnumberOptional on createUpdatable
SupplierEmailAddresstext · max 2000Optional on createUpdatable
SupplierFaxtext · max 60Optional on createUpdatable
SupplierIdnumberOptional on createUpdatableSearchable
SupplierPartyIdnumberOptional on createUpdatableSearchable
SupplierPayOnUseFlagyes/no · max 1Read-only
SupplierSitetext · max 240Optional on createUpdatableSearchable
SupplierSiteIdnumberOptional on createUpdatableSearchable
UseCustomerSalesOrderFlagyes/no · max 1Optional on createUpdatableSearchable
UseOrderDateForOrderPricingFlagyes/no · max 1Optional on createUpdatableSearchable
UseRequestedDateFlagyes/no · max 1Optional on createUpdatableSearchable
UseShipToLocationFlagyes/no · max 1Optional on createUpdatableSearchable
UseShipToOrganizationAndLocationFlagyes/no · max 1Optional on createUpdatableSearchable
VersionIdnumberRead-onlySearchable

Names, types, labels and flags from Oracle's REST specification (26C). Flexfield and custom attributes vary by pod: check /describe for yours.

Check a payload

Checked in your browser only; nothing you paste is sent anywhere. Checks names and flags, not values.

Children 17

Child resources sit under one record: /fscmRestApi/resources/11.13.18.05/draftPurchaseAgreements/{draftPurchaseAgreementsUniqID}/child/<name>. Add them to a GET with expand.

Actions 16

Actions use Content-Type: application/vnd.oracle.adf.action+json. A path with a {key} runs on one record.

Use in AI Agent Studio

More in For Builders.

Pitfalls