Skip to Content

Purchase Return

  • Code: PUR-PR
  • Module: Purchasing
  • Type: Transaction

1. Overview

A Purchase Return (Return) is a document recording goods the store sends back to a supplier, along with the reason. Every Return has one or more persons in charge (PIC), who are authorized to submit and cancel it. A Return is the reverse leg of the purchasing flow: where a Goods Receipt (GR) records goods coming in, a Return records goods going back out to the supplier. A Return stands apart from money matters — it records the physical event, namely the products and quantities that went out, while its financial counterpart only appears as a Credit Note when the returned goods have already been billed.

Expected outcome: every item going back to a supplier has an official record of what, how many, from which receipt, and why, so store stock adjusts immediately, goods that were already returned are not billed, and credit from the supplier can be claimed back on a clear basis.

2. Problem

Without a return document, damaged, expired, or wrongly delivered goods sent back to a supplier only live in conversations and warehouse staff’s personal notes. System stock keeps counting goods that are physically gone, and bills are still calculated from the original receipt quantity. As a result:

  • System stock does not match physical stock, and the difference is only discovered during a stock take, when the cause is hard to trace.
  • Goods that were already returned are still billed by the supplier, so the store pays for goods it does not have.
  • Credit from the supplier for goods already paid has no document basis, so claiming it depends on memory and renegotiation.
  • There is no record of return reasons per supplier, so supplier quality cannot be evaluated with numbers.

3. Goals & Non-goals

3.1 Goals

  • Every return of goods to a supplier is recorded as its own transaction, including when the originating receipt can no longer be traced because the goods have mixed into store stock.
  • Store stock decreases exactly when the goods are declared out, not after some other administrative process finishes.
  • Goods that were returned before being billed never end up on the supplier’s bill.
  • Goods returned after being billed produce a credit that can be claimed back, without ever changing a bill that is already in effect.
  • The reason for the return is recorded per transaction, so the volume and causes of returns per supplier can be read as numbers.
  • Supporting evidence of the return is stored attached to its document, not scattered across each staff member’s device.

3.2 Non-goals

  • Calculating the financial value of a return; the price, discount, and tax on returned goods are the Credit Note’s business, not the Return’s (BR-13).
  • A Bill reference from the Return side; the bill number is outside the warehouse’s scope and linking to it is done by the Credit Note (BR-22).
  • A supplier approval flow for returns inside the system; the agreement with the supplier happens outside the app, and the return is recorded once that agreement exists.
  • Recording replacement goods from the supplier; replacement goods come in through the Purchase Order and Goods Receipt flow like a regular purchase.
  • Correcting a Return that is already Closed; an incorrect return is not changed, but handled through a separate financial correction mechanism that has not been built yet.
  • Write-offs, that is damaged goods that the supplier does not take back; that is not a return because the goods never go out to the supplier and no credit is produced. There is no feature for it yet.
  • A stock card or stock movement history per product; a Return only changes the stock quantity, without forming a movement ledger of its own.

4. Business Rules

