Cómo instalar la app de AZUR en Shopify en 5 minutos (guía paso a paso)

Antes de empezar: lo que necesitas

• Una tienda Shopify activa (cualquier plan) con acceso de administrador.
• Una cuenta en AZUR con tu RUC, establecimiento y punto de emisión configurados.
• Tu firma electrónica cargada en AZUR. Sin firma no hay comprobante válido; si te falta, en tufirma.com.ec la obtienes en menos de una hora.
• Tu api_key y el enlace de instalación, que te envía soporte técnico de AZUR al escribir a soporte@azur.com.ec.

Paso 1: abre el enlace de instalación desde tu tienda

Con la sesión de tu tienda Shopify abierta, entra al enlace que te envió soporte. Shopify te mostrará la pantalla de instalación de AZUR Facturación Electrónica con los permisos que pide: leer y editar pedidos. Pulsa Instalar.

Paso 2: pega tu api_key

Al terminar la autorización se abre el panel de Ajustes de la app. En el campo api_key pega la clave que recibiste. Esa clave identifica tu empresa, tu establecimiento, tu punto de emisión y el ambiente (pruebas o producción), así que no hay nada más que configurar para conectar.

Paso 3: revisa las opciones de emisión

• Evento que emite la factura: al marcar el pedido como pagado (recomendado) o al crearlo.
• Forma de pago: el código SRI que se registra en la factura (por defecto 20, otros con utilización del sistema financiero).
• IVA por defecto: 15% o 0%, para los productos que Shopify no marque con impuesto.
• Tipo de producto: bien o servicio.
• Formato del PDF: comprobante normal en A4 o ticket.

Pulsa Guardar cambios.

Paso 4: haz una venta de prueba

Crea un pedido, márcalo como pagado y vuelve al panel de la app. En unos segundos aparece la factura con su número, su clave de acceso de 49 dígitos y, cuando el SRI la autoriza, el enlace al PDF. Si prefieres no arriesgar secuenciales, pide a soporte un api_key de ambiente de pruebas para esta etapa.

Paso 5: pide la cédula o RUC en el carrito

Para que las facturas salgan a nombre del comprador y no como consumidor final, agrega un campo en el carrito llamado cedula_ruc. Es un cambio de dos líneas en la plantilla del carrito y soporte te lo indica exactamente. Sin ese campo, la app factura a consumidor final, que también es válido para ventas menores.

Problemas frecuentes

• Api_key no existe: revisa que la pegaste completa y que corresponde a un punto de emisión activo.
• Error en firmado: tu firma electrónica no está cargada o su contraseña no está configurada en AZUR.
• La factura no aparece: confirma que el pedido está en estado pagado; si elegiste emitir al pagar, un pedido pendiente no factura.

Empieza hoy: crea tu cuenta gratis en azur.com.ec/registro, carga tu firma electrónica (si aún no la tienes, en tufirma.com.ec la obtienes en menos de una hora) y escríbenos a soporte@azur.com.ec para recibir tu api_key y el enlace de instalación de la app de AZUR para Shopify.