Skip to content

Purchase Credit Note (Internal) Applet

Purpose and overview

In purchasing, a credit note (also called a supplier credit or purchase credit note) is a formal record that reduces what your company owes a supplier, or corrects what you already recorded, when something changes after a purchase or invoice. Typical reasons include returned goods, wrong quantities or prices, agreed rebates, or duplicate billing. In plain terms: a supplier invoice says you should pay more; a purchase credit note says you should pay less or take an amount off the account.

In BigLedger, the Purchase Credit Note (Internal) Applet is where you create and maintain that record inside the ERP, with the same overall shape as other purchase documents: header details, supplier account, and lines so procurement and finance stay aligned.

Cannot see a menu item or button? Administrators control feature visibility, field settings, and permissions. If something you were trained on is missing, ask your admin—it may be turned off for your role or company policy.

Every credit note ties together who you are crediting (supplier on Account), which document you are editing (header on Main Details), and what is credited on each line (Line Items on create, Lines on edit). Optional tabs add payment, department, knock-off from GRN/PO/supplier DO (KO For), e-invoice, settlement, and evidence when your tenant shows them.


Before you begin

  • Agree internally who proposes credit amounts (procurement) and who approves them for posting (finance), so totals and reasons are clear before you use FINAL.
  • The supplier must exist in master data before you can complete the Account tab on a new credit note.
  • Whether you must tie a credit to an existing posted invoice depends on your process. When KO For is visible on create, it is for knock-off from Purchase GRN, Purchase Order, or Supplier Delivery Order (see KO For tab); linking or settlement against a posted purchase invoice may use Doc Link, ARAP, or other steps your finance team defines.
  • For statutory e-invoice steps after posting, your organisation may also use My E-Invoice Admin Applet—see that guide for queues and status, not this page.

Who benefits and problems solved

WhoTypical use
ProcurementCreate and update credit notes, supplier and addresses, and lines; use bulk tools when many lines change.
FinanceReview totals, use FINAL when the credit is ready for downstream posting, use DISCARD or VOID when policy allows; work in E-Invoice, ARAP, or Contra when enabled and trained.
OperationsRun file imports, attachments, or exports when your company uses them for evidence or hand-off.

Without a structured credit-note process, teams often rely on email and spreadsheets, which makes it hard to prove what was agreed, match credits to invoices or receipts, and keep procurement and finance on the same numbers. This applet gives one official list, header plus supplier plus lines in one place, optional links to e-invoice and settlement when your tenant enables them, and bulk paths through the Line Items workspace and File Import.


Key features overview

Overview of the Purchase Credit Note (Internal) Applet: documents, line items, and import
Purchase credit notes, the Line Items workspace, and file import in one applet.

Quick start

The layout may show the same areas as tabs across the top or as expansion panels you open one at a time—that is a display choice only; the underlying data and steps are the same. Users can switch layout with CHANGE VIEW (see Settings).

For procurement: record a credit and get it ready for finance

  1. Open Purchase Credit Note (Internal) from the sidebar and use the list search or filters to find an existing document, or start Create / + for a new one.
  2. On Create Purchase Credit Note, work through Main Details, then Account, then Line Items. Treat optional tabs only when your process requires them (Payment, Department Hdr, KO For—see below).

Main Details — what to fill in

  • Required vs optional fields are controlled by Field settings for your tenant. On the form, anything your company marks as mandatory usually shows as required (for example asterisk or red highlight when empty). If you are unsure about a blank field, ask procurement lead or admin rather than guessing.
  • Reference numbers: Use the field your policy names for each purpose. A practical pattern many teams use: put the supplier’s own credit note reference (if they issued one) in the supplier or external reference field your form exposes; put your internal case or return ID in an internal reference; put the original purchase invoice or PO number wherever finance asked you to trace the credit (sometimes a dedicated reference, sometimes remarks). If your form only has one reference line, agree one convention with finance and stick to it.
  • Dates: Use the document date and any due/posting-related dates your form shows the way finance trained you (often “today” for the credit note date unless policy says otherwise).

Account

  • Pick the same supplier the credit is for, and bill-to / ship-to that match the agreement or the original transaction.

Line Items — quantities and prices

  • Enter the credit you are recording now: item, quantity being credited, and unit price for this credit (the amount that should reduce payables after posting—not “extra” fields for history unless your form has them).
  • Price to use: If finance agreed to credit at the same unit price as the original invoice, use that price on the line. If they agreed a different credit price (promotional credit, partial write-down, negotiated return value), enter that agreed price—not the old invoice price. When in doubt, confirm with finance before posting.
  • Example (returned goods): Finance agrees to credit 10 returned units at MYR 50.00 each. On Line Items, choose the same item code as the original purchase (or the return line item your policy uses), enter Qty 10, Unit price 50.00 (or your form’s equivalent labels), and a clear line remark such as “Return RMA-123”. Totals on the header should match what was approved.

