# Update receive invoice

Partially updates an existing Receive Invoice. Only provided fields will be updated.

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

## Path parameters:

  - `siteId` (number, required)
    Site identifier

  - `receiveInvoiceId` (string, required)
    Receive Invoice unique identifier (UUID)

## Request fields (application/json):

  - `comments` (string)
    Free-text comments associated with the receive invoice.

  - `currency` (string)
    ISO 4217 currency code for all monetary amounts on this invoice.

  - `dueDate` (string)
    Due date/time for payment of the receive invoice.
    Example: "2025-01-01"

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

  - `freightAmount` (string)
    Total freight amount including tax, as a decimal string.
    Example: "100.00"

  - `freightTaxAmount` (string)
    Tax component of the freight amount, as a decimal string.
    Example: "100.00"

  - `invoiceNumber` (string)
    Supplier-provided invoice number used to track the invoice on their end.

  - `isActive` (boolean)
    Whether the receive invoice is active.

  - `lineItems` (array)
    Line items that make up this receive invoice.

  - `lineItems.createdAt` (string)
    Timestamp when the line item was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `lineItems.discountAmount` (string)
    Discount applied to this line item, as a decimal string.
    Example: "100.00"

  - `lineItems.groupId` (string)
    Grouping identifier for related line items.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.invoiceLineItemId` (string, required)
    Identifier for the invoice line item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.isActive` (boolean)
    Whether the line item is active.

  - `lineItems.ledgerAccountId` (string)
    Ledger account associated with this line item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.lineTaxAmount` (string, required)
    Total tax amount for this line.
    Example: "100.00"

  - `lineItems.lineTotalAmount` (string, required)
    Total amount for this line excluding tax.
    Example: "100.00"

  - `lineItems.lineType` (string)
    Type/category of the line item.

  - `lineItems.locationId` (string)
    Location associated with this line item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.name` (string, required)
    Display name/description of the line item.

  - `lineItems.ownershipId` (string)
    Owning organization or business unit for this line item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.productId` (string)
    Product or service associated with this line item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.quantity` (number, required)
    Quantity of the product or service.

  - `lineItems.salesPersonId` (string)
    Salesperson associated with this line item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.standardUnitPriceAmount` (string)
    Standard (list) unit price excluding tax.
    Example: "100.00"

  - `lineItems.standardUnitTaxAmount` (string)
    Standard (list) tax per unit.
    Example: "100.00"

  - `lineItems.status` (string)
    Status of the line item.

  - `lineItems.taxCode` (string)
    Tax code applied to this line item.

  - `lineItems.taxPercent` (number)
    Tax percentage applied to this line item.

  - `lineItems.unitPriceAmount` (string, required)
    Unit price excluding tax, as a decimal string.
    Example: "100.00"

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

  - `lineItems.updatedAt` (string)
    Timestamp when the line item was last modified.
    Example: "2025-01-01T00:00:00.000Z"

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

  - `purchaseOrderIds` (array)
    List of purchase orders associated with this receive invoice.

  - `roundingAmount` (string)
    Rounding adjustment applied to the invoice total, as a decimal string.
    Example: "100.00"

  - `supplierId` (string)
    Identifier of the supplier contact associated with this receive invoice.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `taxAmount` (string)
    Total tax amount for the invoice, as a decimal string.
    Example: "100.00"

  - `totalAmount` (string)
    Total invoice amount including tax, as a decimal string.
    Example: "100.00"

  - `transactedAt` (string)
    Timestamp of the receive invoice transaction.
    Example: "2025-01-01T00:00:00.000Z"

## Response 200 fields (application/json):

  - `comments` (string, required)
    Free-text comments associated with the receive invoice.

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

  - `currency` (string, required)
    ISO 4217 currency code for all monetary amounts on this invoice.

  - `dueDate` (string, required)
    Due date/time for payment of the receive invoice.
    Example: "2025-01-01T00:00:00Z"

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

  - `freightAmount` (string, required)
    Total freight amount including tax, as a decimal string.
    Example: "100.00"

  - `freightTaxAmount` (string, required)
    Tax component of the freight amount, as a decimal string.
    Example: "100.00"

  - `invoiceNumber` (string, required)
    Supplier-provided invoice number used to track the invoice on their end.

  - `isActive` (boolean, required)
    Whether the receive invoice is active.

  - `lineItems` (array, required)
    Line items that make up this receive invoice.

  - `lineItems.createdAt` (string)
    Timestamp when the line item was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `lineItems.discountAmount` (string)
    Discount applied to this line item, as a decimal string.
    Example: "100.00"

  - `lineItems.groupId` (string)
    Grouping identifier for related line items.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.invoiceLineItemId` (string, required)
    Identifier for the invoice line item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.isActive` (boolean)
    Whether the line item is active.

  - `lineItems.ledgerAccountId` (string)
    Ledger account associated with this line item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.lineTaxAmount` (string, required)
    Total tax amount for this line.
    Example: "100.00"

  - `lineItems.lineTotalAmount` (string, required)
    Total amount for this line excluding tax.
    Example: "100.00"

  - `lineItems.lineType` (string)
    Type/category of the line item.

  - `lineItems.locationId` (string)
    Location associated with this line item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.name` (string, required)
    Display name/description of the line item.

  - `lineItems.ownershipId` (string)
    Owning organization or business unit for this line item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.productId` (string)
    Product or service associated with this line item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.quantity` (number, required)
    Quantity of the product or service.

  - `lineItems.salesPersonId` (string)
    Salesperson associated with this line item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `lineItems.standardUnitPriceAmount` (string)
    Standard (list) unit price excluding tax.
    Example: "100.00"

  - `lineItems.standardUnitTaxAmount` (string)
    Standard (list) tax per unit.
    Example: "100.00"

  - `lineItems.status` (string)
    Status of the line item.

  - `lineItems.taxCode` (string)
    Tax code applied to this line item.

  - `lineItems.taxPercent` (number)
    Tax percentage applied to this line item.

  - `lineItems.unitPriceAmount` (string, required)
    Unit price excluding tax, as a decimal string.
    Example: "100.00"

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

  - `lineItems.updatedAt` (string)
    Timestamp when the line item was last modified.
    Example: "2025-01-01T00:00:00.000Z"

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

  - `purchaseOrderIds` (array, required)
    List of purchase orders associated with this receive invoice.

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

  - `roundingAmount` (string, required)
    Rounding adjustment applied to the invoice total, as a decimal string.
    Example: "100.00"

  - `supplierId` (string, required)
    Identifier of the supplier contact associated with this receive invoice.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `taxAmount` (string, required)
    Total tax amount for the invoice, as a decimal string.
    Example: "100.00"

  - `totalAmount` (string, required)
    Total invoice amount including tax, as a decimal string.
    Example: "100.00"

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

  - `transactedAt` (string, required)
    Timestamp of the receive invoice transaction.
    Example: "2025-01-01T00:00:00.000Z"


## Response 400 fields

## Response 401 fields

## Response 404 fields