Documentación

Guía de b2cBridge

Todo lo que necesitas para instalar, configurar y sincronizar tus marketplaces.

Instalación

b2cBridge se instala como cualquier plugin de WordPress:

  1. Descarga el archivo .zip desde tu área de cuenta en app.b2cbridge.com.
  2. En WordPress, ve a Plugins → Añadir nuevo → Subir plugin.
  3. Selecciona el .zip, instálalo y actívalo.

Requisitos: WordPress 6.0+, WooCommerce 8.0+ y PHP 8.0 o superior.

Activar la licencia

Tras activar el plugin, ve a b2cBridge → Licencia e ingresa la clave que recibiste por correo al suscribirte. La licencia habilita exactamente los canales que contrataste; cada canal se activa según tu plan.

La licencia se vincula al dominio donde la activas. Si necesitas trasladarla a otro dominio, escríbenos a hola@b2cbridge.com.

Primeros pasos

El flujo recomendado es: conectar un canal, vincular tus publicaciones por SKU, definir márgenes y lanzar la sincronización. Te recomendamos empezar con un canal y el modo seguro activado.

Conectar un canal

Cada marketplace tiene su propia sección de configuración con las credenciales de API que entrega el canal. Canales disponibles:

FalabellaSeller Center API
RipleyAPI Mirakl
ParisAPI Cencosud
Mercado LibreOAuth + multi-bodega
WalmartPróximamente

Vincular publicaciones

b2cBridge relaciona tus productos de WooCommerce con las publicaciones del marketplace mediante el SKU. Asegúrate de que el SKU en WooCommerce coincida con el del marketplace. En Mercado Libre, el plugin busca el SKU en el atributo SELLER_SKU de cada publicación.

Sincronizar precio y stock

Define un margen por canal, calcula los precios y lanza la sincronización masiva. Cada canal usa el método óptimo para su API; en Mercado Libre la sincronización masiva corre en segundo plano para no saturar.

Importar pedidos

Los pedidos del marketplace entran automáticamente a WooCommerce con cliente, dirección y, donde el canal lo expone, el costo de envío. Defines desde qué fecha importar para no traer pedidos antiguos.

Reimportar pedidos

Si un pedido no entró por una falla temporal, puedes reimportarlo por su ID, o traer en lote todos los pedidos desde una fecha. Disponible en la configuración de cada canal.

Facturador en el checkout

b2cBridge incorpora su propio facturador en el checkout: los campos para que el cliente solicite documento tributario (boleta o factura) se renderizan directamente desde el plugin, sin depender de snippets externos. Funciona tanto en el checkout de bloques de WooCommerce (recomendado) como en el checkout clásico.

Cuando el cliente marca «Requiero Factura Electrónica», aparecen los campos de facturación: RUT, Razón Social, Giro y la cascada Región → Comuna → Ciudad. Estos datos viajan al ERP al emitir el documento.

Prefill para clientes registrados

Si el cliente tiene sus datos de empresa guardados, el facturador los precarga automáticamente y deja la cascada de localidad preseleccionada. El cliente solo confirma y paga, sin reescribir nada.

Recomendamos el checkout de bloques. Es la dirección oficial de WooCommerce y ofrece la experiencia más fluida con la cascada Región → Comuna → Ciudad, evitando conflictos de temas o addons que afectan al checkout clásico.

Delivery · Comunas de Chile

El módulo Delivery reemplaza el campo de región nativo de WooCommerce por Comuna, usando las 346 comunas de Chile como opciones de envío. El pedido, los correos y el administrador muestran el nombre de la comuna (ej. «Las Condes»), nunca el código interno.

Vive en b2cBridge → Delivery (Comunas). Qué hace al activarlo:

  • Inyecta las 346 comunas de Chile como opciones de envío.
  • Renombra «Región» → «Comuna» y oculta el código postal.
  • Usa los mismos códigos CL_XXX que el plugin estándar de comunas, de modo que tus zonas de envío siguen funcionando sin reconfigurar.

Antes de activar: si usas un plugin de comunas de terceros, desactívalo primero. Si ambos gestionan las comunas a la vez, pueden entrar en conflicto. Rollback inmediato: si algo falla, desmarca la opción y reactiva tu plugin anterior — al compartir los mismos códigos CL_XXX, el despacho se restablece de inmediato.

b2cBridge emite documentos tributarios electrónicos (SII Chile) con Lioren directamente desde tus pedidos y los enlaza al marketplace. A diferencia de la integración nativa, b2cBridge maneja correctamente los productos variables y te permite recuperar el folio y gestionar el documento desde el propio plugin.

Lioren se contrata como una unidad más de tu plan (igual que un canal). Una vez activo, opera en dos modos:

Modo API (recomendado)

b2cBridge emite el documento por la API de Lioren: recupera el folio, permite glosas, reemisión y anulación con nota de crédito, y sube la boleta/factura al canal automáticamente. Es el modo que aprovecha todo b2cBridge.

Modo webhook

