Create Requisitions with Description-Based Lines

You may want to order expense items or services by providing an item description. You may want to indicate whether prices have been negotiated for these lines or a negotiation is required with a supplier. You can use the Purchase Requisitions resource to create requisitions for description-based lines.

Let's discuss these scenarios briefly.
  • Create a requisition with description-based goods lines.

  • Create a requisition with description-based fixed price services lines.

Create a Requisition with Description-Based Goods Lines

Let's consider that you want to request 5 high-fidelity LCD monitors of 24 inches manufactured by Cordel Electronics. The supplier to fulfill the order has been identified as CV_SuppA05, an existing supplier in the application. The price of each monitor has been negotiated with the supplier to US$ 649.

To create a requisition for the LCD monitors:

  1. Identify the supplier name and the purchasing site name associated with the requisitioning BU.
  2. Identify the category of this expense.
  3. Perform a POST operation on this URL, providing the following details in the request body.
"LineTypeCode" : "Goods",
"ItemDescription": "23 Inch High Definition LCD Monitors",
"CategoryName":"Monitors",
"Price":"649",
"Currency":"US Dollar", 
"Quantity":5,
"UOM":"Each",
"Supplier":"CV_SuppA05", 
"SupplierSite":"CVSuppA05Site01",
"NegotiatedByPreparerFlag": true,
"ManufacturerName":"Cordel Electronics",

Example URL

Use this resource URL format:
/fscmRestApi/resources/version/purchaseRequisitions

cURL Command

POST

curl -u username:password -X POST -H "Content-Type:application/vnd.vision.adf.resourceitem+json" -d 'request payload' 
"https://servername/fscmRestApi/resources/version/purchaseRequisitions"

Example Request

Here's an example of the request body in JSON format:

{
  "RequisitioningBU": "Vision Operations",
  "PreparerEmail" : "jnj@oracle.com",
  "ExternallyManagedFlag": false,
  "Description" : "Requisition for 5 LCD Monitors",
  "lines":[
  {
  "LineNumber" : 1,
  "LineTypeCode" : "Goods",
  "ItemDescription": "23 Inch High Definition LCD Monitors",
  "CategoryName":"Monitors",
  "Price":"649",
  "Currency":"US Dollar", 
  "Quantity":5,
  "UOM":"Each",
  "Supplier":"CV_SuppA05", 
  "SupplierSite":"CVSuppA05Site01",
  "ManufacturerName":"Cordel Electronics",
  "DestinationTypeCode" : "EXPENSE",
  "DestinationOrganizationId" : 204,
  "DeliverToLocationCode" : "V1- New York City",
  "RequesterEmail" : "jnj@oracle.com",
  "RequestedDeliveryDate":"2021-08-31",

    "distributions": [
                {
                    "Quantity":5,
                    "DistributionNumber": 1
                }
            ]
 }
 ]
 }

Example Response

Here's an example of the response body in JSON format:

