Workflow

How to Create a Prospect

Verified end to end. Demo run create-prospect-20260519T031326Z created prospect [22] AI Demo Prospect 20260519T031326Z and verified it through DT_Select_Prospects and NameEntidades.

Evidence Summary

Route
/entidades/prospect
Page title
OG - Prospects
Workflow run
create-prospect-20260519T031326Z
Created prospect
[22] AI Demo Prospect 20260519T031326Z
Verification
DT_Select_Prospects returned recordsFiltered: 1
Evidence file
raw/playwright/workflows/latest-create-prospect.json

Verified prospect creation workflow

When to Use This

Use this workflow for a potential customer or supplier that should be tracked commercially before becoming a full customer/supplier master record. Prospects carry classification, expected type, contact data, campaign, commercial, and business-area context.

Step-by-Step

  1. Open Entities / Prospects, or navigate directly to /entidades/prospect.
  2. Click New Prospect. OfficeGest loads the side modal Add new prospect through loadForm&form=prospect&id=novoprospect.
  3. Choose Customer Type. The verified run used Company, stored as TipoCliente=E.
  4. Enter the required VAT Number.
  5. Choose Expected Type. The verified run used Customer, stored as TipoProv=C.
  6. Enter the required identity and address fields: Name, Address, Location, Zip Code, and Country.
  7. Optionally fill Email, Phone, Cell phone, Referrer Type, and Classification. The verified run used CodClassif=CF / Cliente Final.
  8. Click Save. OfficeGest posts createNovoProspect.
  9. Confirm the success message Data written successfully.
  10. Search the Prospects grid by name or VAT number to confirm the new prospect appears.

Required and Default Fields

FieldVerified behavior
Customer TypeDefault observed: Company, stored as TipoCliente=E.
VAT NumberRequired. Stored as NContrib.
Expected TypeDefault observed: Customer, stored as TipoProv=C. The modal also offers Supplier.
NameRequired. Stored as Nome.
AddressRequired. Stored as Morada.
LocationRequired. Stored as Localidade.
Zip CodeRequired. Stored as CodPostal.
CountryRequired. The workflow used PT.
Email, phone, mobileOptional; saved contact values use the selected country prefix.
ClassificationOptional; the workflow used CF, displayed as Cliente Final.

Verified Created Record

FieldValue
Prospect id22
NameAI Demo Prospect 20260519T031326Z
VAT590313266
ClassificationCF / Cliente Final
Expected typeTipoProv=C / Customer
AddressRua Prospect Demo 19
LocationLeiria
Zip Code2400-004
Emailai-demo-prospect-20260519t031326z@example.invalid
Phone+351.244000004
Cell phone+351.949031326
StatusActivo: T

Backend Calls Observed

ActionPurpose
DT_Select_ProspectsLoads and filters the Prospects grid. The verified lookup by prospect name returned one row for id 22.
loadForm&form=prospect&id=novoprospectLoads the New Prospect modal HTML.
createNovoProspectCreates the prospect. The response returned id: 22 and saved fields including type, classification, and RGPD defaults.
Sel2_SelectLooks up postal-code data after the zip code is entered.
NameEntidadesReads the created prospect by CodTerc. The correct table parameter is tabla=Prospect. A lookup with tabla=Cliente and the same id returned an unrelated existing customer, so it must not be used for prospects.

Raw evidence: raw/playwright/workflows/create-prospect-20260519T031326Z.json. Screenshots: assets/screenshots/create-prospect-20260519T031326Z-01-prospects-list.png through assets/screenshots/create-prospect-20260519T031326Z-05-verified-list.png.