Business rules are the set of provisions and constraints that apply to Returns throughout the application, on every screen and action that involves it, whoever performs it. These rules are the single source of truth: if another part of this PRD appears to differ, the rules here prevail.

  • BR-01 Every Return belongs to one store and one supplier, and references at most one Goods Receipt. If a Return names a Goods Receipt, all returned products must come from that receipt and every line must point to that receipt’s item; if it does not name one, none of its lines may point to any receipt item.
  • BR-02 A Return without a Goods Receipt is the only exception to BR-01, used when the goods have mixed into store stock and the originating receipt cannot be determined. A Return either references one receipt entirely or none at all; a mixed state does not apply.
  • BR-03 A Return never changes the content of a Goods Receipt. The sent, rejected, and received quantities on the GR remain as recorded, however much is later returned.
  • BR-04 A Bill that has left Draft status is never changed by a Return. Its value and quantity remain as when it was billed, and the financial counterpart of the return is the Credit Note (BR-09). A Bill that is still in Draft is not yet in effect and is instead recalculated (BR-18).
  • BR-05 The quantity of a receipt that can still be billed is calculated when the Bill is created, namely the Received Quantity minus the active return quantity on that receipt item. This figure is never stored as a field on the Bill.
  • BR-06 The cumulative return quantity on one receipt item must not exceed that item’s Received Quantity. Returns in Cancelled status are not counted. Several partial Returns on the same item are allowed as long as their total stays within the limit.
  • BR-07 When a Return is submitted, store stock decreases by the return quantity of each line. The decrease happens once, at submission, not when the Return is created.
  • BR-08 A Return on goods that have never been billed immediately becomes Closed when submitted, without a Credit Note. This closing is set by the system and is not a user action.
  • BR-09 A Return on goods that have already been billed creates exactly one Credit Note in Draft status when submitted, and only becomes Closed when that Credit Note is submitted. This closing is also set by the system.
  • BR-10 A Return in Draft status can only be submitted or deleted. A Draft has no effect yet, so a Return that turns out not to be used is deleted, not cancelled. Cancellation only applies to Returns in Submitted status, done by the PIC (BR-23): stock is restored by the amount previously deducted, and a cancellation reason is required.
  • BR-11 A Return that has issued a Credit Note can only be cancelled while that Credit Note is still in Draft. That cancellation deletes the Credit Note — rather than cancelling it — because a Draft Credit Note has never recognized any credit, and also restores stock.
  • BR-12 A Return whose Credit Note has been submitted cannot be cancelled. When the Credit Note is submitted, the system automatically closes the Return to Closed (BR-09), and from then on the Return is a historical record.
  • BR-13 A Return does not calculate or store financial value. The Return’s scope is the warehouse area, which only knows stock and quantity, so when adding or editing a Return there is no price, discount, or tax input, and the document-level summary only contains quantities. All monetary values for returned goods are handled by the Credit Note.
  • BR-14 Every Return must include a return reason. The reason is a note and reporting material; it does not determine the Return’s status and does not determine whether a Credit Note exists. A Return may also attach supporting documents as more than one file, or attach nothing; attachments are only evidence and do not affect the Return’s status. The limits on the number, size, and type of files Need confirmation.
  • BR-15 A Return only changes the stock quantity. The product’s average cost is not recalculated by a Return, just as goods receiving does not change it either.
  • BR-16 The referenced Goods Receipt must belong to the same store and supplier as the Return.
  • BR-17 The billing status of returned goods is determined by the system, not filled in by the user. A Return that references a Goods Receipt counts as not yet billed if that receipt has not been referenced by any Bill or its Bill is still in Draft, and counts as already billed if its Bill has left Draft. A Return without a Goods Receipt always counts as already billed (BR-21).
  • BR-18 If the receipt being returned is already referenced by a Bill in Draft status, submitting the Return reduces that Bill line’s quantity by the return quantity, then all of its totals are recalculated. The adjustment can only go downward; a line whose quantity runs out stays with quantity 0 so its receipt reference is not detached. This change is recorded in the Bill’s activity log.
  • BR-19 Every data change and status transition of a Return is recorded along with its actor and time.
  • BR-20 One Goods Receipt can be the source of many Returns, because problem goods are often found gradually; every submission is evaluated against the latest quota (BR-06). Submitting a Return is evaluated as one indivisible unit: the return quota check, stock reduction, billing status determination, Draft Bill adjustment, and Credit Note issuance happen together or not at all. If a Bill on the same receipt is being created at the same time, only one succeeds; the other fails and must be retried on the latest figures.
  • BR-21 A Return without a Goods Receipt does not reduce the quantity that can be billed on any Bill, because billing is always based on receipts. Goods whose originating receipt is unknown are handled entirely through the Credit Note (BR-09, BR-17).
  • BR-22 A Return only references a Goods Receipt or references nothing. A Return does not store and does not show a Bill reference, either at the document level or on its lines, because the bill number is outside the warehouse’s scope. Linking to a Bill is the Credit Note’s business.
  • BR-23 Every Return must have a person in charge (PIC) before it can be submitted. Submitting and cancelling a Return may only be done by a PIC assigned to that Return who has the permission for that action; creating a Return alone does not grant this authority. PIC assignment can only be changed while the Return is in Draft.

5. Flow

