Documentación de b2cBridge

¿Qué es b2cBridge?

b2cBridge es un plugin de WooCommerce que actúa como puente entre tu tienda y Falabella Marketplace. Automatiza tres procesos que normalmente se hacen manualmente:

• Stock — Cuando llega un pedido de Woo o Falabella, el stock se actualiza automáticamente en ambas plataformas.
• Precios — Define el precio Falabella manualmente o usa el sistema de markup (precio Woo × porcentaje) con redondeo automático.
• Pedidos — Las órdenes de Falabella llegan automáticamente a WooCommerce via webhook, sin necesidad de revisarlas manualmente en Seller Center.

El relay b2cBridge

Todos los planes incluyen acceso al relay de b2cBridge. Las llamadas a la API de Falabella salen desde nuestra infraestructura en lugar de tu hosting, lo que resuelve el problema de IPs bloqueadas que ocurre en Kinsta, WP Engine, SiteGround y otros hostings administrados.

Requisitos

Componente	Versión mínima	Estado
WordPress	6.3 o superior	✔ Requerido
WooCommerce	8.0 o superior	✔ Requerido
PHP	8.1 o superior	✔ Requerido
cURL	Habilitado en el servidor	✔ Requerido
HTTPS	SSL activo en el sitio	✔ Requerido para webhook
HPOS (High-Performance Orders)	Compatible con WC 8+	Opcional

Credenciales de Falabella necesarias

• UserID — Email del usuario con acceso a la API (no el email del administrador principal).
• API Key — Clave generada por Falabella para ese usuario.

Instalación

1. Descarga el plugin desde b2cbridge.com/descargar/. Recibirás un archivo woo-falabella-sync.zip en tu email.

2. En tu WordPress ve a Plugins → Añadir nuevo → Subir plugin y selecciona el archivo .zip descargado.

3. Haz clic en Instalar ahora y luego en Activar plugin.

4. Ve a WooCommerce → Ajustes → Falabella. Verás el panel de configuración con varias pestañas.

Obtener credenciales de Falabella

Para crear el usuario con acceso a la API en Falabella Seller Center:

1. Inicia sesión en Falabella Seller Center con tu cuenta principal de administrador.

2. Ve a Mi cuenta → Configuración general → Administrar usuarios.

3. Haz clic en Agregar usuario.

4. Asigna el rol "Acceso a la API del vendedor". Este es el único rol con permisos de API.

5. Guarda. Falabella generará automáticamente un API Key asociado a ese usuario.

6. Copia el email del usuario y el API Key. Los necesitarás en el plugin.

Ingresar las credenciales en el plugin

En el plugin ve a WooCommerce → Ajustes → Falabella → ⚙ Configuración e ingresa:

Campo	Descripción
UserID	Email del usuario con rol "Acceso a la API del vendedor"
API Key	Clave de 40 caracteres generada por Falabella para ese usuario
URL del relay	URL del relay de b2cBridge (preconfigurada: https://relay.b2cbridge.com/relay.php)
Relay Secret	Secret HMAC para autenticar las llamadas al relay (lo provee b2cBridge al activar)

Haz clic en Guardar cambios y luego en Probar conexión para verificar que las credenciales son correctas.

Configurar el relay

El relay de b2cBridge viene preconfigurado en todos los planes. En la pestaña ⚙ Configuración verás los campos:

• URL del relay — Por defecto: https://relay.b2cbridge.com/relay.php. No lo cambies salvo indicación del soporte.
• Relay Secret — El secret HMAC que firma cada request. Es único para tu instalación.

¿Cómo funciona el relay?

El plugin no llama directamente a la API de Falabella. En cambio:

1. El plugin envía el request firmado al relay de b2cBridge.
2. El relay valida la licencia y el HMAC.
3. El relay llama a Falabella desde su infraestructura y devuelve la respuesta.

Esto elimina los bloqueos de IP que ocurren cuando Kinsta, WP Engine u otros hostings intentan conectarse directamente a Falabella.

Activar licencia

El plugin funciona sin licencia en modo Free con 10 sincronizaciones por día. Para sincronizaciones ilimitadas necesitas activar una licencia Pro o Agency.

1. Ve a WooCommerce → Ajustes → Falabella → 🔑 Licencia.

2. Pega tu license key en el campo correspondiente. El formato es B2CB-XXXX-XXXX-XXXX-XXXX.

3. Haz clic en ✔ Activar licencia.

4. Si la activación es exitosa, verás el panel de estado con tu plan, fecha de vencimiento y dominio registrado.

Registrar el webhook en Falabella

El webhook permite que Falabella notifique automáticamente a tu WooCommerce cuando llega una orden nueva. Sin el webhook tendrías que revisar Seller Center manualmente.

1. Ve a WooCommerce → Ajustes → Falabella → 🔔 Webhook.

2. Si el campo "Token secreto" dice "no generado", haz clic en Regenerar token.

3. Copia la URL completa que aparece (incluye el ?token=...).

4. Haz clic en Registrar webhook en Falabella. El plugin llamará automáticamente a CreateWebhook en la API.

5. Verás una confirmación con el ID del webhook registrado.

¿Qué pasa cuando llega una orden?

1. Falabella envía {"event": "onOrderCreated", "payload": {"OrderId": 12345}}.
2. El plugin llama a GetOrderItems para obtener los SKUs y cantidades.
3. Crea un pedido en WooCommerce en estado "processing".
4. WooCommerce descuenta el stock automáticamente.
5. El hook de sync de stock reporta el nuevo stock a Falabella.

Precios Falabella

b2cBridge permite dos formas de definir el precio que se envía a Falabella:

1. Precio manual por producto

En el editor de cada producto verás un campo "Precio Falabella ($)" en la pestaña General. Ingresa el precio directamente y al guardar el producto se sincroniza con Falabella automáticamente (si la sincronización está habilitada).

2. Precio calculado con markup (recomendado)

Usa el Actualizador Masivo de Precios en la pestaña 🔄 Act. Masivas. Define un porcentaje de markup y el sistema calcula:

Precio Falabella = Precio Regular Woo × (1 + markup / 100)

Por ejemplo con markup 20% y precio Woo de $8.325:

Precio base:   $8.325
Markup 20%:    $8.325 × 1.20 = $9.990
Redondeo $500: $10.000

Markup por categoría

En la pestaña 🔄 Act. Masivas puedes configurar:

• Markup global — Se aplica a todos los productos sin markup específico.
• Markup por categoría — Sobreescribe el global para esa categoría.
• Redondeo — Sin redondeo, a $100, $500 o $1.000 (siempre redondea hacia arriba).

Modos de operación

Modo	Qué hace	Cuándo usar
Vista previa	Cuenta cuántos productos serían actualizados, sin tocar nada	Para verificar antes de ejecutar
Solo WooCommerce	Calcula y guarda el precio en el meta del producto, NO envía a Falabella	Para preparar precios antes de publicar
Aplicar precios	Calcula, guarda y envía todos los precios a Falabella en un solo request	Sincronización masiva real

Sincronización de stock

Sync automático (por pedidos)

Con la opción "Sincronización habilitada" activa, el stock se reporta a Falabella automáticamente cuando:

• Un pedido pasa a estado pending o processing → se descuenta el stock en Falabella.
• Un pedido es cancelado → se restaura el stock en Falabella.

Sync masivo (manual)

En la pestaña 🔄 Act. Masivas → Sección B puedes sincronizar el stock completo de una vez. Útil cuando:

• Acabas de instalar el plugin y quieres sincronizar el estado inicial.
• Hubo actualizaciones manuales de stock en Woo (ERP, importación CSV).
• Falabella muestra stock desactualizado.

Pedidos importados de Falabella

Los pedidos importados desde Falabella aparecen en WooCommerce con el badge "Falabella #OC" en la columna "Canal" del listado de órdenes.

Filtro por fecha

En la pestaña ⚙ Configuración puedes definir una fecha mínima de importación. Las órdenes de Falabella anteriores a esa fecha serán ignoradas aunque lleguen por webhook.

Deduplicación

Si Falabella reenvía el webhook de una orden ya importada, el plugin la detecta por el _falabella_order_id y la ignora silenciosamente.

SKUs no encontrados

Si un ítem de la orden de Falabella tiene un SKU que no existe en WooCommerce, se importan el resto de los ítems y se agrega una nota interna indicando qué SKUs no se encontraron.

Monitor de Feeds

Falabella procesa las actualizaciones de forma asíncrona. Cuando envías un ProductUpdate o UpdateStock, Falabella devuelve un FeedID que hay que consultar después para saber si se procesó correctamente.

b2cBridge hace esto automáticamente cada 15 minutos. En la pestaña 📡 Monitor de Feeds puedes ver:

• Todos los feeds pendientes y su estado actual.
• Feeds finalizados con cantidad de éxitos y errores.
• Detalle de errores por SKU cuando Falabella rechaza un producto.

Estados de un feed

Estado	Significado
Queued	Recibido por el plugin, pendiente de consultar a Falabella
Processing	Falabella lo está procesando
Finished	Procesado correctamente (puede tener errores parciales)
Expired	Sin respuesta de Falabella en más de 24 horas

Log de actividad

En la pestaña 📋 Log puedes ver el historial completo de sincronizaciones filtrado por tipo:

• Precio — Cada actualización de precio enviada a Falabella.
• Stock — Cada actualización de stock.
• Webhook — Eventos recibidos de Falabella.
• Feed — Resultados del monitoreo de feeds.

Cada entrada muestra: fecha, SKU, valor enviado, estado (✔ / ✘) y mensaje de Falabella si hubo error.

Columna Falabella en productos

En el listado de Productos verás la columna "Falabella" con dos badges:

• 💲 Precio — Verde si el último precio se sincronizó correctamente, naranja si está pendiente, rojo si hubo error.
• 📦 Stock — Mismo sistema para el stock.

Planes y límites

Función	Free	Pro	Agency
Sincronizaciones/día	10	Ilimitadas	Ilimitadas
Markup por categoría	✘	✔	✔
Sync masivo	✘	✔	✔
Sitios WooCommerce	1	1	Hasta 5
Soporte	—	Email prioritario	Email prioritario
Precio	Gratis	USD 99/año	USD 299/año

Ver comparativa completa de planes →

Errores comunes

E007: Login failed. Signature mismatch

El UserID o API Key son incorrectos, o el usuario no tiene el rol correcto.

• Verifica que el UserID sea el email del usuario con rol "Acceso a la API del vendedor".
• El rol "Seller Full Access" NO da acceso a la API.
• Verifica que no haya espacios al copiar el API Key.

[429] Too many attempts

Falabella limita a 1 feed por request. El modo de sincronización masiva de b2cBridge agrupa todos los SKUs en un solo request para evitar este error.

Si lo ves en sync automática (pedidos individuales), espera 2 minutos y vuelve a intentar.

[101] Error de formato detectado

El XML enviado a Falabella tiene un error de formato. Verifica:

• Que el SKU del producto exista en Falabella Seller Center.
• Que el precio sea mayor a 0.
• Que el stock sea un número entero positivo.

Error de conexión al relay

El plugin no puede llegar al relay de b2cBridge.

• Usa el botón "Probar relay" para diagnosticar.
• Verifica que la URL del relay sea https://relay.b2cbridge.com/relay.php.
• Verifica que el Relay Secret sea correcto.
• Algunos firewalls de hosting bloquean salidas HTTPS. Contacta a soporte.

Webhook no recibe pedidos

• Verifica que el token en la URL del webhook sea correcto.
• La URL debe ser HTTPS (no HTTP).
• Usa el API Explorer de Falabella para enviar un webhook de prueba manualmente.
• Revisa el tab 📋 Log → Webhook para ver si hay eventos recibidos.

FAQ

¿Debo activar "Sincronización habilitada" para que el bulk funcione?

Sí. El toggle de sincronización también afecta al bulk masivo de precios cuando usas el modo "real". El bulk en modo "Solo WooCommerce" funciona sin el toggle.

¿Puedo cambiar de hosting sin perder la configuración?

Sí. La configuración se guarda en la base de datos de WordPress. Al migrar el sitio a otro hosting la configuración migra con él. Solo necesitas desactivar la licencia antes de migrar y reactivarla en el nuevo dominio.

¿Qué pasa si Falabella cambia su API?

El relay de b2cBridge absorbe los cambios de API menores. Los cambios mayores se reflejan en actualizaciones del plugin. Los planes Pro y Agency incluyen actualizaciones durante 1 año.

¿El plugin funciona con productos variables en WooCommerce?

Sí. Las variaciones se tratan como SKUs independientes en Falabella. El precio Falabella se configura por variación. El markup masivo aplica el mismo porcentaje a cada variación basándose en su precio regular.

¿Cómo obtengo soporte?

Plan Free: documentación únicamente.
Plan Pro y Agency: email a hola@b2cbridge.com con respuesta en menos de 24 horas hábiles.