{
    "RequisitionHeaderId": 300100546219759,
    "Requisition": "10505802",
    "RequisitioningBUId": 204,
    "RequisitioningBU": "Vision Operations",
    "PreparerId": 300100542558856,
    "Preparer": "Jill Jack",
    "PreparerEmail": "jnj@oracle.com",
    "Description": "Requistion for 5 LCD Monitors",
    "Justification": null,
    "DocumentStatus": "Incomplete",
    "DocumentStatusCode": "INCOMPLETE",
    "SubmissionDate": null,
    "ApprovedDate": null,
    "FunctionalCurrencyCode": null,
    "SoldToLegalEntityId": null,
    "SoldToLegalEntity": null,
    "FundsStatus": null,
    "FundsStatusCode": null,
    "InterfaceSourceCode": null,
    "InterfaceSourceLineId": null,
    "EmergencyPONumber": null,
    "ModifyingApproverId": null,
    "ModifyingApprover": null,
    "ModifyingApproverEmail": null,
    "OverridingApproverId": null,
    "OverridingApprover": null,
    "OverridingApproverEmail": null,
    "FundsOverrideApproverId": null,
    "FundsOverrideApprover": null,
    "FundsOverrideApproverEmail": null,
    "ApprovedById": null,
    "ApprovedByEmail": null,
    "BudgetaryControlEnabledFlag": null,
    "EmergencyRequisitionFlag": null,
    "ExternallyManagedFlag": false,
    "InternalTransferFlag": false,
    "FundsChkFailWarnFlag": false,
    "CreationDate": "2021-08-18T07:36:56+00:00",
    "LastUpdateDate": "2021-08-18T07:36:56.610+00:00",
    "CreatedBy": "jnj@oracle.com",
    "LastUpdatedBy": "jnj@oracle.com",
    "ActiveRequisitionFlag": false,
    "SourceApplicationCode": null,
    "RejectedById": null,
    "RejectedByDisplayName": null,
    "RejectedReason": null,
    "lines": [
        {
            "RequisitionHeaderId": 300100546219759,
            "RequisitionLineId": 300100546219760,
            "LineNumber": 1,
            "SmartFormId": null,
            "SmartFormName": null,
            "LineTypeId": 1,
            "LineTypeCode": "Goods",
            "RequisitionLineSource": "REST_INTEGRATION",
            "CategoryId": 2917,
            "CategoryName": "Monitors",
            "ItemDescription": "23 Inch High Definition LCD Monitors",
            "ItemId": null,
            "Item": null,
            "ItemRevision": null,
            "Quantity": 5,
            "SecondaryQuantity": null,
            "UnitPrice": 649,
            "CurrencyCode": "USD",
            "Currency": "US Dollar",
            "UOMCode": "Ea",
            "UOM": "Each",
            "SecondaryUOMCode": null,
            "SecondaryUOM": null,
            "ConversionRateType": null,
            "ConversionRateDate": null,
            "ConversionRate": null,
            "Price": 649,
            "LineStatus": "INCOMPLETE",
            "LineStatusDisplayValue": null,
            "Amount": null,
            "CurrencyAmount": null,
            "UrgentFlag": null,
            "NegotiatedByPreparerFlag": true,
            "NegotiationRequiredFlag": null,
            "SourceAgreementTypeCode": null,
            "SourceAgreementType": null,
            "SourceAgreementHeaderId": null,
            "SourceAgreement": null,
            "SourceAgreementLineId": null,
            "SourceAgreementLineNumber": null,
            "UNNumberId": null,
            "UNNumber": null,
            "HazardClassId": null,
            "HazardClass": null,
            "HazardClassCode": null,
            "UNSPSCCode": null,
            "ManufacturerName": "Cordel Electronics",
            "ManufacturerPartNumber": null,
            "BPAPriceUserOverrideFlag": null,
            "NewSupplierFlag": null,
            "SupplierId": 1717,
            "Supplier": "CV_SuppA05",
            "SupplierSiteId": 4060,
            "SupplierSite": "CVSuppA05Site01",
            "SupplierContactId": null,
            "SupplierContact": null,
            "SupplierContactEmail": null,
            "SupplierContactPhone": null,
            "SupplierContactFax": null,
            "SuggestedSupplier": null,
            "SuggestedSupplierSite": null,
            "SuggestedSupplierContact": null,
            "SuggestedSupplierContactPhone": null,
            "SuggestedSupplierContactFax": null,
            "SuggestedSupplierContactEmail": null,
            "SupplierItemNumber": null,
            "RequesterId": 300100542558856,
            "Requester": "Jack, Jill",
            "RequesterEmail": "jnj@oracle.com",
            "SuggestedBuyerId": null,
            "SuggestedBuyer": null,
            "SuggestedBuyerEmail": null,
            "ModifiedByBuyerId": null,
            "ModifiedByBuyer": null,
            "AssignedBuyerId": null,
            "AssignedBuyer": null,
            "AssignedBuyerDisplayName": null,
            "AssignedBuyerEmail": null,
            "RequestedDeliveryDate": "2021-08-31",
            "DestinationTypeCode": "EXPENSE",
            "DestinationType": "Expense",
            "DestinationOrganizationId": 204,
            "DestinationOrganizationCode": "V1",
            "DestinationOrganization": "Vision Operations",
            "DestinationSubinventory": null,
            "OneTimeLocationFlag": false,
            "DeliverToLocationId": 204,
            "DeliverToLocationCode": "V1- New York City",
            "DeliverToAddress": "90 Fifth Avenue, New York,NY 10022-3422, New York, United States",
            "FormattedDeliverToAddress": "90 Fifth Avenue<BR>New York,NY 10022-3422<BR>New York<BR>United States",
            "NoteToBuyer": null,
            "NoteToReceiver": null,
            "NoteToSupplier": null,
            "POAutomationFailedReasonCode": null,
            "POAutomationFailedReason": null,
            "POHeaderId": null,
            "POLineId": null,
            "PurchaseOrder": null,
            "POBuyerId": null,
            "BuyerOnPurchaseOrder": null,
            "SupplierOnPurchaseOrder": null,
            "ProcurementBUId": null,
            "ProcurementBU": null,
            "SourceTypeCode": "EXTERNAL",
            "SourceType": null,
            "SourceOrganizationId": null,
            "SourceOrganization": null,
            "SourceSubinventory": null,
            "TransferOrderHeaderId": null,
            "TransferOrder": null,
            "TransferOrderLineId": null,
            "NegotiationHeaderId": null,
            "Negotiation": null,
            "NegotiationLineNumber": null,
            "ResponseNumber": null,
            "ResponseLineNumber": null,
            "OnNegotiationFlag": null,
            "WorkOrderId": null,
            "WorkOrder": null,
            "WorkOrderOperationId": null,
            "WorkOrderOperationSequence": null,
            "WorkOrderProduct": null,
            "WorkOrderSubType": null,
            "BackToBackFlag": null,
            "ConfiguredItemFlag": false,
            "DeliverToCustomerId": null,
            "DeliverToCustomer": null,
            "DeliverToCustomerLocationId": null,
            "RequestedShipDate": null,
            "SalesOrderLineNumber": null,
            "SalesOrder": null,
            "SalesOrderScheduleNumber": null,
            "ShipToCustomerId": null,
            "ShipToCustomer": null,
            "ServiceLevelCode": null,
            "ServiceLevel": null,
            "ModeOfTransportCode": null,
            "ModeOfTransport": null,
            "CarrierId": null,
            "Carrier": null,
            "CreatedBy": "jnj@oracle.com",
            "CreationDate": "2021-08-18T07:36:56.131+00:00",
            "LastUpdatedBy": "jnj@oracle.com",
            "LastUpdateDate": "2021-08-18T07:36:56.614+00:00",
            "LastSubmittedDate": null,
            "LastApprovalDate": null,
            "OriginalSubmittedDate": null,
            "OriginalApprovalDate": null,
            "CancelDate": null,
            "CancelReason": null,
            "RequisitionLineGroup": "LINES_REQUIRING_ATTENTION",
            "LineImageURL": null,
            "SupplierItemAuxiliaryId": null,
            "DisableAutosourceFlag": false,
            "DeliverToOneTimeAddress": null,
            "LineTypeOrderTypeLookupCode": "QUANTITY",
            "ReturnedByBuyerId": null,
            "ReturnedByBuyerDisplayName": null,
            "ReturnReason": null,
            "distributions": [
                {
                    "RequisitionDistributionId": 300100546219761,
                    "RequisitionLineId": 300100546219760,
                    "Quantity": 5,
                    "DistributionNumber": 1,
                    "ChargeAccountId": null,
                    "ChargeAccount": null,
                    "CurrencyAmount": null,
                    "CurrencyNonrecoverableExclusiveTax": null,
                    "CurrencyRecoverableExclusiveTax": null,
                    "ChartOfAccountId": 101,
                    "UserAccountOverrideFlag": false,
                    "links": [
                        {
                            "rel": "self",
                            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/child/distributions/300100546219761",
                            "name": "distributions",
                            "kind": "item",
                            "properties": {
                                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                            }
                        },
                        {
                            "rel": "canonical",
                            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/child/distributions/300100546219761",
                            "name": "distributions",
                            "kind": "item"
                        },
                        {
                            "rel": "parent",
                            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760",
                            "name": "lines",
                            "kind": "item"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/child/distributions/300100546219761/child/DFF",
                            "name": "DFF",
                            "kind": "collection"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/child/distributions/300100546219761/child/projectDFF",
                            "name": "projectDFF",
                            "kind": "collection"
                        }
                    ]
                }
            ],
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760",
                    "name": "lines",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760",
                    "name": "lines",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759",
                    "name": "purchaseRequisitions",
                    "kind": "item"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/DestinationTypeVO",
                    "name": "DestinationTypeVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/PurchasingLineTypePVO",
                    "name": "PurchasingLineTypePVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/SmartFormVVO",
                    "name": "SmartFormVVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/SourceAgreementHeaderIdVO",
                    "name": "SourceAgreementHeaderIdVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/SupplierSiteLOVCompleteSupplierSitePVO",
                    "name": "SupplierSiteLOVCompleteSupplierSitePVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/CurrencyPVO",
                    "name": "CurrencyPVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/SupplierContactLOVCompleteSupplierContactPVO",
                    "name": "SupplierContactLOVCompleteSupplierContactPVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/PersonEmailVVO",
                    "name": "PersonEmailVVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/OrgOrganizationDefinitionsPVO",
                    "name": "OrgOrganizationDefinitionsPVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/UnitOfMeasureConversionPVO",
                    "name": "UnitOfMeasureConversionPVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/SupplierLOVCompleteSupplierPVO",
                    "name": "SupplierLOVCompleteSupplierPVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/LocationLovPVO",
                    "name": "LocationLovPVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/SourceAgreementsVO",
                    "name": "SourceAgreementsVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/SourceAgreementLinesVO",
                    "name": "SourceAgreementLinesVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/ItemVVO",
                    "name": "ItemVVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/lov/PurchasingCategoryVO",
                    "name": "PurchasingCategoryVO",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/child/DFF",
                    "name": "DFF",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/child/attachments",
                    "name": "attachments",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/child/distributions",
                    "name": "distributions",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/child/informationTemplates",
                    "name": "informationTemplates",
                    "kind": "collection"
                },
                {
                    "rel": "action",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/action/calculateTax",
                    "name": "calculateTax",
                    "kind": "other"
                },
                {
                    "rel": "action",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/action/deriveChargeAccount",
                    "name": "deriveChargeAccount",
                    "kind": "other"
                },
                {
                    "rel": "action",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines/300100546219760/action/cancel",
                    "name": "cancel",
                    "kind": "other"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759",
            "name": "purchaseRequisitions",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759",
            "name": "purchaseRequisitions",
            "kind": "item"
        },
        {
            "rel": "lov",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/lov/ApprovedByEmailPersonLovPVO",
            "name": "ApprovedByEmailPersonLovPVO",
            "kind": "collection"
        },
        {
            "rel": "lov",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/lov/PreparerEmailPersonLovPVO",
            "name": "PreparerEmailPersonLovPVO",
            "kind": "collection"
        },
        {
            "rel": "lov",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/lov/ReqBUNameRequisitionBusinessUnitVVO",
            "name": "ReqBUNameRequisitionBusinessUnitVVO",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/DFF",
            "name": "DFF",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/attachments",
            "name": "attachments",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/lines",
            "name": "lines",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/child/summaryAttributes",
            "name": "summaryAttributes",
            "kind": "collection"
        },
        {
            "rel": "action",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/action/submitRequisition",
            "name": "submitRequisition",
            "kind": "other"
        },
        {
            "rel": "action",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/action/calculateTaxAndAccounting",
            "name": "calculateTaxAndAccounting",
            "kind": "other"
        },
        {
            "rel": "action",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/action/createDefaultDistributions",
            "name": "createDefaultDistributions",
            "kind": "other"
        },
        {
            "rel": "action",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/action/cancel",
            "name": "cancel",
            "kind": "other"
        },
        {
            "rel": "action",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/action/updateAllLines",
            "name": "updateAllLines",
            "kind": "other"
        },
        {
            "rel": "action",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546219759/action/processPunchoutShoppingCart",
            "name": "processPunchoutShoppingCart",
            "kind": "other"
        }
    ]
}

