Si estás empezando a conectar tu tienda online con el ERP, es normal encontrarte con errores de sincronización de productos o pedidos. Aquí tienes los problemas más habituales al integrar una tienda online con un ERP, explicados paso a paso y en lenguaje sencillo, con lo que puedes hacer en cada caso.
Los cuatro primeros los puedes resolver tú mismo en unos minutos. Los dos últimos dependen de tu hosting o de quien lleve la parte técnica de tu tienda.
Si algo no encaja con tu caso, anota el mensaje de error exacto que ves en shopea.me: es la pista más útil para tu proveedor técnico.
Para que la integración funcione, cada producto y cada variante deben tener una referencia (SKU) única. Esa referencia es el identificador que usa shopea.me para relacionar la información entre tu tienda online y el ERP. Si un producto no la tiene, el ERP no sabe a qué artículo corresponde y la sincronización se detiene para no provocar errores de stock, precios o pedidos mal asignados. Es uno de los fallos más frecuentes, sobre todo en catálogos creados a mano o importados de otros sistemas.
CAMI-ALGODON-01 o ZAPATO-NEGRO-42.Este error aparece cuando dos o más productos o variantes comparten la misma referencia (SKU). Para el ERP eso es una ambigüedad: no sabe a qué artículo asignar el stock, el precio o el pedido. Es muy habitual la primera vez que se conecta una tienda, sobre todo si has duplicado productos para crearlos más rápido o has importado un catálogo antiguo.
CAMI-BLANCA-S, CAMI-BLANCA-M, CAMI-BLANCA-L.
Mantener las referencias ordenadas y sin duplicados reduce errores de stock y facilita el trabajo de tu equipo de ventas y logística.
Para protegerte de vender más unidades de las que tienes, shopea.me no registra un pedido en el ERP si el stock disponible es insuficiente según los datos del propio ERP. Es habitual al empezar a sincronizar stock, sobre todo si antes llevabas el inventario a mano o en hojas de cálculo.
Aquí la sincronización funciona: el pedido se copia al ERP sin errores, pero el cliente entra sin CIF ni NIF, así que no puedes emitirle una factura correcta y tienes que pedirle el dato a mano. No es un fallo de la integración: la tienda nunca llegó a recoger ese dato en el momento de la compra. WooCommerce no incluye de serie un campo para el CIF/NIF, y lo mismo pasa en otras plataformas si nadie lo ha añadido.
Hay que añadir un campo de CIF/NIF al proceso de compra de tu tienda, para que el comprador lo escriba y shopea.me pueda copiarlo al ERP junto con el resto de los datos.
Cómo añadirlo en WooCommerceAhí te indicamos el plugin que recomendamos y los campos que shopea.me lee automáticamente para encontrar el CIF/NIF en el pedido.
Un error HTTP 500 significa que tu tienda ha devuelto un fallo interno del servidor mientras shopea.me intentaba comunicarse con ella. Suele venir de la configuración del servidor, de un módulo o de un plugin de la propia tienda.
Cuando el equipo técnico corrija el error, la sincronización volverá a funcionar en los siguientes intentos.
A veces la tienda no devuelve el resultado en formato JSON, sino una página de desafío de Cloudflare, un captcha o una pantalla de bloqueo de un firewall web (WAF). shopea.me intenta acceder a la API de la tienda y recibe una página HTML de protección en lugar de la respuesta que necesita. No tiene que ver con el ERP ni con los datos del pedido: ocurre porque la protección de seguridad está bloqueando o inspeccionando las llamadas a la API.
/wp-json/wc/v3/. En otras plataformas el síntoma es el mismo,
pero la ruta de la API será distinta.
La solución habitual es excluir la ruta de la API del firewall para que responda directamente con JSON.
/wp-json/wc/v3/* (en WooCommerce)./wp-json/wc/v3/* del firewall o WAF.”
No necesitas repetir el pedido ni rehacer la configuración desde cero. Una vez corregido el error —referencia, stock, fallo de la tienda o bloqueo del firewall— shopea.me se encarga del resto:
Comparte con tu equipo técnico los mensajes de error exactos que veas en shopea.me: son la pista más útil para resolver la incidencia.