API de Ventas
Endpoints para gestionar oportunidades de venta, etapas del pipeline y actividades comerciales.
Oportunidades
Listar oportunidades
Parámetros de consulta:
| Parámetro | Tipo | Descripción |
|---|
page | number | Número de página |
per_page | number | Registros por página (max: 100) |
stage | string | Filtrar por etapa del pipeline |
assigned_to | string | Filtrar por vendedor asignado |
min_value | number | Valor mínimo del negocio |
max_value | number | Valor máximo del negocio |
status | string | open, won, lost |
{
"data": [
{
"id": "opp_def456",
"name": "Implementación CRM - Tech Corp",
"value": 25000.00,
"currency": "USD",
"stage": "negotiation",
"status": "open",
"probability": 70,
"expected_close_date": "2026-04-15",
"lead_id": "lead_abc123",
"assigned_to": "user_xyz789",
"created_at": "2026-03-01T10:00:00Z"
}
]
}
Crear una oportunidad
{
"name": "Contrato anual - Empresa SA",
"value": 50000.00,
"currency": "USD",
"stage": "proposal",
"lead_id": "lead_abc123",
"expected_close_date": "2026-05-01",
"products": ["product_001", "product_002"]
}
Actualizar una oportunidad
PATCH /v1/opportunities/:id
Cerrar una oportunidad
POST /v1/opportunities/:id/close
{
"status": "won",
"final_value": 48000.00,
"close_notes": "Negociación exitosa con descuento del 4%"
}
Pipeline
Listar etapas del pipeline
Respuesta:
{
"data": [
{
"id": "stage_001",
"name": "Prospección",
"order": 1,
"probability": 10
},
{
"id": "stage_002",
"name": "Contacto inicial",
"order": 2,
"probability": 25
}
]
}
Actividades
Listar actividades
Crear una actividad
{
"type": "call",
"title": "Llamada de seguimiento",
"description": "Confirmar interés en la propuesta",
"opportunity_id": "opp_def456",
"due_date": "2026-03-20T14:00:00Z"
}
call, meeting, email, task, note
Las actividades completadas suman puntos al sistema de gamificación del vendedor asignado.
Próximos pasos