Optional tabs when visible:

  • Payment — only if your process records payment lines on the credit note.
  • Department Hdr — department or segment on the header when your company allocates credits that way.
  • KO For — see KO For tab; use it when you should build lines from open quantities on a Purchase GRN, Purchase Order, or Supplier Delivery Order instead of typing every line by hand.
  1. Click CREATE to save a new document (use RESET only if you intend to clear the draft form). After the document exists, continue editing with SAVE; optional tabs on the saved document are described under Edit screen tabs.

For finance: approve posting and follow your close-out steps

  1. Open the document from the list and confirm supplier, totals, and lines against your approval rules.
  2. Use SAVE while changes are still in progress. When the credit is ready for generic document posting, use FINAL (header button on the edit screen).
  3. On Main Details, DISCARD removes a draft (no posting status yet, or status DRAFT). VOID appears after the document is FINAL (posted), when your settings and permissions allow. Either action can be hidden or blocked while the document is locked—ask finance or admin if a button is missing.
  4. Complete E-Invoice, ARAP, Contra, Doc Link, or other tabs only as your training describes. Deep e-invoice submission and My E-Invoice workflows are covered in My E-Invoice Admin Applet and, where relevant, Purchase Invoice (Internal) Applet.

For operations: bulk lines and evidence

  1. Use File Import for CSV uploads; fix errors shown on Checking, then re-import or continue per your admin’s procedure.
  2. Use Line Items workspace to find and correct specific lines after import or when working across many documents.
  3. On an open document, use Attachment or Export when those tabs are visible and your process requires files or extracts.
After you FINAL, the document is treated as posted for your process: follow-up (payables effect, e-invoice, settlement) depends on tenant configuration. Confirm with finance whether a settlement run, e-invoice check, or other step is required—see Purchase Invoice (Internal) Applet for ARAP and invoice-side context where credits mirror invoices.

Field reference

This section explains what each part of the credit note form is for. Which fields are required depends on your company’s Field settings—the tables below describe purpose, not whether every tenant marks them mandatory.

For shared concepts (currency, GL segments, e-invoice supplier fields), see also Purchase Invoice (Internal) Applet where similar fields are documented for invoices.

Main Details (document header)

FieldWhat it is for
Doc Short CodeSystem document type code (read-only after creation).
Doc No (Tenant)Document number at tenant level.
Document No (Company)Document number at company level (when shown).
Document No (Branch)Document number at branch level (when shown).
Custom Document NumberOptional custom numbering when your admin enables it.
Client Doc Short CodeShort code for your external document classification.
Client Doc 1 No – 5 NoUp to five external reference numbers (supplier CN, PO, invoice, case ID—agree usage with finance).
BranchBranch that owns this credit note.
LocationStore or location within the branch.
PurchaserPerson responsible for this credit (buyer or procurement contact).
Transaction DateDate of the credit note for posting and reporting.
Credit TermsPayment or credit terms applied to this document.
ReferencePrimary header reference (often supplier credit note number or internal trace ID).
RemarksFree-text notes visible on the document.
Permit NoImport or permit reference when your process requires it.
CurrencyDocument currency (amounts on lines are in this currency).
Base CurrencyYour organisation’s reporting currency (when shown).
Currency RateExchange rate between document currency and base currency.
Tracking IDShipment, RMA, or logistics tracking reference.
External Quotation / Order / Delivery Order / Invoice / Others (+ dates)Cross-reference to supplier documents outside BigLedger.
Posting StatusDRAFT, FINAL, or VOID—whether the credit is still editable, posted, or cancelled.
StatusActive/inactive document status (for example ACTIVE).
Main Details tab on an open purchase credit note showing header fields, branch, dates, and references
Main Details: header fields including branch, location, dates, references, currency, and posting status.

Account (supplier)

The Account tab has subtabs Entity Details, Bill To, and Ship To when your admin shows them.

Field / areaWhat it is for
Entity Id / supplier pickerThe supplier receiving the credit—must match the party on the original transaction.
Entity Name, Type, StatusSupplier master data for identification and compliance.
ID Number, Identity Type, Email, PhoneSupplier identity and contact (used for reporting and e-invoice when enabled).
CurrencySupplier account currency context when shown.
Bill ToBilling name and address on the credit.
Ship ToShipping or return address when relevant to the credit.
Account tab showing supplier entity details and bill-to or ship-to addresses
Account: select the supplier and confirm Bill To and Ship To match the credit agreement.

