Fiscalbase para Shopify
Cada pedido pagado de tu tienda Shopify se convierte en una factura autorizada por el SRI, cada reembolso en una nota de crédito y, si lo activas, cada despacho en una guía de remisión.
Próximamente
La app de Shopify está construida y probada, pero todavía no está en la Shopify App Store: aún no se ha probado con una tienda real ni ha pasado la revisión de Shopify. Esta página explica cómo funcionará; te avisaremos cuando puedas instalarla.
Si vendes en Shopify, no tienes que integrar nada. Instalas la app, pegas tu clave de Fiscalbase y cada pedido pagado se factura solo. La app usa la misma API pública que cualquier desarrollador, con tu propia clave, así que tus comprobantes quedan en tu cuenta de Fiscalbase como los que emites por la API.
Qué hace
- Factura cada pedido cuando está pagado, no cuando se crea: el pago contra entrega, las transferencias y las capturas posteriores se facturan al cobrarse.
- Lee la cédula o el RUC de tu cliente de donde esté: del formulario de la página de agradecimiento, del campo de identificación de Ecuador del checkout, del campo Empresa, de tu punto de venta o de su compra anterior.
- Respeta tus precios: descuentos, envío, precios con IVA incluido, productos con IVA 0 %, exentos o no objeto, y pagos divididos entre varias pasarelas.
- Convierte cada reembolso con dinero en una nota de crédito por exactamente lo que se facturó.
- Emite la guía de remisión de cada despacho, si lo activas: por cada envío, con la factura como sustento y tu transportista. Viene apagado: cómo activarlo.
- Te avisa lo que necesita de ti: un pedido de más de USD 50 sin identificación, uno editado o cancelado después de facturarse, una factura que el SRI devolvió.
Cómo se configura
Instala la app
Desde el administrador de Shopify. Tu tienda tiene que vender en dólares: el SRI solo recibe comprobantes en USD.
Conecta tu clave de Fiscalbase
Pega una clave de API de platform.fiscalbase.io. Empieza con una clave fb_sandbox_: todo funciona igual, pero nada llega al SRI. La app guarda tu clave cifrada y nunca la vuelve a mostrar, solo sus últimos cuatro caracteres.
Elige dónde numerar
En Ajustes, el emisor, el establecimiento y el punto de emisión de las facturas de tu tienda. Si tu clave tiene un solo emisor, ya viene elegido.
Pide la cédula o el RUC en el checkout
En Configuración → Checkout de Shopify, deja el campo Empresa como opcional y cámbiale el nombre a «Cédula / RUC (para tu factura)». No lo hagas obligatorio: los botones de pago rápido desaparecen si lo es. Además, puedes pedirle al soporte de Shopify el campo de identificación de Ecuador («CI o RUC»).
Activa también, desde el editor del checkout, la validación de Fiscalbase y el formulario de la página de agradecimiento. La validación revisa los dígitos de la cédula o del RUC mientras tu cliente compra y, si lo dejas activado en Ajustes, no permite pagar más de USD 50 sin identificación.
Revisa tus formas de pago y tu IVA 0 %
En Ajustes, cada pasarela de tu tienda con su forma de pago del SRI: PayPhone, Kushki o PayPal como tarjeta de crédito, el pago contra entrega como efectivo, las transferencias como sistema financiero. Si vendes productos sin IVA, elige si son IVA 0 %, exentos o no objeto, por producto o por colección: Shopify no distingue entre los tres.
Haz un pedido de prueba y pasa a Producción
Paga un pedido con la pasarela de prueba de Shopify y mira su factura autorizada en Sandbox desde el pedido. Cuando estés listo, conecta una clave fb_live_ de un emisor con numeración de Producción y firma electrónica vigente: desde ese momento se facturan los pedidos pagados después, nunca los anteriores.
Producción necesita un plan. Si llegaste desde la Shopify App Store, elígelo en Tu plan, en la página de inicio de la app: son los mismos planes, con los mismos precios en dólares, y te los cobra Shopify. Si ya pagas Fiscalbase directamente, tu plan sirve también para tu tienda.
La identificación del comprador
Una factura a consumidor final no se puede corregir, acreditar ni anular. Por eso, cuando un pedido pagado llega sin identificación, la app espera 30 minutos (lo cambias en Ajustes) a que tu cliente la escriba en la página de agradecimiento o a que tú la añadas en el pedido. Cuando se cumple el tiempo:
- Hasta USD 50, se factura a consumidor final.
- Más de USD 50, el pedido espera con la etiqueta
factura-pendientehasta que alguien añada la identificación. Filtra tus pedidos por esa etiqueta para encontrarlos.
Un pedido que ya trae una identificación válida se factura enseguida. La app solo acepta cédulas y RUC con dígitos correctos, y consulta el RUC en el SRI para poner la razón social exacta.
En cada pedido
El bloque de Fiscalbase en la página del pedido muestra el número y el estado de la factura, los mensajes del SRI, las notas de crédito de sus reembolsos y, si activaste las guías, la guía de cada envío con su RIDE y su XML. Desde ahí puedes:
- ver el RIDE y descargar el XML autorizado;
- reenviar la factura por correo;
- añadir la identificación del comprador mientras el pedido la espera;
- reintentar una factura que el SRI devolvió, con el mismo número, o una guía que falló o que el SRI devolvió;
- abrir el comprobante en Fiscalbase.
En tu punto de venta, la caja puede escribir la cédula o el RUC antes de cobrar, ver la razón social que registra el SRI y, si no la tenía, añadirla después de la venta.
Reembolsos y cancelaciones
| Pasa en Shopify | Qué hace la app |
|---|---|
| Reembolsas productos o el envío | Una nota de crédito por lo reembolsado, cuando la factura está autorizada |
| Reembolsas sin devolver dinero | Nada: no hay qué acreditar |
| Reembolsas una factura a consumidor final | Nada: el SRI no admite nota de crédito ni anulación para ella. Te avisa en el pedido para que registres la devolución en tu contabilidad |
| Cancelas antes de facturar | No se factura |
| Cancelas después de facturar, sin reembolso | Te avisa en el pedido para que la anules en el SRI o la reembolses |
| Editas el pedido después de facturar | Te avisa en el pedido: emite una nota de crédito y una factura nueva desde Fiscalbase |
Despachos y guías de remisión
La guía sustenta el traslado de la mercadería, y la ley se la pide a quien la mueve: si entregas en la puerta de tu cliente, eres tú. La app puede emitirla por cada envío, pero viene apagada: necesita datos que solo tú tienes, quién reparte y en qué vehículo, y una guía con un transportista equivocado es un comprobante del SRI, no un borrador. Apagada, la app no toca tus despachos y emites la guía desde la consola o la API.
| Pasa en Shopify | Qué hace la app con las guías activadas |
|---|---|
| Despachas un pedido facturado con tu propio reparto | Una guía por envío, con la factura del pedido como sustento, tu transportista y tu placa, saliendo de la dirección del local de Shopify que despachó. Espera a que la factura esté autorizada |
| Despachas el pedido en dos partes | Una guía por cada parte, con solo lo que va en ella |
| Despachas con un courier que emite su propia guía de transporte | Nada: la guía del courier cubre el traslado (Reglamento, art. 36, numeral 3) |
| Despachas con un courier y la guía la emites tú | Una guía con el RUC, el nombre y la placa del courier que configuraste |
| Tu cliente retira en tienda, o el producto es digital o un servicio | Nada. Te lo dice en el pedido, con el motivo |
| Cancelas un envío cuya guía ya se emitió | Te avisa en el pedido: si la mercadería no salió, anula la guía en SRI en línea |
| La guía falla o el SRI la devuelve | Lo muestra en el pedido con el motivo, y Reintentar la rehace |
Solo salen guías de los envíos hechos después de activarlas: lo que ya salió, salió sin ella.
Cómo activarlas
Elige cómo entregas
En Ajustes → Guías de remisión, Emitir una guía por cada envío: entrego yo si todo lo entregas tú, o salvo los couriers que emiten la suya si además usas couriers.
Escribe tu transportista
La cédula, el RUC o el pasaporte de quien reparte, su nombre y la placa del vehículo. La app revisa los dígitos como lo hace el SRI. Puedes añadir una dirección de partida por defecto: se usa solo si el local de Shopify que despacha no tiene dirección.
Si usas couriers, añádelos
Escribe cada empresa como aparece al despachar en Shopify («Servientrega»). Para cada una, elige si emite su propia guía o si la emites tú con su RUC, su nombre y la placa del vehículo que retira. Una empresa que no está en la lista se trata como tu propio reparto. Confirma con tu courier qué guía usa antes de marcarlo: quién emite la guía.
Al actualizar la app, Shopify puede pedirte aprobar un permiso nuevo: leer cómo y desde qué local se despacha cada pedido. Sin activar las guías, la app no lo usa.
Tus datos y los de tus clientes
La app no guarda nombres, correos ni direcciones: solo la identificación del comprador y la referencia a cada comprobante. Si desinstalas la app, 48 horas después borramos todo lo de tu tienda, incluida tu clave. Tus comprobantes siguen en tu cuenta de Fiscalbase, donde la ley te pide conservarlos siete años.