5.1 Main Flowchart

  1. Create Return — Staff select the goods receipt being returned, then mark the products and quantities sent back along with the reason. If the originating receipt is unknown, the receipt is left empty and products are selected directly from the store’s inventory (BR-02). Supporting documents may be attached, or not (BR-14).
  2. Validation — Inputs are checked before the Return is saved: item origin, return quantity limit, and store and supplier match. A Return that violates the rules cannot be saved, and the errors are shown in the relevant section.
  3. Draft — The initial status after the Return is saved. Stock has not changed and there is no effect yet in other modules. While in Draft, its content can still be edited and its PIC assigned without changing the status; from here the Return can be submitted or deleted, and a Return that is not used is deleted, not cancelled (BR-10).
    • 3a. Edit Return Data — General data and the product list can be updated, and the Return stays in Draft.
    • 3b. Assign PIC — One or more store employees are assigned as the person in charge. The Return stays in Draft, and this assignment is required before the Return can be submitted (BR-23).
  4. Submitted — Done by the PIC. The Return is declared in effect and its content is locked. From this point its line quantities can no longer be changed.
  5. Reduce Stock — Store stock decreases by the return quantity of each line (BR-07).
  6. Check Billing Status — The system reads the referenced receipt to determine whether the returned goods have ever been billed (BR-17). A Return without a receipt always takes the already billed path (BR-21).
  7. Adjust Billable Quantity — For goods not yet billed, the quantity that can still be billed decreases: if there is no Bill yet, the reduction is applied when the Bill is created later (BR-05); if there is already a Bill in Draft status, that Bill’s quantity and totals are recalculated right then (BR-18).
  8. Credit Note — For goods already billed, one Credit Note in Draft status is created by the system as the Return’s financial counterpart, and that is where all of its monetary value is determined (BR-13). The details are explained in a separate PRD.
  9. Closed — The Return has been fully processed. For returns not yet billed, this status is reached at submission; for returns already billed, when their Credit Note is submitted (BR-08, BR-09, BR-12).
  10. Cancelled — Done by the PIC on a Return that has been submitted, with a required reason (BR-10, BR-23).
    • 10a. Restore Stock — Store stock increases again by the amount previously deducted, and if there is a Credit Note in Draft status, that Credit Note is deleted (BR-10, BR-11).

5.2 Status Lifecycle

StatusDescriptionNext
Draft
draft
Being prepared, store stock has not changedSubmitted, or deleted
Submitted
submitted
In effect and locked, stock has decreasedClosed, Cancelled
Closed
closed
The Return has been fully processed; if already billed, its Credit Note has been submitted—
Cancelled
cancelled
Withdrawn, stock has been restored—

6. Document Structure

This section defines the content of the Return document itself: which fields a Return has, their type, which are required, their initial values, their value rules, and their calculation formulas. The provisions here apply wherever the Return is created or changed and are enforced on save, regardless of how the field is displayed.

6.1 General

FieldTypeRequiredDefaultRules
Return NumberText—Generated on saveSet by the system in the format PR/{Store Code}/{Year}/{000000}, cannot be changed
StoreRef. StoreYesThe store where the user is currently workingCannot be changed (BR-01)
Goods ReceiptRef. GRNo—Empty means a Return without a receipt (BR-02). Selected from GRs of the same store in Submitted or Closed status; cannot be changed after the Return is submitted
SupplierRef. SupplierYesThe supplier of the selected receiptSelected manually only on a Return without a receipt; must be the same as the receipt’s supplier if there is one (BR-16)
Return DateDate & TimeYesNowStores the date along with the time the goods went out
Shipping AddressRef. Store AddressYesThe store’s default shipping address, or its first addressSelected from the Return store’s addresses; where the goods are sent from
Receiving AddressRef. Supplier AddressYesThe supplier’s default address, or its first addressSelected from the Return supplier’s addresses; must be selected again if the supplier changes
Shipping Plate NumberTextNo—The vehicle carrying the returned goods, maximum 255 characters
Shipping Person in ChargeTextNo—Name of the driver or courier carrying the returned goods, maximum 255 characters
Person in Charge (PIC)Ref. Employee, multipleYes, before submittingThe logged-in user’s employee record, if anyStore employees; can only be filled in by holders of the assign permission (BR-23)
Return ReasonEnumYes—Damaged, Expired, Wrong Item, Overstock, Failed Quality Check, or Other (BR-14)
Supplier Return ReferenceTextNo—The return authorization number from the supplier, if the supplier issues one
Supporting DocumentsFile, multipleNo—May be more than one file and may be left empty; the limits on number, size, and file type Need confirmation (BR-14)
NotesTextNo——
Cancellation ReasonTextYes, when cancelled—Required on the Cancel action, which is only available on Submitted Returns (BR-10)
StatusEnum—DraftSet by the system; see Status Lifecycle