Video walkthrough: selecting the supplier and updating billing details on a purchase credit note.

Line Items / Lines (credit lines)

On Create Purchase Credit Note the tab is Line Items; on an open document it is Lines—same data, different screen title.

FieldWhat it is for
Item CodeProduct or service being credited.
Item NameDescription from item master.
UOMUnit of measure (each, box, kg, etc.).
QtyQuantity being credited (reduces payables by this amount × unit price).
Unit Price (Inclusive of Tax)Agreed credit price per unit—not necessarily the original invoice price unless finance confirmed that.
SST / VAT / GSTTax amount on the line when applicable.
Txn AmountLine total in document currency.
RemarksLine-level reason (for example “Return RMA-123”, “Price correction”).
Serial #Serial-tracked items—enter when your item setup requires it.
Segment Code, Dimension Code, Profit Centre Code, Project CodeGL allocation when your finance policy splits credits by department or project.
Landed CostsAdditional cost components when costing is enabled.
Lines tab showing credit line items with item code, quantity, unit price, and amounts
Lines (Line Items on create): each row records what is being credited—item, quantity, and unit price.

Record a supplier credit

This is the day-to-day workflow inside the applet: one list, one document, supplier account, and credit lines.

Main list: Purchase Credit Note (Internal)

From the sidebar, open the main list to search, filter, and open documents. Create / + starts a new credit note when you have permission. Columns may include document number, dates, amounts, Self Billed ? (reflects the header/supplier self-billed flag when present), and status—exact columns depend on configuration.

Purchase Credit Note (Internal) listing with search and Create control
Main list: search and filter credit notes, open a row, or start a new document with Create / +.

Create a new credit note

Video walkthrough: creating a purchase credit note from the listing through Main Details, Account, Line Items, and CREATE.

  1. From the list, click Create / +. The screen title is Create Purchase Credit Note.
  2. Main Details — dates, references, and other header fields your company requires (see Field reference).
  3. Account — select the supplier and billing/shipping details as required.
Create Purchase Credit Note screen showing Main Details or Account tab with header and supplier fields
Create a credit note: complete Main Details and Account before moving to lines.
  1. Line Items — add lines (items, quantities, amounts) for what is being credited.
Create Purchase Credit Note Line Items tab with credit lines in the grid
Line Items: enter each credited item, quantity, and unit price (or use KO For when your process starts from another document).
  1. Optional tabs (only if shown): Payment, Department Hdr, KO For — complete when your process says so. See KO For tab.
  2. Click CREATE to persist the document. Use RESET to clear the unsaved create form.

KO For tab (create)

The KO For tab is optional and only appears when your administrator enables it. It exists so you can import knock-off lines from an existing purchase document instead of re-typing item codes, quantities, and baseline amounts.

Inside the tab you get subtabs such as KO For Purchase GRN, KO For Purchase Order, and KO For Supplier Delivery Order (exact titles match your screen). Typical flow: open the subtab that matches the document you are crediting against, search and select that document, then use the knock-off action your training describes. The system brings open quantities and linked line data from that document into this credit note so you start from what was already received or ordered. Review and adjust lines afterward if the credit quantity or price differs from what was pulled (for example partial return or negotiated credit).

If you skip KO For, you can still enter lines manually on Line Items; finance may later match the credit to invoices or payables using Doc Link, ARAP, or other tools on the saved document. Whether knock-off is required is a company rule, not something the applet decides for you.

For invoice-centric knock-off, settlement, and ARAP behaviour, continue with Purchase Invoice (Internal) Applet after the credit note exists if that is how your tenant is set up.

Edit an existing credit note

Open a row from the list. The header shows SAVE and, when allowed, FINAL.

Open purchase credit note in edit mode with SAVE and FINAL in the header
After the document exists: use SAVE while editing; use FINAL when finance is ready to post the credit note.

For tab-by-tab guidance on the saved document, see Edit screen tabs.


Edit screen tabs

After you CREATE a credit note, the edit screen shows a set of tabs (or vertical panels if CHANGE VIEW is set that way). Tabs appear only when your administrator has not hidden them. Work through them in the order below when your process requires each step.

Main Details

When to use: Always—the document header.

What you do here: Review or update branch, location, dates, references, currency, and remarks. DISCARD (draft) and VOID (posted) appear here when permitted. Confirm Posting Status before you assume the credit is live in payables.

