Skip to Content

Bill

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

1. Overview

A Bill is the official document recording a supplier’s charge for goods already received through a Goods Receipt (GR), and it is also the end point of the purchasing flow from PO to payment. One Bill applies to one supplier and can combine several GRs, whether they come from a Purchase Order (PO) or were created without a PO; Bill items are formed automatically from the selected GR items, and staff only adjust prices, discounts, and tax. Every Bill has one person in charge (PIC), who is authorized to submit that bill. After it is submitted, payments to the supplier are recorded on the Bill, all at once or in installments, until it is fully paid.

Expected outcome: the owner knows how much is owed to each supplier, when it falls due, and how much has and has not been paid, while the store only pays for goods actually received.

2. Problem

Without matching against the goods actually received, supplier bills are paid based on the invoice alone, so the store is prone to paying more than it should. As a result:

  • The store also pays for goods that were short-delivered or rejected at receiving.
  • Prices on the invoice that differ from the price agreed in the PO go undetected, so the difference is never questioned.
  • The total owed to each supplier and its due date are not monitored, so payments are late or even paid twice.
  • Installment payments are not recorded neatly, so the remaining bill has to be recalculated manually.

3. Goals & Non-goals

3.1 Goals

  • A bill only covers goods actually received, not what is written on the supplier’s invoice.
  • Price differences between the PO agreement and the supplier’s bill are visible before payment is made.
  • Several deliveries from the same supplier can be billed at once, without splitting payment per delivery.
  • The total owed to each supplier along with its due date is monitored in one place.
  • Installment payments are recorded until fully paid, so the remaining bill does not need to be calculated manually.

3.2 Non-goals

  • Cancelling or revising a Bill that has been submitted.
  • Printing or downloading a Bill as a PDF, even though Purchase Order and Goods Receipt have it.
  • Adding, deleting, or changing product quantities beyond what is recorded on the Goods Receipt.
  • Advance payments before a Bill is created.
  • Debit notes, credit notes, and returns to suppliers.
  • Multi-currency transactions; all values are recorded in a single currency.
  • Automatic accounting journal entries into the Finance module.

4. Business Rules

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

  • BR-01 Every Bill belongs to one store and can only be created and edited by users currently working in that store.
  • BR-02 Every Bill must have a person in charge (PIC) before it can be submitted. Submitting a Bill may only be done by a PIC assigned to that Bill who has the permission for that action; creating a Bill alone does not grant this authority.
  • BR-03 The Bill’s content, including PIC assignment, can only be changed while it is in Draft status, and only Draft Bills can be deleted. After it is submitted, its content is locked and the only things still possible are recording or deleting payments.
  • BR-04 One Bill is for one supplier only. All selected GRs must come from the same supplier, and the supplier cannot be changed after the Bill is created.
  • BR-05 Only GRs of the same store in Submitted status can be billed. One GR may only be referenced by one Bill, and its status becomes Closed as soon as the Bill is created.
  • BR-06 The Purchase Order selection only serves to filter the GRs that can be selected, covering POs of the same store in Submitted, Partially Received, or Received status, plus an option for GRs that were created without a PO. Both can be combined in one Bill, and the Bill’s PO list is derived from the GRs it ends up referencing.
  • BR-07 Bill items are formed one by one from the selected GR items, with the quantity following the received quantity. The quantity cannot be changed, and products cannot be added or deleted manually.
  • BR-08 If a GR item is linked to a PO, its price, discounts, and tax are filled in automatically from that PO item. The price of each product is at least 1.
  • BR-09 One product may have more than one discount. Percentage discounts are applied in sequence, each on the remaining value after the previous discount, and only then are nominal discounts subtracted. Product tax is calculated from the value after discount if it is a percentage, or is a fixed nominal amount.
  • BR-10 In addition to per-product discounts and tax, a Bill can have a discount and tax for the whole bill. Both are calculated the same way, but on the net value of all products after per-product discounts.
  • BR-11 A discount with a value of 0 is not saved.
  • BR-12 The billing address is taken from the supplier’s addresses, not the store’s address. Addresses other than the supplier’s are not accepted.
  • BR-13 The due date follows the selected payment term, calculated from the bill date: CBD and COD fall on the bill date itself, EOM at the end of its month, and Net N falls N days after it. Only the Custom term is filled in manually, and filling it in is required.
  • BR-14 Payments can only be recorded on Bills in Submitted or Partially Paid status. Every payment must state the method, time, an amount of at least 1, and at least one person in charge.
  • BR-15 The Partially Paid and Paid statuses are set automatically from the amount already paid: if there is a remainder it becomes Partially Paid, if the remainder is zero it becomes Paid. This status cannot be changed manually.
  • BR-16 A Bill that is already Paid is locked; its payments can neither be added nor deleted.
  • BR-17 Every data change and status transition of a Bill is recorded along with its actor and time.

