Usar la API de QuoteCrest

Descripción general

En el plan Business, QuoteCrest expone una API REST completa para que tu propio software — un ERP, un CRM, una app de servicios de campo — pueda gestionar los presupuestos directamente. Todo lo que puede hacer la aplicación está disponible: presupuestos y líneas, clientes, la biblioteca de artículos, tasas impositivas, plantillas de términos, pagos, generación de PDF, el asistente de presupuestos con IA y los disparadores de sincronización contable.

La referencia completa y siempre actualizada de los endpoints está en quotecrest.com/api-docs.

Obtener acceso

1. Asegúrate de que tu equipo está en el plan Business (Configuración → Facturación). Las llamadas a la API desde equipos Free o Pro devuelven 403 plan_required.
2. Ve a Configuración → Desarrolladores y haz clic en Registrar aplicación.
3. Asigna un nombre, tu URI de redirección (HTTPS, o localhost durante el desarrollo) y los scopes que necesites: read para acceso de lectura, write para crear y actualizar.
4. Copia el Client Secret (secreto de cliente) cuando se muestre — aparece exactamente una vez. El Client ID (identificador de cliente) permanece visible en la página de la aplicación.

Autenticación

La API usa OAuth 2.0 Authorization Code con PKCE — sin claves de API. Tu app envía a un usuario a /oauth/authorize, este aprueba los scopes solicitados, y tú intercambias el código devuelto (junto con tu verificador PKCE) en /oauth/token por un token de acceso.

• Los tokens de acceso duran 2 horas; usa el token de actualización para obtener un nuevo par.
• Los tokens de actualización rotan en cada uso — guarda siempre el par más reciente.
• Cada token está vinculado a un solo equipo: el equipo del usuario que lo autorizó.

Envía el token en cada solicitud:

Authorization: Bearer YOUR_ACCESS_TOKEN

Empieza con GET /api/v1/me — devuelve el equipo autorizado, sus valores predeterminados de presupuesto y los scopes de tu token.

Qué puedes construir

• Automatización de presupuestos — crea clientes y presupuestos (POST /api/v1/quotes), añade líneas en bloque, envía o publica, y descarga el PDF. Los valores predeterminados del equipo (términos, vencimiento, condiciones de pago, modo de precios) se aplican automáticamente.
• Presupuestos con IA — POST /api/v1/ai_quotes convierte una descripción del trabajo en lenguaje natural en un borrador de presupuesto completo usando tu biblioteca de artículos.
• Seguimiento de pagos — consulta el status / payment_status del presupuesto o lista /api/v1/payments para ver importes, comisiones y pagos netos.
• Contabilidad — comprueba el estado de la conexión en GET /api/v1/integrations y lanza una importación del catálogo de QuickBooks o Xero con POST /api/v1/integrations/{provider}/sync.

Para un recorrido completo con solicitudes de ejemplo, lee nuestra guía en dos partes: configurar tu espacio de trabajo y conectar tu app a la API.

Límites y errores

• El tráfico general de la API está limitado por IP; la generación con IA está limitada a 10 solicitudes por minuto por equipo. Una respuesta 429 significa que debes esperar y reintentar.
• 401 — token caducado o revocado (actualiza y reintenta). 402 insufficient_credits — el saldo de créditos de IA del equipo se ha agotado. 422 — errores de validación, con detalles en el cuerpo de la respuesta.

Revoca una aplicación conectada en cualquier momento desde Configuración → Desarrolladores, o como usuario final desde tu página de aplicaciones autorizadas — sus tokens dejan de funcionar de inmediato.