How to Create a Recuperacao FTM in OfficeGest

Evidence Summary

Create route: /vendas/ftm/create
List route: /vendas/ftm
Final view: /vendas/ftm/view/OTk5OTAwMDE2
Workflow run: recovery-ftm-20260519T061803Z
Created document: 999900016 / FTM 9999/16
Evidence file: raw/playwright/workflows/latest-recovery-ftm.json

Verified Recuperacao FTM workflow

When to Use This

Use Recuperacao [FTM] for a recovery invoice document in the sales module. In the verified demo, FTM used the same vehicle/entity, delivery-method, retention, accounting, and stock-updating article-line behavior as the C. Interno CI flow, but saved under the FTM document type and list table.

Step-by-Step

Open Sales / Recuperacao [FTM], then click New, or navigate directly to /vendas/ftm/create.
Confirm the page title is OG - Recuperacao [FTM]. The primary save actions are Save Draft, Save and Print, and Save and Finish.
Select the customer. The verified run used customer 910, 100 Ouvidos Lda, VAT 509031862.
Review Vehicle & Entity. Vehicle fields were visible and Print vehicle data was checked, but the verified direct article-line FTM saved with license plate, brand, model, and mileage fields empty.
Review Delivery Method. The verified run used load address Leiria, postal code 2400, country PRT, and discharge address from the customer master record in Moura.
Confirm document series, employee, commercial, payment term, and currency. The verified run used series 9999, employee Demo, commercial Comercial 1, payment term PP, and currency EUR.
Optionally enter a reference. The verified run used AI-FTM-20260519T061803Z.
Add the article line. The verified run inserted article AI-DEMO-20260519-021105, quantity 1, warehouse 1, unit price 1.60, VAT 23%, and total 1.97.
Click Save and Finish. OfficeGest showed the confirmation Are you sure?; confirm it to create the FTM.
OfficeGest posts saveDocument, redirects to the FTM view, and creates an open recovery invoice. The verified save response was 999900016%OK&=&OKDOC&=&.
Search the FTM list for 999900016. The verified row showed status ABR / Open, total 1.97, paid 0.00, pending 1.97, and payment term Pronto Pagamento.
Check stock after saving. Warehouse 1 physical stock changed from 2 to 1; warehouse 2 stayed 0; customer-order and supplier-order quantities stayed unchanged.

Verified FTM Values

Field	Value
Internal number	`999900016`
Visible document number	`FTM 9999/16`
Customer	`[910] 100 Ouvidos Lda`, VAT `509031862`
Route/list identity	`/vendas/ftm`, table `DocumFTM`, `typesaft=FT`, `tipoop=FTM`, `oficinas=T`, `recibo=F`, `actualizacc=T`.
Vehicle fields	`doc_CodEquipExt`, `doc_Viatura`, `doc_Marca`, and `doc_Modelo` were present but blank in the verified direct-line save; `imprimirviatura` was checked.
Line	Article `AI-DEMO-20260519-021105`, quantity `1`, warehouse `1`, VAT `23%`.
Status	`ABR`, visible as Open; validation `N/D`.
Total	`1.97`; paid `0.00`; pending `1.97`.
Stock effect	Warehouse `1` physical stock changed from `2` to `1`; warehouse `2` stayed `0`; `qtd_enc_cliente` stayed `2`; `qtd_enc_forn` stayed `1`.

Backend Calls Observed

Action or endpoint	Purpose
`DT_List_Documentos&table=DocumFTM`	Loads and verifies FTM documents with `oficinas=T`, `recibo=F`, `actualizacc=T`, `typesaft=FT`, and `tipoop=FTM`.
`NameEntidades&tabla=Cliente`	Loads customer master data for customer `910`, including VAT, address, seller, and employee context.
`findDocsPendentes`	Checks pending customer documents for customer `910` during entity selection.
`loadArtigoReducido` / `insertLinhaTabDoc`	Loads the stock-updating article and inserts the FTM line. The inserted row used temporary table `47295`, article `AI-DEMO-20260519-021105`, customer `910`, warehouse `1`, quantity `1`, and document type `FTM`.
`create_document&option=calcular_totais`	Calculates gross, VAT, retention, and total. Verified totals were net `1.60`, VAT `0.37`, retention `0.00`, and total `1.97`.
`checkProfitMargins`	Validates profit margin rules for temporary table `47295` before saving.
`saveDocument`	Creates the FTM document. The verified response was `{"return":"999900016%OK&=&OKDOC&=&","print_documents":[]}`.
`dt_list_recalc_stock_articles_lojas`	Confirms stock/order quantities after final save. Warehouse `1` physical stock changed from `2` to `1`.

Raw evidence: raw/playwright/workflows/recovery-ftm-20260519T061803Z.json. Probe evidence: raw/playwright/vendas-ftm-create-probe.json. Screenshots: assets/screenshots/recovery-ftm-20260519T061803Z-01-create-page.png through assets/screenshots/recovery-ftm-20260519T061803Z-04-ftm-list.png.