Workflow

How to Create a Consignment Guide

Verified end to end. Demo run consignment-guide-gc-20260519T055311Z created consignment guide GC 9999/5 / 999900005, verified the saved row through the GC list, and confirmed warehouse stock reduction.

Evidence Summary

Create route
/vendas/gc/create
List route
/vendas/gc
Final view
/vendas/gc/view/OTk5OTAwMDA1
Workflow run
consignment-guide-gc-20260519T055311Z
Created document
999900005 / GC 9999/5
Evidence file
raw/playwright/workflows/latest-consignment-guide-gc.json

Verified consignment guide workflow

When to Use This

Use Guide consignao [GC] when goods leave company stock under consignment for a customer, without creating a settled invoice. In the verified demo, GC behaved like an open sales shipping document: it kept the customer current account open, used list table GConsig, and reduced stock in the selected warehouse.

Step-by-Step

  1. Open Sales / Shipping / Guide consignao [GC], then click Create Guide Consignment, or navigate directly to /vendas/gc/create.
  2. Select the customer. The verified run used customer 910, 100 Ouvidos Lda, VAT 509031862.
  3. Review the available source association menu. The GC create page exposes [ENC] Internal Doc and [ORC] Quotation, but the verified run created a direct article-line guide.
  4. Open Delivery Method. Load details defaulted to Leiria headquarters; the verified run set discharge to the customer address in Moura, postal code 7860-004, country PRT.
  5. Confirm document series, employee, commercial, and payment term. The verified run used series 9999, employee Demo, commercial Comercial 1, and payment term PP.
  6. Optionally enter a Reference. The verified run used AI-GC-20260519T055311Z.
  7. Add the article line. The verified run inserted article AI-DEMO-20260519-021105, quantity 1, warehouse 1, unit price 1.60, VAT 23%, and total 1.97.
  8. Click Save and Finish. OfficeGest showed the confirmation Are you sure?; confirm it to create the guide.
  9. OfficeGest posts saveDocument, redirects to the GC view, and creates an open consignment guide. The verified save response was 999900005%OK&=&OKDOC&=&.
  10. Search the GC list for 999900005. The verified row showed status ABR / Open, total 1.97, paid 0.00, pending 1.97, and payment term Pronto Pagamento.
  11. Check stock after saving. Warehouse 1 stock for the article changed from 2 to 1; warehouse 2 stayed 0.

Verified GC Values

FieldValue
Internal number999900005
Visible document numberGC 9999/5
Customer[910] 100 Ouvidos Lda, VAT 509031862
LineArticle AI-DEMO-20260519-021105, quantity 1, warehouse 1, VAT 23%.
StatusABR, visible as Open; validation N/D.
Total1.97; paid 0.00; pending 1.97.
Stock effectWarehouse 1 stock changed from 2 to 1; warehouse 2 stayed 0.

Backend Calls Observed

Action or endpointPurpose
DT_List_Documentos&table=GConsigLoads and verifies consignment guides with typesaft=GC, tipoop=GC, and actualizacc=F.
NameEntidades&tabla=ClienteLoads customer master data for customer 910.
loadArtigoReducido / insertLinhaTabDocLoads the warehouse article and inserts the GC line. The article line stored stock 2 before save and warehouse 1.
create_document&option=calcular_totaisCalculates gross, VAT, and total. Verified totals were net 1.60, VAT 0.37, and total 1.97.
saveDocumentCreates the GC document. The verified response was {"return":"999900005%OK&=&OKDOC&=&","print_documents":[]}.
dt_list_recalc_stock_articles_lojasConfirms stock after final save. Warehouse 1 changed from 2 to 1.

Raw evidence: raw/playwright/workflows/consignment-guide-gc-20260519T055311Z.json. Probe evidence: raw/playwright/vendas-gc-create-probe.json. Screenshots: assets/screenshots/consignment-guide-gc-20260519T055311Z-01-create-page.png through assets/screenshots/consignment-guide-gc-20260519T055311Z-04-gc-list.png.