WooCommerce Sync

Conector bidireccional entre elsistema.lat y tiendas WooCommerce. Sincroniza catálogos, productos y órdenes en tiempo real mediante webhooks con firma HMAC-SHA256, manteniendo consistencia de inventario entre plataformas.

HMACFirma segura
BidireccionalSync en tiempo real
3Entidades sincronizadas
RESTAPI v3

Funcionalidades

🔄

Sincronización de Categorías

Sincronización jerárquica de categorías padre-hijo entre el ERP y WooCommerce. Las categorías pueden fluir en ambas direcciones: el ERP puede ser la fuente de verdad o bien absorber la estructura existente de WooCommerce. El mapeo inteligente detecta categorías similares por nombre y sugiere fusiones para evitar duplicados. Los slugs se generan automáticamente optimizados para SEO.

🔄

Sincronización de Productos

Sincronización completa de productos incluyendo nombre, descripción corta y larga, imágenes (hasta 10 por producto), SKU, código de barras, precio regular y precio de oferta, stock, peso y dimensiones. Los productos variables de WooCommerce se mapean correctamente con sus variantes. La sincronización de inventario es inmediata: un cambio de stock en el ERP se refleja en WooCommerce en segundos.

📥

Sincronización de Órdenes

Las órdenes generadas en WooCommerce se importan automáticamente al ERP con todos sus metadatos: datos de cliente, dirección de facturación y envío, productos, cantidades, impuestos, descuentos, método de pago y costo de envío. El ERP genera automáticamente el documento FEL correspondiente y actualiza el estado de la orden en WooCommerce cuando cambia en el sistema interno.

🏷️

Mapeo de Impuestos

Configuración de equivalencias entre las clases de impuestos de WooCommerce y las tasas fiscales del ERP. Soporte para IVA estándar, exento, reducido y regímenes especiales. El sistema valida que cada producto importado tenga una tasa fiscal válida y alerta sobre discrepancias antes de procesar órdenes, garantizando la correcta emisión de documentos FEL.

🌐

Webhooks con HMAC-SHA256

Comunicación segura mediante webhooks firmados con HMAC-SHA256. Cada petición entrante se valida criptográficamente para garantizar su autenticidad e integridad. Los webhooks de WooCommerce (order.created, order.updated, product.created, product.updated, product.deleted) se registran automáticamente al configurar la conexión. El sistema implementa reintentos exponenciales para webhooks fallidos y una bitácora detallada.

🔄

Reset y Re-sync Completo

Herramientas de administración para reiniciar la sincronización desde cero: resync de todas las categorías, productos u órdenes en un rango de fechas. Útil durante la migración inicial o para corregir inconsistencias tras períodos de desconexión. El proceso de re-sync es incremental y no duplica registros existentes gracias a la detección por SKU y número de orden.

📊

Log de Sincronización

Registro detallado de cada operación de sincronización con timestamp, entidad afectada, dirección (ERP→WC o WC→ERP), estado (éxito/error) y mensaje descriptivo. El log es filtrable por fecha, tipo de entidad y estado. Los errores incluyen el payload completo de la petición para facilitar el diagnóstico. Exportación a CSV para auditorías y reportes de integración.

Configuración de la Conexión

La conexión con WooCommerce se establece mediante la API REST v3, utilizando credenciales de tipo Consumer Key y Consumer Secret generadas desde el panel administrativo de WordPress. El proceso de configuración guía al usuario paso a paso: ingreso de la URL de la tienda, generación y copia de credenciales, y verificación de conectividad. Una vez establecida la conexión, el sistema descubre automáticamente los endpoints disponibles y registra los webhooks necesarios.

El plugin de WooCommerce para elsistema.lat se instala con un solo clic desde el marketplace de WordPress y proporciona una interfaz nativa dentro del panel de WooCommerce para monitorear el estado de la sincronización, revisar el log y forzar re-syncs parciales por categoría o producto. El plugin se actualiza automáticamente y mantiene compatibilidad con las últimas tres versiones mayores de WooCommerce.

Arquitectura de Sincronización

1ConexiónConfiguración de credenciales y verificación de API REST v3.
2MapeoDefinición de equivalencias de impuestos y categorías entre sistemas.
3Sync InicialMigración masiva de productos existentes. El ERP es fuente de verdad.
4WebhooksRegistro automático de webhooks firmados con HMAC-SHA256.
5Tiempo RealCambios de stock y nuevas órdenes fluyen instantáneamente entre sistemas.
Video: WooCommerce Sync — Tutorial paso a paso
Video tutorial de WooCommerce Sync (próximamente)