Browse all articles

Conexión de Billbee

Last updated

Conectar Billbee a ChannelDock

Billbee es una plataforma multicanal de gestión de pedidos utilizada por muchos vendedores en Alemania, Austria y Suiza. La integración de ChannelDock (actualmente en Beta) le permite enviar pedidos de ChannelDock a Billbee para fulfillment, importar opcionalmente stock y productos desde Billbee, y recibir el seguimiento de envío de vuelta en ChannelDock.

Esta integración está disponible en Connections → Other — no en Sales channels.

Cómo funciona esta conexión

  • Los pedidos con estado order o backorder en ChannelDock se sincronizan con Billbee.
  • ChannelDock crea pedidos en Billbee usando su número de pedido de ChannelDock como referencia externa.
  • Cuando un pedido se envía en Billbee, el seguimiento se sincroniza de vuelta a ChannelDock y el pedido se completa en el canal de venta original.
  • Cuando un pedido se cancela en Billbee, se cancela en ChannelDock.
  • Los niveles de stock pueden sincronizarse opcionalmente desde Billbee a ChannelDock (desactivado por defecto).
  • Se pueden importar nuevos productos desde Billbee a ChannelDock basándose en el EAN.

Antes de conectar

Necesita lo siguiente en Billbee y ChannelDock:

