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
- 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.
- 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.
- 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.
- Submitted — Done by the PIC. The Bill’s content is locked, and from this point payments to the supplier can start being recorded.
- 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.
- 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.
- Partially Paid — Part of the bill has been paid and the rest is still owed. The next payment is processed as in step 5.
- Paid — The entire bill has been paid. Payments can no longer be added or deleted.
5.2 Status Lifecycle
| Status | Description | Next |
|---|---|---|
Draftdraft | Being prepared, not yet in effect | Submitted, or deleted |
Submittedsubmitted | In effect and locked, no payments yet | Partially Paid, Paid |
Partially Paidpartially_paid | Part of the bill has been paid, the rest is still owed | Paid |
Paidpaid | 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
| Field | Type | Required | Default | Rules |
|---|---|---|---|---|
| Bill Number | Text | — | Generated on save | Set by the system in the format BILL/{Store Code}/{Year}/{000000}, cannot be changed |
| Store | Ref. Store | Yes | The store where the user is currently working | Cannot be changed (BR-01) |
| Purchase Order | Ref. PO, multiple | No | — | Filters the GRs that can be selected; only POs of the same store in Submitted, Partially Received, or Received status (BR-06) |
| Goods Receipt | Ref. GR, multiple | Yes | — | Selected from GRs of the same store in Submitted status, all from the same supplier (BR-04, BR-05); cannot be changed after creation |
| Supplier | Ref. Supplier | — | The supplier of the first PO or GR | Set by the system, cannot be changed after creation (BR-04) |
| Billing Address | Ref. Supplier Address | Yes | The supplier’s default billing address, or its first address | Selected from the supplier’s addresses (BR-12) |
| Bill Date | Date | Yes | Today | — |
| Payment Term | Enum | Yes | — | CBD, COD, EOM, Net 14, Net 30, Net 60, Net 90, or Custom |
| Due Date | Date | Yes, if the term is Custom | Calculated from the Payment Term | Only filled in manually for the Custom term (BR-13) |
| Person in Charge (PIC) | Ref. Employee, multiple | Yes, before submitting | The logged-in user’s employee record, if any | Store employees; can only be filled in by holders of the assign permission (BR-02) |
| Billing Proof | File, multiple | No | — | Images or documents, for example a photo of the supplier’s invoice |
| Notes | Text | No | — | — |
| General Discount | Percent or Currency, multiple | No | 0 | May be more than one, with an optional note (BR-10); a value of 0 is not saved (BR-11) |
| General Tax | Percent or Currency | No | No tax | — |
| Status | Enum | — | Draft | Set by the system; see Status Lifecycle |
6.2 Line Items
| Field | Type | Required | Default | Rules |
|---|---|---|---|---|
| GR Item | Ref. GR Item | — | Follows the selected GR | Set by the system; one row for each GR item (BR-07) |
| Product (Package) | Ref. Product | — | Follows the GR item | Set by the system, cannot be changed (BR-07) |
| Quantity | Decimal | — | The received quantity on the GR item | Set by the system, cannot be changed (BR-07) |
| Measurement Unit | Text | — | Follows the GR item’s package | Set by the system |
| Unit Price | Currency | Yes | The PO item’s price if linked, otherwise 0 | At least 1 (BR-08) |
| Percentage Discount | Percent, multiple | No | The PO item’s discount if linked, otherwise 0 | Applied in sequence (BR-09), with an optional note; a value of 0 is not saved (BR-11) |
| Nominal Discount | Currency, multiple | No | The PO item’s discount if linked, otherwise 0 | Subtracted after the Percentage Discounts (BR-09), with an optional note; a value of 0 is not saved (BR-11) |
| Tax | Percent or Currency | No | The PO item’s tax if linked, otherwise no tax | Calculated from the value after discount (BR-09) |
6.3 Calculations
| Field | Formula |
|---|---|
| Total Gross Price | Sum of (Quantity × Unit Price) across all lines |
| Total Item Discount | Sum of discounts across all lines, applied in sequence per line (BR-09) |
| Total General Discount | The whole-bill discount on Total Gross Price minus Total Item Discount, applied in sequence (BR-10) |
| Total Net Price | Total Gross Price − Total Item Discount − Total General Discount |
| Total Item Tax | Sum of tax across all lines, calculated from the value after discount (BR-09) |
| Total General Tax | The whole-bill tax, calculated from Total Net Price (BR-10) |
| Bill Total | Total Net Price + Total Item Tax + Total General Tax |
| Total Paid | Sum of all recorded payments |
| Total Remaining | Bill Total − Total Paid |
6.4 Payment
| Field | Type | Required | Default | Rules |
|---|---|---|---|---|
| Payment Method | Enum | Yes | — | Cash, Bank Transfer, Giro, Credit Card, or Other |
| Payment Date & Time | Date & Time | Yes | Now | — |
| Payment Amount | Currency | Yes | 0 | At least 1 (BR-14) |
| Person in Charge | Ref. Employee, multiple | Yes | The logged-in user’s employee record, if any | At least one store employee (BR-14) |
| Proof of Payment | File, multiple | No | — | Images or documents |
| Notes | Text | No | — | — |
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
| Column | Sortable | Sample Value | Component |
|---|---|---|---|
| Select | — | — | Checkbox, Expand Toggle |
| No | — | 1 | Number |
| Bill Number | Yes | BILL/CBI/2026/000042 | Link |
| Store | — | Cianjur Store | Text |
| Supplier | — | PT Sumber Rejeki | Text |
| Bill Date | Yes | 23 Sep 2026 | Date |
| Due Date | Yes | 23 Oct 2026 | Date |
| Bill Total | — | Rp 13,320,000 | Currency |
| Total Paid | — | Rp 5,000,000 | Currency |
| Total Remaining | — | Rp 8,320,000 | Currency |
| Person in Charge | — | Andi, Sari | Accordion, Add Button |
| Created By | — | Budi Santoso | Text |
| Status | — | Partially Paid | Badge |
| Actions | — | View · Edit · Delete | Action Menu |
Expanded Row
| Column | Sample Value | Component |
|---|---|---|
| Receipt Number | GR/CBI/2026/000031 | Link |
| Product (Package) | Cooking Oil 2L (Carton) | Thumbnail, Text |
| Quantity | 10 | Number |
| Measurement Unit | Carton | Text |
| Unit Price | Rp 250,000 | Currency |
| Total Discount | Rp 250,000 | Currency |
| Total Tax | Rp 247,500 | Currency |
| Total Price | Rp 2,497,500 | Currency |
7.2 Advance Filter
| Field | Control | Options Source | Default |
|---|---|---|---|
| Store | Multi Select | Stores assigned to the user | Active store |
| Bill Date Range | Date Range Picker | — | Empty |
| Supplier | Multi Select | Supplier master, searchable | Empty |
| Status | Multi Select | Status enum | Empty |
| Person in Charge | Multi Select | Store employees, searchable | Empty |
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
| Field | Control | Options Source | Behavior |
|---|---|---|---|
| Store | Read-only | The store where the user is currently working | — |
| Purchase Order | Multi Select | The active store’s POs in Submitted, Partially Received, or Received status, plus the Without Purchase Order option | Changed → Goods Receipt is cleared |
| Goods Receipt | Multi Select | The active store’s GRs in Submitted status that reference the selected Purchase Orders, or GRs without a PO | Disabled until at least one Purchase Order is selected; selected → Supplier is locked and the product list is rebuilt |
| Supplier | Read-only | Derived from the first Purchase Order or Goods Receipt | Locked once the first selection is made; cleared again if all selections are cleared |
| Billing Address | Single Select | The Supplier’s addresses | Disabled until the Supplier is locked |
| Bill Date | Date Picker | — | — |
| Payment Term | Single Select | Payment term enum | Changed → Due Date is recalculated |
| Due Date | Date Picker | — | Disabled except for the Custom term |
| Person in Charge (PIC) | Multi Select | Store employees | Can only be filled in by holders of the assign permission |
| Billing Proof | File Uploader, multiple | — | — |
| Notes | Textarea | — | — |
General Discount & Tax Dialog
| Field | Control | Behavior |
|---|---|---|
| General Discount | Percent Input and Currency Input, can be more than one | Rows are added/removed; each may come with a note |
| General Tax | Percent/nominal toggle, then Number Input or Currency Input | — |
Products — Table
| Column | Sample Value | Component |
|---|---|---|
| Receipt Number | GR/CBI/2026/000031 | Link |
| Product (Package) | Cooking Oil 2L (Carton) | Thumbnail, Text |
| Quantity | 10 | Number |
| Measurement Unit | Carton | Text |
| Unit Price | Rp 250,000 | Currency |
| Total Discount | Rp 250,000 | Currency |
| Total Tax | Rp 247,500 | Currency |
| Total Price | Rp 2,497,500 | Currency |
| Actions | Edit, or View in read mode | Action Menu |
Products — Form
| Field | Control | Options Source | Behavior |
|---|---|---|---|
| Product (Package) | Read-only | The originating GR item | Cannot be replaced (BR-07) |
| Quantity | Read-only | The originating GR item | Cannot be changed (BR-07) |
| Measurement Unit | Read-only | The GR item’s package | — |
| Unit Price | Currency Input | — | The last purchase price is shown as a reference next to the label |
| Percentage Discount | Percent Input, can be more than one | — | The row order determines the calculation order |
| Nominal Discount | Currency Input, can be more than one | — | — |
| Tax | Percent/nominal toggle, then Number Input or Currency Input | — | — |
Products — Calculations
| Field | Sample Value | Component |
|---|---|---|
| Total Gross Price | Rp 12,500,000 | Currency, read-only |
| Total Item Discount | Rp 500,000 | Currency, read-only |
| Total General Discount | Rp 200,000 | Currency, read-only |
| Total Net Price | Rp 11,800,000 | Currency, read-only |
| Total Item Tax | Rp 1,298,000 | Currency, read-only |
| Total General Tax | Rp 0 | Currency, read-only |
| Bill Total | Rp 13,098,000 | Currency, read-only |
| Total Paid | Rp 5,000,000 | Currency, read-only |
| Total Remaining | Rp 8,098,000 | Currency, read-only |
Payments — Summary
| Field | Sample Value | Component |
|---|---|---|
| Bill Total | Rp 13,098,000 | Currency, read-only |
| Total Paid | Rp 5,000,000 | Currency, read-only |
| Total Remaining | Rp 8,098,000 | Currency, read-only |
Payments — Form
| Field | Control | Options Source | Behavior |
|---|---|---|---|
| Payment Method | Single Select | Payment method enum | — |
| Payment Date & Time | Date Time Picker | — | Defaults to now |
| Payment Amount | Currency Input | — | — |
| Person in Charge | Multi Select | Store employees | Defaults to the logged-in user’s employee record |
| Proof of Payment | File Uploader, multiple | — | — |
| Notes | Textarea | — | — |
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.
| ID | Acceptance criteria |
|---|---|
| AC-01.1 | When 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.2 | More 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.3 | The 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.4 | The 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.5 | The 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.6 | When 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.7 | Every time the GR selection changes, the product list is rebuilt from all selected GR items. |
| AC-01.8 | When 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.9 | When Save succeeds, the Bill is saved in Draft status, a success toast appears, and the user is redirected to the Bill list. |
| AC-01.10 | When saving is rejected, error messages appear in the Review step and on the related fields. |
| AC-01.11 | When the user leaves the wizard with unsaved input, an unsaved changes confirmation appears. |
| AC-01.12 | The active store is inactive — the Add page shows the inactive store page. |
| AC-01.13 | The user is not assigned to any store — the Bill page shows the no store assigned page. |
| AC-01.14 | A 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.15 | All PO and GR selections are cleared — the supplier lock is released; the supplier and billing address are cleared. |
| AC-01.16 | The 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.17 | The 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.18 | The 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.
| ID | Acceptance criteria |
|---|---|
| AC-02.1 | If 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.2 | The 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.3 | The Set General Discount/Tax dialog sets percentage discounts, nominal discounts, and tax for the whole bill (BR-10). |
| AC-02.4 | When 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.5 | Products 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.6 | The 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.7 | A 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.
| ID | Acceptance criteria |
|---|---|
| AC-03.1 | The Edit Data button only appears on Draft Bills for users with the update permission in the active store (BR-03). |
| AC-03.2 | The 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.3 | In 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.4 | When the edit URL is opened on a Bill that is not in Draft, the page returns to the read-only detail view. |
| AC-03.5 | The open tab stays the same when switching from detail to edit. |
| AC-03.6 | The 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.
| ID | Acceptance criteria |
|---|---|
| AC-04.1 | More 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.2 | The 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.
| ID | Acceptance criteria |
|---|---|
| AC-05.1 | The 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.2 | After confirmation, the status becomes Submitted, and who submitted it and when are recorded. |
| AC-05.3 | On a Submitted Bill, the Edit Data button, edit product, and edit general discount/tax do not appear. |
| AC-05.4 | The Bill has no PIC yet — the Submit button is disabled for all users until a PIC is assigned. |
| AC-05.5 | A 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.
| ID | Acceptance criteria |
|---|---|
| AC-06.1 | The Payments tab is disabled while the Bill is in Draft status (BR-14). |
| AC-06.2 | The 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.3 | The 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.4 | The 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.5 | After a payment is saved, the summary and Bill status are updated according to BR-15. |
| AC-06.6 | The 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.
| ID | Acceptance criteria |
|---|---|
| AC-07.1 | The 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.2 | After a payment is deleted, the summary and Bill status are recalculated. |
| AC-07.3 | All payments are deleted from a Partially Paid Bill — Needs confirmation: the status returns to Submitted. |
US-08 - Bill list and search
As an owner, I want to view and filter Bills, so that I can quickly find bills that are not yet paid.
| ID | Acceptance criteria |
|---|---|
| AC-08.1 | By default, the active store’s Bills are shown; advanced filters: store, bill date range, supplier, status, and person in charge; keyword search. |
| AC-08.2 | Columns: bill number, store, supplier, bill date, due date, bill total, total paid, total remaining, person in charge, created by, and status. |
| AC-08.3 | Default sort by latest bill date at the top, with pagination. Sortable columns: bill number, bill date, and due date. |
| AC-08.4 | Rows can be expanded to see the Bill’s product list without opening the detail. |
| AC-08.5 | Row 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.
| ID | Acceptance criteria |
|---|---|
| AC-09.1 | The Delete action is only available on Draft Bills for users with the delete permission in the active store, after confirmation. |
| AC-09.2 | Bulk delete is available from the selected rows in the list. |
| AC-09.3 | A 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.
| ID | Acceptance criteria |
|---|---|
| AC-10.1 | The activity log is available per Bill (in the detail) and for all Bills (in the list). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Finance Staff | The supplier sends a monthly invoice; creates one Bill combining all of that month’s GRs from the supplier, including GRs without a PO |
| Finance Staff | The price on the supplier’s invoice differs from the PO price; adjusts the product price before submitting the Bill |
| Owner | Pays part of the bill first because of cash flow, then settles the remainder the following week |
| Owner | Monitors bills that are not yet paid and nearing their due date, per supplier and per PIC |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Condition |
|---|---|---|
| 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 Bill | purchase:bill:create:store | Store is active |
| Edit Bill (General Data) | purchase:bill:update:store | Store is active |
| Edit Bill (General Discount and Tax) | purchase:bill:update:store | Store is active |
| Delete Bill | purchase:bill:delete:store | Store is active |
| View Product Detail | — | Follows the view Bill detail permission |
| Edit Product (Price, Discount, Tax) | purchase:bill:update:store | Store is active |
| Add Payment | purchase:bill:update:store | Store is active |
| Delete Payment | purchase:bill:update:store | Store is active |
| Assign PIC | purchase:bill:assign:store | Store is active, from the Bill list |
| Submit | purchase:bill:submit:store | Store is active, user is the PIC |
10.2 Action by Status
| Action | Draft | Submitted | Partially Paid | Paid |
|---|---|---|---|---|
| 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).