Quipuy
Guías paso a paso29 de mayo de 20266 min de lecturaEquipo Quipuy

Tienda online (Shopify, WooCommerce) + factura SRI Ecuador 2026

Tienes tienda en Shopify o WooCommerce y necesitas factura electrónica SRI por cada venta. Aquí cómo integrar sin sufrir.

Tienda online + facturación SRI Ecuador 2026 — integración

Tu tienda online ya vende. Shopify, WooCommerce, Tienda Nube — la plataforma no importa. Lo que importa es que cada venta requiere factura electrónica al SRI.

Si lo haces manual (cada pedido → emites factura aparte), se te va una mañana al día. Si lo integras vía API, factura sale automática en 30 segundos sin que tú toques nada.

Aquí está cómo.

El problema sin integración

Cliente compra en Shopify → Email confirmando pedido
       ↓
Tú abres facturador SRI manualmente
       ↓
Copias datos del cliente del email
       ↓
Digitas productos uno por uno
       ↓
Calculas IVA
       ↓
Emites factura
       ↓
Descargas PDF
       ↓
Mandas al cliente por email

Tiempo por venta: 5-10 minutos. Para 30 pedidos/día = 3-5 horas/día solo facturando.

El flujo automatizado

Cliente compra en Shopify → Webhook Shopify
       ↓
Tu integración recibe el pedido
       ↓
Llama POST /api/v1/facturas en Quipuy
       ↓
Quipuy emite factura electrónica + firma + envía SRI
       ↓
Quipuy envía PDF + XML al email del cliente automáticamente
       ↓
Cliente recibe factura legal en su email

Tiempo por venta: 30 segundos. Sin intervención humana.

Componentes necesarios

1. Tienda online con webhooks

Shopify, WooCommerce, Tienda Nube — todas permiten webhooks al recibir pedido confirmado.

2. API key de tu sistema de facturación

En Quipuy: Configuración → API Keys → crea key en modo live (o test para probar).

3. Endpoint intermedio (middleware)

Recibe webhook de Shopify → llama API de Quipuy. Puede ser:

  • Función serverless (Vercel, Netlify, AWS Lambda) — recomendado, gratis hasta cierto volumen
  • Make.com / Zapier — sin código, $10-30/mes para volumen medio
  • Servidor propio — si ya tienes infraestructura

4. Mapeo de datos

Pedido Shopify trae datos del cliente + productos. Tu middleware los traduce al formato de Quipuy API.

Arquitectura tienda online + factura electrónica SRI

Setup con Quipuy API (paso a paso)

Paso 1: crear API key

  1. Entra a quipuy.com/dashboard/configuracion/api
  2. Click "Generar nueva key"
  3. Etiqueta: "Shopify Producción"
  4. Modo: live (en producción) o test (mientras pruebas — fuerza ambiente PRUEBAS SRI)
  5. Copia la key (qpy_live_abc123...) — solo se muestra una vez

Paso 2: configurar webhook en Shopify

  1. Shopify Admin → Settings → Notifications → Webhooks
  2. Crear webhook: evento Order created → URL de tu middleware
  3. Formato: JSON

Paso 3: middleware ejemplo (Node.js)

import crypto from "node:crypto";

export default async function handler(req, res) {
  // 1. Verificar firma de Shopify (opcional pero recomendado)
  const sig = req.headers["x-shopify-hmac-sha256"];
  const expected = crypto
    .createHmac("sha256", process.env.SHOPIFY_SECRET)
    .update(JSON.stringify(req.body))
    .digest("base64");
  if (sig !== expected) return res.status(401).end();

  const order = req.body;

  // 2. Mapear datos Shopify → Quipuy
  const cliente = {
    identification: order.customer?.note?.match(/\d{10,13}/)?.[0] || "9999999999999",
    name: `${order.customer?.first_name} ${order.customer?.last_name}` || "CONSUMIDOR FINAL",
    email: order.customer?.email,
  };

  const lines = order.line_items.map((item) => ({
    description: item.title,
    quantity: item.quantity,
    unit_price: parseFloat(item.price),
    tax_rate: 15, // IVA 15%
  }));

  // 3. Llamar API de Quipuy
  const idempotencyKey = `shopify-${order.id}`;
  const response = await fetch("https://quipuy.com/api/v1/facturas", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.QUIPUY_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": idempotencyKey,
    },
    body: JSON.stringify({ cliente, lines }),
  });

  const data = await response.json();
  console.log("Factura emitida:", data.document?.clave_acceso);

  res.status(200).json({ ok: true });
}

