Skip to Content

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

  1. 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.
  2. 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).
  3. 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).
  4. 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.
  5. 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).
  6. 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).
  7. 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).
  8. 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

StatusDescriptionNext
Draft
draft
Issued automatically, awaiting value review and PIC assignmentSubmitted, or deleted if the Return is cancelled
Submitted
submitted
Credit recognized and locked, no Refunds yetPartially Refunded, Refunded
Partially Refunded
partially_refunded
Part of the credit has been returned, the rest is still held by the supplierRefunded, or Submitted if all Refunds are deleted
Refunded
refunded
All of the credit has been returnedPartially 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

FieldTypeRequiredDefaultRules
Credit Note NumberText—Generated on submitSet 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 ReturnRef. Return—The Return that issued itSet by the system, one Return one Credit Note, cannot be changed (BR-02)
StoreRef. Store—The Return’s storeSet by the system, cannot be changed
SupplierRef. Supplier—The Return’s supplierSet by the system, cannot be changed
BillRef. Bill—The Bill that billed the GR Item on the Return lineSet by the system from the returned receipt, not from the Return’s inputs; empty on a Return without a goods receipt (BR-04)
Issue DateDate—When the Return is submittedSet by the system, cannot be changed
Supplier Credit Note NumberTextYes, 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 DateDateNo—The date on the supplier’s document, if different from the Issue Date
Person in Charge (PIC)Ref. Employee, multipleYes, before submittingEmptyStore employees; can only be filled in by holders of the assign permission (BR-13)
Credit Note ProofFile, multipleYes, 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)
NotesTextNo——
General DiscountPercent or Currency, multipleNoOne 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 DiscountMay be more than one, with an optional note; a value of 0 is not saved (BR-14)
General TaxPercent or CurrencyNoThe source Bill’s General Tax; if nominal, in proportion to the returned quantityCalculated from Total Net Price (BR-04)
StatusEnum—DraftSet by the system; see Status Lifecycle

6.2 Line Items

FieldTypeRequiredDefaultRules
Return LineRef. Return Item—The Return line being creditedSet by the system; one Credit Note line for each Return line (BR-03)
Bill ItemRef. Bill Item—The Bill item that billed the GR Item on the Return lineSet by the system; empty if the Return is without a goods receipt (BR-04)
Product (Package)Ref. Store Product Inventory—Follows the Return lineSet by the system, cannot be changed
Measurement UnitText—Follows the Return lineSet by the system
QuantityDecimal—The Return Quantity on the Return lineSet by the system, cannot be changed in any circumstance (BR-03)
Unit PriceCurrencyYes, before submittingThe Bill item’s unit price; empty if the Return is without a goods receiptAt least 1 when submitting; can only be changed while in Draft (BR-05, BR-18)
Percentage DiscountPercent, multipleNoThe Bill item’s percentage discount, as isApplied in sequence according to their order; a value of 0 is not saved (BR-04)
Nominal DiscountCurrency, multipleNoThe Bill item’s nominal discount, in proportion to the returned quantitySubtracted after the Percentage Discounts; a value of 0 is not saved (BR-04)
TaxPercent or CurrencyNoThe Bill item’s tax; if nominal, in proportion to the returned quantityCalculated from the value after discount (BR-04)

6.3 Calculations

FieldFormula
Total Gross PriceSum of (Quantity × Unit Price) across all lines
Total Item DiscountSum of discounts across all lines, applied in sequence per line
Total General DiscountThe whole-document discount on Total Gross Price minus Total Item Discount, applied in sequence (BR-14)
Total Net PriceTotal Gross Price − Total Item Discount − Total General Discount
Total Item TaxSum of tax across all lines, calculated from the value after discount
Total General TaxThe whole-document tax, calculated from Total Net Price
Credit Note TotalTotal Net Price + Total Item Tax + Total General Tax, unrounded; shown in whole rupiah (BR-17)
Credit LimitSum 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 RefundSum of all Refunds recorded on this Credit Note
Remaining CreditCredit 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