Create a Requisition with a Description-Based Fixed Price Services Lines

Let's consider that your organization requires training services for new hires. A new service provider has been identified as Star Training & Consulting Ltd. The training cost needs to be negotiated with the service provider, which is not configured as a supplier in the application and, therefore, is a new supplier. To create a requisition for service lines:

  1. Identify the category of purchases.

  2. Optionally identify the Supplier Name, Supplier Address, and Supplier Contact.
  3. Perform a POST operation on this URL, providing the following details in the request body:
"LineTypeCode" : "Fixed Price Services",
  "ItemDescription": "IT Training services for new hires - FY21 Q4 ",
  "CategoryName":"Service",
      "NewSupplierFlag":true,
      "SuggestedSupplier":"Star Training & Consulting Ltd.", 
      "NegotiationRequiredFlag": true, 

Example URL

Use this resource URL format:
/fscmRestApi/resources/version/purchaseRequisitions

cURL Command

POST

/fscmRestApi/resources/11.13.18.05/purchaseRequisitions

cURL Command

curl -u username:password -X POST -H "Content-Type:application/vnd.vision.adf.resourceitem+json" -d 'request payload' 
"https://servername/fscmRestApi/resources/version/purchaseRequisitions"

Example Request

Here's an example of the request body in JSON format:

{
  "RequisitioningBU": "Vision Operations",
  "PreparerEmail" : "jnj@oracle.com",
  "ExternallyManagedFlag": false,
  "Description" : "New Hire Training",
  "lines":[
  {
  "LineNumber" : 1,
  "LineTypeCode" : "Fixed Price Services",
  "ItemDescription": "IT Training services for new hires - FY21 Q4 ",
  "CategoryName":"Service",
  "CurrencyAmount":"1200",
  "Currency":"US Dollar", 
  "NewSupplierFlag":true,
  "SuggestedSupplier":"Star Training & Consulting Ltd.", 
  "SuggestedSupplierSite":"2305 Lemon Street, Sunnyvale, CA 94102",
  "SuggestedSupplierContact":"Jeremy Andrews",
  "SuggestedSupplierContactEmail":"Jeremy.Andrew@star.com",
  "NegotiationRequiredFlag": true,
  "DestinationTypeCode" : "EXPENSE",
  "DestinationOrganizationId" : 204,
  "DeliverToLocationCode" : "V1- New York City",
  "RequesterEmail" : "jnj@oracle.com",
  "RequestedDeliveryDate":"2021-08-31",
    "distributions": [
                {
                    "CurrencyAmount":1200,
                    "DistributionNumber": 1
                }
            ]
 }
 ]
 }

