Credit Note
- Code: PUR-CN
- Module: Purchasing
- Type: Transaction
1. Overview
A Credit Note is a document recording the amount of credit a supplier recognizes for goods that were billed and then returned. The Credit Note is the money side of a Purchase Return: the Return records which goods went out, the Credit Note records their value according to the agreement with the supplier. A Credit Note is not created manually — it is issued automatically when a Return on goods that have already been billed is submitted, then reviewed by finance staff before taking effect. Every Credit Note has one or more persons in charge (PIC), who are authorized to submit it. After it is submitted, the money the supplier gives back is recorded as a Refund, all at once or in installments, until it is fully settled.
Expected outcome: every post-billing return has a credit figure that a human has checked before it is recognized, bills already in effect stay intact as they are, and the remaining credit that has not yet come back to the store is visible as a figure that can be claimed from the supplier until fully settled.
2. Problem
Without a Credit Note, a return on goods that were already billed has no financial counterpart. The bill stands at full value while the goods have already gone back to the supplier, and the size of the credit only lives as a verbal agreement between staff and the supplier’s salesperson. As a result:
- There is no official figure for how much the supplier must give back, so claiming it depends on personal notes and memory.
- The return value is immediately treated as final without a chance to be checked, even though the price, discount, and tax agreed for the credit often differ from what was billed.
- Credit that has been partially returned cannot be told apart from credit still hanging in full, so credit reports to suppliers cannot be trusted.
- Money returned by a supplier has no parent document limiting its amount, so nothing prevents recording more than the credit recognized.
3. Goals & Non-goals
3.1 Goals
- Every post-billing return produces exactly one credit document, without anyone needing to remember or create it manually.
- The credit value is checked and can be adjusted by finance staff before it is recognized, without ever changing the quantity of goods already returned.
- It is clear who is responsible for submitting each Credit Note, and evidence from the supplier is stored attached to its document.
- Bills already in effect stay intact; correcting their value is represented by the Credit Note, not by rewriting the bill.
- The remaining credit that has not come back to the store can always be read as a figure, and the Credit Note’s status follows by itself whether its credit has not been, been partially, or been fully returned.
3.2 Non-goals
- Settling credit through deductions by the supplier from a later bill, whether automatic or marked manually by finance staff. V1 only closes credit through Refunds; settlement through bill deductions will be discussed when this feature is refined later.
- More than one Credit Note for one Return; the relationship is always one to one.
- Creating Credit Notes manually, independent of a Return.
- Correcting a Credit Note that has been submitted; corrections are handled through a separate financial correction mechanism that has not been built yet.
- A complete supplier payables (Accounts Payable) module, including credit aging and expiry.
4. Business Rules
Business rules are the set of provisions and constraints that apply to Credit Notes 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 A Credit Note is only issued from a Return on goods that have already been billed. A Return on goods not yet billed never produces a Credit Note.
- BR-02 One Return has at most one Credit Note. A repeated Return submission, or one happening at the same time, never issues a second Credit Note, because its issuance is tied to the Return submission, which cannot be interrupted.
- BR-03 The quantity of every Credit Note line is always exactly the same as the source Return line, and the number of lines is the same too. Quantity cannot be changed from the Credit Note in any circumstance; correcting quantity is the Return’s business.
- BR-04 The Credit Note’s financial value is taken from the Bill item that billed those goods, which the system finds through the GR Item on the Return line: its unit price, discounts, and tax, with the same two-level tax structure as the Bill. Percentage values are copied as they are, while nominal discounts, nominal tax, and nominal General Tax are copied in proportion to quantity, namely the Bill value × (Credit Note Quantity ÷ Bill Quantity), because the Bill’s nominal values apply to the entire billed quantity. The Return itself never stores a Bill reference. On a Return without a goods receipt there is no GR Item, so the Bill item cannot be determined, and all values are filled in manually.
- BR-05 Financial values, General Discount, persons in charge, and Credit Note proof can only be changed while the Credit Note is in Draft status. After it is submitted, all of its content is locked, except for adding Credit Note proof (BR-15).
- BR-06 A Credit Note that has been submitted is never changed to adjust for changes in the Return or Bill, and conversely a Return that has been submitted is never changed to match its Credit Note.
- BR-07 A Credit Note in Draft status is deleted together when its Return is cancelled, because its credit has never been recognized so there is nothing to keep as a record. This deletion is recorded in the Return’s activity log. Deletion can never be done directly on a Credit Note, and a Credit Note in Submitted, Partially Refunded, or Refunded status can neither be deleted nor cancelled.
- BR-08 The Remaining Credit is always derived from the Credit Note Total minus the sum of all recorded Refunds. If stored, its value is only a copy recalculated from all remaining Refunds every time a Refund is recorded or deleted, by the single writer, and is never changed in any other way. The Refund amount must not exceed the Credit Note Total, so the Remaining Credit is never negative.
- BR-09 The Credit Note Total must not exceed the Credit Limit. The Credit Limit is the sum, across all lines, of the per-unit value of the Bill item after discounts and tax — including the portion of the Bill’s General Discount and General Tax allocated to that item — multiplied by the returned quantity. The limit applies to the document, not per line: finance staff may raise one line’s price and lower another’s as long as the Credit Note Total stays within the limit. On a Return without a goods receipt, the source Bill item is unknown, so the Credit Limit uses the average cost of the store’s product inventory multiplied by the returned quantity.
- BR-10 The Partially Refunded and Refunded statuses are set automatically from the amount of Refunds recorded: a Refund with the Remaining Credit still above zero becomes Partially Refunded, a Remaining Credit of zero becomes Refunded. This status cannot be changed manually.
- BR-11 Every time a Refund is deleted, the Remaining Credit and Credit Note status are recalculated: if Refunds remain it becomes Partially Refunded, if no Refunds remain it returns to Submitted. This also applies to a Credit Note that is already Refunded.
- BR-12 Every data change and status transition of a Credit Note is recorded along with its actor and time, including recording and deleting Refunds and the status changes they cause.
- BR-13 Every Credit Note must have a person in charge (PIC) before it can be submitted. A Credit Note is issued without a PIC because it is issued by the system, and its PIC is assigned by a holder of the assign permission while in Draft. Submitting a Credit Note may only be done by a PIC assigned to that Credit Note who has the permission for that action.
- BR-14 The General Discount may be more than one, each with an optional note, and is applied in sequence on the Total Gross Price minus the Total Item Discount. The Bill’s General Discount is not copied as is, because it applies to the entire bill, not to part of the returned goods. Instead, the Credit Note is issued with one nominal General Discount noted “Bill discount allocation”, worth the portion of the Bill’s General Discount allocated to the returned goods, so its initial value does not exceed the Credit Limit (BR-09). This discount may be changed or removed while in Draft. A value of 0 is not saved.
- BR-15 A Credit Note may attach Credit Note proof from the supplier as more than one file, or attach nothing; attachments are only evidence and do not affect the Credit Note’s status, except on a Return without a goods receipt (BR-18). The number of files is not limited; each is at most 2 MB, of type PDF, JPG, JPEG, PNG, or WEBP. Because supplier documents often arrive late, proof may be added while the Credit Note is Draft, Submitted, or Partially Refunded, but no longer once it is Refunded. Files can only be deleted while in Draft; after submission, every attached file, including those added later, is locked. An addition is re-checked against the latest status, so it is rejected if the Credit Note is already Refunded when saved, and it changes neither the Credit Note’s values nor its status.
- BR-16 Submitting a Credit Note and closing its source Return to Closed happen together or not at all. Submitting a Credit Note and cancelling its source Return cancel each other out: if both happen at the same time, only the one that completes first succeeds, and the other is rejected after rechecking the latest status. Changing a Credit Note’s values is also rechecked against the latest status, so no change is saved after the Credit Note is submitted.
- BR-17 The Total Price of every line and the Credit Note Total are calculated and stored as they are, without rounding by the system. Rounding to whole rupiah, half up, is for display only. The Remaining Credit and all comparisons against Refunds use the unrounded values.
- BR-18 A Credit Note can only be submitted if every Unit Price is at least 1, the Total Discount does not exceed the Total Gross Price, and the Credit Note Total is greater than 0. While in Draft these values may be incomplete. On a Return without a goods receipt, the Supplier Credit Note Number and at least one Credit Note Proof are also required before submitting.
5. Flow
5.1 Main Flowchart
- Purchase Return submitted, post-billing — A Return on goods that have already been billed is submitted, and the system issues one Credit Note for it without a PIC (BR-01, BR-02, BR-13). The details are explained in a separate PRD.
- Draft — The Credit Note’s initial status. Its quantities are already locked to follow the Return, while its financial values are still awaiting finance staff’s review.
- 2a. Adjust Financial Values — Unit price, discounts, tax, and General Discount are adjusted to match the credit note issued by the supplier, as long as they do not exceed the billed value; the supplier’s credit note proof may be attached (BR-05, BR-09, BR-14, BR-15).
- 2b. Assign PIC — One or more store employees are assigned as the person in charge. The Credit Note stays in Draft, and this assignment is required before the Credit Note can be submitted (BR-13).
- Submitted — Done by the PIC, after its values are complete and the Credit Note Total is above zero (BR-18). The credit is recognized, its content is locked except for adding Credit Note proof (BR-15), and its number is assigned. In the same action the source Return becomes Closed, so it can no longer be cancelled, and the Credit Note can receive Refunds (BR-16).
- Refund recorded or deleted — Money actually returned by the supplier is recorded as a Refund against this Credit Note, all at once or in installments; a Refund recorded by mistake is deleted. The details are explained in a separate PRD.
- Check Remaining Credit — Every time a Refund is recorded or deleted, the Total Refund and Remaining Credit are recalculated to determine the Credit Note’s next status. If all Refunds have been deleted, the status returns to Submitted (BR-08, BR-10, BR-11).
- Partially Refunded — Part of the credit has been returned and the rest is still held by the supplier. The next Refund is processed as in step 4, and late-arriving Credit Note proof can still be added (BR-15).
- Refunded — All of the credit has been returned and the Credit Note stops accepting new Refunds. Refunds already recorded can still be deleted, and the status is recalculated as in step 5 (BR-11).
- Deleted — A Draft Credit Note is deleted along with its source Return being cancelled; credit that was never recognized leaves no document behind (BR-07).
5.2 Status Lifecycle
| Status | Description | Next |
|---|---|---|
Draftdraft | Issued automatically, awaiting value review and PIC assignment | Submitted, or deleted if the Return is cancelled |
Submittedsubmitted | Credit recognized and locked, no Refunds yet | Partially Refunded, Refunded |
Partially Refundedpartially_refunded | Part of the credit has been returned, the rest is still held by the supplier | Refunded, or Submitted if all Refunds are deleted |
Refundedrefunded | All of the credit has been returned | Partially Refunded or Submitted, if Refunds are deleted |
6. Document Structure
This section defines the content of the Credit Note document itself: which fields it has, their type, which are required, their initial values, their value rules, and their calculation formulas. The provisions here apply wherever the Credit Note is created or changed and are enforced on save, regardless of how the field is displayed.
6.1 General
| Field | Type | Required | Default | Rules |
|---|---|---|---|---|
| Credit Note Number | Text | — | Generated on submit | Set by the system in the format CN/{Store Code}/{Year}/{000000}, cannot be changed; empty while in Draft so that a deleted Draft Credit Note does not leave a gap in numbering (BR-07) |
| Purchase Return | Ref. Return | — | The Return that issued it | Set by the system, one Return one Credit Note, cannot be changed (BR-02) |
| Store | Ref. Store | — | The Return’s store | Set by the system, cannot be changed |
| Supplier | Ref. Supplier | — | The Return’s supplier | Set by the system, cannot be changed |
| Bill | Ref. Bill | — | The Bill that billed the GR Item on the Return line | Set by the system from the returned receipt, not from the Return’s inputs; empty on a Return without a goods receipt (BR-04) |
| Issue Date | Date | — | When the Return is submitted | Set by the system, cannot be changed |
| Supplier Credit Note Number | Text | Yes, before submitting if the Return is without a goods receipt | — | The number of the credit document issued by the supplier, used by finance staff to match (BR-18) |
| Supplier Credit Note Date | Date | No | — | The date on the supplier’s document, if different from the Issue Date |
| Person in Charge (PIC) | Ref. Employee, multiple | Yes, before submitting | Empty | Store employees; can only be filled in by holders of the assign permission (BR-13) |
| Credit Note Proof | File, multiple | Yes, before submitting if the Return is without a goods receipt | — | Images or documents, for example a photo of the supplier’s credit note; no limit on the number of files, 2 MB each, PDF/JPG/JPEG/PNG/WEBP; can be added until Refunded, deleted only while in Draft (BR-15, BR-18) |
| Notes | Text | No | — | — |
| General Discount | Percent or Currency, multiple | No | One nominal “Bill discount allocation” discount worth the portion of the Bill’s General Discount for the returned goods; empty if the Bill has no General Discount | May be more than one, with an optional note; a value of 0 is not saved (BR-14) |
| General Tax | Percent or Currency | No | The source Bill’s General Tax; if nominal, in proportion to the returned quantity | Calculated from Total Net Price (BR-04) |
| Status | Enum | — | Draft | Set by the system; see Status Lifecycle |
6.2 Line Items
| Field | Type | Required | Default | Rules |
|---|---|---|---|---|
| Return Line | Ref. Return Item | — | The Return line being credited | Set by the system; one Credit Note line for each Return line (BR-03) |
| Bill Item | Ref. Bill Item | — | The Bill item that billed the GR Item on the Return line | Set by the system; empty if the Return is without a goods receipt (BR-04) |
| Product (Package) | Ref. Store Product Inventory | — | Follows the Return line | Set by the system, cannot be changed |
| Measurement Unit | Text | — | Follows the Return line | Set by the system |
| Quantity | Decimal | — | The Return Quantity on the Return line | Set by the system, cannot be changed in any circumstance (BR-03) |
| Unit Price | Currency | Yes, before submitting | The Bill item’s unit price; empty if the Return is without a goods receipt | At least 1 when submitting; can only be changed while in Draft (BR-05, BR-18) |
| Percentage Discount | Percent, multiple | No | The Bill item’s percentage discount, as is | Applied in sequence according to their order; a value of 0 is not saved (BR-04) |
| Nominal Discount | Currency, multiple | No | The Bill item’s nominal discount, in proportion to the returned quantity | Subtracted after the Percentage Discounts; a value of 0 is not saved (BR-04) |
| Tax | Percent or Currency | No | The Bill item’s tax; if nominal, in proportion to the returned quantity | Calculated from the value after discount (BR-04) |
6.3 Calculations
| Field | Formula |
|---|---|
| Total Gross Price | Sum of (Quantity × Unit Price) across all lines |
| Total Item Discount | Sum of discounts across all lines, applied in sequence per line |
| Total General Discount | The whole-document discount on Total Gross Price minus Total Item Discount, applied in sequence (BR-14) |
| Total Net Price | Total Gross Price − Total Item Discount − Total General Discount |
| Total Item Tax | Sum of tax across all lines, calculated from the value after discount |
| Total General Tax | The whole-document tax, calculated from Total Net Price |
| Credit Note Total | Total Net Price + Total Item Tax + Total General Tax, unrounded; shown in whole rupiah (BR-17) |
| Credit Limit | Sum of (the Bill item’s per-unit value after discounts, tax, and the allocation of the Bill’s General Discount and General Tax × Quantity) across all lines; on a Return without a goods receipt, the sum of (the inventory’s average cost × Quantity) (BR-09) |
| Total Refund | Sum of all Refunds recorded on this Credit Note |
| Remaining Credit | Credit Note Total − Total Refund (BR-08) |
7. UI Structure
This section defines how Credit Notes are displayed and operated: the list columns, filters, and form controls along with their option sources. This section only governs display and interaction; content and value rules still follow Document Structure. A Credit Note has no PDF because its official document is issued by the supplier, not the store.
7.1 Datatable
| Column | Sortable | Sample Value | Component |
|---|---|---|---|
| Select | — | — | Checkbox, Expand Toggle |
| No | — | 1 | Number |
| Credit Note Number | Yes | CN/CBI/2026/000007 | Link, ”-” while in Draft |
| Store | — | Cianjur Store | Text |
| Return Number | — | PR/CBI/2026/000042 | Link |
| Supplier | — | PT Sumber Rejeki | Text |
| Bill Number | — | BILL/CBI/2026/000042 | Link |
| Issue Date | Yes | 24 Sep 2026 | Date |
| Supplier Credit Note Number | — | NK/2026/IX/118 | Text |
| Credit Note Total | Yes | Rp 499,500 | Currency |
| Total Refund | — | Rp 200,000 | Currency |
| Remaining Credit | Yes | Rp 299,500 | Currency |
| Person in Charge | — | Andi, Sari | Accordion, Add Button |
| Status | — | Partially Refunded | Badge |
| Actions | — | View · Edit | Action Menu |
Expanded Row
| Column | Sample Value | Component |
|---|---|---|
| Product (Package) | Cooking Oil 2L (Carton) | Thumbnail, Text |
| Quantity | 2 | Number |
| Measurement Unit | Carton | Text |
| Unit Price | Rp 250,000 | Currency |
| Gross Price | Rp 500,000 | Currency |
| Discount | Rp 50,000 | Currency |
| Net Price | Rp 450,000 | Currency |
| Tax | Rp 49,500 | Currency |
| Total Price | Rp 499,500 | Currency |
7.2 Advance Filter
| Field | Control | Options Source | Default |
|---|---|---|---|
| Store | Multi Select | Stores assigned to the user | Empty |
| Issue Date Range | Date Range Picker | — | Empty |
| Supplier | Multi Select | Supplier master, searchable | Empty |
| Person in Charge | Multi Select | Store employees, searchable | Empty |
| Status | Multi Select | Status enum | Empty |
| Only Those with Remaining Credit | Toggle | — | Off |
7.3 Form & Details
Edit — Two tabs, General and Products. Only financial values and their completeness are active: unit price, discounts, and tax per product, plus General Discount, General Tax, supplier credit note number and date, persons in charge, credit note proof, and notes. Quantities, products, and all document references are shown read-only. Only available while the Credit Note is in Draft. Actions: Save, assign PIC, upload and delete credit note proof. There is no Create mode: a Credit Note is always issued by the system from a Return.
Detail — The Credit Note Number, status badge, and status stepper at the top, followed by links to the source Return and Bill, then read-only General, Products, and Refunds tabs (disabled while in Draft). Credit note proof appears as a list of downloadable files. Actions: Edit Data, Submit, Add Credit Note Proof, Add Refund, and Activity Logs, each appearing according to the Credit Note status. Add Credit Note Proof is available while Submitted and Partially Refunded, opening a File Uploader for new files with no delete action on existing files (BR-15). The Submit button is still shown to users who are not the PIC, but in a disabled state (BR-13).
General
| Field | Control | Options Source | Behavior |
|---|---|---|---|
| Purchase Return | Read-only | The source Return | Shown as a link to the Return detail |
| Bill | Read-only | The source Bill | Shown as a link; empty if there is none |
| Store | Read-only | The Return’s store | — |
| Supplier | Read-only | The Return’s supplier | — |
| Issue Date | Read-only | — | — |
| Supplier Credit Note Number | Text Input | — | — |
| Supplier Credit Note Date | Date Picker | — | — |
| Person in Charge (PIC) | Multi Select | The Credit Note store’s employees | Can only be filled in by holders of the assign permission, otherwise read-only; issued empty |
| Credit Note Proof | File Uploader, multiple | — | Optional, except for a Return without a goods receipt; files already uploaded appear as a list that can be deleted while in Draft; after submission, new files are added through the Add Credit Note Proof action in Detail |
| Notes | Textarea | — | — |
| General Discount | Percent Input and Currency Input, can be more than one | — | Rows are added/removed; each may come with a note. Changed → Credit Note Total is recalculated |
| General Tax | Number Input with a percent or nominal option | — | Changed → Credit Note Total is recalculated |
Products — Table
| Column | Sample Value | Component |
|---|---|---|
| Product (Package) | Cooking Oil 2L (Carton) | Thumbnail, Text |
| Quantity | 2 | Number |
| Measurement Unit | Carton | Text |
| Unit Price | Rp 250,000 | Currency |
| Gross Price | Rp 500,000 | Currency |
| Discount | Rp 50,000 | Currency |
| Net Price | Rp 450,000 | Currency |
| Tax | Rp 49,500 | Currency |
| Total Price | Rp 499,500 | Currency |
| Actions | Edit, View | Action Menu |
Products — Form
| Field | Control | Options Source | Behavior |
|---|---|---|---|
| Product (Package) | Read-only | The Return line | — |
| Quantity | Read-only | The Return line | Cannot be changed, even while in Draft |
| Unit Price | Currency Input | — | The value on the Bill item is shown as a reference next to the label |
| Percentage Discount | Percent Input, can be more than one | — | The row order determines the calculation order |
| Nominal Discount | Currency Input, can be more than one | — | — |
| Tax | Number Input with a percent or nominal option | — | — |
Products — Calculations
| Field | Sample Value | Component |
|---|---|---|
| Total Gross Price | Rp 500,000 | Currency, read-only |
| Total Item Discount | Rp 50,000 | Currency, read-only |
| Total General Discount | Rp 0 | Currency, read-only |
| Total Net Price | Rp 450,000 | Currency, read-only |
| Total Item Tax | Rp 49,500 | Currency, read-only |
| Total General Tax | Rp 0 | Currency, read-only |
| Credit Note Total | Rp 499,500 | Currency, read-only |
| Credit Limit | Rp 499,500 | Currency, read-only |
Total Refund and Remaining Credit are not shown here; they only appear in the Refunds summary.
Refunds — Summary
| Field | Sample Value | Component |
|---|---|---|
| Credit Note Total | Rp 499,500 | Currency, read-only |
| Total Refund | Rp 200,000 | Currency, read-only |
| Remaining Credit | Rp 299,500 | Currency, read-only |
The list of recorded Refunds (Refund 1, 2, etc.) is shown as cards below this summary, each with a Delete action. Their fields and rules are explained in Refund.
8. User Stories
US-01 - Issue a Credit Note automatically
As the system, I want to issue one Draft Credit Note as soon as a post-billing return is submitted, so that finance staff always have a document to review without having to remember to create it.
| ID | Acceptance criteria |
|---|---|
| AC-01.1 | A Credit Note is only issued from a Return on goods that have already been billed; a pre-billing return produces nothing (BR-01). |
| AC-01.2 | One Return never produces a second Credit Note, including when its submission is repeated (BR-02). |
| AC-01.3 | The quantity of each Credit Note line is exactly the same as the Return line, and the number of lines is the same (BR-03). |
| AC-01.4 | The unit price, percentage discount, and percentage tax are filled from the Bill item that billed those goods; the General Discount is filled with one “Bill discount allocation” row worth the portion of the Bill’s General Discount for the returned goods, or empty if the Bill has no General Discount (BR-04, BR-14). |
| AC-01.5 | The Credit Note is issued without a person in charge and without a number (BR-13). |
| AC-01.6 | A Return without a goods receipt — the source Bill item cannot be determined, so the Unit Price is issued empty and filled in manually, with the Credit Limit from the inventory’s average cost (BR-04, BR-09). |
| AC-01.7 | A Bill item with a nominal discount or tax and only part of its quantity returned — that nominal value is filled in proportion to the quantity, for example a Rp 20,000 discount on quantity 10 becomes Rp 2,000 for a return of quantity 1 (BR-04). |
US-02 - Review and adjust the credit value
As finance staff, I want to adjust prices, discounts, and tax before submitting, so that the recognized credit equals what is written on the supplier’s credit note.
| ID | Acceptance criteria |
|---|---|
| AC-02.1 | Unit price, per-product discounts, tax, General Discount, and General Tax can be changed while in Draft status (BR-05). |
| AC-02.2 | The General Discount can be added as more than one row, percent or nominal, each with an optional note, and the Credit Note Total is recalculated every time it changes (BR-14). |
| AC-02.3 | Quantity cannot be changed, even while in Draft, and appears read-only in the form (BR-03). |
| AC-02.4 | Changes are rejected after the Credit Note is submitted, except for adding Credit Note proof (BR-15); opening the edit URL on a non-Draft Credit Note returns the user to the detail view (BR-05). |
| AC-02.5 | A Credit Note Total exceeding the Credit Limit is rejected on save, with a message mentioning the Credit Limit; raising one line’s price is still accepted as long as the Credit Note Total stays within the limit (BR-09). |
| AC-02.6 | Users can upload any number of credit note proofs, each at most 2 MB of type PDF, JPG, JPEG, PNG, or WEBP, and can save without uploading any file; files already uploaded can be deleted while in Draft (BR-15). |
| AC-02.7 | A Return without a goods receipt — the Credit Limit is calculated from the store product inventory’s average cost multiplied by the returned quantity (BR-09). |
| AC-02.8 | The Total Price of every line and the Credit Note Total are stored unrounded and shown in whole rupiah, rounded half up (BR-17). |
| AC-02.9 | The Credit Note is submitted by another user while a change is being saved — the change is rejected because the Credit Note is no longer Draft (BR-16). |
US-03 - Assign the person in charge
As a store manager, I want to assign a PIC on a Credit Note, so that it is clear who is authorized to submit the credit.
| ID | Acceptance criteria |
|---|---|
| AC-03.1 | More than one PIC can be selected from the store’s employee list, when editing a Draft or through the add button in the Person in Charge column of the list (BR-13). |
| AC-03.2 | The add PIC button in the list only appears on Draft Credit Notes for users with the assign permission in the active store (BR-05, BR-13). |
US-04 - Submit a Credit Note
As a PIC, I want to submit a Credit Note that has been checked, so that the credit is officially recognized and its source return can be closed.
| ID | Acceptance criteria |
|---|---|
| AC-04.1 | The Submit Credit Note button appears on Draft Credit Notes for users with the submit permission in the active store, and is only enabled if the user is that Credit Note’s PIC (BR-13). |
| AC-04.2 | After confirmation, the status becomes Submitted, the Credit Note Number is assigned, all content is locked except for adding Credit Note proof, and who submitted it and when are recorded (BR-05, BR-12, BR-15). |
| AC-04.3 | The source Return moves to Closed status in the same action; if either fails, neither changes (BR-16). |
| AC-04.4 | A Submitted Credit Note can receive Refunds; a Draft Credit Note cannot. |
| AC-04.5 | Value changes on the Bill after the Credit Note is submitted do not change the Credit Note’s value (BR-06). |
| AC-04.6 | The Credit Note has no PIC yet — the Submit button is disabled for all users until a PIC is assigned (BR-13). |
| AC-04.7 | A user who is not the PIC opens the Credit Note — the Submit button appears but is disabled (BR-13). |
| AC-04.8 | A Unit Price below 1, a Total Discount exceeding the Total Gross Price, or a Credit Note Total of zero — submission is rejected with a message pointing to the incomplete part (BR-18). |
| AC-04.9 | A Return without a goods receipt lacking a Supplier Credit Note Number or lacking any Credit Note Proof — submission is rejected (BR-18). |
| AC-04.10 | The Credit Note is submitted at the same time as its source Return is cancelled — only one succeeds; if submission comes first, cancellation is rejected because the Return is already Closed, and if cancellation comes first, submission is rejected because the Credit Note has been deleted (BR-16). |
US-05 - Deletion follows the Return
As the system, I want to delete a Draft Credit Note when its source Return is cancelled, so that no credit is left hanging without goods.
| ID | Acceptance criteria |
|---|---|
| AC-05.1 | Cancelling a Return whose Credit Note is still Draft deletes that Credit Note in the same action (BR-07). |
| AC-05.2 | There is no direct delete or cancel action on a Credit Note on any screen (BR-07). |
| AC-05.3 | A Return whose Credit Note is already Submitted, Partially Refunded, or Refunded cannot be cancelled, so this path is never reached (BR-07). |
| AC-05.4 | A deleted Credit Note does not appear in any list and leaves no Cancelled status behind (BR-07). |
| AC-05.5 | The Credit Note’s deletion is recorded in the Return’s activity log along with its actor and time (BR-07). |
US-06 - Automatic refund status
As finance staff, I want the Credit Note status to follow by itself the amount of money the supplier has returned, so that it is immediately visible which credit has not been, been partially, or been fully refunded.
| ID | Acceptance criteria |
|---|---|
| AC-06.1 | A Refund that leaves a Remaining Credit above zero moves the status to Partially Refunded without a separate action (BR-10). |
| AC-06.2 | A Refund that brings the Remaining Credit to zero moves the status to Refunded without a separate action (BR-10). |
| AC-06.3 | There is no action to change the Partially Refunded or Refunded status manually (BR-10). |
| AC-06.4 | A Credit Note in Refunded status cannot receive new Refunds, because its Remaining Credit is already zero (BR-08, BR-10). |
| AC-06.5 | A Refund is deleted — the Remaining Credit is recalculated, and the status becomes Partially Refunded if Refunds remain, or Submitted if there are none left, including from Refunded (BR-11). |
US-07 - Credit Note list and search
As finance staff, I want to view and filter Credit Notes, so that I know which credit still has to be claimed from suppliers.
| ID | Acceptance criteria |
|---|---|
| AC-07.1 | By default, the active store’s Credit Notes are shown; advanced filters: store, supplier, issue date range, person in charge, status, and only those with remaining credit; keyword search. |
| AC-07.2 | Columns: credit note number, store, return number, supplier, bill number, issue date, supplier credit note number, credit note total, total refund, remaining credit, person in charge, and status. |
| AC-07.3 | Default sort by latest issue date at the top, with pagination. Sortable columns: credit note number, issue date, credit note total, and remaining credit. |
| AC-07.4 | Rows can be expanded to see the product list without opening the detail. |
US-08 - Activity history
As an owner, I want to see the Credit Note activity log, so that I know who changed values and when the credit was recognized.
| ID | Acceptance criteria |
|---|---|
| AC-08.1 | The activity log is available per Credit Note (in the detail) and for all Credit Notes (in the list) (BR-12). |
| AC-08.2 | Value adjustments and PIC assignment while in Draft are recorded along with their before and after values (BR-12). |
| AC-08.3 | Status transitions caused by Refunds being recorded or deleted are recorded along with their actor and time (BR-12). |
US-09 - Completing proof after submission
As finance staff, I want to add Credit Note proof after the Credit Note is submitted, so that supplier documents that arrive late are still kept attached to their Credit Note.
| ID | Acceptance criteria |
|---|---|
| AC-09.1 | The Add Credit Note Proof button appears on the detail of a Submitted or Partially Refunded Credit Note for users with the update permission in the active store (BR-15). |
| AC-09.2 | Added files follow the same types and sizes, with no limit on their number; files of another type or larger than 2 MB are rejected (BR-15). |
| AC-09.3 | Files cannot be deleted after the Credit Note is submitted, including newly added files (BR-05, BR-15). |
| AC-09.4 | Refunded Credit Note — the button is not shown; it appears again if the status returns to Partially Refunded or Submitted because a Refund is deleted (BR-11, BR-15). |
| AC-09.5 | The Credit Note becomes Refunded while an addition is being saved — the addition is rejected because the Credit Note is already Refunded (BR-15). |
| AC-09.6 | Adding proof changes neither the Credit Note’s values nor its status, and is recorded in the activity log along with its actor and time (BR-12, BR-15). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Store Manager | Assigns a finance staff member as PIC on a Draft Credit Note that was just issued from a Return |
| Finance Staff | Opens a Draft Credit Note, matches its value against the paper credit note from the supplier, adds a general discount and lowers its tax so they match, attaches a photo of the supplier’s credit note, then submits it as the PIC |
| Finance Staff | Records the supplier’s money returns bit by bit on the same Credit Note, sees its status become Partially Refunded, then move by itself to Refunded when the remaining credit is used up |
| Finance Staff | Receives the supplier’s paper credit note only after the Credit Note is Partially Refunded, then attaches a photo of it through Add Credit Note Proof on the detail |
| Owner | Filters Credit Notes across stores that still have a remainder to chase suppliers that have not returned their credit |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Condition |
|---|---|---|
| View Credit Note List (All Stores) | purchase:credit-note:list:any | — |
| View Credit Note List (Assigned Stores) | purchase:credit-note:list:store | — |
| View Credit Note Detail (All Stores) | purchase:credit-note:view:any | — |
| View Credit Note Detail (Assigned Stores) | purchase:credit-note:view:store | — |
| Edit Data (General Data, General Discount and Tax) | purchase:credit-note:update:store | Store is active |
| View Product Detail | — | Follows the view Credit Note detail permission |
| Edit Product (Price, Discount, Tax) | purchase:credit-note:update:store | Store is active |
| Upload Credit Note Proof | purchase:credit-note:update:store | Store is active |
| Delete Credit Note Proof | purchase:credit-note:update:store | Store is active |
| Download Credit Note Proof | — | Follows the view Credit Note detail permission |
| Assign PIC (From the List) | purchase:credit-note:assign:store | Store is active, from the Credit Note list |
| Assign PIC (From the Edit Form) | purchase:credit-note:update:storepurchase:credit-note:assign:store | Store is active |
| Submit | purchase:credit-note:submit:store | Store is active, user is the PIC |
| Record Refund | purchase:refund:create:store | Store is active; see Refund |
| Delete Refund | purchase:refund:delete:store | Store is active; see Refund |
| View Activity Logs | — | Follows the view Credit Note detail permission |
There are no create, delete, or cancel permissions: a Credit Note is always issued by the system (BR-01) and its deletion follows the Return’s cancellation (BR-07). The moves to Partially Refunded and Refunded have no permission of their own because they are set by the system (BR-10). A user with the update permission but without the assign permission can still save the Edit form, but their PIC input is ignored.
10.2 Action by Status
| Action | Draft | Submitted | Partially Refunded | Refunded |
|---|---|---|---|---|
| Edit Data (General Data, General Discount and Tax) | ✓ | — | — | — |
| View Product Detail | ✓ | ✓ | ✓ | ✓ |
| Edit Product (Price, Discount, Tax) | ✓ | — | — | — |
| Upload Credit Note Proof | ✓ | ✓ | ✓ | — |
| Delete Credit Note Proof | ✓ | — | — | — |
| Download Credit Note Proof | ✓ | ✓ | ✓ | ✓ |
| Assign PIC (From the List) | ✓ | — | — | — |
| Assign PIC (From the Edit Form) | ✓ | — | — | — |
| Submit | ✓ | — | — | — |
| Record Refund | — | ✓ | ✓ | — |
| Delete Refund | — | — | ✓ | ✓ |
| Deleted along with the Return | ✓ | — | — | — |
| View Activity Logs | ✓ | ✓ | ✓ | ✓ |
11. Notifications
This feature does not trigger any notifications.
12. Dependencies
Related PRDs
- Purchase Return — the sole issuer of Credit Notes, the source of their line quantities, the path to the Bill item through the GR Item, and the source of their deletion (BR-01, BR-03, BR-04, BR-07).
- Bill — the default source of financial values and the Credit Limit (BR-04, BR-09). A Bill that has left Draft never changes, so this reference is stable; if bill cancellation or revision is ever added, its effect on Credit Notes already issued must be determined first in both PRDs.
- Refund — recording the money actually returned by the supplier, which reduces the Remaining Credit and determines the Partially Refunded or Refunded status (BR-08, BR-10, BR-11).
Master data
- Stores — the active store, active status, and employees (PIC) (BR-13).
- Suppliers — the supplier recognizing the credit.
- Products & Product Inventory — packages and measurement units carried over from Return lines.
- File Manager — storage for attached credit note proof (BR-15).
Effects on other modules
- Purchase Return — the source Return moves to Closed when the Credit Note is submitted, in the same action (BR-16). Post-billing Returns already submitted before this feature goes live have their Draft Credit Note issued once at release, so they can be reviewed and close their Return as usual.
- Product Inventory — its average cost becomes the basis of the Credit Limit on a Return without a goods receipt (BR-09), without being changed by the Credit Note.
- A Credit Note does not change stock and does not change any Bill.
- Finance — the Remaining Credit of all Credit Notes becomes the basis for monitoring credit not yet returned by suppliers.
- Every change is recorded in the activity log (BR-12).