En Billbee

  1. Inicie sesión en Billbee.
  2. Vaya a Settings → Billbee API (o Settings → System → Billbee API).
  3. Active el acceso API en la pestaña General settings.
  4. Establezca una contraseña API. Billbee exige una contraseña segura:
    • Al menos 12 caracteres
    • Al menos una mayúscula, una minúscula, un número y un carácter especial (!@$%^&*+#)
    • No use dos puntos (:) en la contraseña — provoca errores de autenticación
  5. Guarde su configuración.

También necesita una Billbee API Key para la aplicación. Se envía en el encabezado HTTP X-Billbee-Api-Key. Solicítela a Billbee si aún no la tiene — consulte la documentación API de Billbee.

Nombre de usuario para la conexión

  • Para la cuenta principal, use la dirección de correo electrónico con la que está registrada su cuenta Billbee.
  • Para una cuenta de personal, use el nombre de usuario Billbee de ese miembro del personal.

En ChannelDock

  • Conecte primero sus canales de venta (Shopify, bol.com, Amazon, etc.) para que los pedidos lleguen a ChannelDock antes de enviarse a Billbee.

Conectar Billbee a ChannelDock

  1. Inicie sesión en su cuenta de ChannelDock.

  2. Vaya a Connections → Other.

    Other integrations page

  3. Haga clic en el logo Billbee (marcado como Beta).

    Billbee integration tile

  4. Complete el formulario de conexión:

    • Billbee API Key — su clave API de aplicación (enviada como X-Billbee-Api-Key).
    • Billbee username/email — su correo de inicio de sesión Billbee o nombre de usuario del personal.
    • Billbee API password — la contraseña API establecida en Billbee (no su contraseña de inicio de sesión habitual).

    Billbee connect modal

  5. Haga clic en Connect Billbee.

ChannelDock valida sus credenciales con la API de Billbee. Si la conexión tiene éxito, Billbee aparece en su lista de Other integrations.

Billbee connected in Other integrations

Configurar ajustes API

Tras conectar, haga clic en el icono settings (engranaje) en la fila de Billbee para abrir Edit API settings:

Billbee API settings

Revise y configure:

Setting Description
Billbee stock sync Desactivado (por defecto), EAN o SKU. Cuando está activado, los niveles de stock se leen desde Billbee y se actualizan en ChannelDock para los productos coincidentes.
Stock ID (optional) Si se rellena, ChannelDock lee el stock desde esa ubicación Billbee específica en lugar de la predeterminada.
Send orders from these sales channels Seleccione qué canales de venta conectados deben enviar sus pedidos a Billbee. Déjelo vacío para no enviar pedidos.

Guarde su configuración tras realizar cambios.

Flujo de pedidos

El flujo de trabajo habitual es el siguiente:

  1. Un cliente realiza un pedido en un canal de venta conectado (por ejemplo, Shopify o bol.com).
  2. El pedido se importa en ChannelDock con estado order.
  3. Si el canal de venta del pedido está seleccionado en Send orders from these sales channels, ChannelDock envía el pedido a Billbee.
  4. ChannelDock usa su número de pedido de ChannelDock como referencia de pedido en Billbee.
  5. Usted cumple el pedido en Billbee (preparación, empaquetado, envío).
  6. Cuando el pedido se envía en Billbee, ChannelDock recibe el número de seguimiento y marca el pedido como completado en el canal de venta original.
  7. Si el pedido se cancela en Billbee, también se cancela en ChannelDock.

Solo se envían a Billbee los pedidos con estado order o backorder. Los pedidos ya sincronizados no se envían de nuevo.

Sincronización de stock (opcional)

La sincronización de stock está desactivada por defecto. Para activarla:

  1. Abra la configuración de la integración Billbee en ChannelDock.
  2. Establezca Billbee stock sync en EAN o SKU.
  3. Opcionalmente establezca un Stock ID si usa varias ubicaciones de stock en Billbee.
  4. Guarde su configuración.

ChannelDock empareja productos entre Billbee y ChannelDock usando el campo seleccionado (EAN o SKU). Solo se actualizan los productos con un identificador coincidente en ambos sistemas.

Los cambios de stock aparecen en el registro de inventario de ChannelDock como eventos Billbee stock update.

Importación de productos

ChannelDock puede importar nuevos productos desde Billbee que aún no existen en ChannelDock. Los productos se emparejan y crean por EAN. Los productos existentes con el mismo EAN se omiten.

Los productos importados incluyen título, SKU, EAN, stock, precio, URL de imagen y dimensiones cuando están disponibles en Billbee.

Solución de problemas

La conexión falla o se rechazan las credenciales

  • Confirme que el acceso API está activado en Billbee en Settings → Billbee API.
  • Introduzca los tres campos: API Key, username/email y API password.
  • Use su contraseña API, no su contraseña de inicio de sesión habitual de Billbee.
  • Compruebe que su contraseña API cumple los requisitos de Billbee y no contiene dos puntos (:).
  • Verifique que su Billbee API Key es válida y está activa.

Los pedidos no se envían a Billbee

  • Abra la configuración de la integración Billbee y compruebe Send orders from these sales channels. Debe seleccionar al menos un canal de venta — si la lista está vacía, no se envían pedidos.
  • Confirme que el estado del pedido en ChannelDock es order o backorder.
  • Compruebe que el pedido no se haya sincronizado ya con Billbee (busque entradas relacionadas con Billbee en el registro del pedido).

El stock no se sincroniza desde Billbee

  • Asegúrese de que Billbee stock sync está en EAN o SKU — está desactivado por defecto.
  • Verifique que existen EAN o SKU coincidentes en productos de Billbee y ChannelDock.
  • Si usa varias ubicaciones de stock en Billbee, pruebe a establecer el Stock ID correcto.

El seguimiento no se sincroniza de vuelta a ChannelDock

  • Confirme que el pedido se envió en Billbee y tiene número o URL de seguimiento.
  • Consulte el registro del pedido en ChannelDock para eventos de envío de Billbee.
  • Deje tiempo para que se ejecute el trabajo de sincronización — las actualizaciones de estado se obtienen de Billbee periódicamente.

¿Necesita ayuda?

Si tiene problemas con la integración de Billbee, contacte con nuestro equipo de soporte a través de la página de soporte de su cuenta de ChannelDock. Incluya el nombre de su conexión Billbee, una descripción del problema y cualquier mensaje de error mostrado durante la conexión o sincronización.

Was this helpful?

Related articles