---
title: "Create a receival note for a specific partner for the stock update."
method: POST
path: "/receivals"
tags: ["Receival"]
---

# Create a receival note for a specific partner for the stock update.

`POST /receivals`

Create a receival note for a specific partner for the stock update.

## Request body

- ReceivalRequest — Receival note creation object for a specific partner
  - `locationId` string, required — Location id in GrubTech platform
  - `supplierId` string, required — Supplier id in GrubTech platform
  - `invoiceNumber` string, required — Invoice number related to the receival note in the external platform
  - `invoiceDate` string, date-time, required — Invoice issued date related to the receival note
  - `poNumber` string — GrubTech purchase order number. This attribute is mandatory if a receival note request is based on a purchase order.
  - `receivalItems` ReceivalItem[], required
    - `catalogItemId` string — Catalog item id in GrubTech platform
    - `qty` Quantity — Quantity details of a catalog item.
      - `qty` number — The amount or number of a specific catalog item
      - `unitId` string — Measuring unit id for above quantity
    - `cost` Cost — Price details for a specific catalog item.
      - `value` integer — Specifies the price amount. The amount should always be an integer value (never decimals) because the price is set in the lowest denomination (e.g., cents for US currency, not dollars). Price should always be set even if the price is 0.
      - `currencyCode` string — These are the three-letter alphabetic codes that represent the various currencies used throughout the world
    - `expiryDate` string, date — The expiration date for the receival item. This attribute is mandatory if the catalog item type equals "INGREDIENT"
  - `source` Source, required — Detailed information about the order source
    - `name` string — Specifies the order source name
    - `uniqueOrderId` string — Unique identifier representing an order on the order platform
    - `placedAt` string — The time that the particular order was placed, represented in ISO8601 format.
    - `channel` string — Specifies the order channel

## Response `200`

Successful response

- RecivalResponse — Recival response
  - `receivalId` string — Receival id in GrubTech platform
  - `createdAt` string, date-time — Receival note created time in GrubTech platform

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/grubtech/apis/grubtech-auth-server.md) · [All operations](https://skmtc.net/grubtech/apis/grubtech-auth-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grubtech/grubtech-auth-server/revisions/21688b6dcb69/schema)