Typical scenario: Procurement corrects the supplier reference number before finance runs FINAL.

Main Details tab on edit purchase credit note
Main Details on edit: update header fields; DISCARD and VOID appear here when permitted.

E-Invoice

When to use: When e-invoice is enabled for your tenant—usually after FINAL.

What you do here: View or trigger e-invoice actions (submission, cancellation) per country rules. Self-billed suppliers may see different subtabs than standard suppliers.

Typical scenario: Finance posts the credit, then completes e-invoice submission from this tab or follows up in My E-Invoice Admin Applet.

E-Invoice tab on purchase credit note after posting
E-Invoice: submission and cancellation panels after FINAL when e-invoice is enabled.

Account

When to use: Always—supplier identity and addresses.

What you do here: Confirm Entity Details, Bill To, and Ship To match the supplier and addresses on the original purchase or return agreement.

Typical scenario: Credit for a return—the ship-to address is the supplier’s return warehouse.

Account tab on edit purchase credit note
Account on edit: confirm supplier entity and addresses.

Lines

When to use: Always—what is being credited.

What you do here: Add, edit, or remove credit lines (item, qty, unit price, tax, remarks). Same grid as Line Items on create.

Typical scenario: Partial return—reduce qty on one line and add a remark with the RMA number.

Lines tab on edit purchase credit note
Lines on edit: add or adjust credited items, quantities, and prices.

ARAP

When to use: When the tab is visible and finance uses payables settlement on the document.

What you do here: View or manage accounts receivable/payable settlement—offset this credit against open supplier invoices or balances.

Typical scenario: Posted credit note reduces amount owed on a specific purchase invoice.

ARAP tab on purchase credit note for payables settlement
ARAP: offset this credit against open supplier invoices or balances.

Payment

When to use: When your process records payment lines directly on the credit document (uncommon for standard supplier credits—confirm with finance).

What you do here: Enter or review payment allocation lines tied to this document.

Typical scenario: Refund or settlement recorded on the same document per company policy.

Payment tab on purchase credit note
Payment: payment lines when your process records them on the credit document.

Department Hdr

When to use: When your company allocates credits by department, segment, or project at header level.

What you do here: Set segment, dimension, profit centre, or project on the document header for GL reporting.

Typical scenario: Credit for a department’s mistaken order—segment code routes the credit to the correct cost centre.

Department Hdr tab on purchase credit note
Department Hdr: segment, dimension, profit centre, or project on the header.

Trace Document

When to use: When audit or finance needs posting trace on the generic document.

What you do here: Review system posting trace and linked posting events (read-only for most users).

Typical scenario: Support investigates why a credit did not appear in a report—trace shows posting history.

Trace Document tab showing posting trace on purchase credit note
Trace Document: read-only posting trace for audit and support.

Contra

When to use: When finance offsets this credit against another payable or document.

What you do here: Create or review contra entries that net this credit against an invoice, debit note, or other balance.

Typical scenario: Supplier sends a credit note that nets against an unpaid invoice—finance records contra here.

Contra tab on purchase credit note
Contra: net this credit against another payable or document.

Doc Link

When to use: When you must formally link this credit to related documents (PO, GRN, invoice, etc.).

What you do here: Add or view document links for traceability and matching—not the same as KO For on create, which pulls lines from GRN/PO/SDO.

Typical scenario: Link posted credit to the original purchase invoice number for three-way matching audit.

Doc Link tab on purchase credit note for linking related documents
Doc Link: formally link this credit to PO, GRN, invoice, or other related documents.

Attachment

When to use: When you need evidence on file (supplier PDF credit note, email approval, photos of returned goods).

What you do here: Upload, view, or download attachments stored against this document.

Typical scenario: Attach the supplier’s signed credit note PDF before FINAL.

Attachment tab on purchase credit note for uploading evidence files
Attachment: upload supplier credit note PDFs, email approvals, or other evidence.

Export

When to use: When you need a data extract of this document for hand-off or external review.

What you do here: Run export in the format your administrator configured.

Typical scenario: Export credit note details for a supplier dispute file.

Export tab on purchase credit note for data extracts
Export: run configured data extracts of this document for external review.

Line Items workspace

The Line Items item in the left menu is not the same as the Line Items tab on Create Purchase Credit Note or the Lines tab on an open document. The menu opens a separate search grid so you can work across many documents and jump straight into editing one line.

  1. Open Line Items from the sidebar.
  2. Use search and filters to narrow the list.
  3. Open a row to edit (screen title Edit Item).
  4. Use the subtabs as shown—for example Item Details, Costing Details, and Issue Link; serial, batch, or bin subtabs appear when your item setup requires them. Click SAVE on the line editor when done.
  5. Use Delete on a line when available and your policy allows it (confirm prompts if shown).