5. Flow

5.1 Main Flowchart

  1. Create Bill — Staff select the goods receipts to be billed, first filtering them through their originating purchase order if needed. The supplier is locked to follow the first selection, and the product list is formed automatically from those receipts. Staff complete the billing address, dates, and payment term, then adjust prices, discounts, and tax before saving.
  2. Validation — Inputs are checked before the Bill is saved. A Bill that violates the rules cannot be saved, and the errors are shown in the relevant section.
  3. Draft — The initial status after the Bill is saved. The referenced goods receipts immediately become Closed and can no longer be billed through another Bill. While in Draft, its content can still be edited and its PIC assigned without changing the status; from here the Bill can be submitted or deleted.
    • 3a. Edit Bill Data — General data and prices, discounts, and tax can be updated, except the store, supplier, and goods receipts, which are locked since the Bill was created. The status stays Draft.
    • 3b. Assign PIC — One or more store employees are assigned as the person in charge. The Bill stays in Draft, and this assignment is required before the Bill can be submitted.
  4. Submitted — Done by the PIC. The Bill’s content is locked, and from this point payments to the supplier can start being recorded.
  5. Record Payment — Every payment to the supplier is recorded along with its method, time, amount, person in charge, and proof. Payments can be made all at once or in installments.
  6. Check Remaining Bill — Every time a payment is recorded or deleted, the total paid and the remaining bill are recalculated to determine the Bill’s next status.
  7. Partially Paid — Part of the bill has been paid and the rest is still owed. The next payment is processed as in step 5.
  8. Paid — The entire bill has been paid. Payments can no longer be added or deleted.

5.2 Status Lifecycle

StatusDescriptionNext
Draft
draft
Being prepared, not yet in effectSubmitted, or deleted
Submitted
submitted
In effect and locked, no payments yetPartially Paid, Paid
Partially Paid
partially_paid
Part of the bill has been paid, the rest is still owedPaid
Paid
paid
The entire bill has been paid—

6. Document Structure

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

6.1 General

FieldTypeRequiredDefaultRules
Bill NumberText—Generated on saveSet by the system in the format BILL/{Store Code}/{Year}/{000000}, cannot be changed
StoreRef. StoreYesThe store where the user is currently workingCannot be changed (BR-01)
Purchase OrderRef. PO, multipleNo—Filters the GRs that can be selected; only POs of the same store in Submitted, Partially Received, or Received status (BR-06)
Goods ReceiptRef. GR, multipleYes—Selected from GRs of the same store in Submitted status, all from the same supplier (BR-04, BR-05); cannot be changed after creation
SupplierRef. Supplier—The supplier of the first PO or GRSet by the system, cannot be changed after creation (BR-04)
Billing AddressRef. Supplier AddressYesThe supplier’s default billing address, or its first addressSelected from the supplier’s addresses (BR-12)
Bill DateDateYesToday—
Payment TermEnumYes—CBD, COD, EOM, Net 14, Net 30, Net 60, Net 90, or Custom
Due DateDateYes, if the term is CustomCalculated from the Payment TermOnly filled in manually for the Custom term (BR-13)
Person in Charge (PIC)Ref. Employee, multipleYes, before submittingThe logged-in user’s employee record, if anyStore employees; can only be filled in by holders of the assign permission (BR-02)
Billing ProofFile, multipleNo—Images or documents, for example a photo of the supplier’s invoice
NotesTextNo——
General DiscountPercent or Currency, multipleNo0May be more than one, with an optional note (BR-10); a value of 0 is not saved (BR-11)
General TaxPercent or CurrencyNoNo tax—
StatusEnum—DraftSet by the system; see Status Lifecycle