ColumnSortableSample ValueComponent
Select——Checkbox, Expand Toggle
No—1Number
Credit Note NumberYesCN/CBI/2026/000007Link, ”-” while in Draft
Store—Cianjur StoreText
Return Number—PR/CBI/2026/000042Link
Supplier—PT Sumber RejekiText
Bill Number—BILL/CBI/2026/000042Link
Issue DateYes24 Sep 2026Date
Supplier Credit Note Number—NK/2026/IX/118Text
Credit Note TotalYesRp 499,500Currency
Total Refund—Rp 200,000Currency
Remaining CreditYesRp 299,500Currency
Person in Charge—Andi, SariAccordion, Add Button
Status—Partially RefundedBadge
Actions—View · EditAction Menu

Expanded Row

ColumnSample ValueComponent
Product (Package)Cooking Oil 2L (Carton)Thumbnail, Text
Quantity2Number
Measurement UnitCartonText
Unit PriceRp 250,000Currency
Gross PriceRp 500,000Currency
DiscountRp 50,000Currency
Net PriceRp 450,000Currency
TaxRp 49,500Currency
Total PriceRp 499,500Currency

7.2 Advance Filter

FieldControlOptions SourceDefault
StoreMulti SelectStores assigned to the userEmpty
Issue Date RangeDate Range Picker—Empty
SupplierMulti SelectSupplier master, searchableEmpty
Person in ChargeMulti SelectStore employees, searchableEmpty
StatusMulti SelectStatus enumEmpty
Only Those with Remaining CreditToggle—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

FieldControlOptions SourceBehavior
Purchase ReturnRead-onlyThe source ReturnShown as a link to the Return detail
BillRead-onlyThe source BillShown as a link; empty if there is none
StoreRead-onlyThe Return’s store—
SupplierRead-onlyThe Return’s supplier—
Issue DateRead-only——
Supplier Credit Note NumberText Input——
Supplier Credit Note DateDate Picker——
Person in Charge (PIC)Multi SelectThe Credit Note store’s employeesCan only be filled in by holders of the assign permission, otherwise read-only; issued empty
Credit Note ProofFile 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
NotesTextarea——
General DiscountPercent 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 TaxNumber Input with a percent or nominal option—Changed → Credit Note Total is recalculated

Products — Table

ColumnSample ValueComponent
Product (Package)Cooking Oil 2L (Carton)Thumbnail, Text
Quantity2Number
Measurement UnitCartonText
Unit PriceRp 250,000Currency
Gross PriceRp 500,000Currency
DiscountRp 50,000Currency
Net PriceRp 450,000Currency
TaxRp 49,500Currency
Total PriceRp 499,500Currency
ActionsEdit, ViewAction Menu

Products — Form

FieldControlOptions SourceBehavior
Product (Package)Read-onlyThe Return line—
QuantityRead-onlyThe Return lineCannot be changed, even while in Draft
Unit PriceCurrency Input—The value on the Bill item is shown as a reference next to the label
Percentage DiscountPercent Input, can be more than one—The row order determines the calculation order
Nominal DiscountCurrency Input, can be more than one——
TaxNumber Input with a percent or nominal option——

Products — Calculations

FieldSample ValueComponent
Total Gross PriceRp 500,000Currency, read-only
Total Item DiscountRp 50,000Currency, read-only
Total General DiscountRp 0Currency, read-only
Total Net PriceRp 450,000Currency, read-only
Total Item TaxRp 49,500Currency, read-only
Total General TaxRp 0Currency, read-only
Credit Note TotalRp 499,500Currency, read-only
Credit LimitRp 499,500Currency, read-only

Total Refund and Remaining Credit are not shown here; they only appear in the Refunds summary.

Refunds — Summary

FieldSample ValueComponent
Credit Note TotalRp 499,500Currency, read-only
Total RefundRp 200,000Currency, read-only
Remaining CreditRp 299,500Currency, 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.

IDAcceptance criteria
AC-01.1A 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.2One Return never produces a second Credit Note, including when its submission is repeated (BR-02).
AC-01.3The 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.4The 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.5The Credit Note is issued without a person in charge and without a number (BR-13).
AC-01.6A 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.7A 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.