File Import

Use File Import when your company loads credit note data from CSV instead of typing each document or line manually.

File Import upload screen titled Upload The Data with Delimeter, file upload area, Sample Format, and SUBMIT
File Import: choose Delimeter, attach a CSV, use Sample Format for the template, then SUBMIT. Review results on the import record under Details and Checking.

Step-by-step upload

  1. Open File Import from the sidebar and start a new import with Create / +.
  2. The upload screen title is Upload The Data. Set Delimeter (the on-screen spelling) to match your CSV:
    • COMMA — fields separated by , (most common)
    • PIPE — fields separated by |
  3. Add a .csv file with Upload File or drag and drop into the drop zone.
  4. Open Sample Format to open the column-picker dialog and download the template CSV (Purchase_Credit_Note_Master_Data_Template.csv). Target fields (mandatory) are always included; you can add source fields (optional) from the left list.
Sample Format dialog showing source fields and target fields for CSV import
Sample Format: target fields (right) are mandatory; add optional source fields (left) before downloading the template CSV.
  1. Click SUBMIT to run the import.
  2. Open the import record (File Details). Review Details for file-level status, and Checking for row-level validation.

Sample Format: target fields (mandatory)

These columns are always required in your CSV header and must be populated on every data row you expect to import. They cannot be removed from the Sample Format download.

ColumnPurpose
BRANCH_CODEBranch code where the credit note belongs.
LOCATION_CODELocation or store code within the branch.
DOC_CURRENCYDocument currency code (for example MYR, USD).
TXN_DATETransaction date (match the date format in the sample template).
HDR_REF_NOHeader reference number for the credit note.
QTYLine quantity being credited.
SETTLEMENT_OR_ITEM_CODEItem code or settlement code for the line.
AMOUNT_INCL_TAXLine amount including tax in document currency.

Sample Format: source fields (optional)

Select these in the Sample Format dialog when your CSV needs extra header, supplier, line, tax, GL, or e-invoice data. Add only the columns you will populate—empty optional columns are usually fine.

Header and document

ColumnPurpose
PURCHASE_AGENTPurchaser or buyer code on the header.
CREDIT_TERMSCredit terms code or name.
CREDIT_LIMITCredit limit reference when used.
HDR_DESCRIPTIONHeader description text.
HDR_REMARKSHeader remarks.
TRACKING_IDTracking or RMA reference.
Client Doc TypeClient document type short code.
Client Doc 1Client Doc 5External reference numbers 1–5.
BASE_DOC_X_RATEExchange rate for foreign-currency documents.
POSTING_STATUSPosting status when importing as draft or final per your process.

Supplier (entity)

ColumnPurpose
ENTITY_CODESupplier code.
ENTITY_NAMESupplier name.
ENTITY_TYPEEntity type classification.
ENTITY_ARAP_TYPEAR/AP type for the entity.
ENTITY_ID_NOSupplier ID number.
ENTITY_ID_TYPEID type (for example NRIC, BRN).
ENTITY_ID_NO_OLDPrevious ID number when applicable.
ENTITY_TOURISM_TAX_ID_NOTourism tax ID.
ENTITY_EINVOICE_TAX_ID_NOE-invoice tax ID.
ENTITY_EINVOICE_ID_TYPEE-invoice ID type.
ENTITY_EINVOICE_ID_VALUEE-invoice ID value.
ENTITY_TAX_REG_NUMBERTax registration number.
ENTITY_SST_NOSST registration number.
ENTITY_PHONESupplier phone.
ENTITY_EMAILSupplier email.
ENTITY_SKIP_EINVOICESkip e-invoice flag when applicable.
ENTITY_UPSERTCreate or update supplier on import when enabled.
ENTITY_BRANCH_CODESupplier branch code.
ENTITY_BRANCH_CODE_XTN_MAPPING_VALUE_0105External mapping values for supplier branch.

Billing and shipping address

ColumnPurpose
BILLING_NAME, BILLING_EMAIL, BILLING_PHONEBill-to contact.
BILLING_ADDRESS_LINE_15, BILLING_COUNTRY, BILLING_STATE, BILLING_CITY, BILLING_POSTCODEBill-to address.
SHIPPING_NAME, SHIPPING_EMAIL, SHIPPING_PHONEShip-to contact.
SHIPPING_ADDRESS_LINE_15, SHIPPING_COUNTRY, SHIPPING_STATE, SHIPPING_CITY, SHIPPING_POSTCODEShip-to address.

