---
title: "Erp purchase order receipt updated"
method: POST
path: "erp-purchase-order-receipt.updated"
---

# Erp purchase order receipt updated

`POST erp-purchase-order-receipt.updated` (webhook)

When a Purchase Order Receipt is updated.

## Payload

- union
  - ErpPurchaseOrderReceiptsUpdatedFullWebhook
    - `connection_id` string, required
    - `data` ErpPurchaseOrderReceiptApiItemSchema, required
      - `id` string, required: The unique ID of the receipt transaction in the ERP.
      - `purchase_order_id` string, required: ID of the parent purchase order this receipt records against.
      - `created_date` string, date-time, required: The date the purchase order receipt was created.
      - `updated_date` string, date-time, required: The date the purchase order receipt was last updated.
      - `receipt_number` string, nullable, required: The user-facing identifier of the receipt as assigned by the ERP.
      - `received_date` string, date-time, required: Date the receipt was recorded in the ERP.
      - `location_id` string, nullable, required: ID of the location the receipt was booked into.
      - `notes` string[], required: List of free-form notes recorded on the receipt.
      - `line_items` ErpPurchaseOrderReceiptLineItem[], required: Items included in this receipt. Splits into one entry per (item, lot, bin) triple — a 100-unit receipt of one item booked into two lots (60 + 40) across two bins emits one entry per (lot, bin).
        - `receipt_line_item_id` string, required: ID of the line within the receipt record.
        - `line_item_id` string, nullable, required: ID of the source purchase-order line that this receipt line fulfills. Joins back to the parent purchase order's `line_items[*].line_item_id`. Null when the ERP doesn't expose the link.
        - `item_id` string, required: ID of the inventory item received.
        - `sku` string, required: SKU / item number of the item received.
        - `quantity` number, required: Quantity received on this line.
        - `lot_id` string, nullable, required: ID of the lot this line was booked into. Null for non-lot-tracked items.
        - `lot_name` string, nullable, required: Human-readable name of the lot this line was booked into.
        - `expiration_date` string, date-time, nullable, required: Expiration date of the lot this line was booked into.
        - `bin_id` string, nullable, required: ID of the bin this line was booked into. Null for non-bin-tracked items.
        - `bin_name` string, nullable, required: Human-readable name of the bin this line was booked into.
      - `custom_fields` object, required: Per-account custom fields defined on the purchase order receipt. Keys are the field names as defined in the ERP; each value carries the raw value, its declared type, and a human-readable label.
      - `external_system_url` string, nullable, required: URL link to the purchase order receipt in the external system (WMS/Freight etc).
      - `trackstar_tags` unknown[], nullable, required: A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
        - unknown
      - `additional_fields` object, required: Integration-specific fields
      - `trackstar_created_date` string, date-time, required
      - `trackstar_updated_date` string, date-time, required
    - `event_type` 'erp-purchase-order-receipt.updated', required
    - `integration_name` string, required
    - `integration_type` string, required
    - `previous_attributes` ErpPurchaseOrderReceiptsUpdatedPreviousAttributes, required
      - `id` string: The unique ID of the receipt transaction in the ERP.
      - `purchase_order_id` string: ID of the parent purchase order this receipt records against.
      - `created_date` string, date-time: The date the purchase order receipt was created.
      - `updated_date` string, date-time: The date the purchase order receipt was last updated.
      - `receipt_number` string, nullable: The user-facing identifier of the receipt as assigned by the ERP.
      - `received_date` string, date-time: Date the receipt was recorded in the ERP.
      - `location_id` string, nullable: ID of the location the receipt was booked into.
      - `notes` string[]: List of free-form notes recorded on the receipt.
      - `line_items` ErpPurchaseOrderReceiptLineItem[]: Items included in this receipt. Splits into one entry per (item, lot, bin) triple — a 100-unit receipt of one item booked into two lots (60 + 40) across two bins emits one entry per (lot, bin).
        - `receipt_line_item_id` string, required: ID of the line within the receipt record.
        - `line_item_id` string, nullable, required: ID of the source purchase-order line that this receipt line fulfills. Joins back to the parent purchase order's `line_items[*].line_item_id`. Null when the ERP doesn't expose the link.
        - `item_id` string, required: ID of the inventory item received.
        - `sku` string, required: SKU / item number of the item received.
        - `quantity` number, required: Quantity received on this line.
        - `lot_id` string, nullable, required: ID of the lot this line was booked into. Null for non-lot-tracked items.
        - `lot_name` string, nullable, required: Human-readable name of the lot this line was booked into.
        - `expiration_date` string, date-time, nullable, required: Expiration date of the lot this line was booked into.
        - `bin_id` string, nullable, required: ID of the bin this line was booked into. Null for non-bin-tracked items.
        - `bin_name` string, nullable, required: Human-readable name of the bin this line was booked into.
      - `custom_fields` object: Per-account custom fields defined on the purchase order receipt. Keys are the field names as defined in the ERP; each value carries the raw value, its declared type, and a human-readable label.
      - `external_system_url` string, nullable: URL link to the purchase order receipt in the external system (WMS/Freight etc).
      - `trackstar_tags` unknown[], nullable: A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
        - unknown
      - `additional_fields` object: Integration-specific fields
      - `trackstar_created_date` string, date-time
      - `trackstar_updated_date` string, date-time
  - ErpPurchaseOrderReceiptsUpdatedTruncatedWebhook
    - `connection_id` string, required
    - `data` ErpPurchaseOrderReceiptsUpdatedTruncatedData, required
      - `id` string: The record this event is about. Absent on connection webhooks, which carry dates rather than a row.
    - `event_type` 'erp-purchase-order-receipt.updated', required
    - `integration_name` string, required
    - `integration_type` string, required
    - `previous_attributes` ErpPurchaseOrderReceiptsUpdatedTruncatedPreviousAttributes, required
    - `data_truncated` boolean, required: Always true on this shape. The event was too large to send in full, so `data` holds only the `id` and `previous_attributes` is empty.
    - `data_url` string, required: Called with your usual API key, it returns a download link for this event exactly as it would have been delivered.

## Acknowledgement `200`

Success

---

[API](https://skmtc.dev/trackstarhq/apis/trackstar-api.md) - [All operations](https://skmtc.dev/trackstarhq/apis/trackstar-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trackstarhq/apis/trackstar-api/revisions/08647f790594?raw)