Workflow

How to Create a Supplier Debit Note NDF

Verified end to end. Demo run supplier-debit-note-ndf-20260519T075402Z created supplier debit-note document 9999/5 / 999900005 for supplier [100] AI Demo Supplier 20260519T030323Z and verified the saved row through the NDF list.

Evidence Summary

Create route
/compras/ndf/create
List route
/compras/ndf
Final view
/compras/ndf/view/OTk5OTAwMDA1
Workflow run
supplier-debit-note-ndf-20260519T075402Z
Created document
999900005 / 9999/5
Evidence file
raw/playwright/workflows/latest-supplier-debit-note-ndf.json

Verified supplier debit note NDF workflow

When to Use This

Use Note debit forn. [NDF] to register a debit note from or against a supplier. The verified path creates an open supplier debit note, updates the supplier current-account side, does not require a payment row at creation, and did not change stock or order quantities for the tested article.

Step-by-Step

  1. Open Purchases / Note debit forn. [NDF], then click Create Debit Note Supplier, or navigate directly to /compras/ndf/create.
  2. Confirm the page route is /compras/ndf/create and the form is using TipoOp=NDF.
  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-NDF-20260519T075402Z, checked by findNumNoForn against table NDebF.
  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 NDF view, and keeps the document in Open status. The verified save response was 999900005%&=&OKDOC&=&.
  10. Search the NDF list for 999900005 or the supplier reference. The verified list row had status ABR / Open, total 1.51, and paid value 0.

Verified NDF Values

FieldValue
Internal number999900005
Visible document number9999/5. The list row did not display an NDF prefix, but the route and list table identify it as tipoop=NDF.
Supplier referenceAI-NDF-20260519T075402Z
Supplier[100] AI Demo Supplier 20260519T030323Z, VAT 590303236
Route/list identity/compras/ndf, table NDebF, tipoop=NDF, tipoterc=F, actualizacc=T, recibo=F.
StatusABR / Open, validation N/D.
PaymentNo payment line; ValorPago=0.
Total1.51
Stock/order effectPhysical stock in warehouse 1 stayed 5; 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=NDebF, supplier 100, and numnoforn=AI-NDF-20260519T075402Z.
loadArtigoReducido&compras=TLoads purchase article metadata, including physical stock 5, cost 1.23, VAT 23, and supplier-order quantity 2.
insertLinhaTabDocInserts the article into temporary NDF table 47957 with id_tipoop=NDF, 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 NDF note.
saveDocumentCreates the open NDF document. The verified payload used TipoOp=NDF, CodTipoLanc=AccNDebFMerc, NumNoForn=AI-NDF-20260519T075402Z, MovimentaStock=1, id=47957, isedit=F, and israsc=0.
DT_List_DocumentosFVerifies the note in the NDF list using table NDebF, actualizacc=T, and tipoop=NDF.
dt_list_recalc_stock_articles_lojasVerifies that physical stock and order quantities did not change after saving the NDF.

Raw evidence: raw/playwright/workflows/supplier-debit-note-ndf-20260519T075402Z.json. Screenshots: assets/screenshots/supplier-debit-note-ndf-20260519T075402Z-01-create-page.png through assets/screenshots/supplier-debit-note-ndf-20260519T075402Z-04-ndf-list.png.

Validation Notes