6.2 Line Items

FieldTypeRequiredDefaultRules
GR ItemRef. GR Item—Follows the selected GRSet by the system; one row for each GR item (BR-07)
Product (Package)Ref. Product—Follows the GR itemSet by the system, cannot be changed (BR-07)
QuantityDecimal—The received quantity on the GR itemSet by the system, cannot be changed (BR-07)
Measurement UnitText—Follows the GR item’s packageSet by the system
Unit PriceCurrencyYesThe PO item’s price if linked, otherwise 0At least 1 (BR-08)
Percentage DiscountPercent, multipleNoThe PO item’s discount if linked, otherwise 0Applied in sequence (BR-09), with an optional note; a value of 0 is not saved (BR-11)
Nominal DiscountCurrency, multipleNoThe PO item’s discount if linked, otherwise 0Subtracted after the Percentage Discounts (BR-09), with an optional note; a value of 0 is not saved (BR-11)
TaxPercent or CurrencyNoThe PO item’s tax if linked, otherwise no taxCalculated from the value after discount (BR-09)

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 (BR-09)
Total General DiscountThe whole-bill discount on Total Gross Price minus Total Item Discount, applied in sequence (BR-10)
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 (BR-09)
Total General TaxThe whole-bill tax, calculated from Total Net Price (BR-10)
Bill TotalTotal Net Price + Total Item Tax + Total General Tax
Total PaidSum of all recorded payments
Total RemainingBill Total − Total Paid

6.4 Payment

FieldTypeRequiredDefaultRules
Payment MethodEnumYes—Cash, Bank Transfer, Giro, Credit Card, or Other
Payment Date & TimeDate & TimeYesNow—
Payment AmountCurrencyYes0At least 1 (BR-14)
Person in ChargeRef. Employee, multipleYesThe logged-in user’s employee record, if anyAt least one store employee (BR-14)
Proof of PaymentFile, multipleNo—Images or documents
NotesTextNo——

7. UI Structure

This section defines how Bills 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 Bill has no PDF (see Non-goals).

7.1 Datatable

ColumnSortableSample ValueComponent
Select——Checkbox, Expand Toggle
No—1Number
Bill NumberYesBILL/CBI/2026/000042Link
Store—Cianjur StoreText
Supplier—PT Sumber RejekiText
Bill DateYes23 Sep 2026Date
Due DateYes23 Oct 2026Date
Bill Total—Rp 13,320,000Currency
Total Paid—Rp 5,000,000Currency
Total Remaining—Rp 8,320,000Currency
Person in Charge—Andi, SariAccordion, Add Button
Created By—Budi SantosoText
Status—Partially PaidBadge
Actions—View · Edit · DeleteAction Menu

Expanded Row

ColumnSample ValueComponent
Receipt NumberGR/CBI/2026/000031Link
Product (Package)Cooking Oil 2L (Carton)Thumbnail, Text
Quantity10Number
Measurement UnitCartonText
Unit PriceRp 250,000Currency
Total DiscountRp 250,000Currency
Total TaxRp 247,500Currency
Total PriceRp 2,497,500Currency

7.2 Advance Filter

