Introducción
Conectar Shopify con Contífico no debería empezar copiando credenciales al azar ni probando configuraciones sin saber qué falta. Una preparación mínima evita errores y permite que la integración empiece con una base ordenada.
Si vienes desde la Home o desde el Centro de Recursos, aquí vas a encontrar un mapa claro de lo que tu empresa debe tener listo antes de activar QIntegro. Si aún no conoces el flujo general, puedes revisar primero cómo funciona la integración paso a paso y luego volver al artículo pilar sobre automatizar la facturación electrónica de Shopify en Ecuador.
Resumen rápido
- una tienda Shopify operativa;
- una cuenta activa en Contífico;
- credenciales autorizadas;
- establecimiento;
- punto de emisión;
- productos e impuestos configurados;
- datos mínimos de clientes;
- una cuenta en QIntegro.
¿Qué necesitas en Shopify?
La tienda debe estar activa y con acceso administrativo suficiente para autorizar la integración. También conviene revisar el catálogo de productos, precios, variantes, impuestos y la configuración del checkout, porque ahí se define qué información quedará disponible para facturación.
Los datos de cliente que Shopify entrega dependen de cómo esté configurada la tienda. Si el checkout no solicita cierta información, la integración no puede inventarla. QIntegro no debe pedir contraseñas personales de Shopify; trabaja con accesos autorizados.
¿Qué necesitas en Contífico?
Contífico debe tener una cuenta activa, acceso autorizado, credenciales necesarias para la integración, establecimiento, punto de emisión, productos, impuestos y la información administrativa requerida para generar documentos. No todas las empresas manejan exactamente la misma configuración, por eso cada caso debe revisarse sobre su operación real.
Establecimiento y punto de emisión
El establecimiento identifica la unidad operativa donde se registra la venta y el punto de emisión define desde qué secuencia documental se genera la factura. QIntegro necesita conocer ambos datos para preparar el documento con la configuración correcta.
La selección adecuada debe corresponder a la configuración real de la empresa en Contífico. Una elección incorrecta puede provocar errores o generar documentos que luego requieran revisión manual.
Productos y variantes
La integración relaciona los productos vendidos en Shopify con los productos utilizados para facturación en Contífico. Cuando corresponde, también toma en cuenta SKU, variantes, nombres, precios, impuestos y unidades. Si un producto falta o está incompleto, la factura puede retrasarse o requerir corrección.
Este artículo no habla de actualización automática de stock ni de sincronización total de inventario. El objetivo es explicar el procesamiento necesario para facturación.
Impuestos
Los impuestos deben estar configurados de forma coherente en ambas plataformas. Shopify y Contífico pueden representar la información de manera distinta, así que la integración necesita transformar los datos al formato esperado. Una configuración incorrecta puede causar errores o impedir que la factura avance.
Datos del cliente
Según el checkout, pueden ser necesarios nombre, identificación, correo, dirección, teléfono, tipo de cliente y otros datos requeridos para facturación. No todos los pedidos contienen automáticamente toda la información, así que la empresa debe configurar su tienda para solicitar lo necesario.
QIntegro procesa únicamente la información disponible y necesaria para la operación; no completa campos ausentes por su cuenta.
Credenciales y permisos
Shopify y Contífico requieren autorizaciones para que una integración pueda operar. Las credenciales deben compartirse únicamente dentro de canales seguros, nunca por mensajes públicos, ni en documentos o capturas sin protección. Si existe sospecha de exposición, la recomendación es revocarlas y regenerarlas según el procedimiento interno de la empresa.
QIntegro utiliza credenciales autorizadas para conectarse, valida la conexión desde el servidor y no expone secretos en el navegador.
Cuenta en QIntegro
El proceso general comienza al crear una cuenta e iniciar sesión. Después la empresa registra Shopify, valida la conexión, registra Contífico, selecciona establecimiento y punto de emisión, vuelve a validar la conexión y finalmente revisa el estado desde el Centro de Operaciones.
Checklist de preparación
Antes de conectar Shopify con Contífico, conviene confirmar que la operación esté lista.
- Shopify está operativo.
- Contífico está activo.
- Tengo autorización para configurar ambas plataformas.
- Los productos están revisados.
- Los impuestos están configurados.
- El establecimiento está identificado.
- El punto de emisión está identificado.
- Los clientes entregan los datos necesarios.
- Las credenciales están disponibles de forma segura.
- Puedo realizar una prueba controlada.
Qué configura la empresa y qué gestiona QIntegro
| Elemento | Responsabilidad de la empresa | Función de QIntegro |
|---|---|---|
| Shopify | Mantener tienda, catálogo y checkout. | Conectarse y procesar pedidos autorizados. |
| Contífico | Mantener cuenta, establecimiento, punto de emisión e impuestos. | Enviar los datos preparados y registrar el resultado. |
| Credenciales | Proveer y proteger accesos autorizados. | Usarlos para establecer las conexiones necesarias. |
| Clientes | Solicitar datos correctos en el checkout. | Procesar la información disponible. |
| Errores | Corregir datos o configuraciones. | Mostrar el estado y la causa operativa cuando sea posible. |
¿Necesitas conocimientos técnicos?
No debería ser necesario desarrollar código para usar la integración. Sí es necesario comprender la configuración básica de la empresa y, en muchos casos, contar con apoyo del responsable administrativo o contable. Una configuración ordenada facilita la implementación, pero eso no significa que debas programar.
Prueba inicial
Antes de operar con volumen, conviene hacer una prueba controlada para verificar la conexión, revisar el cliente, comprobar productos e impuestos y confirmar que establecimiento y punto de emisión estén bien seleccionados. El objetivo es detectar ajustes a tiempo, no generar documentos reales innecesarios.
Errores frecuentes antes de conectar
Los problemas más comunes son credenciales incompletas, permisos insuficientes, establecimiento incorrecto, punto de emisión equivocado, productos sin configuración, impuestos inconsistentes, clientes sin identificación, checkout sin datos mínimos y asumir que la integración corrige automáticamente toda la operación.
Preguntas frecuentes
¿Necesito una cuenta activa en Shopify?
Sí. La tienda debe estar operativa para que QIntegro pueda recibir y procesar pedidos autorizados.
¿Necesito una cuenta activa en Contífico?
Sí. La integración necesita una cuenta activa y configurada para generar documentos correctamente.
¿Debo tener productos creados en ambas plataformas?
Lo recomendable es tenerlos revisados y consistentes para evitar retrasos o errores al momento de facturar.
¿Qué es el punto de emisión?
Es la secuencia o punto desde el que se emite el documento. Debe corresponder a la configuración real de la empresa en Contífico.
¿Qué datos debe entregar el cliente?
Depende del checkout, pero normalmente nombre, identificación, correo, dirección y otros datos requeridos para facturación.
¿Debo compartir mi contraseña?
No. Las credenciales deben compartirse solo por canales seguros y con acceso autorizado.
¿Necesito conocimientos técnicos?
No para programar, pero sí para entender la configuración mínima del negocio y revisar los datos necesarios.
¿Puedo probar la conexión antes de operar?
Sí. De hecho, conviene hacerlo con una prueba controlada para revisar resultados antes de aumentar volumen.
¿Qué pasa si falta una configuración?
La integración puede requerir revisión. QIntegro registra el resultado para que el equipo corrija la configuración correspondiente.
Conclusión
La integración comienza mucho antes del primer pedido automatizado. Una configuración ordenada de Shopify, Contífico, productos, impuestos y datos de clientes permite que el proceso sea más estable y fácil de supervisar.