Skip to content

Scenario Impact Analysis

Analyse Impact

GET /api/scenario-analysis-impact

Required privilege: Scenarios / View

Calculates the supply chain impact of a proposed change within a scenario - e.g., increasing demand for an item, changing a supplier, or adjusting a forecast.

Query Parameters

Parameter Type Required Description
type string Yes Change type: Procurement, Manufacturing, Inventory, Demand, Forecast
parents JSON Yes Parent record IDs driving the change (e.g., PO IDs, SO IDs)
children JSON No Child record IDs if narrowing impact scope

Example Request

curl -b cookies.txt \
  "https://acme.knosc.com/api/scenario-analysis-impact?type=Procurement&parents=[42,43]"

Response

{
  "data": {
    "impacted_items": 3,
    "impacted_warehouses": 2,
    "supply_change": 500,
    "demand_gap": -200,
    "affected_orders": [
      {
        "type": "Sales Order",
        "id": 88,
        "number": "SO-2024-001",
        "impact": "Demand at risk"
      }
    ]
  }
}

Get Impacted Items

GET /api/scenario-analysis-impacted-items/{id}

Returns the list of items affected by a specific scenario.

curl -b cookies.txt "https://acme.knosc.com/api/scenario-analysis-impacted-items/7"

Response

{
  "data": {
    "rows": [
      {
        "Item Number": "ITEM-A",
        "Item Description": "Widget Assembly - Type A",
        "Impact Type": "Supply Shortfall",
        "Impact Quantity": -200,
        "Warehouses Affected": ["WH-01"]
      }
    ]
  }
}

Impacted Procurement

GET /api/scenario-analysis-impacted-procurement/{scenario_id}
GET /api/scenario-analysis-impacted-procurement/{scenario_id}/{po_id}

Returns purchase orders impacted by the scenario. Optionally scoped to a specific PO.

Impacted Manufacturing

GET /api/scenario-analysis-impacted-manufacturing/{scenario_id}
GET /api/scenario-analysis-impacted-manufacturing/{scenario_id}/{mo_id}

Impacted Inventory

GET /api/scenario-analysis-impacted-inventory/{scenario_id}
GET /api/scenario-analysis-impacted-inventory/{scenario_id}/{item_id}

Impacted Forecast

GET /api/scenario-analysis-impacted-forecast/{scenario_id}
GET /api/scenario-analysis-impacted-forecast/{scenario_id}/{fo_id}

Impacted Demand

GET /api/scenario-analysis-impacted-demand/{scenario_id}
GET /api/scenario-analysis-impacted-demand/{scenario_id}/{so_id}

All impacted endpoints follow the same pattern: return a list of affected records with impact type, quantity change, and affected warehouses. The optional second path parameter narrows results to a single record.