---
title: "Create a receipt for a specific purchase or sales order"
method: POST
path: "/api/receiving/receipts"
tags: ["Receiving Receipt"]
---

# Create a receipt for a specific purchase or sales order

`POST /api/receiving/receipts`

## Request body

- ReceivingReceiptCreateDto — Represents creating a receiving object on an entity
  - `orderType` 'purchaseOrder' | 'salesOrder', required — Order type enum
  - `orderId` string, required — Id of parent order to which this receipt belongs
  - `lines` ReceivingLineItemReceiptLineItemCreateDto[], required — Line items
    - `lineItemId` string, required — Id of the line item corresponding to this receiving.
    - `quantityReceived` number, double, required — Quantity of the associated item that has been received (non-cumulative).
    - `lotNumber` string, nullable — Lot number to receive the item into.
    - `locationId` string, nullable — Location to receive the item into. Please reference /api/locations endpoint.
    - `expirationDate` string, date-time, nullable — Expiration date indicating when this receiving is good until.
    - `fullyReceived` boolean, nullable — Indicate if this is fully received.

## Response `200`

Receipt created

- 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.
  - `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 was not created

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/versions/1b5649cff14a/schema)