FieldControlOptions SourceDefault
StoreMulti SelectStores assigned to the userActive store
Bill Date RangeDate Range Picker—Empty
SupplierMulti SelectSupplier master, searchableEmpty
StatusMulti SelectStatus enumEmpty
Person in ChargeMulti SelectStore employees, searchableEmpty

7.3 Form & Details

Create — A three-step wizard: General, Products, then Review. The Next button validates the current step before moving on, and the Review step shows a read-only summary of all inputs. Actions: Next, Save.

Edit — Two tabs, General and Products, with all fields enabled including the General Discount & Tax dialog. Only available while the Bill is in Draft. Actions: Save, edit product price/discount/tax.

Detail — The Bill Number, status badge, and status stepper at the top, followed by three tabs: General, Products, and Payments (disabled while in Draft). Actions: Edit Data, Submit, and Activity Logs, each appearing according to the Bill status. The Submit button is still shown to users who are not the PIC, but in a disabled state.

General

FieldControlOptions SourceBehavior
StoreRead-onlyThe store where the user is currently working—
Purchase OrderMulti SelectThe active store’s POs in Submitted, Partially Received, or Received status, plus the Without Purchase Order optionChanged → Goods Receipt is cleared
Goods ReceiptMulti SelectThe active store’s GRs in Submitted status that reference the selected Purchase Orders, or GRs without a PODisabled until at least one Purchase Order is selected; selected → Supplier is locked and the product list is rebuilt
SupplierRead-onlyDerived from the first Purchase Order or Goods ReceiptLocked once the first selection is made; cleared again if all selections are cleared
Billing AddressSingle SelectThe Supplier’s addressesDisabled until the Supplier is locked
Bill DateDate Picker——
Payment TermSingle SelectPayment term enumChanged → Due Date is recalculated
Due DateDate Picker—Disabled except for the Custom term
Person in Charge (PIC)Multi SelectStore employeesCan only be filled in by holders of the assign permission
Billing ProofFile Uploader, multiple——
NotesTextarea——

General Discount & Tax Dialog

FieldControlBehavior
General DiscountPercent Input and Currency Input, can be more than oneRows are added/removed; each may come with a note
General TaxPercent/nominal toggle, then Number Input or Currency Input—

Products — Table

ColumnSample ValueComponent
Receipt NumberGR/CBI/2026/000031Link
Product (Package)Cooking Oil 2L (Carton)Thumbnail, Text
Quantity10Number
Measurement UnitCartonText
Unit PriceRp 250,000Currency
Total DiscountRp 250,000Currency
Total TaxRp 247,500Currency
Total PriceRp 2,497,500Currency
ActionsEdit, or View in read modeAction Menu

Products — Form

FieldControlOptions SourceBehavior
Product (Package)Read-onlyThe originating GR itemCannot be replaced (BR-07)
QuantityRead-onlyThe originating GR itemCannot be changed (BR-07)
Measurement UnitRead-onlyThe GR item’s package—
Unit PriceCurrency Input—The last purchase price 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——
TaxPercent/nominal toggle, then Number Input or Currency Input——

Products — Calculations

FieldSample ValueComponent
Total Gross PriceRp 12,500,000Currency, read-only
Total Item DiscountRp 500,000Currency, read-only
Total General DiscountRp 200,000Currency, read-only
Total Net PriceRp 11,800,000Currency, read-only
Total Item TaxRp 1,298,000Currency, read-only
Total General TaxRp 0Currency, read-only
Bill TotalRp 13,098,000Currency, read-only
Total PaidRp 5,000,000Currency, read-only
Total RemainingRp 8,098,000Currency, read-only

Payments — Summary

FieldSample ValueComponent
Bill TotalRp 13,098,000Currency, read-only
Total PaidRp 5,000,000Currency, read-only
Total RemainingRp 8,098,000Currency, read-only

Payments — Form

