> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amovio.ro/llms.txt
> Use this file to discover all available pages before exploring further.

# CRM & Lead-uri

> Urmărește prospecții de la primul contact până la finalizarea vânzării.

## Prezentare generală

Modulul **Lead-uri** îți oferă o vizualizare kanban a întregului pipeline de vânzări. Fiecare card reprezintă un prospect și vehiculul de interes.

## Etapele pipeline-ului

| Etapă         | Descriere                                 |
| ------------- | ----------------------------------------- |
| **Nou**       | Lead intrat, necontactat încă             |
| **Contactat** | Primul contact realizat                   |
| **Interesat** | A confirmat interesul, urmează test drive |
| **Negociere** | Discuții active de preț/condiții          |
| **Contract**  | Contract în pregătire sau semnat          |
| **Câștigat**  | Vânzare finalizată                        |
| **Pierdut**   | Lead-ul nu s-a materializat               |

## Crearea unui lead

1. Mergi la **Lead-uri → Lead nou**.
2. Selectează clientul (existent din **Contacte** sau adaugă unul nou).
3. Asociază vehiculul de interes.
4. Setează sursa lead-ului: Autovit, site propriu, recomandare, telefon etc.
5. Adaugă o notă inițială și salvează.

## Scanare Buletin (OCR) în wizardul de lead

În fluxurile **Cumpărător**, **Vânzător** și **Intermediere**, secțiunea **Date personale** a wizardului de lead include butonul **Scanează Buletin**.

1. Apasă **Scanează Buletin** și alege **Fotografiază acum** sau **Alege din galerie / fișier** (JPG, PNG, WEBP, HEIC, HEIF).
2. Amovio recunoaște automat **nume** și **prenume** din C.I. și le pre-completează în formular.
3. Verifică datele și completează restul wizardului (telefon, email, vehicul de interes etc.).