IDAcceptance criteria
AC-02.1Unit price, per-product discounts, tax, General Discount, and General Tax can be changed while in Draft status (BR-05).
AC-02.2The 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.3Quantity cannot be changed, even while in Draft, and appears read-only in the form (BR-03).
AC-02.4Changes 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.5A 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.6Users 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.7A 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.8The 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.9The 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.

IDAcceptance criteria
AC-03.1More 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.2The 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.

IDAcceptance criteria
AC-04.1The 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.2After 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.3The source Return moves to Closed status in the same action; if either fails, neither changes (BR-16).
AC-04.4A Submitted Credit Note can receive Refunds; a Draft Credit Note cannot.
AC-04.5Value changes on the Bill after the Credit Note is submitted do not change the Credit Note’s value (BR-06).
AC-04.6The Credit Note has no PIC yet — the Submit button is disabled for all users until a PIC is assigned (BR-13).
AC-04.7A user who is not the PIC opens the Credit Note — the Submit button appears but is disabled (BR-13).
AC-04.8A 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.9A Return without a goods receipt lacking a Supplier Credit Note Number or lacking any Credit Note Proof — submission is rejected (BR-18).
AC-04.10The 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.

IDAcceptance criteria
AC-05.1Cancelling a Return whose Credit Note is still Draft deletes that Credit Note in the same action (BR-07).
AC-05.2There is no direct delete or cancel action on a Credit Note on any screen (BR-07).
AC-05.3A Return whose Credit Note is already Submitted, Partially Refunded, or Refunded cannot be cancelled, so this path is never reached (BR-07).
AC-05.4A deleted Credit Note does not appear in any list and leaves no Cancelled status behind (BR-07).
AC-05.5The 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.

IDAcceptance criteria
AC-06.1A Refund that leaves a Remaining Credit above zero moves the status to Partially Refunded without a separate action (BR-10).
AC-06.2A Refund that brings the Remaining Credit to zero moves the status to Refunded without a separate action (BR-10).
AC-06.3There is no action to change the Partially Refunded or Refunded status manually (BR-10).
AC-06.4A Credit Note in Refunded status cannot receive new Refunds, because its Remaining Credit is already zero (BR-08, BR-10).
AC-06.5A 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).

As finance staff, I want to view and filter Credit Notes, so that I know which credit still has to be claimed from suppliers.

IDAcceptance criteria
AC-07.1By 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.2Columns: 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.3Default 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.4Rows 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.

IDAcceptance criteria
AC-08.1The activity log is available per Credit Note (in the detail) and for all Credit Notes (in the list) (BR-12).
AC-08.2Value adjustments and PIC assignment while in Draft are recorded along with their before and after values (BR-12).
AC-08.3Status 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.

IDAcceptance criteria
AC-09.1The 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.2Added 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.3Files cannot be deleted after the Credit Note is submitted, including newly added files (BR-05, BR-15).
AC-09.4Refunded 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.5The 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.6Adding 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

RoleScenario
Store ManagerAssigns a finance staff member as PIC on a Draft Credit Note that was just issued from a Return
Finance StaffOpens 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 StaffRecords 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 StaffReceives 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
OwnerFilters 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

ActionPermissionCondition
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:storeStore is active
View Product Detail—Follows the view Credit Note detail permission
Edit Product
(Price, Discount, Tax)
purchase:credit-note:update:storeStore is active
Upload Credit Note Proofpurchase:credit-note:update:storeStore is active
Delete Credit Note Proofpurchase:credit-note:update:storeStore is active
Download Credit Note Proof—Follows the view Credit Note detail permission
Assign PIC
(From the List)
purchase:credit-note:assign:storeStore is active, from the Credit Note list
Assign PIC
(From the Edit Form)
purchase:credit-note:update:store
purchase:credit-note:assign:store
Store is active
Submitpurchase:credit-note:submit:storeStore is active, user is the PIC
Record Refundpurchase:refund:create:storeStore is active; see Refund
Delete Refundpurchase:refund:delete:storeStore 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

ActionDraftSubmittedPartially RefundedRefunded
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).
Last updated on