Goods receipts

Overview
This page shows the recorded goods receipts — and the job attached to it is check and release.
At its core is blocked stock: goods that have arrived sit blocked at first and are not yet in inventory. Only release posts them. That is not a detour but the point at which wrong deliveries and damage are noticed before the goods appear sellable.
Two states: blocked stock and released.
Core tasks
Record an acceptance. The upper section lists the open goods acceptances: parcels that arrived but have not been recorded yet. Record acceptance creates one, close links it to a goods receipt or discards it with a reason.
Record a receipt. Recording happens on the purchase order — the goods receipt action there. This page is the overview, not the recording place.
Check. The detail view shows the purchase order, arrival date, lines with quantity, a note and — where done — the release date. Free-text lines are possible as well.
Release. Release posts the lines to the warehouse; the confirmation says so explicitly. Afterwards stock rises.
Jump to the purchase order. To the purchase order leads back into the process.
Fields in detail
Two documents sit on top of each other on this page. Goods acceptance at the top is recorded and closed here — it has a real input mask. The goods receipt below it is booked on the purchase order; here it is a display plus the release action.
Record a goods acceptance
The acceptance records that parcels have arrived — no more. It deliberately carries no quantities: nobody looks inside the boxes at the dock. It therefore books no stock either.
| Field | Required | Values / format | What it does |
|---|---|---|---|
Sender as stated on the parcel sender | conditional | text, max. 160 characters | Who delivered, as written on the parcel. Sender or tracking number must be set — without either the server rejects the acceptance, because otherwise nobody finds the goods at the dock again. |
Tracking number trackingNumber | conditional | text, max. 60 characters | The carrier's number. Together with the sender the alternative mandatory entry. |
Carrier carrier | no | text, max. 60 characters | Who delivered it. |
Number of parcels packageCount | no | whole number greater than 0 | How many packages arrived. |
Note note | no | text | What was noticed — damaged box, missing delivery note. |
Supplier supplierRoleId | no | a supplier | Assigns the acceptance to a master supplier. Not offered in the mask; interface and automation only. |
Brand brandId | no | one of your brands | Settable on creation only, and only in a brand where you actually hold purchasing.receipt.record. Not offered in the mask. |
Closing links the acceptance to one recorded goods receipt (goodsReceiptUlid) — or discards it if no receipt is chosen; the reason then goes into note. The dialog demands one of the two. A closed acceptance can no longer be changed: it is the record of what arrived.
Goods receipt — what the list shows
| Element | Field | What it means |
|---|---|---|
| Receipt | id | The running number of the receipt. |
| Order | goodsOrderNumber | Which purchase order it belongs to, as a jump there. |
| Received at | receivedAt | When it was booked. |
| Delivery note number | deliveryNoteNumber | The supplier's paperwork; the detail people search by later. |
| Blocked stock | isBlockedStock | Whether the goods are booked but not yet sellable. |
| State | bookingStatus | captured = recorded but not booked · released = booked. |
| Released at | releasedAt | When release happened. Empty means stock is unchanged. |
| Lines | items | Description and quantity per line, free-text lines included. |
| Note | note | What was recorded at booking time. |
Release posts the lines to the warehouse. The action takes no input and cannot be withdrawn — afterwards only a stock adjustment with a reason helps, see stock.
Settings & permissions
- Module
module.purchasing. - Permission
purchasing.receipt.record. - Before release, stock does not change. Anyone planning with the goods already is planning with
blocked stock.
- A receipt can arise from a delivery notification — then it is
already prepared.
FAQ & troubleshooting
Stock is unchanged after the receipt. As expected — only release posts. Check the release date.
I cannot create a receipt here. Correct. Recording happens on the purchase order; the message on the empty page says so.
The delivered quantity differs. Record what actually arrived. The permitted deviation is governed by the order's tolerance; anything beyond is a matter for the supplier.
Released goods turned out to be defective. Release cannot be withdrawn. Correct through a stock adjustment with a reason, see Stock.