6.2 Line Items

FieldTypeRequiredDefaultRules
SequenceInteger—Follows the order of additionSet by the system
Product (Package)Ref. Store Product InventoryYesFollows the selected receipt itemOne row per package; on a Return with a receipt only packages on that receipt (BR-01)
GR ItemRef. GR Item—The receipt item with the same packageSet by the system; must belong to the receipt in the header (BR-01), and empty on a Return without a receipt (BR-02). It is the only trace the Credit Note uses to find the Bill item (BR-22)
Measurement UnitText—Follows the selected packageSet by the system
Returnable QuantityDecimal—Calculated when the item is selectedThe receipt item’s Received Quantity minus earlier active returns (BR-06); empty on a Return without a receipt
Return QuantityDecimalYes1At least 0.01 and not exceeding the Returnable Quantity (BR-06)

Return lines do not contain price, discount, or tax; all financial value lives in the Credit Note (BR-13).

6.3 Calculations

FieldFormula
Total Return QuantitySum of the Return Quantity across all lines
Item CountNumber of product lines on the Return

7. UI Structure

This section defines how Returns are displayed and operated: the list columns, filters, form controls along with their option sources, and the PDF layout. This section only governs display and interaction; content and value rules still follow Document Structure.

7.1 Datatable

ColumnSortableSample ValueComponent
Select——Checkbox, Expand Toggle
No—1Number
Return NumberYesPR/CBI/2026/000042Link
Store—Cianjur StoreText
Receipt Number—GR/CBI/2026/000042Link, empty if without a receipt
Supplier—PT Sumber RejekiText
Return DateYes23 Sep 2026 14:30DateTime
Person in Charge—Andi, SariAccordion, Add Button
Return Reason—DamagedBadge
Total Return QuantityYes12Number
Credit Note Number—CN/CBI/2026/000007Link, empty if not yet billed
Created By—Budi SantosoText
Status—SubmittedBadge
Actions—Print · View · Edit · DeleteAction Menu

Expanded Row

ColumnSample ValueComponent
Product (Package)Cooking Oil 2L (Carton)Thumbnail, Text
Return Quantity2Number
Measurement UnitCartonText

7.2 Advance Filter

FieldControlOptions SourceDefault
StoreMulti SelectStores assigned to the userEmpty
Return Date RangeDate Range Picker—Empty
SupplierMulti SelectSupplier master, searchableEmpty
Return ReasonMulti SelectReturn reason enumEmpty
StatusMulti SelectStatus enumEmpty

7.3 Form & Details

Create — A three-step wizard: General, Products, then Review. The General step determines the goods receipt being returned or marks it as without a receipt, and the Products step can only be opened after that choice is set. The Next button validates the current step before moving on, and the Review step shows a read-only summary of all inputs. Actions: Next, Save, PDF Preview.

Edit — Two tabs, General and Products, with all fields enabled except Goods Receipt, including PIC assignment. Only available while the Return is in Draft. Actions: Save, assign PIC, add/edit/delete product, upload and delete supporting documents, PDF Preview.

Detail — The Return Number, status badge, and status stepper at the top, followed by read-only General and Products tabs. Supporting documents appear as a list of downloadable files. If the Return produces a Credit Note, the Credit Note number along with its status appears as a link at the top. Actions: Edit Data, Submit, Delete, Cancel, Print, and Activity Logs, each appearing according to the Return status — Delete only on Draft and Cancel only on Submitted (BR-10). Status action buttons are still shown to users who are not the PIC, but in a disabled state (BR-23).

General

