Workflow

How to Create a Supplier Return Note NVF

Verified end to end. Demo run supplier-return-note-nvf-20260519T080457Z created supplier return note NVF 9999/1 / 999900001 for supplier [100] AI Demo Supplier 20260519T030323Z, verified the NVF list row, and confirmed the stock decrease.

Evidence Summary

Create route
/compras/nvf/create
List route
/compras/nvf
Final view
/compras/nvf/view/OTk5OTAwMDAx
Workflow run
supplier-return-note-nvf-20260519T080457Z
Created document
999900001 / NVF 9999/1
Evidence file
raw/playwright/workflows/latest-supplier-return-note-nvf.json

Verified supplier return note NVF workflow

When to Use This

Use Note Return Supplier [NVF] to record goods returned to a supplier. In the verified path the document stayed open and unpaid, did not create a payment row, and reduced physical stock for the returned article line.

Step-by-Step

  1. Open Purchases / Note Return Supplier [NVF], then click Create Return Note Supplier, or navigate directly to /compras/nvf/create.
  2. Confirm the page route is /compras/nvf/create and the form is using TipoOp=NVF.
  3. Select the Supplier. The verified run used supplier 100, AI Demo Supplier 20260519T030323Z, VAT 590303236.
  4. Enter a traceable value in Supplier`s N.. The verified run used AI-NVF-20260519T080457Z, checked by findNumNoForn against table NDevolF.
  5. Review dates and defaults. The verified run used emission date 19/05/2026, due date 20/05/2026, series 9999, employee Demo, payment condition PP, currency EUR, and warehouse 1.
  6. Add the article line. The verified line used article AI-DEMO-20260519-021105, quantity 1, unit cost 1.23, VAT 23%, and total 1.51.
  7. Click Save and Finish.
  8. Confirm the Are you sure? dialog with OK.
  9. OfficeGest posts saveDocument, redirects to the NVF view, and keeps the document in Open status. The verified save response was 999900001%&=&OKDOC&=&.
  10. Search the NVF list for 999900001 or the supplier reference. The verified list row had status ABR / Open, total 1.51, and paid value 0.
  11. Verify stock if the return includes stock-moving articles. The verified run changed warehouse 1 stock from 4 to 3.

Verified NVF Values

FieldValue
Internal number999900001
Visible document numberNVF 9999/1
Supplier referenceAI-NVF-20260519T080457Z
Supplier[100] AI Demo Supplier 20260519T030323Z, VAT 590303236
Route/list identity/compras/nvf, table NDevolF, tipoop=NVF, tipoterc=F, actualizacc=F, recibo=F.
StatusABR / Open. Validation fields were blank in the verified list response.
PaymentNo payment line; ValorPago=0.
Total1.51
Stock/order effectPhysical stock in warehouse 1 changed from 4 to 3; customer-order quantity stayed 4; supplier-order quantity stayed 2.

Backend Calls Observed

Action or endpointPurpose
NameEntidades&tabla=FornLoads supplier master data after selecting supplier 100.
findNumNoFornChecks duplicate supplier reference using tabela=NDevolF, supplier 100, and numnoforn=AI-NVF-20260519T080457Z.
loadArtigoReducido&compras=TLoads purchase article metadata, including physical stock 4, cost 1.23, VAT 23, customer-order quantity 4, and supplier-order quantity 2.
insertLinhaTabDocInserts the article into temporary NVF table 48087 with id_tipoop=NVF, cliente=100, isforn=T, quantity 1, and warehouse 1.
price_variation_articleChecks supplier/article price variation for supplier 100.
create_document&option=calcular_totaisCalculates net, VAT, and total for the NVF note.
saveDocumentCreates the open NVF document. The verified payload used TipoOp=NVF, NumNoForn=AI-NVF-20260519T080457Z, MovimentaStock=1, id=48087, isedit=F, and israsc=0. No CodTipoLanc was present in the captured save payload.
DT_List_DocumentosFVerifies the note in the NVF list using table NDevolF, actualizacc=F, and tipoop=NVF.
dt_list_recalc_stock_articles_lojasVerifies warehouse stock after saving the NVF.

Raw evidence: raw/playwright/workflows/supplier-return-note-nvf-20260519T080457Z.json. Screenshots: assets/screenshots/supplier-return-note-nvf-20260519T080457Z-01-create-page.png through assets/screenshots/supplier-return-note-nvf-20260519T080457Z-04-nvf-list.png.

Validation Notes