How to Create Damages RMA in OfficeGest

Evidence Summary

Create route: /vendas/rma/create
List route: /vendas/rma
Final view: /vendas/rma/view/OTk5OTAwMDA5
Workflow run: damages-rma-20260519T062812Z
Created document: 999900009 / RMA 9999/9
Evidence file: raw/playwright/workflows/latest-damages-rma.json

Verified Damages RMA workflow

When to Use This

Use Damages [RMA] when registering a damages or malfunction sales-side document for a customer without immediately moving stock. In the verified demo, RMA created an open backlog-style document: physical stock stayed unchanged and customer-order quantity increased by the line quantity.

Step-by-Step

Open Sales / Damages [RMA], then click New malfunction or New, or navigate directly to /vendas/rma/create.
Confirm the page title is OG - Damages [RMA]. 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 the source association menu. RMA exposes [ORC] Quotation as an association option; the verified run created a direct article-line RMA.
Confirm document series, employee, commercial, and payment term. The verified run used series 9999, employee Demo, commercial Comercial 1, and payment term PP.
Optionally enter a reference. The verified run used AI-RMA-20260519T062812Z.
Add the article line. The verified run inserted article AI-DEMO-20260519-021105, quantity 1, warehouse 1, unit price 1.60, VAT 23%, total 1.97, and estimated date 19/05/2026.
Click Save and Finish. OfficeGest showed the confirmation Are you sure?; confirm it to create the RMA.
OfficeGest posts saveDocument, redirects to the RMA view, and creates an open damages document. The verified save response was 999900009%&=&OKDOC&=&.
Search the RMA list for 999900009. 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 stayed 1, while customer-order quantity changed from 3 to 4.

Verified RMA Values

Field	Value
Internal number	`999900009`
Visible document number	`RMA 9999/9`
Customer	`[910] 100 Ouvidos Lda`, VAT `509031862`
Route/list identity	`/vendas/rma`, table `DocumRMA`, `typesaft=WNE`, `tipoop=RMA`, `oficinas=F`, `recibo=F`, `actualizacc=F`.
Line	Article `AI-DEMO-20260519-021105`, quantity `1`, warehouse `1`, VAT `23%`, estimated date `19/05/2026`.
Status	`ABR`, visible as Open; validation `N/D`.
Total	`1.97`; paid `0.00`; pending `1.97`.
Stock/order effect	Warehouse `1` physical stock stayed `1`; `qtd_enc_cliente` changed from `3` to `4`; `qtd_enc_forn` stayed `1`.

Backend Calls Observed

Action or endpoint	Purpose
`DT_List_Documentos&table=DocumRMA`	Loads and verifies RMA documents with `oficinas=F`, `recibo=F`, `actualizacc=F`, `typesaft=WNE`, and `tipoop=RMA`.
`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 non-stock-updating article context and inserts the RMA line. The call used `actualizastocks=F`, temporary table `47394`, article `AI-DEMO-20260519-021105`, customer `910`, warehouse `1`, quantity `1`, and document type `RMA`.
`create_document&option=calcular_totais`	Calculates gross, VAT, and total. Verified totals were net `1.60`, VAT `0.37`, and total `1.97`.
`saveDocument`	Creates the RMA document. The verified response was `{"return":"999900009%&=&OKDOC&=&","print_documents":[]}`.
`dt_list_recalc_stock_articles_lojas`	Confirms stock/order quantities after final save. Physical stock stayed `1`; customer-order quantity changed to `4`.

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