Introducción
Descripción general
Cotizera es una plataforma SaaS multi-tenant para generar cotizaciones profesionales en PDF. La API te permite crear cotizaciones de forma programática, gestionar clientes y productos, hacer seguimiento del ciclo de vida de las cotizaciones a través de un pipeline, y recibir notificaciones en tiempo real mediante webhooks para tus integraciones.
URL base
Todos los endpoints de la API son relativos a:
https://cotizera.com/apiAutenticación
Cotizera usa autenticación basada en sesiones a través de NextAuth. Autentícate enviando tus credenciales al endpoint de login y luego incluye la cookie de sesión en las solicitudes siguientes.
Consulta la guía de Autenticación para más detalles.
Conceptos clave
Multi-Tenancy
Cada solicitud está asociada a tu tenant (cuenta de negocio). El aislamiento de datos es automático — solo puedes acceder a los recursos que pertenecen a tu tenant.
Roles
| Rol | Descripción |
|---|---|
| OWNER | Acceso completo a todos los recursos del tenant, configuración y gestión de equipo |
| COLLABORATOR | Puede crear cotizaciones, consultar productos/clientes y crear clientes |
Planes
| Plan | Características |
|---|---|
| FREE | Cotizaciones básicas — crea cotizaciones, gestiona productos y clientes |
| PRO | Todo lo del plan Free, más: webhooks, pipeline, dashboard, colaboradores, registro de auditoría, firmas digitales, versionado de cotizaciones, multi-moneda, portal de clientes, branding en PDF |
Qué puedes hacer
- Cotizaciones — Crea, lista, actualiza y genera cotizaciones profesionales en PDF con líneas de detalle
- Ciclo de vida de cotizaciones — Haz seguimiento de las transiciones de estado: Generada → Enviada → Ganada / Perdida
- Productos — Administra tu catálogo de productos con SKUs, precios y categorías
- Clientes — Mantén una base de datos de clientes con datos de contacto y metadatos
- Pipeline — Visualiza el flujo de cotizaciones en un tablero Kanban (PRO)
- Webhooks — Recibe notificaciones de eventos en tiempo real para tus integraciones (PRO)
- Zapier — Conéctate a más de 6,000 apps mediante integración con Zapier basada en webhooks (PRO)
Siguientes pasos
- Autenticación — Aprende a autenticar tus solicitudes a la API
- API de Cotizaciones — Empieza a crear cotizaciones
- Guía de Webhooks — Configura notificaciones en tiempo real
- Manejo de Errores — Entiende las respuestas de error