Deals & Pipelines

Pipelines

Un pipeline define el proceso de ventas con etapas configurables.

Listar pipelines

GET /admin/crm/pipelines

Crear pipeline

POST /admin/crm/pipelines

Campo	Requerido	Tipo	Descripción
key	sí	string	Identificador único
name	sí	string	Nombre del pipeline
is_default	no	bool	Marcar como pipeline por defecto

Renombrar pipeline

POST /admin/crm/pipelines/:id/rename

Marcar como default

POST /admin/crm/pipelines/:id/default

Eliminar pipeline

DELETE /admin/crm/pipelines/:id

Gestionar etapas

Acción	Método	Endpoint
Ver etapas	GET	/admin/crm/pipelines/:id/stages
Agregar etapa	POST	/admin/crm/pipelines/:id/stages
Eliminar etapa	DELETE	/admin/crm/pipelines/:id/stages/:stage_id

Crear etapa:

{
  "key": "proposal",
  "name": "Propuesta enviada",
  "is_won_stage": false,
  "is_lost_stage": false
}

---

Deals

Un deal es una oportunidad de venta con etapa, monto y probabilidad.

Vista Kanban

GET /admin/crm/deals

Parámetros:

Nombre	Tipo	Descripción
status	string	open (default), closed, all
view	string	kanban, table
q	string	Buscar por título
tag	string	Filtrar por tag
owner	uuid	Filtrar por responsable
date_from	date	Fecha cierre esperado desde
date_to	date	Fecha cierre esperado hasta

Crear deal

POST /admin/crm/deals

Campo	Requerido	Tipo	Descripción
title	sí	string	Título de la oportunidad
amount	no	int64	Monto en centavos
currency	no	string	Moneda (default: PEN)
probability	no	int	Probabilidad 0-100
contact_id	sí	uuid	Contacto asociado
account_id	no	uuid	Cuenta asociada
stage_id	no	uuid	Etapa inicial
owner_id	no	uuid	Responsable
expected_close	no	date	Fecha de cierre esperado
tags	no	[]string	Tags

Editar deal

POST /admin/crm/deals/:id/edit

Mover deal entre etapas

POST /admin/crm/deals/:id/move

{
  "stage_id": "uuid-de-etapa-destino"
}

Eliminar deal

DELETE /admin/crm/deals/:id