How to Create a Supplier Payment Note RF in OfficeGest

Evidence Summary

Create route: /compras/rf/create
List route: /compras/rf
Workflow run: supplier-payment-rf-20260519T071455Z
Created payment note: 999900074 / RF 9999/74
Settled source: 999900342 / FAF 9999/342
Evidence file: raw/playwright/workflows/latest-supplier-payment-rf.json

Verified Supplier Payment Note RF workflow

When to Use This

Use Payment Note [RF] to pay or liquidate one or more open supplier documents. The verified run selected an open supplier invoice FAF 9999/342, moved it into the payment list, added a cash payment, and saved a closed RF document.

Step-by-Step

Open Purchases / Payment Note [RF], then click the create action, or navigate directly to /compras/rf/create.
Confirm the page title is OG - Payment Note [RF]. The create page exposes tabs for Supplier, Details, Recomendations, and Document.
Select the supplier. The verified run used supplier 100, AI Demo Supplier 20260519T030323Z, VAT 590303236.
Wait for OfficeGest to load the pending supplier documents. The verified pending document was FAF 9999/342, supplier reference AI-FAF-20260519T070810Z, total 1.51, paid 0, and due date 20/05/2026.
Select the document to pay and click Liquidar. OfficeGest calls changeEstadoRecibo and moves the row from pending state F to selected state T.
Confirm the selected document total. The verified RF showed total/value to pay 1.51.
Choose a payment method. The verified run used [NUM] Numerario, which created a payment line for 1.51 with outbox [0] Caixa 0.
Click End.
Confirm the Are you sure? dialog if shown.
OfficeGest posts saveDocumentRecibo. The verified response was 999900074&=&OKDOC&=&.
Verify the RF list. Search 999900074 on /compras/rf; the verified row showed RF 9999/74, supplier 100, total 1.51, and status F / Closed.
Verify the source FAF list. Search 999900342 on /compras/faf; the verified invoice changed from ABR / Open with ValorPago=0 to LIQ / Finished with ValorPago=1.51.

Verified RF Values

Field	Value
RF internal number	`999900074`
Visible RF number	`RF 9999/74`
Supplier	`[100] AI Demo Supplier 20260519T030323Z`, VAT `590303236`
Route/list identity	`/compras/rf`, table `RecibosF`, `recibo=T`, `actualizacc=T`, `tipoop=RF`, `tipoterc=F`.
RF status	`F`, visible as Closed.
RF total	`1.51`. The RF list reports `ValorPago=0` for the RF itself.
Settled supplier invoice	`999900342 / FAF 9999/342`, supplier reference `AI-FAF-20260519T070810Z`.
Source invoice result	FAF changed to `LIQ` / Finished with `ValorPago=1.51`, total `1.51`, validation `N/D`.
Payment	`[NUM] Numerario`, outbox `[0] Caixa 0`, value `1.51`, estimated date `19/05/2026`.

Backend Calls Observed

Action or endpoint	Purpose
`DT_List_DocumentosF&table=RecibosF`	Lists supplier payment notes with `recibo=T`, `actualizacc=T`, `tipoop=RF`, and `tipoterc=F`.
`DT_List_DocumentosF&table=FactF`	Verifies the source FAF before and after payment.
`NameEntidades&tabla=Forn`	Loads supplier master data after selecting supplier `100`.
`loadTabDocumentoReciboF`	Loads the supplier payment-note document context for `tipoop=RF`, supplier `100`, and temporary id `47645`.
`listaTabDocumentoRecibo&estado=F`	Loads pending supplier documents. The verified row was `FAF 9999/342` with pending value `1.51`.
`listaTabDocumentoRecibo&estado=T`	Loads supplier documents selected to pay.
`changeEstadoRecibo`	Moves the selected FAF row from pending to selected. The verified response was `{"success":true}`.
`payment&option=add`	Adds the payment line. The verified request used `compras=T`, `entidade=100`, `modopagamento=NUM`, `modobase=N`, `total=1.51`, and `tipoop=RF`.
`payment&option=validate`	Validates that the payment covers the RF total before final save.
`saveDocumentRecibo`	Saves the RF. The verified payload included `TipoOp=RF`, `CodTipoLanc=AccReciboF`, and `totAPagar=1.51`.
`payment&option=get_payment`	Loads the payment card on the saved RF view.

Raw evidence: raw/playwright/workflows/supplier-payment-rf-20260519T071455Z.json. Probe evidence: raw/playwright/compras-rf-create-probe.json. Screenshots: assets/screenshots/supplier-payment-rf-20260519T071455Z-01-create-page.png through assets/screenshots/supplier-payment-rf-20260519T071455Z-05-rf-list.png.

Validation Notes

RF works from pending supplier documents: it does not use article lines. The payment note selects open supplier documents and applies payment rows.
The source document is the key proof: verify both the RF row and the original FAF row. In the verified run, the FAF settlement state changed to LIQ with paid value equal to the invoice total.
Payment must match total: OfficeGest called payment&option=validate before saving; the verified payment total and RF total were both 1.51.
RF list payment semantics differ from the source invoice: the RF list row itself reported ValorPago=0, while the source FAF reported ValorPago=1.51 after settlement.