Manual del plugin

Cotizador Automático agrega un botón «Agregar a cotización» a tu tienda WooCommerce: el cliente arma su cotización, la recibe por email con un PDF profesional y la paga en un clic.

1 · Instalación del plugin

1. Descarga el .zip del plugin desde tu panel (o desde el email de bienvenida).
2. En WordPress ve a Plugins → Añadir nuevo → Subir plugin, sube el .zip y presiona Activar.
3. Aparece el menú Cotizador Automático en el admin de WordPress. Desde ahí generas la licencia (paso 2) y configuras el botón.

Requisitos: WordPress 6.0+, WooCommerce 7.0+ y PHP 8.0+. Compatible con cualquier tema; el botón hereda los estilos de tu tienda.

2 · Licencia gratis

No necesitas comprar nada para empezar: dentro del plugin presiona «Generar licencia gratis» y en segundos tienes una licencia activa en el plan FREE (15 cotizaciones al mes con todas las funciones).

✔ Licencia generada

Licencia:  7F3A-9K2M-4Q8X-1B6C   (formato XXXX-XXXX-XXXX-XXXX)
Dominio:   mitienda.cl
Plan:      FREE — 15 cotizaciones/mes
Estado:    Activa

Amarre por dominio e IP: la licencia queda ligada al dominio y a la IP del servidor que la generó (una licencia = una tienda). En cada operación el plugin envía ambos y deben coincidir. Los sitios locales (localhost, IPs privadas) no se amarran, para que puedas desarrollar tranquilo. Si migras de servidor o dominio, escríbenos y la movemos.

3 · Flujo de una cotización

1. El cliente presiona «Agregar a cotización» en los productos que le interesan (sin pasar por el carrito).
2. Revisa su cotización, ingresa su nombre y email, y la envía.
3. Recibe al instante un email con el PDF profesional adjunto (logo, detalle, condiciones y vigencia). Tú recibes una copia.
4. El email y el PDF traen un link de pago en 1 clic: al abrirlo, el carrito de WooCommerce se llena solo con los productos cotizados y el cliente cae directo en tu checkout, con tus mismos medios de pago.

Cada cotización enviada (email + PDF generado) descuenta 1 de tu cuota mensual. Los borradores que el cliente no envía no descuentan.

4 · Planes y cuota

• · FREE: 15 cotizaciones por mes calendario, con todas las funciones (PDF, email, pago en 1 clic, plantillas).
• · PRO (USD 29/mes o USD 290/año — 2 meses gratis): cotizaciones ilimitadas y soporte prioritario.
• · La cuota se reinicia el día 1 de cada mes (hora UTC).
• · Al agotarse la cuota, el plugin pausa las cotizaciones nuevas hasta el próximo mes o hasta que actives PRO desde el panel.

GET https://api.automaticquotation.com/api/v1/plugin/validate
X-API-Key: 7F3A-9K2M-4Q8X-1B6C
X-Site-Url: https://mitienda.cl

→ {
  "valid": true,
  "plan": { "code": "FREE", "monthly_quota": 15, "unlimited": false },
  "usage": { "used": 6, "remaining": 9 },
  "binding": { "domain": "mitienda.cl" }
}

El contador es visible en el propio plugin y en el panel; el plugin te avisa cuando quedan pocas cotizaciones del mes.

5 · Panel y acceso rápido

En tu panel gestionas la licencia, ves el historial de cotizaciones, el contador de cuota, la facturación y las plantillas del PDF.

Acceso rápido: el botón «Abrir panel» dentro del plugin te lleva a tu panel ya autenticado con la licencia de la tienda — sin volver a escribir la contraseña desde el admin de WordPress.

6 · Plantillas del PDF

El PDF se renderiza en el servidor con Chromium (Gotenberg): tipografía y layout idénticos a lo que ves en la vista previa del panel. Desde Panel → Configuración personalizas:

• · Logo y colores de tu marca.
• · Textos de condiciones comerciales y notas al pie.
• · Días de vigencia de la cotización (fecha de expiración impresa).
• · Moneda, impuestos y formato de números según tu tienda.

Los cambios de plantilla aplican a las cotizaciones siguientes; las ya enviadas no se alteran.

7 · Endpoints de render (referencia técnica)

El plugin usa estos endpoints automáticamente; se documentan para integraciones avanzadas. Autenticación con dos headers obligatorios en cada request:

X-API-Key: 7F3A-9K2M-4Q8X-1B6C      # tu licencia
X-Site-Url: https://mitienda.cl      # dominio amarrado a la licencia

POST /api/v1/plugin/render/pdf — sustituye los {placeholders} de tu plantilla y devuelve el PDF (application/pdf). El PDF y el email de una misma cotización (mismo quotation_ref) descuentan 1 sola de la cuota mensual; preview: true nunca descuenta.

curl -X POST https://api.automaticquotation.com/api/v1/plugin/render/pdf \
  -H "X-API-Key: $LICENSE_KEY" \
  -H "X-Site-Url: https://mitienda.cl" \
  -H "Content-Type: application/json" \
  --output cotizacion-1042.pdf \
  -d '{
    "template_html": "<h1>Cotización {id}</h1><p>{name}</p>{products_table}<p>Total: {total}</p>",
    "data": {
      "id": "1042",
      "name": "Ana Rojas",
      "products_table": "<table>...</table>",
      "total": "$ 25.980"
    },
    "quotation_ref": "cot-1042"
  }'

POST /api/v1/plugin/render/email — mismo contrato, devuelve { "html": "..." } para el email de la cotización.

GET /api/v1/plugin/validate — plan, cuota usada y estado de la licencia (ver sección 4). No descuenta cuota.

Llama a la API siempre desde tu servidor, nunca desde el navegador: expondrías tu licencia. Ante un 429 (cuota agotada) el cuerpo indica cuándo se reinicia tu cuota.

8 · Notas legales

«WooCommerce» y «WordPress» son marcas de sus respectivos titulares, mencionadas solo con fines descriptivos de compatibilidad. Cotizador Automático es un producto independiente. Cada licencia queda amarrada a un dominio y una IP de servidor (una licencia = una tienda) y el servicio se entrega tal cual, con los límites de cuota y disponibilidad del plan contratado. Puedes cancelar el plan PRO cuando quieras y volver al plan FREE sin perder tu configuración.