Example Response

Here's an example of the response body in JSON format.

{
    "RequisitionHeaderId": 300100546287832,
    "Requisition": "10505815",
    "RequisitioningBUId": 204,
    "RequisitioningBU": "Vision Operations",
    "PreparerId": 300100542558856,
    "Preparer": "Jill Jack",
    "PreparerEmail": "jnj@oracle.com",
    "Description": "New Hire Training",
    "Justification": null,
    "DocumentStatus": "Incomplete",
    "DocumentStatusCode": "INCOMPLETE",
    "SubmissionDate": null,
    "ApprovedDate": null,
    "FunctionalCurrencyCode": null,
    "SoldToLegalEntityId": null,
    "SoldToLegalEntity": null,
    "FundsStatus": null,
    "FundsStatusCode": null,
    "InterfaceSourceCode": null,
    "InterfaceSourceLineId": null,
    "EmergencyPONumber": null,
    "ModifyingApproverId": null,
    "ModifyingApprover": null,
    "ModifyingApproverEmail": null,
    "OverridingApproverId": null,
    "OverridingApprover": null,
    "OverridingApproverEmail": null,
    "FundsOverrideApproverId": null,
    "FundsOverrideApprover": null,
    "FundsOverrideApproverEmail": null,
    "ApprovedById": null,
    "ApprovedByEmail": null,
    "BudgetaryControlEnabledFlag": null,
    "EmergencyRequisitionFlag": null,
    "ExternallyManagedFlag": false,
    "InternalTransferFlag": false,
    "FundsChkFailWarnFlag": false,
    "CreationDate": "2021-08-18T09:58:10+00:00",
    "LastUpdateDate": "2021-08-18T09:58:10.954+00:00",
    "CreatedBy": "jnj@oracle.com",
    "LastUpdatedBy": "jnj@oracle.com",
    "ActiveRequisitionFlag": false,
    "SourceApplicationCode": null,
    "RejectedById": null,
    "RejectedByDisplayName": null,
    "RejectedReason": null,
    "lines": [
        {
            "RequisitionHeaderId": 300100546287832,
            "RequisitionLineId": 300100546287833,
            "LineNumber": 1,
            "SmartFormId": null,
            "SmartFormName": null,
            "LineTypeId": 6,
            "LineTypeCode": "Fixed Price Services",
            "RequisitionLineSource": "REST_INTEGRATION",
            "CategoryId": 3595,
            "CategoryName": "Service",
            "ItemDescription": "IT Training services for new hires - FY21 Q4 ",
            "ItemId": null,
            "Item": null,
            "ItemRevision": null,
            "Quantity": null,
            "SecondaryQuantity": null,
            "UnitPrice": null,
            "CurrencyCode": "USD",
            "Currency": "US Dollar",
            "UOMCode": null,
            "UOM": null,
            "SecondaryUOMCode": null,
            "SecondaryUOM": null,
            "ConversionRateType": null,
            "ConversionRateDate": null,
            "ConversionRate": null,
            "Price": null,
            "LineStatus": "INCOMPLETE",
            "LineStatusDisplayValue": null,
            "Amount": 1200,
            "CurrencyAmount": 1200,
            "UrgentFlag": null,
            "NegotiatedByPreparerFlag": null,
            "NegotiationRequiredFlag": true,
            "SourceAgreementTypeCode": null,
            "SourceAgreementType": null,
            "SourceAgreementHeaderId": null,
            "SourceAgreement": null,
            "SourceAgreementLineId": null,
            "SourceAgreementLineNumber": null,
            "UNNumberId": null,
            "UNNumber": null,
            "HazardClassId": null,
            "HazardClass": null,
            "HazardClassCode": null,
            "UNSPSCCode": null,
            "ManufacturerName": null,
            "ManufacturerPartNumber": null,
            "BPAPriceUserOverrideFlag": null,
            "NewSupplierFlag": true,
            "SupplierId": null,
            "Supplier": null,
            "SupplierSiteId": null,
            "SupplierSite": null,
            "SupplierContactId": null,
            "SupplierContact": null,
            "SupplierContactEmail": null,
            "SupplierContactPhone": null,
            "SupplierContactFax": null,
            "SuggestedSupplier": "Star Training & Consulting Ltd.",
            "SuggestedSupplierSite": "2305 Lemon Street, Sunnyvale, CA 94102",
            "SuggestedSupplierContact": "Jeremy Andrews",
            "SuggestedSupplierContactPhone": null,
            "SuggestedSupplierContactFax": null,
            "SuggestedSupplierContactEmail": "Jeremy.Andrew@star.com",
            "SupplierItemNumber": null,
            "RequesterId": 300100542558856,
            "Requester": "Jack, Jill",
            "RequesterEmail": "jnj@oracle.com",
            "SuggestedBuyerId": null,
            "SuggestedBuyer": null,
            "SuggestedBuyerEmail": null,
            "ModifiedByBuyerId": null,
            "ModifiedByBuyer": null,
            "AssignedBuyerId": null,
            "AssignedBuyer": null,
            "AssignedBuyerDisplayName": null,
            "AssignedBuyerEmail": null,
            "RequestedDeliveryDate": "2021-08-31",
            "DestinationTypeCode": "EXPENSE",
            "DestinationType": "Expense",
            "DestinationOrganizationId": 204,
            "DestinationOrganizationCode": "V1",
            "DestinationOrganization": "Vision Operations",
            "DestinationSubinventory": null,
            "OneTimeLocationFlag": false,
            "DeliverToLocationId": 204,
            "DeliverToLocationCode": "V1- New York City",
            "DeliverToAddress": "90 Fifth Avenue, New York,NY 10022-3422, New York, United States",
            "FormattedDeliverToAddress": "90 Fifth Avenue<BR>New York,NY 10022-3422<BR>New York<BR>United States",
            "NoteToBuyer": null,
            "NoteToReceiver": null,
            "NoteToSupplier": null,
            "POAutomationFailedReasonCode": null,
            "POAutomationFailedReason": null,
            "POHeaderId": null,
            "POLineId": null,
            "PurchaseOrder": null,
            "POBuyerId": null,
            "BuyerOnPurchaseOrder": null,
            "SupplierOnPurchaseOrder": null,
            "ProcurementBUId": null,
            "ProcurementBU": null,
            "SourceTypeCode": "EXTERNAL",
            "SourceType": null,
            "SourceOrganizationId": null,
            "SourceOrganization": null,
            "SourceSubinventory": null,
            "TransferOrderHeaderId": null,
            "TransferOrder": null,
            "TransferOrderLineId": null,
            "NegotiationHeaderId": null,
            "Negotiation": null,
            "NegotiationLineNumber": null,
            "ResponseNumber": null,
            "ResponseLineNumber": null,
            "OnNegotiationFlag": null,
            "WorkOrderId": null,
            "WorkOrder": null,
            "WorkOrderOperationId": null,
            "WorkOrderOperationSequence": null,
            "WorkOrderProduct": null,
            "WorkOrderSubType": null,
            "BackToBackFlag": null,
            "ConfiguredItemFlag": false,
            "DeliverToCustomerId": null,
            "DeliverToCustomer": null,
            "DeliverToCustomerLocationId": null,
            "RequestedShipDate": null,
            "SalesOrderLineNumber": null,
            "SalesOrder": null,
            "SalesOrderScheduleNumber": null,
            "ShipToCustomerId": null,
            "ShipToCustomer": null,
            "ServiceLevelCode": null,
            "ServiceLevel": null,
            "ModeOfTransportCode": null,
            "ModeOfTransport": null,
            "CarrierId": null,
            "Carrier": null,
            "CreatedBy": "jnj@oracle.com",
            "CreationDate": "2021-08-18T09:58:10.156+00:00",
            "LastUpdatedBy": "jnj@oracle.com",
            "LastUpdateDate": "2021-08-18T09:58:10.963+00:00",
            "LastSubmittedDate": null,
            "LastApprovalDate": null,
            "OriginalSubmittedDate": null,
            "OriginalApprovalDate": null,
            "CancelDate": null,
            "CancelReason": null,
            "RequisitionLineGroup": "LINES_REQUIRING_ATTENTION",
            "LineImageURL": null,
            "SupplierItemAuxiliaryId": null,
            "DisableAutosourceFlag": false,
            "DeliverToOneTimeAddress": null,
            "LineTypeOrderTypeLookupCode": "FIXED PRICE",
            "ReturnedByBuyerId": null,
            "ReturnedByBuyerDisplayName": null,
            "ReturnReason": null,
            "distributions": [
                {
                    "RequisitionDistributionId": 300100546287834,
                    "RequisitionLineId": 300100546287833,
                    "Quantity": null,
                    "DistributionNumber": 1,
                    "ChargeAccountId": null,
                    "ChargeAccount": null,
                    "CurrencyAmount": 1200,
                    "CurrencyNonrecoverableExclusiveTax": null,
                    "CurrencyRecoverableExclusiveTax": null,
                    "ChartOfAccountId": 101,
                    "UserAccountOverrideFlag": false,
                    "links": [
                        {
                            "rel": "self",
                            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/child/distributions/300100546287834",
                            "name": "distributions",
                            "kind": "item",
                            "properties": {
                                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                            }
                        },
                        {
                            "rel": "canonical",
                            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/child/distributions/300100546287834",
                            "name": "distributions",
                            "kind": "item"
                        },
                        {
                            "rel": "parent",
                            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833",
                            "name": "lines",
                            "kind": "item"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/child/distributions/300100546287834/child/DFF",
                            "name": "DFF",
                            "kind": "collection"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/child/distributions/300100546287834/child/projectDFF",
                            "name": "projectDFF",
                            "kind": "collection"
                        }
                    ]
                }
            ],
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833",
                    "name": "lines",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833",
                    "name": "lines",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832",
                    "name": "purchaseRequisitions",
                    "kind": "item"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/DestinationTypeVO",
                    "name": "DestinationTypeVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/PurchasingLineTypePVO",
                    "name": "PurchasingLineTypePVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/SmartFormVVO",
                    "name": "SmartFormVVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/SourceAgreementHeaderIdVO",
                    "name": "SourceAgreementHeaderIdVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/SupplierSiteLOVCompleteSupplierSitePVO",
                    "name": "SupplierSiteLOVCompleteSupplierSitePVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/CurrencyPVO",
                    "name": "CurrencyPVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/SupplierContactLOVCompleteSupplierContactPVO",
                    "name": "SupplierContactLOVCompleteSupplierContactPVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/PersonEmailVVO",
                    "name": "PersonEmailVVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/OrgOrganizationDefinitionsPVO",
                    "name": "OrgOrganizationDefinitionsPVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/UnitOfMeasureConversionPVO",
                    "name": "UnitOfMeasureConversionPVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/SupplierLOVCompleteSupplierPVO",
                    "name": "SupplierLOVCompleteSupplierPVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/LocationLovPVO",
                    "name": "LocationLovPVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/SourceAgreementsVO",
                    "name": "SourceAgreementsVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/SourceAgreementLinesVO",
                    "name": "SourceAgreementLinesVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/ItemVVO",
                    "name": "ItemVVO",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/lov/PurchasingCategoryVO",
                    "name": "PurchasingCategoryVO",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/child/DFF",
                    "name": "DFF",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/child/attachments",
                    "name": "attachments",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/child/distributions",
                    "name": "distributions",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/child/informationTemplates",
                    "name": "informationTemplates",
                    "kind": "collection"
                },
                {
                    "rel": "action",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/action/calculateTax",
                    "name": "calculateTax",
                    "kind": "other"
                },
                {
                    "rel": "action",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/action/deriveChargeAccount",
                    "name": "deriveChargeAccount",
                    "kind": "other"
                },
                {
                    "rel": "action",
                    "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines/300100546287833/action/cancel",
                    "name": "cancel",
                    "kind": "other"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832",
            "name": "purchaseRequisitions",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832",
            "name": "purchaseRequisitions",
            "kind": "item"
        },
        {
            "rel": "lov",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/lov/ApprovedByEmailPersonLovPVO",
            "name": "ApprovedByEmailPersonLovPVO",
            "kind": "collection"
        },
        {
            "rel": "lov",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/lov/PreparerEmailPersonLovPVO",
            "name": "PreparerEmailPersonLovPVO",
            "kind": "collection"
        },
        {
            "rel": "lov",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/lov/ReqBUNameRequisitionBusinessUnitVVO",
            "name": "ReqBUNameRequisitionBusinessUnitVVO",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/DFF",
            "name": "DFF",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/attachments",
            "name": "attachments",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/lines",
            "name": "lines",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/child/summaryAttributes",
            "name": "summaryAttributes",
            "kind": "collection"
        },
        {
            "rel": "action",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/action/submitRequisition",
            "name": "submitRequisition",
            "kind": "other"
        },
        {
            "rel": "action",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/action/calculateTaxAndAccounting",
            "name": "calculateTaxAndAccounting",
            "kind": "other"
        },
        {
            "rel": "action",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/action/createDefaultDistributions",
            "name": "createDefaultDistributions",
            "kind": "other"
        },
        {
            "rel": "action",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/action/cancel",
            "name": "cancel",
            "kind": "other"
        },
        {
            "rel": "action",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/action/updateAllLines",
            "name": "updateAllLines",
            "kind": "other"
        },
        {
            "rel": "action",
            "href": "https://servername/fscmRestApi/resources/version/purchaseRequisitions/300100546287832/action/processPunchoutShoppingCart",
            "name": "processPunchoutShoppingCart",
            "kind": "other"
        }
    ]
}