Skip to content

Get Purchase Options

Request

Returns purchase options for a sourcing scenario, grouped by offer. Each purchase option represents a selected offer with its order quantity, pricing, and the sourcing line items it fulfills. This data is designed for ERP systems to create purchase orders.

Quantity model

  • quantity is the number of offer units to order.
  • unit_of_measurement defines what one offer unit represents (e.g. 1 piece, or 5 meters of cable).
  • purchase_quantity is the total in base units: quantity × unit_of_measurement.value. This is a computed convenience field.

Resolving offer details

Each purchase option carries an offer_id. Use this identifier with GET /offers/{id} or POST /offers/bulk to fetch the full offer including supplier information, pricing tiers, and availability.

The endpoint reflects the currently persisted offer selection; it does not trigger a recalculation.

Security
BearerAuth
Path
idstringrequired

UUID of the sourcing scenario to retrieve purchase options for.

Headers
Acceptstring(SourcingScenarioAcceptHeader)required

Set this to application/api.luminovo.sourcing-scenario-v1+json.

Value:"application/api.luminovo.sourcing-scenario-v1+json"
GET
/sourcing-scenarios/{id}/purchase-options
curl -i -X GET \
  'https://api.luminovo.com/sourcing-scenarios/{id}/purchase-options' \
  -H 'Accept: application/api.luminovo.sourcing-scenario-v1+json' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Purchase options for the sourcing scenario. Each entry represents a selected offer with its order quantity and the sourcing line items it fulfills.

Bodyapplication/json
purchase_optionsArray of objects(PurchaseOption)required

The purchase options for the sourcing scenario. Each entry represents one offer selected by the sourcing engine with its determined order quantity and the sourcing line items it fulfills.

Response
{
  "purchase_options": [
    { … },
    { … }
  ]
}