> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-unsw-v6.advance-uac.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-unsw-v6.advance-uac.com/_mcp/server.

# Credit scenarios

Ready-to-post request bodies, each producing a different shape of credit decision. POST any of them
to `/institution/applications` and read the result from
`/institution/applications/{id}/outcome`.

Each body carries a fixed `sourceRef`, so re-sending one is a `409` rather than a duplicate.

## Several subjects, several units

Four courses satisfy one credit mapping **together**, and that single decision awards **two** units. This is the case a flat one-source-one-unit model cannot represent.

| Awards                |                                                        |
| --------------------- | ------------------------------------------------------ |
| `COMM6106 + COMM6112` | one `decisionId`, both listing all four source courses |
| `COMM6206, COMM6513`  | separate decisions, one source each                    |
| `FINS3640`            | granted at 0 UOC                                       |
| `COMM5005, ECON5205`  | internal rules rather than mappings                    |

Result: 36 UOC, `workflowStatus: DECIDED`.

#### Request body

```json
{
  "applicant": {
    "givenName1": "Giulia",
    "familyName": "Conti",
    "dob": "2002-04-11",
    "emailAddress": "giulia.conti@sample.test",
    "sourceName": "SITS",
    "sourceRef": "SAMPLE-STU-01"
  },
  "programCode": "8429",
  "year": 2026,
  "stream": "DOMESTIC_FP",
  "sourceName": "SITS",
  "sourceRef": "SAMPLE-APP-01",
  "description": "UAC sample test case - M sources to N targets. Four courses satisfy one credit mapping together, and that single decision awards two units - COMM6106 and COMM6112 share one decisionId and both list all four sources. The same subjects also trigger three single-source mappings and two internal rules, so the response shows several decision shapes side by side. Total 36 UOC, workflow DECIDED.",
  "qualifications": [
    {
      "type": "tertiary",
      "source": "officer",
      "data": {
        "code": "BIEF",
        "name": "Bachelor of International Economics and Finance",
        "type": "Bachelor Degree",
        "institution": "Bocconi University",
        "country": "Italy",
        "completedYear": 2024,
        "completed": true
      },
      "subjects": [
        {
          "type": "subject",
          "source": "officer",
          "data": {
            "code": "30012",
            "name": "Mathematics",
            "institution": "Bocconi University",
            "country": "Italy",
            "level": "undergraduate",
            "studyLevel": "introductory",
            "focus": "mathematics",
            "grade": "Pass",
            "completedYear": 2022
          }
        },
        {
          "type": "subject",
          "source": "officer",
          "data": {
            "code": "30177",
            "name": "Statistics",
            "institution": "Bocconi University",
            "country": "Italy",
            "level": "undergraduate",
            "studyLevel": "intermediate",
            "focus": "statistics",
            "grade": "Pass",
            "completedYear": 2023
          }
        },
        {
          "type": "subject",
          "source": "officer",
          "data": {
            "code": "30221",
            "name": "Principles of Management",
            "institution": "Bocconi University",
            "country": "Italy",
            "level": "undergraduate",
            "studyLevel": "introductory",
            "focus": "management",
            "grade": "Pass",
            "completedYear": 2022
          }
        },
        {
          "type": "subject",
          "source": "officer",
          "data": {
            "code": "30498",
            "name": "Econometrics",
            "institution": "Bocconi University",
            "country": "Italy",
            "level": "undergraduate",
            "studyLevel": "advanced",
            "focus": "econometrics",
            "grade": "Pass",
            "completedYear": 2024
          }
        }
      ]
    }
  ]
}
```

## Two subjects for one unit

An internal rule, not a mapping. The macroeconomics rule requires two subjects when neither is intermediate, so both are consumed for one unit and both appear in `sources`.

| Awards     |                                                                 |
| ---------- | --------------------------------------------------------------- |
| `ECON5102` | one decision, two subject sources plus the parent qualification |
| `ECON1203` | a separate mapping match on the second subject, at 0 UOC        |

Result: 6 UOC, `workflowStatus: DECIDED`.

#### Request body