Paso 4: probar en modo test

Con API key test, las facturas van a ambiente PRUEBAS del SRI (no son reales). Prueba 5-10 pedidos. Verifica que llegan PDF al cliente.

Paso 5: cambiar a producción

Cuando confirmes que funciona, regenera API key en modo live y actualiza el env var del middleware.

Idempotencia (crítico)

Si Shopify reenvía el mismo webhook por timeout, tu sistema NO debe emitir 2 facturas.

Solución: Idempotency-Key header con order.id único. Quipuy detecta y devuelve la factura previamente emitida.

Webhooks para seguimiento

Quipuy tiene webhooks salientes que te notifican cuando:

  • factura.autorizada — SRI autorizó
  • factura.rechazada — algo falló (raro en producción)

Configura un webhook en Quipuy hacia tu sistema. Si autoriza → marcas el pedido como "facturado" en tu sistema. Si rechaza → te avisa para que investigues.

Para WooCommerce

WooCommerce tiene API REST y webhooks similares a Shopify. El middleware es prácticamente el mismo, solo cambia el formato del payload.

Plugin oficial WooCommerce → Quipuy no existe aún (en roadmap), pero el setup manual con webhook + función serverless funciona.

Para Tienda Nube

Tienda Nube tiene API y webhooks. Mismo enfoque.

Costos

Plan Quipuy

  • EMPRENDEDOR $9/mes: 80 facturas/mes (~30 pedidos/día si tienes solo plataforma online)
  • PYME $19/mes: 250 facturas/mes
  • CONTABLE $25/mes: ilimitado

Función serverless (middleware)

  • Vercel Hobby: gratis hasta 100k invocaciones/mes
  • Vercel Pro: $20/mes ilimitado

Total mensual

Para tienda online de 50-100 pedidos/día: $25-45/mes todo incluido.

Errores comunes en la integración

1. No usar Idempotency-Key

Webhook se reintenta → emites 2 facturas → cliente recibe 2 PDFs → confusión.

2. Mapear mal el cliente

Si Shopify trae cédula en notas y tu middleware no la extrae bien, facturas siempre a "Consumidor Final". El cliente con RUC se pierde la deducción.

3. No manejar errores

API de Quipuy puede devolver 422 si falta data. Si tu middleware no logea el error, se pierden ventas sin que sepas.

4. Olvidar el IVA

Productos en Shopify tienen precio. Si guardas con IVA incluido, tu cálculo de factura debe descontar el IVA. Define la regla y úsala consistentemente.

5. Webhook sin firma verificada

Cualquiera puede hacer POST a tu endpoint y crear facturas falsas. Siempre verifica HMAC del webhook.

Preguntas frecuentes

¿Quipuy tiene plugin oficial para Shopify?

Hoy no. La integración es vía API REST + middleware tuyo (o Make.com / Zapier).

¿Necesito programador para la integración?

Para Shopify + middleware Node.js: sí, mínimo 4-8 horas de un developer ($100-300 USD).

Alternativa sin código: Make.com o Zapier, $10-30/mes setup.

¿Cuál es la API de Quipuy?

quipuy.com/dashboard/configuracion/api. Endpoints: POST /facturas, POST /notas-credito, POST /retenciones. Idempotencia obligatoria. Rate limit 60-120 req/min.

¿El cliente recibe factura al instante?

Sí. Quipuy emite + envía al SRI + autoriza + manda email al cliente. Todo en 5-15 segundos.

¿Si Shopify se cae, qué pasa con la factura?

No se emite. Cuando vuelva Shopify, el webhook se reenvía y se emite la factura atrasada.

¿Cuánto cobra Quipuy por factura via API?

El plan mensual cubre el volumen. Costo marginal $0.004/factura. Si saturas el plan, subes al siguiente.

Conclusión

Tienda online + factura SRI automatizado vale la pena si tienes más de 10 pedidos/día. Setup: 4-8 horas, costo mensual: $25-45.

Genera tu API key en Quipuy y empieza con plan EMPRENDEDOR ($9/mes). Si no eres desarrollador, contacta soporte — recomendamos integradores.

Lectura relacionada: Cobrar con tarjeta + factura inmediato · Vender por Instagram + factura.