Workflow

How to Create a Supplier Invoice FAF

Verified end to end. Demo run supplier-invoice-faf-20260519T070810Z created supplier invoice FAF 9999/342 / 999900342 for supplier [100] AI Demo Supplier 20260519T030323Z and verified it through DT_List_DocumentosF plus stock recalculation.

Evidence Summary

Create route
/compras/faf/create
List route
/compras/faf
Workflow run
supplier-invoice-faf-20260519T070810Z
Created invoice
999900342 / FAF 9999/342
Evidence file
raw/playwright/workflows/latest-supplier-invoice-faf.json

Verified Supplier Invoice FAF workflow

When to Use This

Use Supplier Invoice [FAF] to register a supplier invoice that increases purchase-side current account debt and, for stock-moving article lines, updates warehouse stock. The verified FAF saved as open and unpaid; it did not require a payment line during creation.

Step-by-Step

  1. Open Purchases / Supplier Invoice [FAF], then click Create Invoice Supplier, or navigate directly to /compras/faf/create.
  2. Confirm the page title is OG - Supplier Invoice [FAF]. The form carries hidden TipoOp=FAF.
  3. Select the supplier. The verified run used supplier 100, AI Demo Supplier 20260519T030323Z, VAT 590303236.
  4. Enter the supplier invoice/reference number in Supplier`s N.. The verified run used AI-FAF-20260519T070810Z, checked by findNumNoForn against table FactF.
  5. Confirm document dates, series 9999, collaborator Demo, and payment condition PP. The verified due date was 20/05/2026.
  6. Add the article line. The verified run used article AI-DEMO-20260519-021105, quantity 1, warehouse 1, unit cost 1.23, VAT 23%, and total 1.51.
  7. Review totals. OfficeGest calculated net 1.23 and rounded document total 1.51.
  8. Click Save and Finish.
  9. Confirm the Are you sure? dialog if shown.
  10. OfficeGest posts saveDocument. The verified response was {"return":"999900342%&=&OKDOC&=&"}.
  11. Verify the FAF list. Search 999900342 on /compras/faf; the verified row showed status ABR / Open, total 1.51, ValorPago=0, and validation N/D.
  12. Verify stock if the invoice includes stock-moving articles. The verified run changed warehouse 1 stock from 1 to 2.

Verified FAF Values

FieldValue
Internal number999900342
Visible documentFAF 9999/342
Supplier referenceAI-FAF-20260519T070810Z
Supplier[100] AI Demo Supplier 20260519T030323Z, VAT 590303236
Route/list identity/compras/faf, table FactF, tipoop=FAF, tipoterc=F, actualizacc=T, recibo=F.
StatusABR / Open, validation N/D.
Total/paymentTotal 1.51; paid value 0.00.
Stock effectWarehouse 1 physical stock for the demo article changed from 1 to 2; customer-order quantity stayed 4; supplier-order quantity stayed 1.

Backend Calls Observed

Action or endpointPurpose
NameEntidades&tabla=FornLoads supplier master data after selecting supplier 100.
findNumNoFornChecks duplicate supplier reference. The verified request used tabela=FactF, forn=100, and numnoforn=AI-FAF-20260519T070810Z.
loadArtigoReducido&compras=TLoads purchase article metadata, including cost 1.23, VAT 23, and current stock.
insertLinhaTabDocInserts the FAF line with id_tipoop=FAF, 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 temporary document table.
saveDocumentSaves the supplier invoice. The verified payload used TipoOp=FAF, MovimentaStock=1, id=47633, isedit=F, and israsc=0.
DT_List_DocumentosF&table=FactFVerifies the saved supplier invoice list row.
dt_list_recalc_stock_articles_lojasVerifies warehouse stock after saving the invoice.

Raw evidence: raw/playwright/workflows/supplier-invoice-faf-20260519T070810Z.json. Probe evidence: raw/playwright/compras-faf-create-probe.json. Screenshots: assets/screenshots/supplier-invoice-faf-20260519T070810Z-01-create-page.png through assets/screenshots/supplier-invoice-faf-20260519T070810Z-04-faf-list.png.

Validation Notes