{
  "test_id": "ORCL.SCM.MFG.MAT.SHORTAGE",
  "scenario_name": "Material Shortage",
  "application": "Oracle Fusion Cloud",
  "product": "SCM",
  "module": "Manufacturing",
  "process": "Material Shortage",
  "business_flow": "Plan-to-Produce",
  "scenario_type": "Positive / Functional",
  "priority": "High",
  "automation_status": "SyntraFlow Ready",
  "library": "Syntra Standard",
  "canonical_url": "https://www.syntraflow.cloud/oracle-erp-testing-tool/test-library/scm/manufacturing/material-transactions/material-shortage/",
  "objective": {
    "intro": "The objective of this test is to validate detection, warning and configured blocking behavior for component shortages on work orders in Oracle Fusion SCM Manufacturing, including shortage reporting at the work order, organization and component level, and shortage resolution paths through replenishment or an authorized override, without assuming a single universal shortage-tolerance rule.",
    "confirms": [
      "component shortage is correctly detected and reported",
      "shortage report correctly reflects work order, organization and component-level detail",
      "work order release is correctly blocked when configured shortage rules require it",
      "a shortage warning is correctly issued where configuration does not require a hard block",
      "shortage within configured tolerance is correctly permitted to proceed",
      "Oracle correctly enforces validation when data errors, configuration errors or security restrictions are introduced (DATA_ERROR, CONFIGURATION_ERROR, SECURITY_ERROR, EXPECTED_VALIDATION)"
    ],
    "scope_note": "This scenario covers component shortage detection, reporting, warning, configured release-blocking and resolution on work orders in Oracle Fusion SCM Manufacturing TEST/UAT environments. It does not assume a single universal shortage-tolerance rule, and does not cover manual component issue, return or backflush transaction behavior, which are covered by the separate Issue Material, Return Material and Backflush Material scenarios in the same Material Transactions cluster."
  },
  "preconditions": [
    "A work order exists with an open component requirement where a shortage condition can be created or already exists.",
    "The component being tested is active in the manufacturing organization, with on-hand quantity set below the required quantity for the scenario under test.",
    "Shortage tolerance and release-blocking rules are configured for the manufacturing organization as expected for the scenario under test.",
    "A replenishment source is available where the scenario requires shortage resolution.",
    "The test user has appropriate access to view shortage reports and, where applicable, override a configured shortage block for the manufacturing organization."
  ],
  "test_data": [
    {
      "field": "Work Order",
      "example": "${WORK_ORDER}"
    },
    {
      "field": "Component",
      "example": "${COMPONENT}"
    },
    {
      "field": "Manufacturing Organization",
      "example": "${MANUFACTURING_ORG}"
    },
    {
      "field": "Shortage Quantity",
      "example": "${SHORTAGE_QUANTITY}"
    },
    {
      "field": "Shortage Tolerance",
      "example": "${SHORTAGE_TOLERANCE}"
    },
    {
      "field": "On-Hand Quantity",
      "example": "${ON_HAND}"
    },
    {
      "field": "Replenishment Source",
      "example": "${REPLENISHMENT_SOURCE}"
    },
    {
      "field": "User Role",
      "example": "${USER_ROLE}"
    }
  ],
  "business_steps": [
    {
      "step_number": 1,
      "step_name": "Sign In and Navigate to Manufacturing",
      "action": "Sign in to Oracle Fusion using an authorised manufacturing test user and navigate to the Manufacturing work area.",
      "test_data": "",
      "expected_result": "The Manufacturing work area opens successfully.",
      "validation_type": "action"
    },
    {
      "step_number": 2,
      "step_name": "Navigate to the Shortage Report or Shorted Work Order",
      "action": "Open the shortage report, or attempt to release or issue against a work order with a shorted component, for the manufacturing organization under test.",
      "test_data": "${WORK_ORDER} / ${COMPONENT} / ${MANUFACTURING_ORG}",
      "expected_result": "The shortage report or the shortage condition on the work order is correctly displayed.",
      "validation_type": "action"
    },
    {
      "step_number": 3,
      "step_name": "Review the Reported Shortage Quantity and Tolerance",
      "action": "Review the reported shortage quantity against on-hand and the configured shortage tolerance for the component and organization.",
      "test_data": "${SHORTAGE_QUANTITY} / ${SHORTAGE_TOLERANCE} / ${ON_HAND}",
      "expected_result": "Shortage quantity, on-hand and configured tolerance are correctly displayed and consistent with the test data.",
      "validation_type": "action",
      "note": "This single business step replaces multiple technical actions such as opening the shortage detail panel and confirming each reported field."
    },
    {
      "step_number": 4,
      "step_name": "Attempt Resolution via Replenishment or Authorized Override",
      "action": "Where the scenario requires it, resolve the shortage by replenishing on-hand from the configured replenishment source, or attempt an override as a user with the specified role.",
      "test_data": "${REPLENISHMENT_SOURCE} / ${USER_ROLE}",
      "expected_result": "Replenishment or override is accepted where permitted, and correctly restricted where the user role is not authorized.",
      "validation_type": "action",
      "note": "Not every scenario requires resolution — this step applies only to scenarios that exercise replenishment or override."
    },
    {
      "step_number": 5,
      "step_name": "Submit the Action",
      "action": "Submit the release, issue, replenishment or override action for processing in the test environment.",
      "test_data": "",
      "expected_result": "Oracle Fusion processes the submitted action without unexpected errors.",
      "validation_type": "action"
    },
    {
      "step_number": 6,
      "step_name": "Verify the Resulting Status and Audit Trail",
      "action": "Reopen or refresh the work order, shortage report and audit trail, and confirm the resulting status correctly reflects the action taken.",
      "test_data": "",
      "expected_result": "Work order status, shortage report and audit trail correctly reflect the detection, block, warning, tolerance or resolution outcome expected for the scenario.",
      "validation_type": "business_assertion",
      "note": "This is the primary business assertion for the scenario — a correctly reflected status and audit trail is the expected pass condition, not merely a successful save."
    }
  ],
  "expected_results": [
    "Component shortage is correctly detected and reported.",
    "Shortage report correctly reflects work order, organization and component-level detail.",
    "Work order release is correctly blocked when configured shortage rules require it.",
    "A shortage warning is correctly issued where configuration does not require a hard block.",
    "Shortage within configured tolerance is correctly permitted to proceed.",
    "Unauthorized shortage override is correctly blocked."
  ],
  "validation_checkpoints": [
    "Component shortage correctly detected and reported.",
    "Shortage report correctly reflects work order, organization and component-level detail.",
    "Release correctly blocked when configured shortage rules require it.",
    "Shortage within tolerance correctly permitted to proceed.",
    "Shortage override correctly restricted to authorized roles.",
    "Unauthorized override correctly blocked."
  ]
}