FieldControlOptions SourceBehavior
StoreRead-onlyThe store where the user is currently working—
Goods ReceiptSingle SelectThe active store’s GRs in Submitted or Closed status, searchable by receipt numberThe Without Goods Receipt option always appears first; selected → Supplier is filled in and the product list is limited to that receipt’s items
SupplierSingle SelectSupplier master, searchableDisabled and filled in automatically if a Goods Receipt is selected
Return DateDateTime Picker—Filled with the date and time when the form is opened
Shipping AddressSingle SelectThe active store’s addressesFilled with the store’s default shipping address, or its first address
Receiving AddressSingle SelectThe selected supplier’s addressesFilled with the supplier’s default address, or its first address; cleared and refilled when the Supplier changes
Shipping Plate NumberText Input——
Shipping Person in ChargeText Input——
Person in Charge (PIC)Multi SelectStore employeesCan only be filled in by holders of the assign permission; defaults to the logged-in user’s employee record
Return ReasonSingle SelectReturn reason enum—
Supplier Return ReferenceText Input——
Supporting DocumentsFile Upload, can be more than one—Optional; files already uploaded appear as a list that can be deleted while in Draft
NotesTextarea——

Products — Table

ColumnSample ValueComponent
Product (Package)Cooking Oil 2L (Carton)Thumbnail, Text
Returnable Quantity10Number
Return Quantity2Number
Measurement UnitCartonText
ActionsEdit, Delete, ViewAction Menu

Products — Form

FieldControlOptions SourceBehavior
Product (Package)Single SelectThe selected receipt’s items; on a Return without a receipt, the store’s product inventory searched by name or barcodeFills in Measurement Unit and Returnable Quantity
Measurement UnitRead-onlyThe selected package—
Returnable QuantityRead-onlyCalculation of the remaining return quotaEmpty on a Return without a receipt
Return QuantityNumber Input—Exceeding the Returnable Quantity → error on the field

Products — Calculations

FieldSample ValueComponent
Total Return Quantity12Number, read-only
Item Count3Number, read-only

7.4 PDF Format

SectionContent
WatermarkThe Return status, only on Draft and Cancelled Returns
Header- Company: Name, Contact, Address
- Document: Purchase Return title, Return Number, Return Date
Parties- Supplier: Name, Receiving Address
- Returned From: Store Name, Shipping Address
- Shipping: Shipping Plate Number, Shipping Person in Charge
Product TableNo | Product | Return Quantity | Measurement Unit
Summary- Details: Receipt Number, Return Reason, Supplier Return Reference
- Notes: Content of the Notes field
- Attachments: List of supporting document names, if any
- Calculations: Total Return Quantity, Item Count
SignatureA column for the goods handover from the store on behalf of the first PIC and a receiver from the supplier’s side, only on Returns that have left Draft status

8. User Stories

US-01 - Create a return from a goods receipt

As warehouse staff, I want to create a return referencing a specific goods receipt, so that the origin of the returned goods is clear and its quota is protected.

IDAcceptance criteria
AC-01.1When a user with the create permission opens Add New in the active store, the General → Products → Review wizard appears with the active store filled in (read-only) and the return date containing the current date and time.
AC-01.2The Goods Receipt options contain the active store’s GRs in Submitted or Closed status, searched by receipt number, with the Without Goods Receipt option always at the top.
AC-01.3When a receipt is selected, the supplier is filled in automatically and cannot be changed, and the product options are limited to that receipt’s items (BR-01, BR-16).
AC-01.4When a product is selected, the measurement unit and returnable quantity are filled from their sources according to Document Structure; there is no price, discount, or tax field on any screen (BR-13).
AC-01.5When the return quantity changes or lines are added and deleted, Total Return Quantity and Item Count are updated without reloading (BR-13).
AC-01.6When Save succeeds, the Return is saved in Draft status, a success toast appears, and the user is redirected to the Return list.
AC-01.7The receipt has already been fully returned — the receipt can still be selected, but all of its products show a returnable quantity of 0 and cannot be added (BR-06).
AC-01.8The active store is inactive — the Add page shows the inactive store page.
AC-01.9The user can upload more than one supporting document and can save the Return without uploading any file; files already uploaded can be deleted while the Return is in Draft (BR-14).
AC-01.10The same receipt can be returned repeatedly through different Returns, each with its own reason and supporting documents (BR-20).
AC-01.11The shipping address is filled in automatically with the store’s default shipping address; the receiving address is filled in with the selected supplier’s default address. If there is no default, the first address is used.