FieldControlOptions SourceBehavior
Payment MethodSingle SelectPayment method enum—
Payment Date & TimeDate Time Picker—Defaults to now
Payment AmountCurrency Input——
Person in ChargeMulti SelectStore employeesDefaults to the logged-in user’s employee record
Proof of PaymentFile Uploader, multiple——
NotesTextarea——

The list of recorded payments (Payment 1, 2, etc.) is shown as cards, each with a Delete action while the Bill is not yet Paid.

8. User Stories

US-01 - Create a Bill from GRs

As finance staff, I want to create a bill from one or more GRs, so that the supplier’s bill matches the goods received.

IDAcceptance criteria
AC-01.1When a user with the create permission opens Add New in the active store, the General → Products → Review wizard appears with the active store filled in (read-only), today’s bill date, and the person in charge set to the logged-in user (if registered as an employee).
AC-01.2More than one Purchase Order can be selected. The Without Purchase Order option always appears first, followed by the active store’s POs in Submitted, Partially Received, or Received status (BR-06), labeled with the PO number and the order date as a description.
AC-01.3The Goods Receipt selection is disabled until at least one Purchase Order (or the Without Purchase Order option) is selected. Its options are only the active store’s GRs in Submitted status that reference the selected POs, plus GRs without a PO if the Without Purchase Order option is selected. The label contains the GR number and the PO number as a description (or the GR date if without a PO).
AC-01.4The supplier is filled in automatically from the first PO selected, or from the first GR if no PO is selected, and cannot be changed manually. POs and GRs of other suppliers still appear but cannot be selected.
AC-01.5The billing address is disabled until the supplier is known. Its options are the supplier’s addresses, defaulting to the supplier’s default billing address; if there is none, the supplier’s first address.
AC-01.6When the payment term or bill date changes, the due date is recalculated according to BR-13. For the Custom term, the due date must be filled in manually.
AC-01.7Every time the GR selection changes, the product list is rebuilt from all selected GR items.
AC-01.8When Next is clicked in the General step and there are no products yet, the user cannot move to the next step and an error appears on the Goods Receipt field.
AC-01.9When Save succeeds, the Bill is saved in Draft status, a success toast appears, and the user is redirected to the Bill list.
AC-01.10When saving is rejected, error messages appear in the Review step and on the related fields.
AC-01.11When the user leaves the wizard with unsaved input, an unsaved changes confirmation appears.
AC-01.12The active store is inactive — the Add page shows the inactive store page.
AC-01.13The user is not assigned to any store — the Bill page shows the no store assigned page.
AC-01.14A PO or GR of another supplier is chosen after the supplier is locked — the option appears but is disabled, so it cannot be selected.
AC-01.15All PO and GR selections are cleared — the supplier lock is released; the supplier and billing address are cleared.
AC-01.16The first PO is removed from the selection — the supplier is locked again from the first remaining PO, or from the first GR if there is no PO.
AC-01.17The supplier has no address yet — the billing address is empty and the Bill cannot be saved; an address needs to be added first in the Supplier master.
AC-01.18The payment term is changed from Custom to another term — the due date is recalculated automatically and the field becomes disabled.

US-02 - Adjust prices, discounts, and tax

As finance staff, I want to adjust prices, discounts, and tax according to the supplier’s invoice, so that the bill total equals what must be paid.

