---
title: "Update a specific receipt for a purchase or sales order"
method: PUT
path: "/api/receiving/receipts/{receiptId}"
tags: ["Receiving Receipt"]
---

# Update a specific receipt for a purchase or sales order

`PUT /api/receiving/receipts/{receiptId}`

## Path parameters

- `receiptId` string, required

## Request body

- ReceivingReceiptUpdateDto — Represents a receiving object on a purchase order
  - `receivedBy` string, required — Id of the user who received the item(s)
  - `date` string, date-time, nullable — Received date override. If not provided, receipt date will default to the date the object was initially created.
  - `externalReferences` object, nullable — Arbitrary key-value-pair like data that can be used to later on search for this receipt object.

## Response `200`

Receipt

- ReceivingReceiptDto — Represents a receiving object
  - `id` string, required — Unique id associated to this entity.
  - `receivedBy` string, nullable — Id of the user who received the item(s)
  - `number` number, double, nullable — Number
  - `date` string, date-time, nullable — Received date
  - `dateOriginal` string, date-time, nullable — Original received date
  - `dateOverride` string, date-time, nullable — Override received date
  - `accountingHeldUtc` string, date-time, nullable — Set while the receipt's accounting events are withheld because it contains material held for incoming inspection (tenant invoice timing = after-inspection). Held receipts are excluded from the receipt list until their inspections resolve; cleared when the deferred events fire.
  - `orderType` 'purchaseOrder' | 'salesOrder' — Order type enum
  - `orderId` string, nullable — Id of parent order to which this receipt belongs
  - `externalReferences` object, nullable — Arbitrary key-value-pair like data that can be used to later on search for this receipt object.
  - `lines` ReceivingLineItemReceiptLineItemDto[] — Receipt Line item data.
    - `id` string, required — Unique id associated to this entity.
    - `lineItemId` string, required — Id of the purchase order line item corresponding to this update
    - `fullyReceived` boolean, required — Indicates whether the entire quantity of this line item have been received
    - `rolledBack` boolean, required — Indicates whether this update is active.
    - `quantityReceived` number, double, nullable — Quantity of the associated item that has been received on this update in the specified unit of measure (non-cumulative)
    - `unitOfMeasureMultiplier` number, double — If the receipt has a different unit of measure than the item is stored in fulcrum, you would use this multiplier with the QuantityReceived to get the amount you received into Fulcrum.
    - `convertedQuantityReceived` number, double — Quantity of the associated item that has been received in Fulcrum's unit of measure
    - `externalReferences` object, nullable — Arbitrary key-value-pair like data that can be used to later on search for this line item.
    - `unitPrice` number, double, nullable — Price of the purchase order line received against, per Fulcrum's unit of measure, so it multiplies directly with `convertedQuantityReceived`. Null means there is no price, not a price of zero. Supplied only by the receipts list endpoint.
    - `lineItemType` 'part' | 'outsideProcessing' | 'tax' | 'discount' | 'fee' | 'vendorCredit' — Purchase order line item type
  - `customFields` object, nullable — Custom fields that have been defined on this entity.
  - `invoiceNumber` string, nullable — The vendor invoice invoice number associated to the receipt.

## Other responses

- `404` — Receipt did not exist

## Changes

- **2026-09-22** `ad309c11f954` — 4 info
  - added the optional property `lines/items/lineItemType` to the response with the `200` status (media type: application/json)
  - added the optional property `lines/items/lineItemType` to the response with the `200` status (media type: application/problem+json)
  - added the optional property `lines/items/unitPrice` to the response with the `200` status (media type: application/json)
  - added the optional property `lines/items/unitPrice` to the response with the `200` status (media type: application/problem+json)
- **2026-08-08** `1b5649cff14a` — 2 info
  - added the optional property `accountingHeldUtc` to the response with the `200` status (media type: application/json)
  - added the optional property `accountingHeldUtc` to the response with the `200` status (media type: application/problem+json)

[Change history](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/changes/api/receiving/receipts/:receiptId/put.md)

---

[API](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/revisions/e584a13d530a?raw)