Line item detail

ColumnPurpose
ITEM_NAMEItem description.
ITEM_DESCRIPTIONExtended item description.
LINE_ITEM_NAMELine display name.
LINE_ITEM_REMARKSLine remarks.
LINE_BRANCH_CODEBranch on the line when different from header.
ITEM_TXN_TYPE, ITEM_TXN_CLASS, ITEM_SUB_ITEM_TYPEItem transaction classification.
ITEM_CCY_CODELine item currency when used.
UOMUnit of measure.
UNIT_PRICE_INCL_TAXUnit price including tax.
DISCOUNT_AMOUNTDiscount on the line.
TAX_CODETax code.
TAX_AMOUNTTax amount.
ITEM_SERIAL_NO, ITEM_BATCH_NO, ITEM_TRACKING_IDSerial, batch, or tracking ID.
GL_CODEGL account code.
SEGMENT_CODE, GL_DIMENSION_CODE, PROFIT_CENTRE_CODE, PROJECT_CODEGL segments and dimensions.
LINE_TXN_DATELine transaction date when different from header.
SORT_CODESort or display order.
ITEM_REF_NOItem reference number.
TXN_TYPE_PNS_STL_MTHD, STL_AMOUNT, TRANSACTION_NO, STL_REMARKSSettlement-related line fields when used.

E-invoice (when applicable)

ColumnPurpose
EINVOICE_ITEM_CLASSIFICATION_CODE, EINVOICE_ITEM_TAX_TYPE_CODE, EINVOICE_ITEM_UOME-invoice line classification.
EINVOICE_SUBMISSION_TYPESubmission type.
EINVOICE_SUPPLIER_TIN_NO, EINVOICE_SUPPLIER_ENTITY_ID_TYPE, EINVOICE_SUPPLIER_ID_NO, EINVOICE_SUPPLIER_SST_NOSupplier e-invoice identity.
EINVOICE_SUPPLIER_NAME, EINVOICE_SUPPLIER_EMAIL, EINVOICE_SUPPLIER_PHONESupplier e-invoice contact.
EINVOICE_SUPPLIER_ADDRESS_NAME, EINVOICE_SUPPLIER_ADDRESS_LINE_15, EINVOICE_SUPPLIER_ADDRESS_CITY, EINVOICE_SUPPLIER_ADDRESS_POSTCODE, EINVOICE_SUPPLIER_ADDRESS_STATE, EINVOICE_SUPPLIER_ADDRESS_COUNTRYSupplier e-invoice address.
EINVOICE_SELF_BILLEDSelf-billed flag.
EINVOICE_BILLING_FREQUENCY, EINVOICE_BILLING_PERIOD_START, EINVOICE_BILLING_PERIOD_ENDBilling period for e-invoice.
ORIGINAL_EINVOICE_REF_UUIDReference to original e-invoice UUID when correcting.

Example CSV rows

Minimal row (mandatory columns only):

BRANCH_CODELOCATION_CODEDOC_CURRENCYTXN_DATEHDR_REF_NOSETTLEMENT_OR_ITEM_CODEQTYAMOUNT_INCL_TAX
HQWH01MYR2026-06-01CN-2026-001ITEM-A00110500.00

Row with supplier and reference (optional columns added):

BRANCH_CODELOCATION_CODEDOC_CURRENCYTXN_DATEHDR_REF_NOENTITY_CODESETTLEMENT_OR_ITEM_CODEQTYAMOUNT_INCL_TAXHDR_REMARKS
HQWH01MYR2026-06-01CN-2026-002SUPP001ITEM-B0025250.00Return RMA-456

Import rules (read before SUBMIT)

  • Mandatory columns: All eight target columns must appear in the header row and be filled on each data row; empty required cells produce errors on Checking.
  • Column names: Match the Sample Format spelling and case exactly.
  • Delimiter: Must match the Delimeter you select on Upload The Data—a comma file with PIPE selected (or vice versa) will fail or mis-parse rows.
  • Failed rows: Treat Checking as the source of truth after each run. Fix the CSV and start a new import (or follow your admin’s recycle procedure).

Import listing and File Details

After SUBMIT, the File Import Listing shows each upload:

