How to Change a Line Description on a Sales Invoice in OfficeGest

Evidence Summary

Create route: /vendas/ft/create
Final view: /vendas/ft/view/OTk5OTAxNjk1
Created invoice: 999901695 / FT 9999/1695
Customer: [910] 100 Ouvidos Lda
Custom description: Consultoria operacional OfficeGest
Evidence file: raw/playwright/workflows/latest-sales-invoice-line-description.json

Verified sales invoice line description workflow

When to Use This

Use a line description change when the article is correct but the customer-facing invoice line needs clearer wording, project context, or service detail. The verified edit only changed the descriptive text; quantities, VAT, and totals stayed unchanged.

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 article description/designation cell. The editable UI case is DesignacaoOri, but the value is saved into DesignacaoExt.
Enter the custom line wording. The verified run used Consultoria operacional OfficeGest.
Wait for the document-line grid to reload and confirm DesignacaoExt now contains the custom wording.
Click Save and Finish, then confirm Are you sure?.
Verify the saved invoice view still shows the custom line description.
Verify the FT list row. Because this is a description-only change, the verified list total stayed 1.97.

Verified Behavior

Check	Observed result
Before edit	The inserted line had `DesignacaoOri=AI Demo Article 20260519T021105Z` and empty `DesignacaoExt`.
Description edit	`updateEditableTabDoc` returned `{"success":true,"msg":""}` for `campo=DesignacaoExt`.
After grid reload	The line returned `DesignacaoExt=Consultoria operacional OfficeGest`.
Final view	The saved FT line retained `DesignacaoOri` as the article name and `DesignacaoExt` as the custom description.
List state	The FT list returned `FT 9999/1695` as `ABR` / Open with total and pending value `1.97`.

The edit function limits normal article-line descriptions to 120 characters. Lines with article code . use a larger 220-character maximum.

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