How do I issue a device and take it back?
Quick answer
Section titled “Quick answer”In the asset detail view, you’ll find the “Issue / return” panel: choose a recipient (employee or free text), optionally set Due On and Note, click “Issue” — done. Taking a device back works via “Take back”. For every transaction, Notory can generate a PDF receipt (issue/return receipt) on request, which you can download or e-mail to the recipient.
Prerequisites
Section titled “Prerequisites”Check-out / return is included on all plans (no feature gating). To e-mail the receipt, SMTP must be configured on the instance.
Instructions
Section titled “Instructions”-
Issue the device. Open the asset. In the “Issue / return” panel (on the right, under the QR code), you can optionally select an employee from the list — the recipient name then fills in automatically. For external recipients, leave the selection at “External recipient (free text)” and type in the name. Optional: Due On (return date) and Note (e.g. “with charger and bag”). Click “Issue”.
Screenshot pendingkatalog-ausgabe-01'Issue / return' panel in the asset detail view with employee selection, Recipient, Due On, Note, and the 'Issue' buttonIssuing directly from the asset: recipient, due date, note — then 'Issue'. -
Use the receipt. After issuing, the panel shows “Currently issued” with the recipient and timestamp. “Download receipt” gets you the issue receipt as a PDF; if an employee is linked, you can deliver it directly with “Send by e-mail”. If the receipt requirement is enabled on the instance, the download starts automatically after issuing.
Screenshot pendingkatalog-ausgabe-02Panel in the 'Currently issued' state with the 'Take back', 'Download receipt', and 'Send by e-mail' buttonsAfter issuing: return and receipt functions in the same panel. -
Take it back. In the panel, click “Take back” — the transaction is marked as returned, and a return receipt becomes available.
-
All transactions at a glance. Under Catalog & Checkout → the “Check-out / return” tab, you’ll see every issuance for the tenant with its status (Checked out/Returned) and timestamps — and you can also quickly check out (select an asset, enter a name, “Check out”) and return (“Return”) devices there.
Screenshot pendingkatalog-ausgabe-03'Check-out / return' tab with a quick check-out form and a table of all transactions with status badgesThe 'Check-out / return' tab: quick check-out and the list of all transactions. -
For recipients: “My devices”. Employees can see the devices currently issued to them in their own “My devices” view.
Issue — only asset_id and assignee_name are required;
assigned_user_id optionally links an actual employee (for the e-mail
receipt and “My devices”):
curl -X POST https://demo.notory.io/api/v1/assignments/checkout \ -H "Authorization: Bearer inv_dein_token" \ -H "Content-Type: application/json" \ -d '{ "asset_id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55", "assignee_name": "Max Mustermann", "assigned_user_id": "b7c31d02-9a4e-4c8f-8b21-6f0a7e5d3c11", "due_at": "2026-08-01T12:00:00Z", "note": "mit Ladegerät und Tasche" }'{ "id": "e4d5c6b7-a890-4123-b456-7c8d9e0f1a2b", "asset_id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55", "assignee_name": "Max Mustermann", "assigned_user_id": "b7c31d02-9a4e-4c8f-8b21-6f0a7e5d3c11", "checked_out_at": "2026-07-08T11:40:12Z", "due_at": "2026-08-01T12:00:00Z", "checked_in_at": null, "status": "checked_out", "note": "mit Ladegerät und Tasche"}Take back (check-in):
curl -X POST -H "Authorization: Bearer inv_dein_token" \ https://demo.notory.io/api/v1/assignments/e4d5c6b7-a890-4123-b456-7c8d9e0f1a2b/checkinDownload the receipt as a PDF, or send it by e-mail:
curl -H "Authorization: Bearer inv_dein_token" \ https://demo.notory.io/api/v1/assignments/e4d5c6b7-a890-4123-b456-7c8d9e0f1a2b/receipt.pdf \ --output beleg.pdfcurl -X POST -H "Authorization: Bearer inv_dein_token" \ https://demo.notory.io/api/v1/assignments/e4d5c6b7-a890-4123-b456-7c8d9e0f1a2b/receipt/emailList transactions and “My devices”:
curl -H "Authorization: Bearer inv_dein_token" \ "https://demo.notory.io/api/v1/assignments?asset_id=a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55&status=checked_out"curl -H "Authorization: Bearer inv_dein_token" \ https://demo.notory.io/api/v1/assets/assigned-to-mePossible errors: 409 (“Asset is already checked out” or “Asset
already returned”), 404 (the asset or linked user isn’t in the tenant),
503 (e-mail delivery not configured), 400 (no e-mail recipient — the
receipt e-mail only works with assigned_user_id).
What happens behind the scenes?
Section titled “What happens behind the scenes?”- One device, one issuance: An asset can only ever be issued once at a
time — a second checkout is rejected with
409, and the interface displays “Check-out failed (may already be checked out).” - A transaction, not a field: Each issuance is its own transaction with
a status (
checked_out→returned), timestamps (checked_out_at,checked_in_at), and a due date — the complete history is preserved. - PDF receipt: The receipt (filename
ausgabe-beleg-…pdforrueckgabe-beleg-…pdf) contains the device, serial number, recipient, and timestamps; the template text can be customized in the instance settings. When the receipt requirement is enabled, the interface downloads it automatically on issue/return. - E-mail delivery: “Send by e-mail” sends the receipt to the linked user’s address (subject line “Ausgabebeleg”/“Rückgabebeleg” — German for “issue receipt”/“return receipt”); without SMTP configured, the interface displays “E-mail delivery is not configured”.
- “My devices”: Via the
assigned_user_idlink, employees can see their own currently issued devices — without any admin rights at all. - Distinction: Issuance complements the organizational assignment via the Assigned To field — it doesn’t replace it.
- Tenant isolation: The asset, recipient user, and transaction must all belong to the same tenant.
Related topics
Section titled “Related topics”- Assign to a user or location — the informal assignment
- Scan an asset QR code — quickly identify a device before issuing it
- Users & Roles — creating recipients as users
- Catalog & Custom Fields — Overview