API Trattative

Gestisci le trattative (deal) tramite API REST.

Endpoints

Metodo	Endpoint	Descrizione
GET	/deals	Lista trattative
POST	/deals	Crea trattativa
GET	/deals/{id}	Dettaglio
PUT	/deals/{id}	Aggiorna
DELETE	/deals/{id}	Elimina
POST	/deals/{id}/change-stage	Cambia stadio

Lista Trattative

GET /api/v1/deals

Query Parameters

Parametro	Tipo	Descrizione
page	int	Pagina
per_page	int	Record per pagina
stage	string	Filtra per stadio
contact_id	int	Filtra per contatto
company_id	int	Filtra per azienda
status	string	open, won, lost

Risposta

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Progetto CRM",
      "value": 50000,
      "probability": 60,
      "stage": "proposal",
      "contact_id": 5,
      "company_id": 3,
      "expected_close_date": "2025-02-28",
      "status": "open"
    }
  ]
}

Creare Trattativa

POST /api/v1/deals

Body

{
  "name": "Progetto CRM",
  "value": 50000,
  "probability": 60,
  "stage": "qualification",
  "contact_id": 5,
  "company_id": 3,
  "expected_close_date": "2025-02-28",
  "priority": "high",
  "source": "referral"
}

Campi

Campo	Tipo	Obbligatorio
name	string	✅
value	number
probability	int
stage	string
contact_id	int
company_id	int
expected_close_date	date
priority	string
source	string

Cambiare Stadio

POST /api/v1/deals/{id}/change-stage

Body

{
  "stage": "negotiation",
  "probability": 70,
  "lost_reason": null
}

Per trattative perse, includi lost_reason.

Stadi Disponibili

Stadio	Codice
Nuovo Lead	new_lead
Qualificazione	qualification
Demo	demo
Proposta	proposal
Negoziazione	negotiation
Impegno Verbale	verbal_commitment
Chiusa Vinta	won
Chiusa Persa	lost

Esempi

# Crea trattativa
curl -X POST "https://bladecrm.it/api/v1/deals" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Nuovo Progetto",
    "value": 25000,
    "contact_id": 10
  }'

# Cambia stadio
curl -X POST "https://bladecrm.it/api/v1/deals/5/change-stage" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"stage": "won"}'