How to Change a Line Gross Price on a Sales Invoice in OfficeGest

Evidence Summary

Create route: /vendas/ft/create
Final view: /vendas/ft/view/OTk5OTAxNjk5
Created invoice: 999901699 / FT 9999/1699
Customer: [910] 100 Ouvidos Lda
Gross price: PVP=3.69
Evidence file: raw/playwright/workflows/latest-sales-invoice-line-gross-price.json

Verified sales invoice line gross price workflow

When to Use This

Use a line gross-price change when the user knows the final price including VAT and wants OfficeGest to derive the net unit price. This differs from editing PrecoUni, which sets the net unit price before VAT.

Step-by-Step

Open Sales / Invoice [FT], then click New document, or navigate directly to /vendas/ft/create.
Select the customer and confirm the mandatory invoice fields. The verified run used customer 910, seller 1, and employee 1.
Add the article line. The verified run inserted article AI-DEMO-20260519-021105, quantity 1, warehouse 1.
In the document lines table, edit the gross-price / PVP column. The stored line field is PVP.
Enter the new gross price. The verified run used 3.69.
Wait for the document-line grid to reload and confirm the line now holds PVP=3.69.
Review the recalculated values. In the verified run OfficeGest derived PrecoUni=3, ValorIVA=0.69, and TotalCIVA=3.69.
Click Save and Finish, then confirm Are you sure?.
Verify the saved invoice view still shows the gross price and recalculated values.

Verified Behavior

Check	Observed result
Before edit	The inserted line had `PVP=1.96677`, `PrecoUni=1.599`, and `TotalCIVA=1.96677`.
Gross price edit	`updateEditableTabDoc` returned `{"success":true,"msg":""}` for `campo=PVP` and `value=3.69`.
After grid reload	The line returned `PVP=3.69`, `PrecoUni=3`, and `TotalCIVA=3.69`.
Final view	The saved FT line retained `PVP=3.69`, `PrecoUni=3`, `ValorIVA=0.69`, and `TotalCIVA=3.69`.
List state	The FT list returned `FT 9999/1699` as `ABR` / Open with total and pending value `3.69`.

Backend Calls Observed

Action or endpoint	Purpose
`NameEntidades`	Loads customer billing data after customer selection.
`loadArtigoReducido` / `insertLinhaTabDoc`	Loads and inserts the invoice article line.
`updateEditableTabDoc`	Updates the line field `PVP`.
`DT_TabDocumento`	Reloads the document-line grid after the gross-price edit.
`saveDocument`	Saves the final FT invoice after confirmation.
`DT_List_Documentos`	Verifies the invoice list row after save.

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