IDAcceptance criteria
AC-02.1If a GR item is linked to a PO item, the price, percentage discount, nominal discount, and tax are filled from the PO item, and the PO price is shown as the Last Purchase Price (read-only). If not linked to a PO, the price is empty (0) and must be filled in (BR-08).
AC-02.2The Edit Product dialog shows the quantity and measurement unit (read-only), then the price (at least 1), percentage and nominal discounts (each can be more than one, with an optional note), and tax as a percentage or nominal (BR-09).
AC-02.3The Set General Discount/Tax dialog sets percentage discounts, nominal discounts, and tax for the whole bill (BR-10).
AC-02.4When the price, discount, or tax changes, the product totals and calculation card are updated without reloading, calculated according to BR-09 and BR-10.
AC-02.5Products cannot be added or deleted, and the quantity cannot be changed. To change the product list, change the GR selection in the General step.
AC-02.6The GR selection is changed after product prices were adjusted — all products are rebuilt from the selected GRs; earlier price, discount, and tax adjustments are lost and must be filled in again.
AC-02.7A GR without a PO is selected — product prices are empty (0) and must be filled in at least 1 before saving.

US-03 - Edit a Draft Bill

As finance staff, I want to edit a Bill that is still in Draft, so that mistakes can be fixed before it is submitted.

IDAcceptance criteria
AC-03.1The Edit Data button only appears on Draft Bills for users with the update permission in the active store (BR-03).
AC-03.2The General tab is saved as a whole: billing address, bill date, payment term and due date, person in charge, billing proof, and notes. Store, purchase orders, goods receipts, and supplier are shown read-only.
AC-03.3In the Products tab, per-product price, discount, and tax are saved immediately per product; general discount and tax are saved immediately through their dialog. Both are only available while the Bill is in Draft.
AC-03.4When the edit URL is opened on a Bill that is not in Draft, the page returns to the read-only detail view.
AC-03.5The open tab stays the same when switching from detail to edit.
AC-03.6The bill is wrong after being Submitted — there is no action yet; a Submitted Bill cannot be cancelled or revised. To be decided: a cancellation flow (for example while there are no payments) or a correction document.

US-04 - Assign the person in charge

As a store manager, I want to assign a PIC on a Bill, so that it is clear who is authorized to submit the bill.

IDAcceptance criteria
AC-04.1More than one PIC can be selected from the store’s employee list, when creating a Bill, when editing a Draft, or through the add button in the Person in Charge column of the list.
AC-04.2The add PIC button in the list only appears on Draft Bills for users with the assign permission in the active store.

US-05 - Submit a Bill

As a PIC, I want to submit a Bill, so that the bill takes effect and payments can be recorded.

IDAcceptance criteria
AC-05.1The Submit Bill button appears on Draft Bills for users with the submit permission, and is only enabled if the user is that Bill’s PIC (BR-02).
AC-05.2After confirmation, the status becomes Submitted, and who submitted it and when are recorded.
AC-05.3On a Submitted Bill, the Edit Data button, edit product, and edit general discount/tax do not appear.
AC-05.4The Bill has no PIC yet — the Submit button is disabled for all users until a PIC is assigned.
AC-05.5A user who is not the PIC opens the Bill — the Submit button appears but is disabled.

US-06 - Record payments

As an owner, I want to record payments to the supplier, all at once or in installments, so that the remaining debt is always known.

IDAcceptance criteria
AC-06.1The Payments tab is disabled while the Bill is in Draft status (BR-14).
AC-06.2The Payments tab shows a summary of the bill total, total paid, and total remaining, followed by the payment list (Payment 1, 2, and so on) along with their details and attachment previews.
AC-06.3The Add Payment button appears for users with the update permission in the active store, while the Bill is not yet Paid (BR-14, BR-16).
AC-06.4The payment form requires the payment method (Cash, Bank Transfer, Giro, Credit Card, Other), payment date & time (default now), amount (at least 1), and at least one person in charge (default the logged-in user). Proof of payment and notes are optional.
AC-06.5After a payment is saved, the summary and Bill status are updated according to BR-15.
AC-06.6The payment amount exceeds the remaining bill — the payment amount is not yet limited against the remaining bill while filling in. Needs confirmation: such a payment should ideally be rejected.

US-07 - Delete payments

As an owner, I want to delete a payment that was recorded incorrectly, so that the remaining bill is correct again.

