How to Set a Line Unit of Measure on a Sales Invoice in OfficeGest

Evidence Summary

Create route: /vendas/ft/create
Final view: /vendas/ft/view/OTk5OTAxNjk4
Created invoice: 999901698 / FT 9999/1698
Customer: [910] 100 Ouvidos Lda
Line unit: H / Hora / Homem (FTE)
Evidence file: raw/playwright/workflows/latest-sales-invoice-line-unit.json

Verified sales invoice line unit workflow

When to Use This

Use a line unit change when the invoice line should be expressed in a different measurement unit, such as hours instead of units. This changes the line unit label and does not recalculate the quantity, price, VAT, or total by itself.

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 unit column. The stored line field is CodUnidade.
Select the target unit. The verified run selected H / Hora / Homem (FTE).
Wait for the document-line grid to reload and confirm the line now holds CodUnidade=H.
Review the line quantity and totals. In the verified run Qtd=1 and TotalCIVA=1.96677 stayed unchanged.
Click Save and Finish, then confirm Are you sure?.
Verify the saved invoice view still shows CodUnidade=H on the document line.

Observed Unit Choices

Code	Label
`BD`	Bidao 20L
`cm`	Centímetro
`CX`	Caixa
`H`	Hora / Homem (FTE)
`kg`	Kilograma
`L`	Litro
`m`	Metro
`M2`	Metro Quadrado
`UN`	Unidades
`VG`	Valor Global

Verified Behavior

Check	Observed result
Before edit	The inserted line had `CodUnidade=UN` and `TotalCIVA=1.96677`.
Unit edit	`updateEditableTabDoc` returned `{"success":true,"msg":""}` for `campo=CodUnidade` and `value=H`.
After grid reload	The line returned `CodUnidade=H` and the same total.
Final view	The saved FT line retained `CodUnidade=H` and `TotalCIVA=1.96677`.
List state	The FT list returned `FT 9999/1698` as `ABR` / Open with total and pending value `1.97`.

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 `CodUnidade`.
`DT_TabDocumento`	Reloads the document-line grid after the unit 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-unit-20260519T210702Z.json. Screenshots: assets/screenshots/sales-invoice-line-unit-20260519T210702Z-01-create-page.png through assets/screenshots/sales-invoice-line-unit-20260519T210702Z-04-final-view.png.