Sales #credit-notes #sales #adjustments #refunds #ar #allocations Raw .md

Sales Credit Notes

Issue credit notes for returns or billing adjustments and allocate credits to open customer invoices.

Routes: /sales-credit-notes /sales-credit-notes/:id

Sales Credit Notes

The Credit Notes module handles negative customer balances resulting from sales returns, pricing adjustments, or commercial goodwill credits.


Business Logic & Allocation Mechanics

1. General Ledger Postings

Posting a Sales Credit Note immediately creates a balanced double-entry transaction in the General Ledger:

Debit:  Sales Revenue / Sales Returns Account   (Reduces reported revenue)
Debit:  Output Tax Liability (Tax Payable)      (Reverses previously recognized tax)
Credit: Accounts Receivable Control Account     (Reduces customer outstanding balance)

2. Credit Allocation Equation & Subledger Balance

Credit notes can either be linked to a specific originating invoice or created standalone:

Invoice Outstanding Balance = Invoice Gross Total - Allocated Payments - Allocated Credit Notes
Credit Note Unallocated Amount = Credit Note Gross Total - Sum(Allocated Amounts to Invoices)
  • Allocation Impact: Allocating a credit note to an open invoice is an operational subledger matching action. Because Accounts Receivable was already credited at the moment of credit note posting, no second GL entry is generated upon allocation; the allocation simply links the subledger records and decrements both outstanding balances.
  • Customer Balance & Aged AR: Credit notes immediately reduce the customer’s total open balance. In aged receivable reports, unallocated credit notes are applied against the oldest aging buckets (or displayed in the unallocated credit column).

3. Payout via Cash Refund

If a customer requests a cash payout rather than carrying forward account credit:

  1. An operator creates a Payment Entry of type customer_refund.
  2. The refund entry matches against the unallocated credit note, posting:
    Debit:  Accounts Receivable Control Account
    Credit: Bank Account

Step-by-Step Workflows

1. Creating a Credit Note

  1. Go to SalesCredit Notes (/sales-credit-notes).
  2. Click New Credit Note.
  3. Select the Customer and (optional) linked Sales Invoice.
  4. Add line items, credited amounts, and tax classifications.
  5. Click Post Credit Note to post to Accounts Receivable and the General Ledger.

2. Allocating Credit to an Open Invoice

  1. Open the posted credit note (/sales-credit-notes/:id).
  2. In the Allocations panel, click Allocate to Invoice.
  3. Select the target unpaid invoice and enter the allocation amount.
  4. Click Confirm Allocation. Both the credit note and invoice outstanding balances update immediately.

Field Reference

FieldDescription
Credit Note NumberLegal credit note document reference (e.g. CRN-2026-00054).
CustomerCredited customer account.
Associated InvoiceLinked sales invoice if raised for a specific bill correction.
Total AmountTotal gross credit value including tax.
Outstanding AmountUnallocated credit balance remaining on the account.

Field Reference & Data Dictionary

Key database fields, input parameters, and definitions associated with this workflow screen:

Field / Parameter Display Name Description & Rules
credit_note_number Credit Note Number Unique credit note identifier (e.g. CRN-2026-00054).
customer_id Customer Customer account receiving the credit balance.
invoice_id Associated Invoice Sales invoice being credited (if linked to a specific bill).
total_amount Total Amount Total amount credited including tax.
outstanding_amount Outstanding Amount Remaining unallocated credit available to offset future invoices or issue cash refunds.