Introducción
Un pedido puede estar correctamente pagado en Shopify y, aun así, no contener todo lo necesario para crear una factura en Contífico. El problema no siempre está en la conexión: también puede estar en el cliente, el producto, los impuestos o la configuración administrativa.
La integración conecta sistemas, pero no convierte datos incompletos o inconsistentes en información correcta sin reglas y configuraciones adecuadas. Si primero quieres entender el flujo operativo general, puedes revisar cómo funciona la integración paso a paso. Si tu empresa aún está preparando la operación, el artículo sobre qué necesitas para conectar Shopify con Contífico también puede ayudarte. Y si quieres ver el contexto comercial completo, vuelve al artículo pilar sobre automatizar la facturación electrónica de Shopify en Ecuador.
Resumen rápido
- datos del cliente;
- identificación;
- productos;
- variantes y códigos;
- impuestos;
- establecimiento y punto de emisión;
- credenciales y conexiones.
Diferencia entre error de conexión, configuración y datos
Antes de revisar un caso concreto conviene distinguir tres categorías. Un error de conexión significa que la plataforma no puede comunicarse correctamente con Shopify o Contífico. Un error de configuración indica que las credenciales pueden funcionar, pero faltan parámetros como establecimiento, punto de emisión, impuestos o productos. Un error de datos aparece cuando el pedido recibido no contiene información suficiente o contiene información inconsistente.
| Tipo de error | Qué significa | Ejemplo | Quién debe revisarlo |
|---|---|---|---|
| Conexión | No hay comunicación correcta con Shopify o Contífico. | La integración no puede validar el acceso. | Empresa con validación de QIntegro. |
| Configuración | La conexión existe, pero faltan parámetros operativos. | Establecimiento o punto de emisión no definido. | Empresa. |
| Datos | El pedido llega incompleto o inconsistente. | Cliente sin identificación o producto sin correspondencia. | Empresa. |
Error 1 - Datos incompletos del cliente
Ocurre cuando faltan nombre, identificación, correo, dirección, teléfono o datos requeridos para emitir el documento. Puede pasar porque el checkout no solicita cierta información, porque el cliente no la entregó o porque los datos están en campos diferentes.
Cómo prevenirlo: revisar el checkout, definir qué datos necesita la empresa, comprobar pedidos de prueba y validar requisitos con el responsable administrativo o contable.
Error 2 - Identificación incorrecta o ausente
La identificación puede llegar vacía, con longitud incorrecta, con un tipo incompatible o en un campo no esperado. También puede ocurrir que la operación utilice consumidor final o cliente identificado según su propia configuración.
Error 3 - Clientes duplicados o difíciles de asociar
Un mismo cliente puede comprar con correos diferentes, existir ya con otra identificación o presentar variaciones en el nombre. Cuando no hay una clave confiable, la asociación se vuelve más difícil.
Una integración puede ayudar a buscar y asociar registros, pero no debe prometer eliminación absoluta de duplicados.
Cómo prevenirlo: recopilar identificaciones consistentes, mantener datos limpios, revisar criterios de asociación y corregir registros duplicados cuando corresponda.
Error 4 - Productos o variantes sin correspondencia
Este error aparece cuando un producto vendido en Shopify no puede asociarse con el producto administrativo de Contífico. También puede deberse a SKU ausente o duplicado, variante no identificada, producto incompleto o unidad inconsistente.
Este artículo se refiere al producto necesario para facturación. No se debe prometer sincronización de inventario ni afirmar que QIntegro corrige automáticamente un catálogo desordenado.
Cómo prevenirlo: usar identificadores consistentes, revisar variantes, mantener productos correctamente configurados y realizar pruebas antes de aumentar volumen.
Error 5 - Impuestos inconsistentes
Shopify y Contífico pueden representar los impuestos de manera diferente. El producto puede tener una configuración incorrecta y un pedido puede incluir descuentos o valores que requieren transformación. La empresa debe definir la configuración tributaria aplicable.
Cómo prevenirlo: revisar impuestos en ambas plataformas, validar productos, probar escenarios reales y confirmar criterios con el responsable contable.
Error 6 - Establecimiento o punto de emisión incorrecto
El establecimiento puede no corresponder a la operación y el punto de emisión puede estar pendiente o mal seleccionado. Una configuración incorrecta puede impedir la creación del documento y cada empresa debe usar su configuración real en Contífico.
Cómo prevenirlo: identificar ambos valores antes de conectar, validar que estén activos, comprobarlos mediante una prueba controlada y no seleccionarlos al azar.
Error 7 - Credenciales inválidas, vencidas o sin permisos
Puede tratarse de una credencial incorrecta, un token revocado, permisos insuficientes, una cuenta desconectada o un secreto que ya no está disponible. QIntegro puede validar la conexión y presentar su estado, pero la empresa debe proveer accesos válidos y protegerlos.
Errores adicionales que pueden aparecer
Además de los siete casos principales, pueden aparecer cantidades o precios inconsistentes, descuentos inesperados, pedidos modificados, respuestas temporalmente no disponibles, configuración administrativa incompleta, datos con formatos no esperados o interrupciones temporales de una plataforma externa.
No todos los errores dependen de la empresa ni todos indican una falla permanente.
Qué hacer cuando una factura no se genera
- 1
Identificar el pedido afectado
Localiza el caso para no mezclarlo con otros pedidos.
- 2
Revisar la categoría del error
Confirma si es de conexión, configuración o datos.
- 3
Confirmar estado de Shopify y Contífico
Verifica que ambas plataformas respondan correctamente.
- 4
Revisar cliente y productos
Comprueba que la información sea consistente.
- 5
Confirmar impuestos
Valida que la configuración tributaria coincida con la operación.
- 6
Revisar establecimiento y punto de emisión
Comprueba que estén bien seleccionados.
- 7
Corregir y ejecutar nuevamente
Repite el flujo solo mediante el mecanismo autorizado.
- 8
Evitar duplicados
No dupliques manualmente una factura sin revisar su estado previo.
Cómo ayuda el Centro de Operaciones
Según el alcance real del MVP, el empresario puede revisar estado de Shopify, estado de Contífico, actividad reciente, pedidos, facturas, alertas, errores comprensibles, acciones recomendadas y consumo del plan gratuito. La automatización no elimina la posibilidad de errores, pero debe evitar que estos permanezcan ocultos.
Error técnico vs. mensaje comprensible
El empresario no debería necesitar interpretar respuestas crudas, códigos internos o trazas. Cuando sea posible, debe recibir qué ocurrió, qué parte se afectó, qué puede revisar y cuál es la siguiente acción. QIntegro debe traducir el problema operativo a un mensaje comprensible sin exponer información sensible.
Tabla de prevención
| Error | Señal habitual | Revisión recomendada | Responsable principal |
|---|---|---|---|
| Datos del cliente incompletos | Falta información para facturar. | Checkout y pedido. | Empresa. |
| Identificación incorrecta o ausente | Dato vacío o incompatible. | Pedido y configuración del tipo de cliente. | Empresa. |
| Clientes duplicados o difíciles de asociar | Más de un registro posible. | Identificación y criterios de asociación. | Empresa con apoyo de QIntegro. |
| Productos o variantes sin correspondencia | No hay relación clara con el catálogo administrativo. | SKU, variantes y configuración de producto. | Empresa. |
| Impuestos inconsistentes | Transformación fiscal no esperada. | Impuestos en ambas plataformas. | Empresa con validación contable. |
| Establecimiento o punto de emisión incorrecto | Documento no se crea o se detiene. | Configuración de Contífico. | Empresa. |
| Credenciales inválidas o sin permisos | Conexión no disponible. | Permisos y autorización. | Empresa con validación de QIntegro. |
Checklist antes de procesar pedidos reales
- Shopify aparece conectado.
- Contífico aparece conectado.
- Establecimiento revisado.
- Punto de emisión revisado.
- Productos de prueba configurados.
- Impuestos revisados.
- Checkout solicita datos necesarios.
- Pedido de prueba disponible.
- Resultado de prueba revisado.
- Responsable operativo sabe dónde consultar alertas.
Qué no debe hacer la empresa
La operación mejora cuando la empresa evita compartir credenciales por canales públicos, cambiar varias configuraciones a la vez sin identificar la causa, repetir una factura sin verificar su estado o asumir que todo error corresponde a la integración. Tampoco conviene ocultar datos obligatorios en el checkout ni operar catálogos e impuestos sin revisarlos.
Preguntas frecuentes
¿Por qué un pedido pagado puede no generar una factura?
Porque el pago no garantiza que el pedido tenga cliente, producto, impuestos y configuración suficientes para facturar correctamente.
¿Qué ocurre si el cliente no tiene identificación?
La factura puede requerir revisión, porque no todos los documentos se pueden emitir con la misma información faltante.
¿QIntegro evita clientes duplicados?
Puede ayudar a asociarlos y a detectar casos parecidos, pero no debe prometer eliminación absoluta de duplicados.
¿Qué pasa si un producto no existe en Contífico?
La factura puede retrasarse hasta que exista una correspondencia válida entre Shopify y el catálogo administrativo.
¿Un impuesto incorrecto puede bloquear la factura?
Sí. Si la configuración tributaria no es coherente, el documento puede quedar en revisión o requerir corrección.
¿Cómo sé si el problema es de conexión o configuración?
La diferencia clave es que un problema de conexión impide comunicarse con la plataforma, mientras que uno de configuración suele involucrar parámetros faltantes o mal definidos.
¿Puedo repetir el proceso después de corregir el error?
Sí, siempre que se use el mecanismo autorizado y se verifique primero el estado del pedido anterior.
¿Necesito soporte técnico para entender una alerta?
No necesariamente. El objetivo es que el mensaje sea comprensible para el equipo operativo, aunque en algunos casos puede requerirse apoyo inicial.
¿La automatización garantiza que nunca habrá errores?
Ninguna integración responsable debe prometer ausencia absoluta de errores; el objetivo es prevenirlos, detectarlos y facilitar su corrección.
Conclusión
Los problemas de facturación no siempre se originan en la conexión. Una operación estable depende de datos completos, productos consistentes, impuestos revisados, credenciales válidas y una configuración correcta en Contífico. La automatización aporta valor cuando reduce tareas repetitivas, valida información, registra resultados, muestra errores y permite actuar con mayor rapidez.