Project Forecasts
projectForecasts Based on 26C
Create, change, delete and look up Project Forecasts, with planning options, planning resources and version errors. Actions include adjust for range of projects and refresh rates for range of projects.
- Operations
- GET (list)GET (one)POST (create)PATCH (update)DELETE9 actions
- Record key
PlanVersionId- Required on create
PlanVersionNameProjectIdProjectNameProjectNumber- At a glance
- 52 fields2 finders11 children
Try it
Only attributes Oracle marks as searchable are offered.
GET /fscmRestApi/resources/11.13.18.05/projectForecasts?fields=ActualBurdenedCostInProjectCurrency,ActualRawCostInProjectCurrency,ActualRevenueInProjectCurrency,AdjustmentPercentage,AdministrativeCode&limit=25&onlyData=true
{
"items": [
{
"ActualBurdenedCostInProjectCurrency": 0,
"ActualRawCostInProjectCurrency": 0,
"ActualRevenueInProjectCurrency": 0,
"AdjustmentPercentage": 0,
"AdministrativeCode": "<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 52
| Attribute | Type | Use |
|---|---|---|
ActualBurdenedCostInProjectCurrency | number | Read-onlySearchable |
ActualRawCostInProjectCurrency | number | Read-onlySearchable |
ActualRevenueInProjectCurrency | number | Read-onlySearchable |
AdjustmentPercentage | number | Optional on create |
AdministrativeCode | text | Optional on createUpdatable |
BurdenedCostInProjectCurrency | number | Read-onlySearchable |
BurdenedCostInProjectLedgerCurrency | number | Read-onlySearchable |
CurrentBaselineBudgetMarginVariance | number | Read-onlySearchable |
CurrentBaselineBudgetMarginVariancePercentage | number | Read-onlySearchable |
CurrentForecastMarginVariance | number | Read-onlySearchable |
CurrentForecastMarginVariancePercentage | number | Read-onlySearchable |
DeferFinancialPlanCreation | text · default Y | Optional on create |
EACEquipmentEffort | number | Read-onlySearchable |
EACLaborEffort | number | Read-onlySearchable |
ETCBurdenedCostInProjectCurrency | number | Read-onlySearchable |
ETCRawCostInProjectCurrency | number | Read-onlySearchable |
ETCStartDate | date | Read-onlySearchable |
FinancialPlanType | text · max 240 | Optional on createUpdatableSearchable |
ForecastCreationMethod | text | Optional on create |
ForecastCreationMethodCode | text | Optional on createSearchable |
ForecastGenerationSource | text | Optional on create |
ForecastGenerationSourceCode | text | Optional on createSearchable |
LockedBy | text · max 255 | Read-onlySearchable |
LockedFlag | yes/no | Optional on createUpdatableSearchable |
Margin | number | Read-onlySearchable |
MarginPercentage | number | Read-onlySearchable |
OriginalBaselineBudgetMarginVariance | number | Read-onlySearchable |
OriginalBaselineBudgetMarginVariancePercentage | number | Read-onlySearchable |
PlanVersionDescription | text · max 2000 | Optional on createUpdatableSearchable |
PlanVersionId | number | Optional on createSearchable |
PlanVersionName | text · max 225 | Required on createUpdatableSearchable |
PlanVersionNumber | number | Read-onlySearchable |
PlanVersionStatus | text | Optional on createUpdatableSearchable |
PlanningAmounts | text · max 30 | Optional on createSearchable |
PlanningOptionId | number | Read-onlySearchable |
PreviousForecastMarginVariance | number | Read-onlySearchable |
PreviousForecastMarginVariancePercentage | number | Read-onlySearchable |
ProjectId | number | Required on createSearchable |
ProjectName | text · max 240 | Required on createSearchable |
ProjectNumber | text · max 25 | Required on createSearchable |
ProjectResourcesStatus | text | Optional on create |
RawCostInProjectCurrency | number | Read-onlySearchable |
RawCostInProjectLedgerCurrency | number | Read-onlySearchable |
RbsVersionId | number | Read-onlySearchable |
RevenueInProjectCurrency | number | Read-onlySearchable |
RevenueInProjectLedgerCurrency | number | Read-onlySearchable |
SourcePlanType | text | Optional on create |
SourcePlanVersionId | number | Optional on create |
SourcePlanVersionName | text | Optional on createSearchable |
SourcePlanVersionNumber | number | Optional on create |
SourcePlanVersionStatus | text | Optional on create |
TotalCommitmentsInProjectCurrency | number | Read-onlySearchable |
Names, types, labels and flags from Oracle's REST specification (26C). Flexfield and custom attributes vary by pod: check /describe for yours.
Finders 2
Predefined searches: ?finder=Name;variable=value,variable2=value2. Pick one in Try it to build the call.
CurrentApprovedProjectForecastFinder·FinancialPlanTypeProjectIdCurrentWorkingProjectForecastFinder·FinancialPlanTypeProjectId
Check a payload
Checked in your browser only; nothing you paste is sent anywhere. Checks names and flags, not values.
Children 11
Child resources sit under one record: /fscmRestApi/resources/11.13.18.05/projectForecasts/{PlanVersionId}/child/<name>. Add them to a GET with expand.
AttachmentsGET · POST · PATCH · DELETE Project Forecast Attachments · 32 fieldsAsyncTrackerIdAttachedDocumentIdCategoryNameContentRepositoryFileSharedCreatedByCreatedByUserNameCreationDateDatatypeCodeDescriptionDmDocumentIdDmFolderPathDmVersionNumberDownloadInfoErrorStatusCodeErrorStatusMessageExpirationDateFileContentsFileNameFileUrlFileWebImageLastUpdateDateLastUpdatedByLastUpdatedByUserNamePostProcessingActionTitleUploadedFileContentTypeUploadedFileLengthUploadedFileNameUploadedTextUriUrlUserNamePlanningOptionsGET · POST · PATCH Planning Options · 68 fieldsActualAmountsThroughPeriodAllowNegativeETCCalculationFlagAmountScaleAssignTaskResourceInSingleCurrencyFlagAssociateProjectCostsOrRevenueToSummaryTasksFlagAutomaticallyUpdateReportedActualAmountsFlagBillRateDerivationDateBillRateDerivationDateTypeBurdenScheduleCostOptionsCalendarTypeCarryForwardUnusedAmountsFromPastPeriodsFlagCostDateTypeForConversionInPCCostDateTypeForConversionInPLCCostFixedDateForConversionInPCCostFixedDateForConversionInPLCCostRateDerivationDateCostRateDerivationDateTypeCostRateTypeForConversionInPCCostRateTypeForConversionInPLCCurrencyTypeCurrentPlanningPeriodDateTypeForCostConversionDateTypeForRevenueConversionDefaultReportingOptionDesignateAsPrimaryCostForecastFlagDesignateAsPrimaryRevenueForecastFlagETCGenerationSourceFixedDateForCostConversionFixedDateForRevenueConversionForecastETCMethodGenSrcPlanVersionIdIncludeActualAmountsFlagJobCostOptionsJobRevenueOptionsMaintainManualSpreadOnDateChangesMultipleTransactionCurrenciesNonlaborResourceCostOptionsNonlaborResourceRevenueOptionsOpenCommitmentsPeriodProfilePersonCostOptionsPersonRevenueOptionsPlanningLevelPlanningOptionIdPlanningResourceBreakdownStructureProjectCurrencyProjectLedgerCurrencyProjectRoleCostOptionsProjectRoleRevenueOptionsRateDerivationDateRateDerivationDateTypeRateTypeForCostConversionRateTypeForRevenueConversionReportCostResourceClassCostOptionsResourceClassRevenueOptionsRetainManuallyAddedForecastLinesFlagRetainOverrideRatesFromSourceFlagRetainSpreadFromSourceFlagRevenueDateTypeForConversionInPCRevenueDateTypeForConversionInPLCRevenueFixedDateForConversionInPCRevenueFixedDateForConversionInPLCRevenueGenerationMethodRevenueRateTypeForConversionInPCRevenueRateTypeForConversionInPLCUsePlanningRatesFlagUseSameConversionAttributeForAllCurrencyConversionsFlagAmountTypesGET · POST Amount Types · 8 fields · 1 findersAmountTypeIdBillRateFlagBurdenedCostFlagBurdenedCostRateFlagQuantityFlagRawCostFlagRawCostRateFlagRevenueFlagExportOptionsGET · POST · PATCH Export Options · 105 fields · 1 findersActualBurdenedCostAmountsActualBurdenedCostInPCActualBurdenedCostInPLCActualMarginActualMarginInPCActualMarginInPLCActualQuantityActualRawCostAmountsActualRawCostInPCActualRawCostInPLCActualRevenueAmountsActualRevenueInPCActualRevenueInPLCBurdenedCostEffectiveMultiplierBurdenedCostInvoiceCommitmentsBurdenedCostInvoiceCommitmentsInPCBurdenedCostInvoiceCommitmentsInPLCBurdenedCostPOCommitmentsBurdenedCostPOCommitmentsInPCBurdenedCostPOCommitmentsInPLCBurdenedCostPRCommitmentsBurdenedCostPRCommitmentsInPCBurdenedCostPRInCommitmentsPLCBurdenedCostStandardMultiplierBurdenedCostStandardRateDisplayCommitmentsFlagDisplayRatesAndAmountsInMultipleTransactionCurrenciesFlagEACBurdenedCostEACBurdenedCostInPCEACBurdenedCostInPLCEACMarginEACMarginInPCEACMarginInPLCEACMarginPercentageEACQuantityEACRawCostEACRawCostInPCEACRawCostInPLCEACRevenueEACRevenueInPCEACRevenueInPLCETCBurdenedCostETCBurdenedCostInPCETCBurdenedCostInPLCETCMarginETCMarginInPCETCMarginInPLCETCMarginPercentageETCQuantityETCRawCostETCRawCostInPCETCRawCostInPLCETCRevenueETCRevenueInPCETCRevenueInPLCEffectiveBurdenedCostRateEffectiveRawCostRateEffectiveRevenueRateExportOptionIdFromDatePlanningCurrencyPlanningResourceProjectCurrencyConversionCostDateProjectCurrencyConversionCostDateTypeProjectCurrencyConversionCostRateProjectCurrencyConversionCostRateTypeProjectCurrencyConversionRevenueDateProjectCurrencyConversionRevenueDateTypeProjectCurrencyConversionRevenueRateProjectCurrencyConversionRevenueRateTypeProjectLedgerCurrencyConversionCostDateProjectLedgerCurrencyConversionCostDateTypeProjectLedgerCurrencyConversionCostRateProjectLedgerCurrencyConversionCostRateTypeProjectLedgerCurrencyConversionRevenueDateProjectLedgerCurrencyConversionRevenueDateTypeProjectLedgerCurrencyConversionRevenueRateProjectLedgerCurrencyConversionRevenueRateTypeQuantityInvoiceCommitmentsQuantityPOCommitmentsQuantityPRCommitmentsRawCostInvoiceCommitmentsRawCostInvoiceCommitmentsInPCRawCostInvoiceCommitmentsInPLCRawCostPOCommitmentsRawCostPOCommitmentsInPCRawCostPOCommitmentsInPLCRawCostPRCommitmentsRawCostPRCommitmentsInPCRawCostPRCommitmentsInPLCResourceClassSpreadCurveStandardRawCostRateStandardRevenueRateTaskNameTaskNumberToDateTotalBurdenedCostCommitmentsTotalBurdenedCostCommitmentsInPCTotalBurdenedCostCommitmentsInPLCTotalQuantityCommitmentsTotalRawCostCommitmentsTotalRawCostCommitmentsInPCTotalRawCostCommitmentsInPLCUnitOfMeasurePlanningCurrenciesGET · POST · DELETE Planning Currencies · 2 fields · 1 findersPlanningCurrencyCodePlanningCurrencyIdPlanningOptionsDFFGET · POST · PATCH Planning Options Descriptive Flexfields · 3 fieldsPlanningOptionId__FLEX_Context__FLEX_Context_DisplayValuePlanningResourcesGET · POST · PATCH · DELETE Planning Resources · 11 fieldsMaintainManualSpreadOnDateChangesPlanningElementIdPlanningEndDatePlanningStartDateRbsElementIdResourceClassResourceNameTaskIdTaskNameTaskNumberUnitOfMeasurePlanningAmountsGET · POST · PATCH · DELETE Planning Amounts · 80 fieldsActualBurdenedCostActualBurdenedCostInProjectCurrencyActualBurdenedCostInProjectLedgerCurrencyActualBurdenedCostRateActualQuantityActualRawCostActualRawCostInProjectCurrencyActualRawCostInProjectLedgerCurrencyActualRawCostRateActualRevenueActualRevenueInProjectCurrencyActualRevenueInProjectLedgerCurrencyActualRevenueRateCurrencyEACBurdenedCostEACBurdenedCostInProjectCurrencyEACBurdenedCostInProjectLedgerCurrencyEACBurdenedCostRateEACQuantityEACRawCostEACRawCostInProjectCurrencyEACRawCostInProjectLedgerCurrencyEACRawCostRateEACRevenueEACRevenueInProjectCurrencyEACRevenueInProjectLedgerCurrencyEACRevenueRateETCBurdenedCostETCBurdenedCostInProjectCurrencyETCBurdenedCostInProjectLedgerCurrencyETCQuantityETCRawCostETCRawCostInProjectCurrencyETCRawCostInProjectLedgerCurrencyETCRevenueETCRevenueInProjectCurrencyETCRevenueInProjectLedgerCurrencyEffectiveETCBurdenedCostRateEffectiveETCRawCostRateEffectiveETCRevenueRateManualSpreadFlagPlanLineIdPurchaseOrderCommittedBurdenedCostPurchaseOrderCommittedBurdenedCostInProjectCurrencyPurchaseOrderCommittedBurdenedCostInProjectLedgerCurrencyPurchaseOrderCommittedQuantityPurchaseOrderCommittedRawCostPurchaseOrderCommittedRawCostInProjectCurrencyPurchaseOrderCommittedRawCostInProjectLedgerCurrencyRequisitionCommittedBurdenedCostRequisitionCommittedBurdenedCostInProjectCurrencyRequisitionCommittedBurdenedCostInProjectLedgerCurrencyRequisitionCommittedQuantityRequisitionCommittedRawCostRequisitionCommittedRawCostInProjectCurrencyRequisitionCommittedRawCostInProjectLedgerCurrencyStandardETCBurdenedCostRateStandardETCRawCostRateStandardETCRevenueRateSupplierInvoiceCommittedBurdenedCostSupplierInvoiceCommittedBurdenedCostinProjectCurrencySupplierInvoiceCommittedBurdenedCostinProjectLedgerCurrencySupplierInvoiceCommittedQuantitySupplierInvoiceCommittedRawCostSupplierInvoiceCommittedRawCostinProjectCurrencySupplierInvoiceCommittedRawCostinProjectLedgerCurrencyTotalCommittedBurdenedCostTotalCommittedBurdenedCostInProjectCurrencyTotalCommittedBurdenedCostInProjectLedgerCurrencyTotalCommittedQuantityTotalCommittedRawCostTotalCommittedRawCostInProjectCurrencyTotalCommittedRawCostInProjectLedgerCurrencyTransferOrderCommittedBurdenedCostTransferOrderCommittedBurdenedCostInProjectCurrencyTransferOrderCommittedBurdenedCostInProjectLedgerCurrencyTransferOrderCommittedQuantityTransferOrderCommittedRawCostTransferOrderCommittedRawCostInProjectCurrencyTransferOrderCommittedRawCostInProjectLedgerCurrencyPlanLinesDFFGET · POST · PATCH Plan Lines Descriptive Flexfields · 3 fieldsPlanLineId__FLEX_Context__FLEX_Context_DisplayValuePlanningAmountDetailsGET · POST · PATCH · DELETE Planning Amount Details · 80 fieldsActualBurdenedCostActualBurdenedCostInProjectCurrencyActualBurdenedCostInProjectLedgerCurrencyActualBurdenedCostRateActualQuantityActualRawCostActualRawCostInProjectCurrencyActualRawCostInProjectLedgerCurrencyActualRawCostRateActualRevenueActualRevenueInProjectCurrencyActualRevenueInProjectLedgerCurrencyActualRevenueRateEACBurdenedCostEACBurdenedCostInProjectCurrencyEACBurdenedCostInProjectLedgerCurrencyEACBurdenedCostRateEACQuantityEACRawCostEACRawCostInProjectCurrencyEACRawCostInProjectLedgerCurrencyEACRawCostRateEACRevenueEACRevenueInProjectCurrencyEACRevenueInProjectLedgerCurrencyEACRevenueRateETCBurdenedCostETCBurdenedCostInProjectCurrencyETCBurdenedCostInProjectLedgerCurrencyETCQuantityETCRawCostETCRawCostInProjectCurrencyETCRawCostInProjectLedgerCurrencyETCRevenueETCRevenueInProjectCurrencyETCRevenueInProjectLedgerCurrencyEffectiveETCBurdenedCostRateEffectiveETCRawCostRateEffectiveETCRevenueRateManualSpreadFlagPeriodNamePlanLineDetailIdPurchaseOrderCommittedBurdenedCostPurchaseOrderCommittedBurdenedCostInProjectCurrencyPurchaseOrderCommittedBurdenedCostInProjectLedgerCurrencyPurchaseOrderCommittedQuantityPurchaseOrderCommittedRawCostPurchaseOrderCommittedRawCostInProjectCurrencyPurchaseOrderCommittedRawCostInProjectLedgerCurrencyRequisitionCommittedBurdenedCostRequisitionCommittedBurdenedCostInProjectCurrencyRequisitionCommittedBurdenedCostInProjectLedgerCurrencyRequisitionCommittedQuantityRequisitionCommittedRawCostRequisitionCommittedRawCostInProjectCurrencyRequisitionCommittedRawCostInProjectLedgerCurrencyStandardETCBurdenedCostRateStandardETCRawCostRateStandardETCRevenueRateSupplierInvoiceCommittedBurdenedCostSupplierInvoiceCommittedBurdenedCostInProjectCurrencySupplierInvoiceCommittedBurdenedCostInProjectLedgerCurrencySupplierInvoiceCommittedQuantitySupplierInvoiceCommittedRawCostSupplierInvoiceCommittedRawCostInProjectCurrencySupplierInvoiceCommittedRawCostInProjectLedgerCurrencyTotalCommittedBurdenedCostTotalCommittedBurdenedCostInProjectCurrencyTotalCommittedBurdenedCostInProjectLedgerCurrencyTotalCommittedQuantityTotalCommittedRawCostTotalCommittedRawCostInProjectCurrencyTotalCommittedRawCostInProjectLedgerCurrencyTransferOrderCommittedBurdenedCostTransferOrderCommittedBurdenedCostInProjectCurrencyTransferOrderCommittedBurdenedCostInProjectLedgerCurrencyTransferOrderCommittedQuantityTransferOrderCommittedRawCostTransferOrderCommittedRawCostInProjectCurrencyTransferOrderCommittedRawCostInProjectLedgerCurrencyVersionErrorsGET Errors · 12 fieldsErrorTypeMessageCauseMessageNameMessageTextMessageUserActionMessageUserDetailsPeriodNamePlanVersionIdResourceNameTaskNameTaskNumberTransactionCurrencyCode
Actions 9
POST …/action/adjustForRangeOfProjects·fromProjectNumberfinancialPlanTypeadjustmentPercentageadjustmentTypetoProjectNumberplanVersionStatusPOST …/action/refreshRatesForRangeOfProjects·fromProjectNumberfinancialPlanTyperetainRateOverridetoProjectNumberplanVersionStatusrefreshOnlyConversionRatesrefreshRatesPeriodForwardPOST …/action/reprocessFailedProjectForecastsPOST …/{PlanVersionId}/action/adjust·adjustmentPercentagefromPeriodadjustmentTypetoPeriodcreateNewWorkingVersionPOST …/{PlanVersionId}/action/refreshActualAmounts·refreshActualAmountsFromrefreshActualAmountsToPOST …/{PlanVersionId}/action/refreshRates·retainRateOverriderefreshOnlyConversionRatesrefreshRatesPeriodForwardPOST …/{PlanVersionId}/child/PlanningResources/{PlanningElementId}/child/PlanningAmounts/{PlanLineId}/action/adjust·adjustmentPercentageadjustmentTypePOST …/{PlanVersionId}/child/PlanningResources/{PlanningElementId}/child/PlanningAmounts/{PlanLineId}/action/refreshRates·retainRateOverriderefreshOnlyConversionRatesrefreshRatesPeriodForwardPOST …/{PlanVersionId}/child/PlanningResources/{PlanningElementId}/child/PlanningAmounts/{PlanLineId}/child/PlanningAmountDetails/{PlanLineDetailId}/action/adjust·adjustmentPercentageadjustmentType
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/projectForecastsand ask only for the fields the agent needs withfields=. Big responses cost tokens and slow the agent. - Prefer a finder such as
CurrentApprovedProjectForecastFinderfor 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:AdjustmentPercentage, notadjustmentpercentage. - 29 fields are read-only: sending them in POST or PATCH fails or is ignored. The builder leaves them out.
- Send dates as
YYYY-MM-DD; date-time fields take ISO 8601 with a time zone. - A list returns 25 rows unless you set
limit; readhasMoreand moveoffsetto page through. - Text fields have maximum lengths (shown in the field table). Longer values are rejected.