US-02 - Create a return without a goods receipt

As warehouse staff, I want to create a return without referencing a receipt, so that goods that have mixed into store stock can still be returned and recorded.

IDAcceptance criteria
AC-02.1When the Without Goods Receipt option is selected, the Supplier field becomes active and is chosen by the user; there is no Bill input on any screen (BR-02, BR-22).
AC-02.2Products are selected directly from the store’s product inventory with search by name or barcode, and the Returnable Quantity column appears empty (BR-02).
AC-02.3Lines of a return without a receipt are never linked to any receipt item, and a Return cannot contain a mix of linked and unlinked lines (BR-02).
AC-02.4A return without a receipt does not consume the return quota of any receipt item, so there is no quota to allocate (BR-21).
AC-02.5Lines of a return without a receipt contain no financial value at all; the value is only filled in later by finance staff in the Credit Note (BR-13).
AC-02.6Submitting a return without a receipt always issues a Credit Note and does not change the quantity still billable for that product (BR-17, BR-21).

US-03 - Submit a return

As a PIC, I want to submit a return, so that store stock adjusts immediately and its content no longer changes.

IDAcceptance criteria
AC-03.1The Submit Return button appears on Draft Returns for users with the submit permission in the active store, and is only enabled if the user is that Return’s PIC (BR-23).
AC-03.2After confirmation, the status becomes Submitted, store stock decreases by the return quantity of each line, and who submitted it and when are recorded (BR-07).
AC-03.3On a Submitted Return, the Edit Data button and product actions do not appear, so its quantities are locked (BR-06, BR-17).
AC-03.4The returned goods have never been billed and no Bill references their receipt yet — the Return immediately becomes Closed in the same action, without a Credit Note (BR-08).
AC-03.5The content of the referenced goods receipt does not change at all after submission (BR-03).
AC-03.6The Return has no PIC yet — the Submit button is disabled for all users until a PIC is assigned (BR-23).

US-04 - Return goods whose Bill is still in Draft

As warehouse staff, I want to still be able to submit a return even while finance staff are preparing a bill on that receipt, so that recording goods going out does not wait for administrative processes.

IDAcceptance criteria
AC-04.1Submitting a return is not rejected by the existence of a Bill in Draft status referencing that receipt (BR-18).
AC-04.2The quantity of the related Draft Bill line decreases by the return quantity, and all Bill totals are recalculated (BR-18).
AC-04.3A Bill line whose quantity is fully returned stays with quantity 0 and its receipt reference is not detached (BR-18).
AC-04.4A Bill that has already left Draft status is never adjusted this way; that case follows the Credit Note path (BR-04).
AC-04.5The adjustment appears in the Bill’s activity log so the bill preparer can see what changed (BR-18).
AC-04.6The Bill that is read and adjusted is found by the system from the referenced receipt, without warehouse users needing to know or select its bill number (BR-17, BR-22).

US-05 - Return goods that have already been billed

As warehouse staff, I want a return on already billed goods to produce a credit note, so that credit from the supplier has a document basis without changing the bill already in effect.

IDAcceptance criteria
AC-05.1The total and quantity of the Bill that billed those goods do not change after the return is submitted (BR-04).
AC-05.2Exactly one Credit Note in Draft status is formed, with each line’s quantity exactly the same as the return line (BR-09).
AC-05.3The Return stays Submitted while its Credit Note is still in Draft, and moves to Closed by itself when that Credit Note is submitted, without a separate user action (BR-09, BR-12).
AC-05.4The Credit Note number appears as a link in the Return detail and in the list column.
AC-05.5A repeated Return submission, whether due to failure or a double click, never issues a second Credit Note (BR-20).
AC-05.6All prices, discounts, and tax on the returned goods are filled in and adjusted in the Credit Note, not in the Return (BR-13).

US-06 - Reject returns exceeding the quota

