Shipping Z-Bombilla

Módulo WooCommerce · Información

¿Qué hace este módulo?

Este módulo conecta tu WooCommerce con Shipping Z-Bombilla para que puedas crear envíos directamente desde los pedidos de tu tienda.

En WooCommerce aparecerá la acción "Enviar" en los pedidos, donde se abre Shipping con el pedido ya preparado para finalizar el envío.

Cuando el envío se confirma, el pedido queda actualizado con el número de seguimiento y un enlace para consultarlo (y opcionalmente se puede avisar al cliente por email).

Instalación
WooCommerce Requiere WooCommerce instalado y activo.
1 Abre el conector en Shipping

En Shipping, entra en E-Commerces → WooCommerce y pulsa Ver conector.


2 Descarga el ZIP del módulo

En la pantalla de WooCommerce, descarga el módulo Shipping Z-Bombilla en formato ZIP.


3 Sube el plugin a WordPress

En WordPress: Plugins → Añadir nuevo → Subir plugin y selecciona el ZIP descargado.


4 Activa el plugin

Actívalo y verás el menú WooCommerce → Shipping Z-B dentro de tu WordPress.

Configuración del módulo

Al entrar en WooCommerce → Shipping Z-B podrás configurar las opciones del módulo.
Aquí te explicamos qué hace cada ajuste para que lo dejes a tu gusto.

1 AccessToken (clave de conexión)

En Shipping podrás obtener o regenerar tu AccessToken y copiarlo.
Después, pégalo en el plugin de WooCommerce.

Esta "clave" permite que, al confirmar un envío, el pedido quede actualizado con el número de seguimiento automáticamente.


2 Ajustes en WooCommerce (qué hace cada campo)
Access Token
Pega aquí la clave que copiaste desde Shipping.
Estado pendiente de envío
Es el estado en el que se permitirá realizar la acción de "Enviar" mediante el módulo, si el pedido no está en ese estado, no aparecerá como "listo para enviar".
Estado al marcar como enviado
Cuando el envío se haya realizado, el pedido se pondrá automáticamente en el estado seleccionado (por ejemplo “Completado”).
Avisar al cliente (email)
Si lo activas, WooCommerce enviará un email al cliente cuando se registre el número de seguimiento.
Ejemplo de mensaje
Es el texto personalizable que se añadirá como nota del pedido (y/o email si lo activas).
Métodos de envío excluidos
Si el pedido usa uno de estos métodos, el módulo no mostrará la opción de "Enviar". Útil para Recogida en tienda, Store pickup, etc.
Enviar pedidos

Desde WooCommerce podrás abrir Shipping con el pedido ya cargado, elegir agencia y obtener la etiqueta.

1 Pulsa “Enviar” en el pedido

En el listado de pedidos (o dentro del pedido), verás el botón "Enviar", al pulsarlo, se abre Shipping con el pedido ya preparado.


2 Shipping carga el pedido automáticamente

Shipping abre la pantalla de Nuevo Envío con la información del pedido ya cargada: destinatario, bultos e importe (y si está disponible, también los productos).
Solo revisa y ajusta lo necesario.


3 Elige la agencia y obtén la etiqueta

Tras calcular, verás las agencias disponibles para ese envío.
Selecciona la opción que prefieras y pulsa Obtener etiqueta.


4 El pedido queda con seguimiento

Al confirmar el envío, el pedido queda actualizado con el número de seguimiento.
Si lo tienes activado, WooCommerce puede avisar al cliente por email, también tendrás la opción de re-enviar si lo necesitas.


5 Qué verás dentro del pedido

Dentro del pedido verás el bloque de Shipping Z-B y una nota con el seguimiento y el enlace.

Lo que ve el cliente

Una vez el envío está confirmado, el cliente podrá ver el seguimiento desde el área de pedidos de la tienda, con el número y un enlace para consultar el estado del envío.

1 Lista de pedidos

En el área de cliente, verá sus pedidos y podrá abrir el pedido para ver los detalles.


2 Actualizaciones del pedido

Dentro del pedido, WooCommerce mostrará una actualización con el número de seguimiento y el enlace para consultarlo.


3 Bloque de seguimiento

El cliente verá un bloque de Seguimiento con el transportista y un botón para Abrir el tracking.


4 Información del tracking

Al abrir el seguimiento, el cliente puede ver el estado del envío, el detalle y opciones como ver en el transportista o copiar el número.

Detalles técnicos (soporte / dev)

Al pulsar Enviar, WooCommerce hace un post a Shipping con:

Campo Descripción
envioJson Datos del envío (destinatario, bultos, importe, referencia) en JSON base64.
order_id ID interno del pedido en WooCommerce.
accessToken (Opcional) Token para auto-login y REST.
itemsJson (Opcional) Productos del pedido (JSON base64).

Referencia de envío: WC-<número_de_pedido>.

Endpoint POST /wp-json/zb-shipping/v1/update
Auth Authorization: Bearer <AccessToken>
Body { "order_id":123, "tracking":"...", "carrier":"...", "shipped_at":"..." }

  • Crear envío: https://shipping.z-bombilla.com/nuevoEnvio
  • Gestión token: https://shipping.z-bombilla.com/connection/woocommerce
  • Seguimiento: https://shipping.z-bombilla.com/envio/seguimiento?numSeguimiento=...

Gestión de envíos (shipping.z-bombilla.com)
Para gestionar y completar la entrega de los pedidos, utilizamos un proveedor externo de envíos ("Shipping Z-B").
Cuando preparamos un envío, transferimos al proveedor los datos necesarios para la expedición y el seguimiento: nombre del destinatario, dirección, ciudad, código postal, provincia/estado, país, email y/o teléfono, referencia del pedido, importe total y datos de paquetería (peso/medidas).
Esta transferencia se realiza con la finalidad de crear la etiqueta, tramitar el transporte y proporcionar el seguimiento del envío.
El proveedor puede devolver a nuestra tienda el número de seguimiento para informar al cliente del estado del envío.