# Create receive invoice item

Creates a new Receive Invoice Item record. Receive Invoice Item resource in the Animal Health Data Store

Endpoint: POST /site/{siteId}/ahds/v1/receive-invoice-item
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Request fields (application/json):

  - `batches` (array)
    Batch/lot information associated with this receive invoice item.

  - `batches.batchId` (string,null)
    Identifier of the batch record.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `batches.createdAt` (string,null)
    Timestamp when this batch record was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `batches.expiryDate` (string,null)
    Expiry date of the batch, if applicable.
    Example: "2025-01-01"

  - `batches.isActive` (boolean,null)
    If true, the batch is active.

  - `batches.name` (string,null)
    Batch or lot name/number.

  - `batches.quantity` (number,null)
    Quantity from this batch associated with the receive invoice item.

  - `batches.type` (string,null)
    Batch type classification.

  - `batches.updatedAt` (string,null)
    Timestamp when this batch record was last modified.
    Example: "2025-01-01T00:00:00.000Z"

  - `comments` (string,null)
    Comments related to this receive invoice item.

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

  - `isActive` (boolean, required)
    If true, the receive invoice item is active and usable.

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

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

  - `locationId` (string,null)
    Identifier of the inventory location associated with this item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `name` (string,null)
    Optional descriptive name for the receive invoice item.

  - `ownershipId` (string,null)
    Identifier of the ownership separation this item belongs to.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `productId` (string,null)
    Identifier of the product on this receive invoice item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `productSupplierId` (string,null)
    Identifier of the product-supplier relationship for this item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `purchaseOrderItemId` (string,null)
    Identifier of the related purchase order item, if any.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `quantity` (number, required)
    Quantity of product invoiced. May represent outers or units depending on supplier configuration.

  - `receiveInvoiceId` (string, required)
    Identifier of the receive invoice this item belongs to.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `receiveInvoiceItemId` (string, required)
    Canonical identifier for this receive invoice item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `supplierCode` (string,null)
    Supplier's product code for this item.

  - `taxCode` (string,null)
    Tax code applied to this line.

  - `taxRate` (number,null)
    Tax rate applied to this line, expressed as a percentage (e.g., 15 for 15%).

  - `unitPrice` (string, required)
    Price per selling unit as a decimal string.
    Example: "100.00"

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

## Response 201 fields (application/json):

  - `batches` (array, required)
    Batch/lot information associated with this receive invoice item.

  - `batches.batchId` (string,null)
    Identifier of the batch record.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `batches.createdAt` (string,null)
    Timestamp when this batch record was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `batches.expiryDate` (string,null)
    Expiry date of the batch, if applicable.
    Example: "2025-01-01"

  - `batches.isActive` (boolean,null)
    If true, the batch is active.

  - `batches.name` (string,null)
    Batch or lot name/number.

  - `batches.quantity` (number,null)
    Quantity from this batch associated with the receive invoice item.

  - `batches.type` (string,null)
    Batch type classification.

  - `batches.updatedAt` (string,null)
    Timestamp when this batch record was last modified.
    Example: "2025-01-01T00:00:00.000Z"

  - `comments` (string,null, required)
    Comments related to this receive invoice item.

  - `createdAt` (string, required)
    Timestamp when this receive invoice item was created.
    Example: "2025-01-01T00:00:00.000Z"

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

  - `isActive` (boolean, required)
    If true, the receive invoice item is active and usable.

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

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

  - `locationId` (string,null, required)
    Identifier of the inventory location associated with this item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `name` (string,null, required)
    Optional descriptive name for the receive invoice item.

  - `ownershipId` (string,null, required)
    Identifier of the ownership separation this item belongs to.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `productId` (string,null, required)
    Identifier of the product on this receive invoice item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `productSupplierId` (string,null, required)
    Identifier of the product-supplier relationship for this item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

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

  - `quantity` (number, required)
    Quantity of product invoiced. May represent outers or units depending on supplier configuration.

  - `receiveInvoiceId` (string, required)
    Identifier of the receive invoice this item belongs to.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `receiveInvoiceItemId` (string, required)
    Canonical identifier for this receive invoice item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `supplierCode` (string,null, required)
    Supplier's product code for this item.

  - `taxCode` (string,null, required)
    Tax code applied to this line.

  - `taxRate` (number,null, required)
    Tax rate applied to this line, expressed as a percentage (e.g., 15 for 15%).

  - `unitPrice` (string, required)
    Price per selling unit as a decimal string.
    Example: "100.00"

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

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


## Response 400 fields

## Response 401 fields

## Response 409 fields