{"id":386,"date":"2026-02-09T05:03:33","date_gmt":"2026-02-09T05:03:33","guid":{"rendered":"https:\/\/sitepact.com\/docs\/guide\/mautic-integration-for-woocommerce\/troubleshooting\/sync-not-working\/"},"modified":"2026-02-09T05:03:33","modified_gmt":"2026-02-09T05:03:33","slug":"la-sincronizacion-no-funciona","status":"publish","type":"docs","link":"https:\/\/sitepact.com\/docs\/es\/guia\/integracion-de-mautic-para-woocommerce\/resolucion-de-problemas\/la-sincronizacion-no-funciona\/","title":{"rendered":"La sincronizaci\u00f3n no funciona"},"content":{"rendered":"<p>Si los contactos o los pedidos no se sincronizan entre WooCommerce y Mautic, siga los pasos que se indican a continuaci\u00f3n para identificar y solucionar el problema. Comience por el principio de la lista, ya que las causas m\u00e1s comunes se enumeran en primer lugar.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">M\u00f3dulo no habilitado<\/h2>\n\n\n\n<p><strong>S\u00edntoma:<\/strong> No se sincronizan datos con Mautic, aunque la prueba de conexi\u00f3n se realiza correctamente.<\/p>\n\n\n\n<p><strong>Soluci\u00f3n:<\/strong> Cada funci\u00f3n de sincronizaci\u00f3n se controla mediante su propio m\u00f3dulo, y los m\u00f3dulos deben habilitarse individualmente. Vaya a <strong>Integraci\u00f3n de WooCommerce &gt; Mautic<\/strong> y marque la pesta\u00f1a correspondiente:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Para sincronizar los contactos, abra el <strong>Sincronizaci\u00f3n de contactos<\/strong> y aseg\u00farate de que el m\u00f3dulo est\u00e9 activado.<\/li>\n\n\n\n<li>Para sincronizar los pedidos, abra el <strong>Sincronizaci\u00f3n de pedidos<\/strong> y aseg\u00farate de que el m\u00f3dulo est\u00e9 activado.<\/li>\n\n\n\n<li>Para sincronizar los carritos abandonados, abra el <strong>Carrito abandonado<\/strong> y aseg\u00farate de que el m\u00f3dulo est\u00e9 activado.<\/li>\n<\/ul>\n\n\n\n<p>Recuerda que el m\u00f3dulo de autenticaci\u00f3n debe estar conectado y funcionando antes de que cualquier otro m\u00f3dulo pueda sincronizar datos.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Campos personalizados de Mautic no creados<\/h2>\n\n\n\n<p><strong>S\u00edntoma:<\/strong> La conexi\u00f3n funciona y el m\u00f3dulo est\u00e1 habilitado, pero datos espec\u00edficos como los detalles del pedido, el valor de por vida o los datos del carrito no aparecen en los contactos de Mautic.<\/p>\n\n\n\n<p><strong>Soluci\u00f3n:<\/strong> El complemento escribe datos en 6 campos personalizados en Mautic. Si estos campos no existen en su instancia de Mautic, la API ignorar\u00e1 los datos sin avisar. Debe crear los siguientes campos manualmente en Mautic en <strong>Configuraci\u00f3n &gt; Campos personalizados<\/strong>:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code data-no-auto-translation=\"\">mautic_woo_order_data<\/code> (Texto)<\/li>\n\n\n\n<li><code data-no-auto-translation=\"\">mautic_woo_cart_data<\/code> (Texto)<\/li>\n\n\n\n<li><code data-no-auto-translation=\"\">mautic_woo_recovery_url<\/code> (URL)<\/li>\n\n\n\n<li><code data-no-auto-translation=\"\">mautic_woo_total_spent<\/code> (N\u00famero)<\/li>\n\n\n\n<li><code data-no-auto-translation=\"\">mautic_woo_order_count<\/code> (N\u00famero)<\/li>\n\n\n\n<li><code data-no-auto-translation=\"\">mautic_woo_coupon_code<\/code> (Texto)<\/li>\n<\/ul>\n\n\n\n<p>Ver el <strong>Campos de Mautic<\/strong> secci\u00f3n de esta documentaci\u00f3n para obtener informaci\u00f3n detallada sobre cada campo, incluyendo el alias y el tipo correctos.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">WP-Cron no se activa<\/h2>\n\n\n\n<p><strong>S\u00edntoma:<\/strong> Los trabajos de sincronizaci\u00f3n masiva se atascan, la detecci\u00f3n de carritos abandonados no funciona o las tareas programadas parecen no ejecutarse nunca.<\/p>\n\n\n\n<p><strong>Soluci\u00f3n:<\/strong> WordPress cron (WP-Cron) solo se ejecuta cuando alguien visita tu sitio. En sitios con poco tr\u00e1fico, esto significa que las tareas programadas pueden retrasarse horas o incluso d\u00edas.<\/p>\n\n\n\n<p>Para garantizar que WP-Cron funcione de manera confiable, configura una tarea cron real en el servidor que acceda a tu sitio. <code data-no-auto-translation=\"\">wp-cron.php<\/code> punto final a intervalos regulares. A continuaci\u00f3n se explica c\u00f3mo hacerlo:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Agregue la siguiente l\u00ednea a su <code data-no-auto-translation=\"\">wp-config.php<\/code> archivo para desactivar el cron activado por defecto por los visitantes: <code data-no-auto-translation=\"\">define( 'DISABLE_WP_CRON', true );<\/code><\/li>\n<li>Configura una tarea cron del sistema (a trav\u00e9s del panel de control de tu alojamiento o SSH) para llamar a WP-Cron cada 5 minutos. El comando es el siguiente: <code data-no-auto-translation=\"\">*\/5 * * * * wget -q -O \/dev\/null https:\/\/yoursite.com\/wp-cron.php<\/code><\/li>\n<\/ol>\n\n\n\n<p>La mayor\u00eda de los proveedores de alojamiento ofrecen un programador de tareas cron en su panel de control. Si no est\u00e1 seguro de c\u00f3mo configurarlo, p\u00f3ngase en contacto con su proveedor de alojamiento para obtener ayuda.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">La sincronizaci\u00f3n de pedidos solo se activa en estados espec\u00edficos.<\/h2>\n\n\n\n<p><strong>S\u00edntoma:<\/strong> Algunos pedidos se sincronizan, pero otros no. Los pedidos nuevos o en proceso no aparecen en Mautic.<\/p>\n\n\n\n<p><strong>Soluci\u00f3n:<\/strong> De forma predeterminada, el m\u00f3dulo Order Sync solo se activa cuando un pedido alcanza el <strong>Terminado<\/strong> o <strong>Reembolsado<\/strong> estado. Los pedidos que a\u00fan se encuentren en proceso, en espera o pendientes de pago no se sincronizar\u00e1n hasta que su estado cambie a uno de los estados rastreados.<\/p>\n\n\n\n<p>Esto es intencionado, ya que sincronizar pedidos incompletos podr\u00eda enviar datos inexactos a Mautic. Si necesita realizar un seguimiento de estados de pedidos adicionales, consulte la pesta\u00f1a Sincronizaci\u00f3n de pedidos para ver las configuraciones disponibles.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">La sincronizaci\u00f3n de contactos requiere un evento de registro.<\/h2>\n\n\n\n<p><strong>S\u00edntoma:<\/strong> El m\u00f3dulo Contact Sync est\u00e1 habilitado, pero los clientes existentes no aparecen en Mautic.<\/p>\n\n\n\n<p><strong>Soluci\u00f3n:<\/strong> La sincronizaci\u00f3n autom\u00e1tica de contactos se activa cuando un nuevo cliente registra una cuenta en tu tienda o cuando un cliente actualiza su perfil. No sincroniza retroactivamente a todos los clientes existentes.<\/p>\n\n\n\n<p>Para sincronizar los clientes existentes, utilice la <strong>Sincronizaci\u00f3n masiva<\/strong> funci\u00f3n en la pesta\u00f1a Sincronizaci\u00f3n de contactos. Esto pone en cola a todos los clientes existentes y los procesa por lotes a trav\u00e9s de WP-Cron.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">La sincronizaci\u00f3n masiva parece estar atascada<\/h2>\n\n\n\n<p><strong>S\u00edntoma:<\/strong> Ha iniciado una sincronizaci\u00f3n masiva, pero la barra de progreso no se ha movido o lleva mucho tiempo en funcionamiento.<\/p>\n\n\n\n<p><strong>Soluci\u00f3n:<\/strong> La sincronizaci\u00f3n masiva procesa los registros por lotes utilizando WP-Cron. Si WP-Cron no funciona de manera confiable, los lotes no se procesar\u00e1n. Consulte la <strong>WP-Cron no se activa<\/strong> Consulte la secci\u00f3n anterior para saber c\u00f3mo configurar una tarea cron adecuada en el servidor.<\/p>\n\n\n\n<p>Tambi\u00e9n puede comprobar el progreso y buscar errores en dos lugares:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Registro de sincronizaci\u00f3n<\/strong> \u2013 Ir a <strong>WooCommerce &gt; Integraci\u00f3n con Mautic &gt; Herramientas<\/strong> y revise el Registro de sincronizaci\u00f3n en busca de mensajes de error en registros individuales.<\/li>\n\n\n\n<li><strong>Registros de depuraci\u00f3n<\/strong> \u2013 Ir a <strong>WooCommerce &gt; Estado &gt; Registros<\/strong> y busca archivos con el c\u00f3digo fuente <strong>Integraci\u00f3n de Mautic con WooCommerce<\/strong>Con el modo de depuraci\u00f3n activado, ver\u00e1 informaci\u00f3n detallada sobre cada lote a medida que se procesa.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Comprobaci\u00f3n del registro de sincronizaci\u00f3n en busca de errores<\/h2>\n\n\n\n<p>El registro de sincronizaci\u00f3n es la forma m\u00e1s r\u00e1pida de identificar por qu\u00e9 un contacto o pedido espec\u00edfico no se ha sincronizado. Para acceder a \u00e9l:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Ir a <strong>WooCommerce &gt; Integraci\u00f3n con Mautic &gt; Herramientas<\/strong>.<\/li>\n<li>Mira el <strong>Registro de sincronizaci\u00f3n<\/strong> secci\u00f3n.<\/li>\n<li>Cada entrada muestra el tipo de objeto (contacto o pedido), el estado de la sincronizaci\u00f3n (correcta o fallida) y cualquier mensaje de error devuelto por la API de Mautic.<\/li>\n<\/ol>\n\n\n\n<p>Los mensajes de error comunes que pueden aparecer en el registro de sincronizaci\u00f3n incluyen:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u00abEl campo no existe\u00bb.<\/strong> \u2013 Falta un campo personalizado obligatorio en Mautic. Consulte el <strong>Campos personalizados de Mautic no creados<\/strong> secci\u00f3n anterior.<\/li>\n\n\n\n<li><strong>\u00abContacto duplicado\u00bb<\/strong> \u2013 Mautic ya tiene un contacto con el mismo correo electr\u00f3nico y ha rechazado la actualizaci\u00f3n. Revisa la configuraci\u00f3n de Mautic para el manejo de duplicados.<\/li>\n\n\n\n<li><strong>\u00ab401 No autorizado\u00bb<\/strong> \u2013 Las credenciales de autenticaci\u00f3n no son v\u00e1lidas o han caducado. Vuelva a comprobar la configuraci\u00f3n de la conexi\u00f3n.<\/li>\n\n\n\n<li><strong>\u00ab429 Demasiadas solicitudes\u00bb<\/strong> \u2013 Has alcanzado el l\u00edmite de frecuencia de la API de Mautic. El complemento volver\u00e1 a intentarlo en la pr\u00f3xima ejecuci\u00f3n de cron. Si esto ocurre con frecuencia, considera aumentar el intervalo entre lotes o reducir el tama\u00f1o de los lotes.<\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"<p>If contacts or orders are not syncing between WooCommerce and Mautic, work through the issues below to identify and fix the problem. Start from the top of the list, as the most common causes are listed first. Module Not Enabled Symptom: No data is syncing to Mautic at all, even though the connection test passes. [&hellip;]<\/p>","protected":false},"author":1,"featured_media":0,"parent":376,"menu_order":1,"comment_status":"","ping_status":"","template":"","format":"standard","categories":[],"doc_label":[],"doc_tag":[],"class_list":["post-386","docs","type-docs","status-publish","format-standard","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/sitepact.com\/docs\/es\/wp-json\/wp\/v2\/docs\/386","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/sitepact.com\/docs\/es\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/sitepact.com\/docs\/es\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/sitepact.com\/docs\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/sitepact.com\/docs\/es\/wp-json\/wp\/v2\/comments?post=386"}],"version-history":[{"count":0,"href":"https:\/\/sitepact.com\/docs\/es\/wp-json\/wp\/v2\/docs\/386\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/sitepact.com\/docs\/es\/wp-json\/wp\/v2\/docs\/376"}],"wp:attachment":[{"href":"https:\/\/sitepact.com\/docs\/es\/wp-json\/wp\/v2\/media?parent=386"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sitepact.com\/docs\/es\/wp-json\/wp\/v2\/categories?post=386"},{"taxonomy":"doc_label","embeddable":true,"href":"https:\/\/sitepact.com\/docs\/es\/wp-json\/wp\/v2\/doc_label?post=386"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sitepact.com\/docs\/es\/wp-json\/wp\/v2\/doc_tag?post=386"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}