---
title: "POST /phases/{jobPhaseId}/stockOnHand"
method: POST
path: "/phases/{jobPhaseId}/stockOnHand"
tags: ["Jobs - Phases"]
---

# POST /phases/{jobPhaseId}/stockOnHand

`POST /phases/{jobPhaseId}/stockOnHand`

Add stock on hand to job phase. Two scenarios are supported:

**With `priceBookLineItemId`:** Only `itemQuantity` is required. `itemDescription`, `itemPrice`, and `itemCost` will be populated from the price book item. No other fields may be passed.

**Without `priceBookLineItemId`:** `itemDescription`, `itemPrice`, `itemCost`, and `itemQuantity` are all required.

## Path parameters

- `jobPhaseId` integer, required

## Request body

- union
  - object
    - `itemQuantity` number, required
    - `priceBookLineItemId` number, required
    - `salesAccountId` number
  - object
    - `itemDescription` string, required
    - `itemPrice` number, required
    - `itemCost` number, required
    - `itemQuantity` number, required
    - `salesAccountId` number

## Response `200`

Successful Response

- StockOnHandResponse
  - `result` string, required
  - `data` StockOnHandItem, required
    - `id` number, required
    - `itemDescription` string, required
    - `jobId` number, required
    - `jobPhaseId` number, required
    - `itemCost` number, nullable, required
    - `itemCostQuantity` number, nullable, required
    - `itemCostTotal` number, nullable, required
    - `itemPrice` number, nullable, required
    - `itemQuantity` number, required
    - `itemTotal` number, nullable, required
    - `priceBookLineItemId` number, nullable, required
    - `priceBookId` number, nullable, required
    - `createdBy` number, nullable, required
    - `dateEntered` string, date-time, required
    - `lastModified` string, date-time, nullable, required
    - `links` Links[], required
      - `href` string, required
      - `rel` string, required
      - `type` 'GET' | 'POST' | 'PUT' | 'PATCH', required

## Other responses

- `4XX` — Client Request Errors
- `5XX` — Server Errors

---

[API](https://skmtc.dev/fergus/apis/fergus-api.md) · [All operations](https://skmtc.dev/fergus/apis/fergus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fergus/fergus-api/revisions/b4f232a22363/schema)