Workflow

How to Change a Line Unit Price on a Sales Invoice

Verified end to end. Demo run sales-invoice-line-unit-price-20260519T204703Z changed an FT line unit price from 1.599 to 2.50, saved FT 9999/1694, and verified the final FT line retained PrecoUni=2.5 with list total 3.08.

Evidence Summary

Create route
/vendas/ft/create
Final view
/vendas/ft/view/OTk5OTAxNjk0
Created invoice
999901694 / FT 9999/1694
Customer
[910] 100 Ouvidos Lda
Unit price
2.50
Evidence file
raw/playwright/workflows/latest-sales-invoice-line-unit-price.json

Verified sales invoice line unit price workflow

When to Use This

Use a line unit-price change when the invoice line should use a price different from the article's default price list value. This edit recalculates the line net value, VAT value, and invoice total.

Step-by-Step

  1. Open Sales / Invoice [FT], then click New document, or navigate directly to /vendas/ft/create.
  2. Select the customer and confirm the mandatory invoice fields. The verified run used customer 910, seller 1, and employee 1.
  3. Add the article line. The verified run inserted article AI-DEMO-20260519-021105, quantity 1, warehouse 1.
  4. In the document lines table, edit the unit-price column. The stored line field is PrecoUni.
  5. Enter the new unit price. The verified run used 2.50.
  6. Wait for the document-line grid to reload and confirm the line now holds PrecoUni=2.5.
  7. Review the recalculated line totals. In the verified run TotalSIVA became 2.5, ValorIVA became 0.575, and TotalCIVA became 3.075.
  8. Click Save and Finish, then confirm Are you sure?.
  9. Verify the saved invoice view still shows PrecoUni=2.5 on the document line.
  10. Verify the FT list total. The verified invoice list row displayed total and pending value 3.08.

Verified Behavior

CheckObserved result
Before editThe inserted line had PrecoUni=1.599, IVA=23, and TotalCIVA=1.96677.
Price editupdateEditableTabDoc returned {"success":true,"msg":""} for campo=PrecoUni and value=2.50.
After grid reloadThe line returned PrecoUni=2.5, TotalSIVA=2.5, ValorIVA=0.575, and TotalCIVA=3.075.
Final viewThe saved FT line retained PrecoUni=2.5, IVA=23, ValorIVA=0.575, and TotalCIVA=3.075.
List stateThe FT list returned FT 9999/1694 as ABR / Open with total and pending value 3.08.

Backend Calls Observed

Action or endpointPurpose
NameEntidadesLoads customer billing data after customer selection.
loadArtigoReducido / insertLinhaTabDocLoads and inserts the invoice article line.
updateEditableTabDocUpdates the line field PrecoUni.
DT_TabDocumentoReloads the document-line grid after the unit-price edit.
saveDocumentSaves the final FT invoice after confirmation.
DT_List_DocumentosVerifies the invoice list row after save.

Raw evidence: raw/playwright/workflows/sales-invoice-line-unit-price-20260519T204703Z.json. Screenshots: assets/screenshots/sales-invoice-line-unit-price-20260519T204703Z-01-create-page.png through assets/screenshots/sales-invoice-line-unit-price-20260519T204703Z-04-final-view.png.