IDAcceptance criteria
AC-07.1The delete payment action appears for users with the update permission in the active store, while the Bill is not yet Paid, after confirmation.
AC-07.2After a payment is deleted, the summary and Bill status are recalculated.
AC-07.3All payments are deleted from a Partially Paid Bill — Needs confirmation: the status returns to Submitted.

As an owner, I want to view and filter Bills, so that I can quickly find bills that are not yet paid.

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

US-09 - Delete a Draft Bill

As finance staff, I want to delete Drafts that will not be used, so that the list stays clean.

IDAcceptance criteria
AC-09.1The Delete action is only available on Draft Bills for users with the delete permission in the active store, after confirmation.
AC-09.2Bulk delete is available from the selected rows in the list.
AC-09.3A Draft Bill is deleted — Needs confirmation: the referenced GRs return to Submitted status so they can be selected on another Bill.

US-10 - Activity history

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

IDAcceptance criteria
AC-10.1The activity log is available per Bill (in the detail) and for all Bills (in the list).

9. User Scenarios

RoleScenario
Finance StaffThe supplier sends a monthly invoice; creates one Bill combining all of that month’s GRs from the supplier, including GRs without a PO
Finance StaffThe price on the supplier’s invoice differs from the PO price; adjusts the product price before submitting the Bill
OwnerPays part of the bill first because of cash flow, then settles the remainder the following week
OwnerMonitors bills that are not yet paid and nearing their due date, per supplier and per PIC

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionCondition
View Bill List
(All Stores)
purchase:bill:list:any—
View Bill List
(Assigned Stores)
purchase:bill:list:store—
View Bill Detail
(All Stores)
purchase:bill:view:any—
View Bill Detail
(Assigned Stores)
purchase:bill:view:store—
Create Billpurchase:bill:create:storeStore is active
Edit Bill
(General Data)
purchase:bill:update:storeStore is active
Edit Bill
(General Discount and Tax)
purchase:bill:update:storeStore is active
Delete Billpurchase:bill:delete:storeStore is active
View Product Detail—Follows the view Bill detail permission
Edit Product
(Price, Discount, Tax)
purchase:bill:update:storeStore is active
Add Paymentpurchase:bill:update:storeStore is active
Delete Paymentpurchase:bill:update:storeStore is active
Assign PICpurchase:bill:assign:storeStore is active, from the Bill list
Submitpurchase:bill:submit:storeStore is active, user is the PIC

10.2 Action by Status

ActionDraftSubmittedPartially PaidPaid
Edit Bill
(General Data)
✓———
Edit Bill
(General Discount and Tax)
✓———
Delete Bill✓———
View Product Detail✓✓✓✓
Edit Product
(Price, Discount, Tax)
✓———
Assign PIC✓———
Submit✓———
Add Payment—✓✓—
Delete Payment—✓✓—
View Activity Logs✓✓✓✓

11. Notifications

This feature does not trigger any notifications.

12. Dependencies

Related PRDs

  • Goods Receipt — the source of Bill items; the GR becomes Closed when referenced (BR-05).
  • Purchase Order — the GR filter, and the default source of product prices, discounts, and tax (BR-06, BR-08).
  • Purchase Return — returns that reduce the GR quantity still available to bill, and recalculate Bills that are still in Draft.
  • Credit Note — the financial counterpart of a return for goods already billed; a Bill that has left Draft is never changed by it.

Master data

  • Stores — the active store, active status, and employees (PIC).
  • Suppliers — the supplier locked from the PO/GR, along with its addresses (billing address).
  • Products & Product Inventory — products and packages carried over from GR items.

Effects on other modules

  • Goods Receipt — the referenced GR becomes Closed and cannot be selected for another Bill (BR-05).
  • A Bill does not change stock; stock already increased when the GR was submitted.
  • Finance — total paid and the remaining bill become the basis for monitoring debt to suppliers.
  • Every change is recorded in the activity log (BR-17).
Last updated on