esofitec. CoreDocs

esofitec. CoreDocs

Addons estándar / Conector eCommerce

Referencia de conectores

Cada plataforma de tienda tiene un conector independiente que implementa la interfaz IConectorTienda. Todos los conectores son descubiertos en tiempo de ejecución mediante MEF y exponen el mismo contrato al motor de sincronización, con independencia de la plataforma subyacente.

WooCommerce#

Propiedad Valor
Clase ConectorWooCommerce
Proyecto Sit.WooCommerce
Librería WooCommerceNET 0.8.6 (fork Esofitec)
Protocolo REST API v3
Autenticación Consumer Key + Consumer Secret (HMAC-SHA256)
Dirección Bidireccional completa
Timeout 90 segundos por petición
Paginación interna 25 elementos por consulta

Funcionalidades disponibles: importación de pedidos, facturas y facturas rectificativas; creación y actualización de clientes; exportación completa de artículos (precio, stock, descripciones, dimensiones, categorías, metadatos, EAN); artículos con variantes (tallas/colores); metadatos en pedidos, clientes y artículos.

Consideraciones: el fork de WooCommerceNET añade soporte para IDs de tipo long/ulong (variantes con identificadores grandes) y corrige respuestas con BOM UTF-8 que la versión original no manejaba correctamente. Las claves Consumer Key y Consumer Secret deben tener permisos de Lectura/Escritura en todos los recursos.


Shopify#

Propiedad Valor
Clase ConectorShopify
Proyecto Sit.Shopify
Librería ShopifySharp 6.28.0 (fork Esofitec)
Protocolo REST API + GraphQL (API versión 2023-07)
Autenticación Bearer (Access Token)
Dirección Bidireccional completa + fulfillments
Rate limiting Espera fija de 510 ms entre llamadas

Funcionalidades disponibles: importación de pedidos, facturas y facturas rectificativas; creación y actualización de clientes; exportación completa de artículos; gestión de preparaciones de pedido (fulfillments): consulta, alta y finalización con número de seguimiento; metadatos en pedidos, clientes y artículos; soporte de múltiples ubicaciones de stock mediante el plugin Sit.ECPluginMapAlm.

Consideraciones: es el conector con mayor funcionalidad y el único que soporta gestión de fulfillments. El fork de ShopifySharp adapta la librería original (compilada para .NET 6+) a .NET Framework 4.8 y añade firma de ensamblado fuerte. El Access Token debe incluir los scopes: read_orders, write_orders, read_products, write_products, read_inventory, write_inventory, read_fulfillments, write_fulfillments. Algunas consultas utilizan GraphQL en lugar de REST para mayor eficiencia (por ejemplo, la consulta de variantes de producto).


Prestashop (clásico)#

Propiedad Valor
Clase ConectorPrestashop
Proyecto Sit.Prestashop
Librería RestSharp 110.2.0
Protocolo REST API XML (Webservice de Prestashop)
Autenticación Basic HTTP (API Key como usuario, contraseña vacía)
Dirección Solo importación
Compatible con Prestashop 7, 8 y 9 (en modo Webservice)

Funcionalidades disponibles: importación de pedidos, facturas y facturas rectificativas (OrderSlips); creación y actualización de clientes; artículos con variantes (combinaciones de Prestashop).

Limitaciones: la exportación de artículos (ERP → Tienda) no está implementada. Los métodos ActualizarProductoID y ActualizarProductoPorReferencia lanzan NotImplementedException en la versión actual. No soporta metadatos.

Exportación no disponible

Si se activa la exportación de artículos para una tienda configurada con el conector clásico de Prestashop, el ciclo producirá errores en el log. Asegurarse de que la opción «Exportar artículos» esté desactivada para estas tiendas.


Prestashop + LabelGrup#

Propiedad Valor
Clase ConectorLabelPrestashop
Proyecto Sit.LblPs
Librería RestSharp 110.2.0
Protocolo REST API propietaria del servidor LabelGrup
Autenticación Credenciales del servidor LabelGrup
Dirección Solo importación

Funcionalidades disponibles: importación de pedidos con packs personalizados y artículos con tallas complejas; notificación de resultado de importación de documentos (actualización de estado en el servidor LabelGrup).

Consideraciones: este conector no se comunica directamente con Prestashop. El servidor intermediario LabelGrup sincroniza los datos desde la base de datos de Prestashop y expone su propia API REST con una estructura completamente diferente. Las credenciales son las del servidor LabelGrup, no las de la tienda Prestashop. No hay exportación de artículos.


Tabla comparativa#

Funcionalidad WooCommerce Shopify Prestashop LabelGrup+PS
Importar pedidos
Importar facturas rectificativas No
Crear/actualizar clientes No
Exportar artículos No No
Exportar stock No No
Metadatos No No
Fulfillments / preparaciones No No No
Variantes (tallas/colores)
Múltiples ubicaciones de stock No Sí (con plugin) No No