```json
{
  "applicant": {
    "givenName1": "Priya",
    "familyName": "Raman",
    "dob": "2001-09-02",
    "emailAddress": "priya.raman@sample.test",
    "sourceName": "SITS",
    "sourceRef": "SAMPLE-STU-02"
  },
  "programCode": "8429",
  "year": 2026,
  "stream": "DOMESTIC_FP",
  "sourceName": "SITS",
  "sourceRef": "SAMPLE-APP-02",
  "description": "UAC sample test case - M sources to ONE target, via an internal rule rather than a mapping. The macroeconomics rule needs two subjects when neither is intermediate, so ECON1004 and ECON1008 are both consumed for ECON5102 and both appear in sources - even though credit_grant.source_subject_code can only hold the first. ECON1008 also matches a mapping that awards ECON1203 at 0 UOC. Total 6 UOC.",
  "qualifications": [
    {
      "type": "tertiary",
      "source": "officer",
      "data": {
        "code": "BCOM",
        "name": "Bachelor of Commerce",
        "type": "Bachelor Degree",
        "institution": "University of Adelaide",
        "country": "Australia",
        "completedYear": 2023,
        "completed": true
      },
      "subjects": [
        {
          "type": "subject",
          "source": "officer",
          "data": {
            "code": "ECON1004",
            "name": "Principles of Macroeconomics",
            "institution": "University of Adelaide",
            "country": "Australia",
            "level": "undergraduate",
            "studyLevel": "introductory",
            "focus": "macroeconomics",
            "grade": "Credit",
            "completedYear": 2021
          }
        },
        {
          "type": "subject",
          "source": "officer",
          "data": {
            "code": "ECON1008",
            "name": "Macroeconomic Policy",
            "institution": "University of Adelaide",
            "country": "Australia",
            "level": "undergraduate",
            "studyLevel": "advanced",
            "focus": "macroeconomics",
            "grade": "Distinction",
            "completedYear": 2023
          }
        }
      ]
    }
  ]
}
```

## The same unit awarded twice

One subject satisfies **two different mappings that both award MATH6306**. Both grant. The unit appears twice under different `decisionId`s, and `totalCreditUoc` counts it twice.

| Awards                |                                           |
| --------------------- | ----------------------------------------- |
| `MATH6306`            | from the first mapping                    |
| `MATH6306 + MATH8306` | from the second, sharing one `decisionId` |

> **Note**
>
> This is deliberate. Collapsing the two would take a unit off one mapping and misreport both, so the clash is surfaced and routed to a credit officer instead. `finalOutcome` stays `false` until they decide — which is exactly why you should not treat a non-final total as an answer.

Result: 18 UOC for 12 UOC of distinct units, `workflowStatus: CREDIT_TEAM_REVIEW`.

#### Request body

```json
{
  "applicant": {
    "givenName1": "Kenji",
    "familyName": "Watanabe",
    "dob": "2002-01-20",
    "emailAddress": "kenji.watanabe@sample.test",
    "sourceName": "SITS",
    "sourceRef": "SAMPLE-STU-03"
  },
  "programCode": "8429",
  "year": 2026,
  "stream": "DOMESTIC_FP",
  "sourceName": "SITS",
  "sourceRef": "SAMPLE-APP-03",
  "description": "UAC sample test case - One subject satisfies TWO different mappings that both award MATH6306. Both grant, so the same unit appears twice under different decisionIds, and totalCreditUoc counts it twice - 18 UOC for 12 UOC of distinct units. The overlap routes the workflow to CREDIT_TEAM_REVIEW rather than being silently collapsed, so finalOutcome stays false until an officer decides.",
  "qualifications": [
    {
      "type": "tertiary",
      "source": "officer",
      "data": {
        "code": "SCI-MATH",
        "name": "Bachelor of Science",
        "type": "Bachelor Degree",
        "institution": "Nagoya University",
        "country": "Japan",
        "completedYear": 2024,
        "completed": true
      },
      "subjects": [
        {
          "type": "subject",
          "source": "officer",
          "data": {
            "code": "0615520",
            "name": "Elements of Analysis II",
            "institution": "Nagoya University",
            "country": "Japan",
            "level": "undergraduate",
            "studyLevel": "intermediate",
            "focus": "mathematics",
            "grade": "A",
            "completedYear": 2023
          }
        }
      ]
    }
  ]
}
```