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 | Sí | Sí | Sí | Sí |
| Importar facturas rectificativas | Sí | Sí | Sí | No |
| Crear/actualizar clientes | Sí | Sí | Sí | No |
| Exportar artículos | Sí | Sí | No | No |
| Exportar stock | Sí | Sí | No | No |
| Metadatos | Sí | Sí | No | No |
| Fulfillments / preparaciones | No | Sí | No | No |
| Variantes (tallas/colores) | Sí | Sí | Sí | Sí |
| Múltiples ubicaciones de stock | No | Sí (con plugin) | No | No |