Purchase
Edit Purchase Line Quantity, Cost and Tax
Quantity, cost and tax edits recalculate the purchase immediately. A cost edit also updates the item's stored company price through a separate request; a tax edit changes the current purchase line but does not update the item tax master.
- Menu path
- Purchase -> Purchases -> New Purchase or open purchase -> Edit
- Verified from
- Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence
frontend/modules/receivings_write.html receiving item table and totals, frontend/static/script/js/modules/js/receiving_add.js editItemCompanyPriceReceiving, frontend/static/script/js/modules/js/receiving_add.js editItemTaxReceiving, frontend/static/script/js/modules/js/receiving_add.js receivingTextboxQtyChange and addLineReceivingChangeQty, frontend/static/script/js/modules/js/receiving_add.js removeLineItemReceiving confirmation
Know What Each Line Control Changes
| Control | Immediate result | Persistence warning |
|---|---|---|
| Quantity | Recalculates line value, line tax, subtotal and grand total. | Saved with the purchase and used for stock movement when received. |
| Cost edit icon | Accepts a non-negative decimal, shows two decimals and recalculates the line. | Also sends a separate company-price update for the item; future workflows can see the new stored cost. |
| Exclusive Tax edit icon | Changes the visible percentage and recalculates this purchase line. | Does not update the item's tax master; correct the item separately when its standard tax is wrong. |
| Pack conversion | Multiplies the entered pack count by the item's conversion factor. | The resulting base-unit quantity is what the receiving calculation uses. |
| Remove line | Removes the line after confirmation and recalculates totals. | No quantity from that line enters this purchase when saved. |
Correct a Line Before Saving
- Select the supplier first, then add or scan the intended item.
- Compare item name and unit with the supplier invoice or delivery note.
- Enter the received or ordered quantity in the Qty field.
- If the supplier unit cost differs, select the edit icon beside Cost and enter the approved decimal amount.
- When Exclusive Tax is enabled and the invoice rate differs, select the tax edit icon and enter a value from 0 to 100.
- Check the line Total after each change instead of editing several fields blindly.
- Compare subtotal, tax, additional charges and grand total with the supplier document.
- Save once, reopen the purchase and confirm the stored line and stock result.
Understand the Calculation
| Tax state | Line calculation | Operator check |
|---|---|---|
| Exclusive Tax selected and line is exclusive | Quantity x cost, plus that base multiplied by the line tax percentage. | Supplier cost must be before tax. |
| Exclusive Tax cleared | The current flow sets the line's added exclusive tax to zero. | Do not assume Posnic extracts included tax from the entered cost. |
| Quantity changed | The same cost and active tax treatment are recalculated for the new quantity. | Check decimal quantities and the displayed unit. |
| Additional charges present | Charges are added at document level after line calculations. | They do not change item cost or line tax. |
| Total rounding enabled | Displayed grand total can be rounded while the underlying computed total is retained. | Reconcile the supplier invoice and rounding policy. |
Cost Edit Has a Wider Effect
The Cost edit is not only a temporary visual correction. After accepting it, Posnic calls the company-price update endpoint for that item independently of the later purchase Save action.
- Use the cost edit only when the new item cost is approved.
- Do not experiment with a cost value and expect Close or Clear to undo the item-master update.
- If the purchase needs a one-off document value but the catalog cost must remain unchanged, follow the owner's approved costing policy before editing.
- After an accidental cost edit, open the item record, verify Company Price and correct it with authorization.
- Review margin and selling-price decisions separately; changing purchase cost does not automatically prove the selling price is still suitable.
Tax Edit Is Purchase-Specific
- The tax edit appears with the Exclusive Tax column and accepts decimal values between 0 and 100.
- It recalculates the current line and marks the line as exclusive for the receiving calculation.
- It does not rewrite the item's configured tax rate or tax type.
- If the supplier invoice exposes a catalog tax setup error, finish the controlled purchase correction and then fix the item tax master separately.
- Changing today's item master does not recompute historical purchase documents.
Returns and Existing Purchases
| Situation | Current guard | Correct response |
|---|---|---|
| Supplier return quantity | Posnic limits the entered return to the available purchased quantity and warns when exceeded. | Return only the quantity actually sent back. |
| Partially received order | Status and remaining receiving belong to the Receive workflow. | Receive or close the remaining quantity from the purchase document. |
| Remove existing line | A confirmation modal appears before the row is removed. | Confirm item identity and inventory consequence first. |
| Closed or controlled history | Available edit actions depend on state and permission. | Use return, void or approved correction rather than rewriting evidence. |
| Decimal quantity | Quantity calculation supports decimals and step controls can move by 0.01. | Use only when the item's unit genuinely supports fractional stock. |
Troubleshooting
| Problem | Likely reason | Controlled response |
|---|---|---|
| Cost edit says Enter a valid amount | Value is blank, negative or not a valid decimal. | Enter a non-negative number using a decimal point. |
| Tax column is hidden | Exclusive Tax is cleared. | Verify invoice tax treatment before enabling it; do not enable only to expose the editor. |
| Tax returns to the old rate on another purchase | Line tax edit did not update the item tax master. | Correct the item's standard tax assignment with approval. |
| Future purchases show an unexpected cost | A previous receiving cost edit updated Company Price. | Audit the item record and the purchase that introduced the change. |
| Total differs from invoice | Quantity, cost, tax, charges or tax-mode interpretation differs. | Reconcile each component and use the invoice-total warning as a review signal. |
| Return quantity is reduced automatically | Requested return exceeded available quantity. | Verify prior returns and return only remaining eligible stock. |
| Removed line disappeared | Removal was confirmed. | Re-add the correct item before save; after save use the approved correction workflow. |
Manager Verification Checklist
- Supplier, item and unit match the external document.
- Quantity reflects ordered, received or returned stock correctly.
- Any cost override is approved and its item-master effect is understood.
- Any line tax override is supported and the item master is corrected separately when required.
- Line totals, subtotal, tax, charges and grand total reconcile.
- Saved purchase and inventory log show the intended result.
- Unexpected company-price changes are reviewed before the next sale or purchase.