As the system, I want to reject a return whose quantity exceeds the quantity actually received, so that stock and bill figures stay consistent.

IDAcceptance criteria
AC-06.1A Return is rejected when the sum of active return quantities on one receipt item exceeds that item’s Received Quantity, before stock changes and before a Credit Note is created (BR-06).
AC-06.2A second, third, and further Return on the same receipt item are still accepted as long as their total stays within the limit (BR-06, BR-20).
AC-06.3A Return that has been Cancelled is not counted as using up the quota (BR-06).
AC-06.4The quantity rejected at receiving can never be returned because it never entered as a Received Quantity (BR-06).
AC-06.5Two Return submissions on the same receipt item happen at the same time — only one passes, and the other is rejected before stock changes (BR-20).

US-07 - Cancel a return

As a PIC, I want to cancel a return that was recorded incorrectly, so that stock goes back to how it was and no credit has been recognized prematurely.

IDAcceptance criteria
AC-07.1The Cancel Return button only appears on Returns in Submitted status for users with the cancel permission in the active store, and is only enabled if the user is the PIC (BR-10, BR-23).
AC-07.2The cancellation dialog requires a reason; the confirm button is disabled while the reason is empty (BR-10).
AC-07.3After cancelling, store stock increases again by the amount previously deducted, and the reason, actor, and time are saved (BR-10).
AC-07.4A Return that has been billed and whose Credit Note is still in Draft — cancellation deletes that Credit Note and restores stock in one action (BR-11).
AC-07.5A Return whose Credit Note has been submitted — the Cancel button is not available because the Return is already Closed (BR-12).
AC-07.6A Return in Draft status has no Cancel action; one that is not used is deleted through the Delete action (BR-10).
AC-07.7A Return in Closed status cannot be cancelled.
AC-07.8A user who is not the PIC opens the Return — the Submit and Cancel buttons appear but are disabled (BR-23).

As an owner, I want to view and filter returns, so that the volume and causes of returns per supplier are visible.

IDAcceptance criteria
AC-08.1By default, the active store’s Returns are shown; advanced filters: store, supplier, return date range, return reason, and status; keyword search.
AC-08.2Columns: return number, store, receipt number, supplier, return date, person in charge, return reason, total return quantity, credit note number, created by, and status.
AC-08.3Default sort by latest return date at the top, with pagination. Sortable columns: return number, return date, and total return quantity.
AC-08.4Rows can be expanded to see the Return’s product list without opening the detail.
AC-08.5Row actions: Print, View, Edit (Draft only), Delete (Draft only), according to permissions.

US-09 - Print a return

As warehouse staff, I want to print a return as a PDF, so that it can travel together with the goods sent back to the supplier.

IDAcceptance criteria
AC-09.1PDF preview is available from the create Return wizard, the detail/edit page, and the Print action in the list, in any status.
AC-09.2Before the Return is saved, the return number on the PDF is shown empty (”-”).
AC-09.3The PDF contains the return reason, supplier return reference, notes, and the list of supporting document names if any, without any financial value (BR-13, BR-14).
AC-09.4The PDF contains the person in charge signature column (the first PIC).

US-10 - Activity history

As an owner, I want to see the return activity log, so that I know who changed what and when.

IDAcceptance criteria
AC-10.1The activity log is available per Return (in the detail) and for all Returns (in the list) (BR-19).

US-11 - Assign the person in charge

As a store manager, I want to assign a PIC on a Return, so that it is clear who is authorized to submit and cancel the return.

IDAcceptance criteria
AC-11.1More than one PIC can be selected from the store’s employee list, when creating a Return, when editing a Draft, or through the add button in the Person in Charge column of the list (BR-23).
AC-11.2The add PIC button in the list only appears on Draft Returns for users with the assign permission in the active store. The assign PIC dialog requires at least one employee (BR-23).
AC-11.3PIC assignment cannot be changed after the Return is submitted (BR-23).

9. User Scenarios

