---
title: "Record a receipt or supervisor disposition"
method: POST
path: "/v1/hub-scanning/orders/{order_id}/operations"
tags: ["Hub Scanning"]
---

# Record a receipt or supervisor disposition

`POST /v1/hub-scanning/orders/{order_id}/operations`

## Request

- Base URL: `https://api.sandbox.usenash.com`
- URL: `https://api.sandbox.usenash.com/v1/hub-scanning/orders/{order_id}/operations`
- Auth: none declared

## Path parameters

- `orderId` string, required

## Request body

- HubOrderOperationRequest
  - `eventId` string, uuid, required
  - `capturedAt` string, date-time, required
  - `deviceId` string, required
  - `reason` string, nullable
  - `operation` 'receive' | 'report_damage' | 'clear_damage' | 'confirm_damage' | 'confirm_damage_donate' | 'mark_shortage' | 'reattempt' | 'mark_lost' | 'close_missing', required
  - `expectedVersion` string, required

## Response `200`

OK

- HubOrderRead
  - `orderId` string, required
  - `hubId` string, required
  - `serviceDate` string, date, required
  - `routeId` string, nullable
  - `barcode` string, required
  - `version` string, required
  - `receiptStatus` 'pending' | 'received' | 'shortage', required
  - `condition` 'not_assessed' | 'first_quality' | 'damage_pending' | 'damaged', required
  - `disposition` 'active' | 'lost_in_hub' | 'closed' | 'donated', required
  - `receivedAt` string, date-time, nullable
  - `receivedBy` string, nullable
  - `conditionReason` string, nullable
  - `staged` boolean
  - `loaded` boolean
  - `actualRouteId` string, nullable
  - `loadBlockedReason` string, nullable
  - `history` HubOrderHistory[]
    - `eventId` string, uuid, required
    - `operation` 'receive' | 'report_damage' | 'clear_damage' | 'confirm_damage' | 'confirm_damage_donate' | 'mark_shortage' | 'reattempt' | 'mark_lost' | 'close_missing', required
    - `capturedAt` string, date-time, required
    - `receivedAt` string, date-time, required
    - `actorId` string, required
    - `reason` string, nullable
  - `allowedOperations` HubOperation[]

## Other responses

- `422`: Unprocessable Content

---

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