Cómo empezar con la API de Cotizera

Si estás construyendo una integración con Cotizera, este artículo te lleva de cero a tu primera cotización en menos de 10 minutos.

Obtén tu clave API

Desde el panel de Cotizera, ve a Configuración → Claves API y genera una nueva clave. Copia el valor — solo se muestra una vez.

export COTIZERA_API_KEY="ck_live_abc123..."

Tip: Usa claves de prueba (ck_test_...) durante el desarrollo para evitar afectar datos reales.

Autenticación

Todas las peticiones requieren el header Authorization:

curl -X GET https://api.cotizera.com/v1/quotes \
  -H "Authorization: Bearer $COTIZERA_API_KEY" \
  -H "Content-Type: application/json"

Si la clave es inválida recibirás un 401 Unauthorized. Consulta la guía de errores para el catálogo completo de códigos.

Crea tu primera cotización

Con la clave lista, crea una cotización programáticamente:

curl -X POST https://api.cotizera.com/v1/quotes \
  -H "Authorization: Bearer $COTIZERA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "cl_abc123",
    "items": [
      {
        "productId": "prod_xyz",
        "quantity": 2,
        "unitPrice": 1500.00
      }
    ],
    "currency": "MXN",
    "validDays": 30,
    "notes": "Precios sujetos a disponibilidad"
  }'

La respuesta incluye el id de la cotización y un enlace al PDF generado:

{
  "id": "qt_789",
  "number": "COT-0042",
  "status": "draft",
  "total": 3000.00,
  "pdfUrl": "https://api.cotizera.com/v1/quotes/qt_789/pdf"
}

Siguientes pasos

• Consulta la referencia completa de la API de Cotizaciones para filtros, paginación y actualizaciones.
• Configura webhooks para recibir notificaciones cuando un cliente acepte o rechace una cotización.
• Explora la integración con Zapier si prefieres automatización sin código.

La API de Cotizera sigue principios REST con respuestas JSON consistentes. Si algo falla, los mensajes de error incluyen el campo exacto y una descripción clara del problema — no tendrás que adivinar.