RoleScenario
Warehouse StaffFinds 2 cartons of dented cooking oil while arranging goods from yesterday’s receipt, creates a return referencing that receipt, attaches a photo of the damaged packaging, then submits it before the bill is created so the billed quantity is reduced automatically
Warehouse StaffFinds the remaining problem goods from the same receipt a week later and creates a second return on that receipt, because its quota still has room
Warehouse StaffFinds expired products that have mixed on the shelf from several deliveries, creates a return without a goods receipt, and hands the value matter over to finance staff
Finance StaffReviews the Credit Note in Draft status that was issued from a post-billing return, fills in and matches its value with the supplier’s credit note, then submits it so its return closes by itself
PICA submitted return turns out to have the wrong quantity; cancels it with a reason so stock is restored and its Draft Credit Note is deleted, then creates a new return
OwnerFilters returns across stores by supplier and return reason to assess which suppliers most often deliver problem goods

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionCondition
View Return List
(All Stores)
purchase:purchase-return:list:any—
View Return List
(Assigned Stores)
purchase:purchase-return:list:store—
View Return Detail
(All Stores)
purchase:purchase-return:view:any—
View Return Detail
(Assigned Stores)
purchase:purchase-return:view:store—
Create Returnpurchase:purchase-return:create:storeStore is active
Edit Return
(General Data)
purchase:purchase-return:update:storeStore is active
Delete Returnpurchase:purchase-return:delete:storeStore is active
View Product Detail—Follows the view Return detail permission
Add Productpurchase:purchase-return:update:store
purchase:purchase-return:create:store
Store is active
Edit Productpurchase:purchase-return:update:storeStore is active
Delete Productpurchase:purchase-return:update:store
purchase:purchase-return:delete:store
Store is active
Upload Supporting Documentpurchase:purchase-return:update:storeStore is active
Delete Supporting Documentpurchase:purchase-return:update:store
purchase:purchase-return:delete:store
Store is active
Assign PICpurchase:purchase-return:assign:storeStore is active, from the Return list
Submitpurchase:purchase-return:submit:storeStore is active, user is the PIC
Cancelpurchase:purchase-return:cancel:storeStore is active, user is the PIC

There is no permission for closing a Return: the move to Closed is set by the system (BR-08, BR-09, BR-12), not an action invoked by users.

10.2 Action by Status

ActionDraftSubmittedClosedCancelled
Edit Return
(General Data)
✓———
Delete Return✓———
View Product Detail✓✓✓✓
Add Product✓———
Edit Product✓———
Delete Product✓———
Upload Supporting Document✓———
Delete Supporting Document✓———
Download Supporting Document✓✓✓✓
Assign PIC✓———
Submit✓———
Cancel—✓——
Issue Credit Note—✓——
Preview and Print PDF✓✓✓✓
View Activity Logs✓✓✓✓

11. Notifications

This feature does not trigger any notifications.

12. Dependencies

Related PRDs

  • Goods Receipt — the only document a Return can reference, the source of returnable items along with the Received Quantity that limits their quota (BR-01, BR-06, BR-22).
  • Bill — read by the system to determine whether goods have been billed (BR-17) and the target of quantity adjustment while still in Draft (BR-18); never referenced directly by the Return (BR-22).
  • Credit Note — the financial counterpart of a post-billing return that holds all of its monetary value (BR-13), whose submission closes the Return (BR-09, BR-12), and whose document is deleted if the Return is cancelled (BR-11).

Master data

  • Stores — the active store, store code for numbering, and its active status.
  • Suppliers — the supplier the goods are returned to.
  • Employees — candidates for the Return’s person in charge (PIC) (BR-23).
  • Products & Product Inventory — packages, measurement units, barcodes, and stock per store.
  • File Manager — storage for supporting documents attached to the Return (BR-14).

Effects on other modules

  • Product Inventory — stock decreases when a Return is submitted and increases again when it is cancelled (BR-07, BR-10).
  • Bill — the quantity still billable decreases for returns that reference a receipt (BR-05, BR-21), and Bills in Draft status are recalculated (BR-18).
  • Credit Note — a Credit Note in Draft status is issued automatically for post-billing returns and for all returns without a receipt (BR-09, BR-17).
  • A Return stores a stable transaction identity as the source of stock reduction, so it can become the origin of stock movements if a stock card is built later (BR-07).
  • A Return does not change a product’s average cost (BR-15).
  • Every change is recorded in the activity log (BR-19).
Last updated on