Usa la integración nativa de Lioren vía webhook de WooCommerce. Funciona sin configuración de API, pero no recupera el folio ni permite gestionar el documento desde b2cBridge. Útil si ya venías usando el webhook de Lioren.

En modo API, desactiva el webhook de Lioren en WooCommerce para evitar emisión duplicada.

Configuración (modo API)

La configuración vive en b2cBridge → Lioren:

  • Modo: selecciona API para que b2cBridge emita el documento.
  • Token Personal (PAT): genéralo en Lioren → Emisión → Token Personal y pégalo. Usa Probar conexión para validarlo.
  • Bodega: al guardar el token, se cargan tus bodegas de Lioren. Elige desde cuál se descuenta el stock al emitir.
  • Emitir documento cuando el pedido pase a: Procesando, Completado o Ambas.
  • Comuna por defecto: ID de comuna para las notas de crédito (por defecto Las Condes, 308).
  • Incluir costo de envío: agrega el despacho como una línea más del documento.
  • Subir al marketplace automáticamente: envía la boleta/factura al canal cuando éste la acepte (cola diferida).

¿Marketplace y web a la vez? Los pedidos de marketplace suelen nacer en Completado y los de tu web pasan por Procesando. Si vendes en ambos, elige Ambas para no perder ninguna emisión — b2cBridge no emite dos veces el mismo pedido.

Costo de Lioren: las integraciones con e-commerce de terceros tienen un límite gratuito de 2.500 documentos al mes; después Lioren aplica un recargo de 0,0002 UF por documento. Este costo lo cobra Lioren, no b2cBridge.

Boletas y facturas con Bsale

Además de Lioren, b2cBridge se integra con Bsale como complemento de facturación electrónica. Emite boletas y facturas (SII Chile), permite anulación con nota de crédito y sincroniza el stock por lotes. Bsale se contrata como una unidad más de tu plan.

Los ERP son mutuamente excluyentes: cada dominio usa Lioren o Bsale, no ambos a la vez. La licencia determina cuál queda activo, y el menú del plugin muestra solo el ERP correspondiente.

📝 Estamos ampliando esta sección. La guía detallada de configuración de Bsale (token, casa matriz, tipos de documento y sincronización de inventario) está en preparación. Mientras tanto, si necesitas conectar Bsale escríbenos a hola@b2cbridge.com y te guiamos paso a paso.

Emitir y subir el documento al canal

Desde el administrador de pedidos, cada pedido de marketplace muestra el menú Acciones ▾ con las operaciones de documento disponibles:

  • Emitir la boleta o factura con Lioren (si no se emitió automáticamente).
  • Subir al canal el documento emitido. Los cinco canales aceptan la recepción del documento tributario.
  • Anular (NC): emite una nota de crédito que anula el documento y cancela el pedido. Es una acción tributaria y no se puede deshacer.

Falabella requiere el folio del documento para aceptar la subida. b2cBridge lo recupera automáticamente cuando emite por API.

Salud del ERP

La pantalla Salud (b2cBridge → Salud · Lioren o Salud · Bsale, según tu ERP activo) es un panel de diagnóstico que verifica que la facturación esté operativa, sin tener que emitir un documento de prueba.

Te permite confirmar de un vistazo:

  • Conexión con el ERP: valida que el token y las credenciales respondan correctamente.
  • Configuración cargada: bodega seleccionada, modo de emisión y estado en que se dispara el documento.
  • Cola de subida al canal: documentos pendientes de subir al marketplace (cola diferida).

Úsala como primer paso cuando un documento no se emitió o no subió al canal como esperabas: te dice si el problema está en la conexión, la configuración o la cola, antes de revisar pedido por pedido.

Panel de cliente

En app.b2cbridge.com gestionas tu cuenta. Tras comprar, crea tu cuenta con el mismo correo de la compra. Desde el panel puedes:

  • Ver el estado de tu licencia, los canales habilitados y la fecha de vigencia.
  • Consultar y copiar tu clave de licencia.
  • Descargar la última versión del plugin.
  • Ampliar tu plan (según tu ciclo — ver más abajo).

Planes y cambios de plan

b2cBridge se cobra por volumen: el precio depende de cuántas unidades tengas activas. Cada canal es una unidad, y el complemento ERP (Lioren o Bsale) cuenta como una unidad más. Puedes elegir ciclo mensual o anual (el anual incluye dos meses de ahorro).

Ampliar tu plan

  • Plan mensual: puedes agregar canales o el ERP al instante desde el panel. Eliges lo nuevo, confirmas el cambio en PayPal y se activa al volver.
  • Plan anual: para cambiar tus unidades, nuestro equipo gestiona el ajuste (requiere recrear la suscripción). Desde el panel verás el botón para solicitarlo a soporte y lo resolvemos rápido.

¿Reducir tu plan (downgrade)? Escríbenos: el cambio queda vigente hasta el fin de tu período actual, sin reembolso del tramo ya pagado.

Soporte

¿Necesitas ayuda? Escríbenos a hola@b2cbridge.com con tu consulta y el detalle de tu configuración.