Saltar al contenido principal

Cotizaciones

Las cotizaciones (Quotes) viven en el módulo B2B y se gestionan desde el CRM.

Listar cotizaciones​

GET /api/v1/b2b/quotes

Parámetros:

NombreTipoDescripción
cursorstringCursor de paginación
limitintItems por página (default 25, máx 100)
filter[status]stringdraft, sent, accepted, rejected, expired, signed, converted
filter[contact_id]stringUUID del contacto
sortstring-created_at, -expires_at, total

Respuesta 200:

{
  "data": [
    {
      "id": "uuid",
      "number": "QT-2026-001",
      "contact_id": "uuid",
      "status": "sent",
      "currency": "PEN",
      "subtotal": 450000,
      "tax_amount": 81000,
      "total": 531000,
      "issued_at": "2026-04-08T12:00:00Z",
      "expires_at": "2026-05-08T12:00:00Z",
      "notes": "Validez 30 días",
      "created_at": "2026-04-08T12:00:00Z",
      "updated_at": "2026-04-08T12:00:00Z"
    }
  ],
  "meta": { "pagination": { "cursor": "eyJ...", "has_next": true, "limit": 25 } }
}

Obtener cotización​

GET /api/v1/b2b/quotes/:id

Crear cotización​

POST /api/v1/b2b/quotes

Actualizar cotización​

PATCH /api/v1/b2b/quotes/:id

Eliminar cotización​

DELETE /api/v1/b2b/quotes/:id

Enviar cotización​

POST /api/v1/b2b/quotes/:id/send

Envía la cotización al contacto por email. Genera PDF si Quotes Pro está activo.

Firmar cotización​

POST /api/v1/b2b/quotes/:id/sign

Firma electrónica del quote (requiere proveedor de firma configurado).

Convertir a pedido​

POST /api/v1/b2b/quotes/:id/convert

Convierte la cotización aceptada/firmada en un pedido (Order).

Archivar cotización​

POST /api/v1/b2b/quotes/:id/archive

Duplicar cotización​

POST /api/v1/b2b/quotes/:id/duplicate

Versiones de cotización​

Listar versiones​

GET /api/v1/b2b/quotes/:id/versions

Obtener versión específica​

GET /api/v1/b2b/quotes/:id/versions/:version

Crear nueva versión​

POST /api/v1/b2b/quotes/:id/versions

Plantillas de cotización​

Listar plantillas​

GET /api/v1/b2b/quotes/templates

Crear plantilla​

POST /api/v1/b2b/quotes/templates

Actualizar plantilla​

PATCH /api/v1/b2b/quotes/templates/:id

Eliminar plantilla​

DELETE /api/v1/b2b/quotes/templates/:id

Marcar como predeterminada​

POST /api/v1/b2b/quotes/templates/:id/default