# Replace purchaseorderitem

Fully replaces an existing Purchaseorderitem. All fields must be provided.

Endpoint: PUT /site/{siteId}/ahds/v1/purchaseorderitem/{purchaseorderitemId}
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

  - `purchaseorderitemId` (string, required)
    Purchaseorderitem unique identifier (UUID)

## Request fields (application/json):

  - `extensions` (object, required)
    Vendor- or practice-specific extensions.

  - `isActive` (boolean, required)
    Whether this purchase order item is active.

  - `outers` (number, required)
    Number of outer packs ordered.

  - `ownershipId` (string, required)
    Identifier representing the owning business unit or organization.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `pricePerUnit` (string, required)
    Net price per individual unit, as a decimal string.
    Example: "100.00"

  - `productId` (string, required)
    Identifier of the product being ordered.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `purchaseOrderId` (string, required)
    Identifier of the related purchase order.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `quantity` (number, required)
    Total number of units ordered.

  - `supplierCode` (string, required)
    Supplier-specific product code, if provided.

  - `taxPerUnit` (string, required)
    Tax amount per individual unit, as a decimal string.
    Example: "100.00"

  - `totalAmount` (string, required)
    Total net amount for this line (excluding tax), as a decimal string.
    Example: "100.00"

  - `totalTaxAmount` (string, required)
    Total tax amount for this line, as a decimal string.
    Example: "100.00"

  - `unitsPerOuter` (number, required)
    Number of units contained in each outer pack.

## Response 200 fields (application/json):

  - `createdAt` (string, required)
    Timestamp when the purchase order item was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `extensions` (object, required)
    Vendor- or practice-specific extensions.

  - `isActive` (boolean, required)
    Whether this purchase order item is active.

  - `outers` (number, required)
    Number of outer packs ordered.

  - `ownershipId` (string, required)
    Identifier representing the owning business unit or organization.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `pricePerUnit` (string, required)
    Net price per individual unit, as a decimal string.
    Example: "100.00"

  - `productId` (string, required)
    Identifier of the product being ordered.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `purchaseOrderId` (string, required)
    Identifier of the related purchase order.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `purchaseorderitemId` (string, required)
    Canonical identifier for the purchase order item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `quantity` (number, required)
    Total number of units ordered.

  - `supplierCode` (string, required)
    Supplier-specific product code, if provided.

  - `taxPerUnit` (string, required)
    Tax amount per individual unit, as a decimal string.
    Example: "100.00"

  - `totalAmount` (string, required)
    Total net amount for this line (excluding tax), as a decimal string.
    Example: "100.00"

  - `totalTaxAmount` (string, required)
    Total tax amount for this line, as a decimal string.
    Example: "100.00"

  - `unitsPerOuter` (number, required)
    Number of units contained in each outer pack.

  - `updatedAt` (string, required)
    Timestamp when the purchase order item was last modified.
    Example: "2025-01-01T00:00:00.000Z"


## Response 400 fields

## Response 401 fields

## Response 404 fields