ColumnMeaning
File NameUploaded file name.
File SizeSize of the upload.
FormatUsually CSV.
StatusRecord status (for example ACTIVE).
Process StatusOverall import result—commonly DONE (completed) or FAILED (file-level failure).
Error MessageSummary when the whole file failed (wrong format, delimiter mismatch, etc.).
Created Date / Created byAudit of who uploaded and when.
File Import listing showing Process Status and Error Message columns
File Import listing: check Process Status and Error Message for file-level results.

Open a row to see File Details with two tabs:

TabPurpose
DetailsFile metadata and process status.
CheckingRow-by-row validation grid (helper table)—use this to fix data and re-import.

Checking tab (helper table)

The Checking tab is your main tool for troubleshooting CSV uploads.

File Details Checking tab with Processed and Validation Error columns
Checking tab: row-level Processed status and Validation Error messages for self-service CSV fixes.
ColumnMeaning
Line NumberRow number in your CSV (excluding header).
ProcessedWhether this row was accepted (true) or rejected (false).
Validation ErrorPlain-language reason the row failed (missing branch, invalid item, bad date, etc.).
Branch Code, Location Code, Settlement/Item Code, …Values the system parsed from your file—compare with your CSV to find typos.
Error Message / Short Error MessageTechnical detail for support when validation text is not enough.

Self-service correction workflow

  1. SUBMIT the file.
  2. Open the import record → Checking tab.
  3. Filter or scan for Processed = false and read Validation Error on each failed row.
  4. Fix those rows in your CSV (delimiter, mandatory columns, valid codes, date format).
  5. Upload again with Create / + and SUBMIT a corrected file.
If Process Status is FAILED with an Error Message on the listing but Checking is empty, the problem is usually file-level (delimiter, encoding, or no valid rows)—fix the file structure before row-level fixes.

If File Import is missing from the menu, feature visibility or role permissions may hide it.


Personalization

Personalization is a separate menu (footer or sidebar link) for individual user preferences—it does not change company-wide settings in Settings.

FeatureWhat you can set
Default SelectionYour personal default branch and location when creating documents (within branches you are allowed to access).
Single / double column layoutDEFAULT_TOGGLE_COLUMN — prefer single- or dual-column form layout where supported.

Use Personalization when you always work from the same branch or warehouse and want faster document creation without asking an admin to change tenant defaults.

Company-wide defaults remain under Settings → Default Selection (administrators only).

Personalization Default Selection screen
Personalization: set your own default branch and location without changing company-wide settings.

E-invoice and related flows

On an open document, the E-Invoice tab appears when e-invoice is enabled for your tenant. After FINAL, panels such as submission or cancellation follow your country and company rules. The document and supplier self-billed flag drives self-billed behaviour in the UI (for example, which e-invoice subtabs show after posting). Configure or interpret self-billed with your finance team and with Purchase Invoice (Internal) Applet where supplier e-invoice settings are documented.

Day-to-day monitoring of submissions, failures, and cancellations belongs in My E-Invoice Admin Applet—use that user guide for queue-based work, not a second copy of those steps here.


Choosing other purchase documents

SituationWhere to read more
Supplier should charge you less (return, error, rebate, duplicate bill)This applet — purchase credit note.
You need to charge the supplier more (under-billing, extra cost to supplier)Purchase Debit Note (Internal) Applet
Physical return of goods with a dedicated return processPurchase Return (Internal) Applet
Refund flows your company separates from standard creditsPurchase Refund Note (Internal) Applet

Related purchase flow guides:


Settings (for administrators)

These live under Settings in the applet. Names match what users usually see in the sidebar.

System configuration

AreaWhat it is for
Application SettingsHide/show fields, tabs, listing columns, and sidebar menus—see Application Settings tabs below.
Default SelectionTenant-wide default company, branch, and location for new documents.
Printable Format SettingsLayout and content of printed or PDF credit notes (logo, columns, no-price variants, branch-specific formats).
Branch SettingsBranch-specific defaults such as print format per branch.
Printable Format Settings for purchase credit note layout
Printable Format Settings: configure logo, columns, and branch-specific print layouts for credit notes.

Application Settings tabs

Open Settings → Application Settings. Use the top tabs to configure behaviour by screen area:

TabWhat administrators configure
Sidebar MenuShow or hide File Import, Line Items, and other sidebar entries.
Advanced Search FilterHide date filters on listings.
Gen Doc ListingListing columns, sort order, FINAL / DISCARD / VOID button visibility, vertical vs horizontal layout defaults.
Main DetailsRequired or hidden header fields, external document references, currency and forex display, purchaser autofill.
E-InvoiceE-invoice tab and field visibility.
AccountEntity Details, Bill To, Ship To sub-tab visibility.
Line ItemsLine grid columns, pricing, tax, serial/batch, costing toggles.
KO ForKnock-off tab on create (GRN / PO / supplier DO).
MiscellaneousHide Payment, Contra, Doc Link, Attachment, Export, Department Hdr, Trace Document, ARAP tabs.
Application Settings Gen Doc Listing tab
Gen Doc Listing: configure listing columns, sort order, and FINAL / DISCARD / VOID button visibility.
Application Settings Main Details tab
Main Details: set required or hidden header fields and currency display options.

Change View

On many settings and document screens, CHANGE VIEW (top right) toggles between horizontal tabs and vertical expansion panels. Same fields and data—only layout changes. Train users on whichever mode your tenant sets as default under Gen Doc Listing.

CHANGE VIEW toggle between horizontal tabs and vertical expansion panels
CHANGE VIEW: switch between horizontal tabs and vertical expansion panels without changing data.

Server-side permissions

AreaWhat it is for
Permission WizardMap roles to applet functions step by step.
Permission SetReusable permission packages.
User PermissionAssign permissions to individual users.
Role PermissionAssign permissions by role.

Video walkthrough for permission setup:

Other settings areas

AreaWhat it is for
Client-side permission listingFine control over buttons such as FINAL, SAVE, DISCARD, VOID.
WebhookEvents to other systems when data changes.
Feature visibilityWhich menus and features appear.
Role pricing scheme linkLinks roles to pricing where used.
Release notesWhat changed in the applet.
Applet log / Audit TrailOperational log for support and audit.

Configure these according to your organisation’s procurement, finance, and approval policies.


If something is wrong

ProblemWhat to try
Cannot create a documentAsk admin to check create permission and Default Selection (company/branch).
FINAL, SAVE, DISCARD, or VOID missingPermissions, client-side permission listing, or Application Settings; finance or admin can adjust.
A trained tab disappearedApplication Settings Miscellaneous or field settings may hide it—admin review.
File Import not in the menuMay be off for your role or hidden under Sidebar Menu in Application Settings.
Tabs vs panelsSame data; use CHANGE VIEW or admin default in Gen Doc Listing.
CSV import rows failOpen Checking tab; match Delimeter and mandatory columns to File Import.

Still stuck? Note your user name, document number (if any), and what you clicked, then contact your BigLedger administrator or internal help desk.


Frequently asked questions

What is the difference between a purchase credit note and a supplier invoice?
An invoice from the supplier normally increases what you owe. A purchase credit note reduces that balance or corrects an earlier posting—see Purpose and overview.

When should I use a credit note instead of a debit note?
Use a credit note when the outcome is “we pay less” or “take this off our account.” Use a debit note when policy says you must charge the supplier more. See Choosing other purchase documents.

How do I link a credit note to an existing purchase invoice?
On create, KO For pulls from Purchase GRN, Purchase Order, or Supplier Delivery Order, not directly from a purchase invoice screen—see KO For tab. For invoice-level linking or settlement, use Doc Link or ARAP when visible, or follow Purchase Invoice (Internal) Applet.

File import failed—what should I check first?
Open the import record and read the Checking tab; fix Delimeter and column layout to match Sample Format. See Checking tab.

What is the Line Items menu versus the Line Items tab or Lines tab?
The Line Items menu searches across documents. On Create Purchase Credit Note the tab is Line Items; on an existing document the tab is Lines—same line list, different screen.

What does Self Billed mean on the list?
The list column Self Billed ? reflects the document/supplier self-billed flag used for e-invoice. Supplier-side setup is described with purchase invoice and e-invoice training.

What is Personalization versus Default Selection in Settings?
Personalization sets your default branch/location and layout. Settings → Default Selection sets company-wide defaults for all users (admin only).


Related documentation


Glossary

TermMeaning
ARAPAccounts receivable/payable area on the document for settlement when enabled.
ContraContra entries when the tab is visible—your finance team defines use.
DelimeterOn-screen label for the CSV field separator on file import (match your file; the usual English spelling is “delimiter”).
DISCARDRemoves a draft credit note when shown (draft or no posting status yet), subject to lock and settings.
Doc LinkTab for linking related documents when visible.
FINALHeader action to post/finalize the document when permitted.
KO / knock-offMatching this credit to other purchase documents. KO For on create imports lines from Purchase GRN, Purchase Order, or Supplier Delivery Order.
Self-billedE-invoice mode for self-billed suppliers; changes which e-invoice panels apply.
VOIDCancels a posted (FINAL) document when shown, subject to lock and settings.