Pentru a completa și CNP-ul, seria/numărul CI și adresa, scanează buletinul din pagina contactului — vezi [Scanare C.I. la contacte](/platform/contacts#scanare-ci-ocr).

<Note>
  Imaginile sunt procesate prin Gemini Vision pe Vertex AI, exclusiv în regiunea UE `europe-west4`. Documentul nu este reținut după procesare și nu este folosit la antrenarea modelelor.
</Note>

## Activități și urmărire

Pe fiecare lead poți înregistra:

* **Apeluri** — durata și rezumatul conversației
* **Email-uri** — trimise direct din platformă
* **Programări** — legate de modulul Calendar
* **Note** — observații interne
* **Task-uri** — acțiuni cu deadline și responsabil

În plus, vizualizarea de detaliu a lead-ului expune un tab **WhatsApp** în timp real: vezi întreg istoricul conversației, fereastra de 24 de ore Meta și poți trimite mesaje sau template-uri fără să părăsești lead-ul. Vezi [Integrare WhatsApp Business](/integrations/whatsapp) pentru configurare.

## Surse de lead-uri

Amovio importă automat lead-urile din:

* **Autovit** — prin webhook la fiecare cerere de informații
* **Formular site** — prin API key unic pentru site-ul tău

<Tip>
  Configurează **alertele de follow-up**: dacă un lead stă mai mult de 3 zile fără activitate, primești o notificare.
</Tip>

## Lead-uri de consignație

Lead-urile de tip **Consignație** acoperă întregul ciclu al unei mașini preluate în comision: de la preluarea de la proprietar până la decontarea finală cu acesta, după vânzare.

### Pipeline-ul de consignație

Față de pipeline-ul standard, consignația folosește etichete proprii. Cel mai important: **Câștigat** apare ca **Vândută** — mașina a plecat la cumpărător, dar lead-ul rămâne deschis până decontezi cu proprietarul.

| Etapă                    | Descriere                                             |
| ------------------------ | ----------------------------------------------------- |
| **Lead nou**             | Contact inițial cu proprietarul                       |
| **Contactat**            | Am discutat cu proprietarul                           |
| **Calificat**            | Vehicul evaluat, termeni discutați                    |
| **Consignație semnată**  | Contract de consignație semnat                        |
| **Listată**              | Mașina e listată la vânzare                           |
| **Negociere cumpărător** | Avem cumpărător, negociem prețul                      |
| **Vândută**              | Mașina vândută cumpărătorului (echivalent „Câștigat") |
| **Pierdut**              | Consignație încheiată fără vânzare                    |

### Fazele lifecycle-ului

Pe lead-ul de consignație, dincolo de etapa pipeline, **faza** descrie unde te afli în fluxul de închidere. Toate acțiunile din tab-ul **Închidere** sunt derivate din faza curentă, astfel încât există o singură acțiune primară vizibilă în fiecare moment.

| Fază                          | Ce înseamnă                              | Acțiunea primară            |
| ----------------------------- | ---------------------------------------- | --------------------------- |
| **Preluare** (`ONBOARDING`)   | Date colectate, contract nesemnat        | Semnează consignația        |
| **Listată** (`LISTED`)        | Consignație semnată, mașina e la vânzare | Am un cumpărător            |
| **Negociere** (`NEGOTIATING`) | Cumpărător atașat, negociem preț         | Continuă spre vânzare       |
| **Închidere** (`CLOSING`)     | Preț agreat, urmează contract + factură  | Închide vânzarea            |
| **Decontare** (`SETTLEMENT`)  | Vândută, urmează plata proprietarului    | Finalizează cu proprietarul |
| **Finalizată** (`DONE`)       | Proprietar plătit, lead închis           | —                           |

### Tab-ul Închidere

Pe lead-urile de consignație, tab-ul **Închidere** înlocuiește lista de acțiuni cu un singur CTA primar, derivat din fază. Acțiunile secundare (regenerare contract, anulare rezervare etc.) trec în meniul overflow. După ce contractul de consignație e semnat, butonul nu se mai oferă a doua oară.

Panoul financiar afișează:

* **Prețul minim agreat** cu proprietarul.
* **Vechimea** (`ageingDays`) — câte zile sunt de la preluare.
* Badge **„Sub minimul agreat"** dacă prețul de vânzare cade sub pragul stabilit.

### Atașarea cumpărătorului (BuyerIntake)

Când treci de la **Listată** la **Negociere/Închidere**, apăsarea pe **Am un cumpărător** deschide modalul **BuyerIntake** — trei pași simpli:

1. **Cumpărător** — alegi un contact existent (căutare după nume, email, telefon) sau creezi unul nou completând nume, telefon, email.
2. **Preț** — introduci prețul de vânzare. Sub câmp vezi în timp real **previzualizarea comisionului** și **suma de plată proprietar**, calculate din cota de comision configurată pe lead.
3. **Confirmare** — opțional, marchezi mașina ca **rezervată** pentru acest cumpărător.

<Warning>
  Dacă prețul introdus este sub **minimul agreat** cu proprietarul, modalul afișează un avertisment și blochează trecerea mai departe până când bifezi **„Aprobat de proprietar"**. Decizia se salvează pe lead.
</Warning>

Modalul face un singur apel către backend care leagă cumpărătorul de lead, actualizează tranzacția și, dacă e cazul, marchează rezervarea.

### Wizardul de închidere (ConsignmentCloseWizard)

În faza **Închidere**, butonul **Închide vânzarea** deschide un wizard care produce, în ordine:

1. **Contract de vânzare** cu cumpărătorul (separat de contractul de consignație).
2. **Factura cumpărătorului** — se prefill-uiește din datele lead-ului și se emite din modulul Facturi.

Pașii deja finalizați sunt sărit automat — dacă deja ai emis factura, wizardul te aduce direct la marcarea vânzării ca finalizată.

### Decontarea cu proprietarul (ConsignmentSettlementDialog)

În faza **Decontare**, apăsarea pe **Finalizează cu proprietarul** deschide dialogul de decontare. Aici:

* Emiți **factura de comision** către proprietar (vezi [Facturare](/platform/invoices#facturi-de-comision-consignație)).
* Marchezi **plata către proprietar** drept efectuată, cu data decontării (`settlementDate`).

După ce ambele acțiuni sunt confirmate, lead-ul trece în faza **Finalizată** și dispare din rapoartele de consignații active.

### Raport Consignații

Din sidebar, **Rapoarte → Consignații** deschide pagina `/dashboard/reports/consignments` cu toate lead-urile de consignație în derulare sau finalizate recent.

Coloanele includ:

* **Lead** (cu link direct în tab-ul Închidere)
* **Vânzător** și **Vehicul**
* **Fază** (badge colorat) și **Vechime** (în zile)
* **Comision** și **De plată** către proprietar
* **Status** — `Plătit proprietar` (verde) sau `Plată pending` (chihlimbar) după caz

Chips-urile de filtrare de sus restrâng lista pe fluxuri operaționale:

| Filtru                    | Faze incluse         |
| ------------------------- | -------------------- |
| **Toate**                 | toate fazele         |
| **Fără cumpărător**       | Preluare, Listată    |
| **În închidere**          | Negociere, Închidere |
| **De încasat proprietar** | Decontare            |

Folosește **De încasat proprietar** ca queue zilnic pentru plățile restante, și **Fără cumpărător** ca listă de mașini care stau prea mult fără ofertă (combinat cu vechimea).