---
title: "Confirm Device Receipt Card"
method: POST
path: "/device/v1/receipts/{item_id}/card"
tags: ["device"]
---

# Confirm Device Receipt Card

`POST /device/v1/receipts/{item_id}/card`

## Request

- Base URL: `https://app.zeno-works.ch` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zeno-works.ch/device/v1/receipts/{item_id}/card`
- Auth: none declared

Attach the receipt to the card transaction the employee picked from the candidate list.

The pick is validated against that same list and re-checked under the row lock (409
``device.cardAlreadyTaken`` if an accountant matched it first). The receipt then leaves the
web Receipts queue; the accountant still approves and classifies the transaction. A repeat of a
pick that already succeeded answers 200 again; a receipt that is no longer waiting in the queue
is refused (409 ``device.receiptAlreadyPlaced``).

Optional ``category_id`` / ``purpose`` (ZR-11): the employee's suggestion, written to the
transaction only where it has none yet (an accountant's choice is never overwritten). 422
``device.categoryNotAvailable`` for a category that is not an active one of this company —
nothing is attached. The accountant still classifies and approves.

## Path parameters

- `item_id` string, required

## Request body

- DeviceCardPickIn
  - `txn_id` string, required
  - `category_id` string, nullable
  - `purpose` string, nullable

## Response `200`

Successful Response

- DeviceCardCandidateOut: A card transaction a receipt may belong to — only what the employee needs to recognise it.
  - `txn_id` string, required
  - `card_label` string, required
  - `card_last4` string, required
  - `txn_date` string, date, required
  - `amount` string, required
  - `currency` string, required
  - `merchant` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zeno-works/apis/zeno-api.md) · [All operations](https://skmtc.dev/zeno-works/apis/zeno-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zeno-works/apis/zeno-api/revisions/1eb93dde146c?raw)