Generar, descargar y cancelar guías de paquetería

Comercial. Se hace en el detalle de una orden, sección Rastreo del envío, de Órdenes. La cuenta con la paquetería se configura en Logística.

Qué es

Generar guía compra la guía de envío de la orden en tu propia cuenta de la paquetería (DHL Express, UPS o Estafeta), guarda el PDF para que lo imprimas y empieza a rastrearla sola. No entras al portal de la paquetería ni copias números.

Una orden puede tener su guía de dos maneras:

Botón	Úsalo cuando	Qué hace
Generar guía	La orden eligió una paquetería y tu cuenta con ella está conectada.	Compra la guía en tu cuenta, guarda el PDF y la deja en rastreo.
Registrar guía	Ya sacaste la guía por tu cuenta, en el portal o en el mostrador de la paquetería.	Solo la asocia a la orden para rastrearla. No compra nada.

Si ya compraste la guía fuera de Flux, no la generes otra vez: regístrala. Generarla compra una guía nueva y la paquetería te la cobra.

Antes de empezar

Tu cuenta de paquetería conectada. En Logística → Conexiones crea la conexión con el conector de tu paquetería, elige el ambiente y captura las credenciales de guías. La pantalla muestra solo si cada credencial está configurada, nunca su valor.

Conector	Credenciales de guías	Además
DHL	expressUsername, expressPassword y expressAccountNumber.	defaultParcelCm con el tamaño de tu caja (por ejemplo `30x20x10`, en centímetros): sin esa medida DHL no genera la guía.
UPS	clientId, clientSecret y accountNumber (tu número de cuenta UPS).	Las medidas son opcionales.
Estafeta	apiKey, clientSecret, customerNumber y subscriberId, los datos que te entrega tu asesor de Estafeta con el convenio.	defaultParcelCm con el tamaño de tu caja; salesOrganization solo si tu convenio la incluye. Si al generar ves La conexión no está habilitada, pide a soporte que habilite el servicio de Estafeta de tu convenio.

La operación de guías disponible. En la misma conexión, Capacidades por operación debe mostrar Guías como Verificada o Sin verificar. Con No disponible el botón responde que tu conexión no genera guías.
La orden eligió una paquetería con cuenta. La guía se genera con la opción de envío que el cliente eligió al pagar y con la cuenta ligada a ella. Una orden de recolección o de reparto local, o anterior a la logística nueva, no la tiene: usa Registrar guía.
Peso en cada producto. Cada producto de la orden necesita su Peso, en gramos, en la pestaña Envío de su ficha (por ejemplo, 450 para un producto de 450 g). La guía lleva el peso real de la orden, nunca uno supuesto; si falta el de un solo producto no se genera.
Sucursal principal completa. Las guías salen de tu sucursal principal: el almacén que tiene Principal activado en Almacenes (de entrada, el que Flux crea al dar de alta tu negocio). Debe tener código postal, ciudad, calle, encargado y teléfono: la paquetería los imprime como remitente. Cuando el cliente paga, la orden guarda esa sucursal como su origen, así que cambiar después de sucursal principal no mueve las órdenes ya pagadas.
Dirección de entrega completa y en México. La orden debe traer nombre, teléfono, ciudad y código postal de quien recibe. Por ahora solo se generan guías con destino en México.

Generar la guía

Abre Órdenes y presiona Ver en la orden pagada.
En Rastreo del envío, presiona Generar guía.
Espera a que el botón diga Generando…. Al terminar verás el aviso Guía generada y, en la orden:
- Número de guía, con botón para copiarlo.
- Guía generada con tu cuenta.
- Costo de la guía.
- Descargar guía y Cancelar guía.
- El Estado del envío en Guía registrada; desde ahí la guía se actualiza sola.

Si presionas el botón dos veces, se corta la conexión o reintentas, no se compra una guía duplicada: la orden conserva la primera.

El costo de la guía

Costo de la guía es lo que la paquetería cobra a tu cuenta por esa guía. No cambia lo que el cliente pagó por el envío: el cargo de la orden queda como estaba, así puedes comparar los dos y ver el margen del envío. Si la paquetería no informa el importe, la pantalla dice La paquetería no informó el costo en lugar de inventar uno.

Descargar la guía

Presiona Descargar guía. Se baja un PDF llamado guia- con el número de guía, listo para imprimir. El archivo queda guardado en tu negocio: solo tu equipo puede descargarlo, las veces que haga falta.

Cancelar la guía

Presiona Cancelar guía y confirma. La guía queda en Guía cancelada, el estado del envío cambia a Envío cancelado y Flux deja de consultarla. Si eliges Conservar, no pasa nada.

Cancelar una guía que ya cancelaste no hace nada: la orden conserva la primera cancelación.

Qué paqueterías cancelan desde Flux

Paquetería	Cancelar guía
UPS	Cancela directo mientras UPS no haya recogido el paquete.
Estafeta	Cancela directo cuando tu convenio incluye la cancelación por sistema. Si no la incluye verás Esta paquetería no cancela por API: cancélala en el portal de Estafeta.
DHL Express	No cancela desde otro sistema (ver abajo).

Con DHL, la cancelación es manual

DHL Express no permite cancelar guías desde otro sistema. Al presionar Cancelar guía con una guía de DHL verás Esta paquetería no cancela por API y la guía sigue activa. Para cancelarla, entra al portal de DHL Express con tu cuenta y cancélala ahí.

Limitación de hoy: Flux no se entera de esa cancelación. La orden seguirá mostrando la guía como activa y no te dejará generar otra para la misma orden. Si necesitas una guía nueva, avisa a soporte.

Con las paqueterías que sí cancelan, si la paquetería rechaza la cancelación verás La paquetería no aceptó cancelar y la guía sigue activa.

Si algo falla

La pantalla explica qué paso se detuvo. En todos los casos no queda una guía a medias ni se cobra, y puedes reintentar cuando lo corrijas.

Mensaje	Qué pasó	Qué hacer
Esta orden no eligió una paquetería	La orden no tiene una opción de envío ligada a tu cuenta.	Usa Registrar guía.
La orden no se puede enviar	La orden está cancelada o reembolsada.	Revisa el estado de la orden.
Tu conexión no genera guías	La conexión no ofrece Guías.	Revisa Capacidades por operación en Logística.
Faltan credenciales de la paquetería	Falta alguna credencial de guías.	Captura las credenciales de guías de tu paquetería en la conexión (tabla de arriba).
La paquetería rechazó tus credenciales	La paquetería no aceptó el usuario, la contraseña, la llave o la cuenta.	Corrígelas en la conexión.
La conexión no está habilitada	El servicio de Estafeta de tu convenio aún no está habilitado en Flux.	Pide a soporte que lo habilite.
Falta el peso de un producto	Un producto de la orden no tiene Peso.	Captúralo en gramos en la pestaña Envío del producto.
Faltan las medidas del paquete	La conexión no tiene defaultParcelCm.	Captura las medidas de tu caja en la conexión.
Falta completar la sucursal principal	Tu negocio no tiene sucursal principal, o le falta código postal, ciudad, calle, encargado o teléfono.	En Almacenes activa Principal en una sucursal y completa esos datos. El aviso de la orden trae el enlace Completar la sucursal principal.
La dirección de entrega está incompleta	Falta ciudad o código postal en la orden.	Corrige la dirección de la orden.
Destino fuera de México	Por ahora las guías solo se generan con destino en México.	Registra la guía que saques por otro medio.
La paquetería rechazó la dirección	La paquetería no reconoció la dirección de entrega o no tiene cobertura en ese código postal.	Corrige el código postal y reintenta. El aviso El último intento de generar la guía falló queda visible hasta que lo logres.
Se agotó el límite diario de llamadas	Tu cuenta llegó a su cuota del día.	Reintenta mañana, o sube el límite diario en la conexión si tu cuenta con la paquetería lo permite.
Ya se está generando la guía	Otro intento sigue en curso.	Espera un momento y recarga la orden.

Buenas prácticas

Captura el Peso de los productos antes de abrir la tienda: es el dato que más guías detiene.
Prueba primero con el ambiente Pruebas de la conexión y revisa el Costo de la guía antes de pasar a Producción.
Genera la guía cuando el paquete esté listo para salir: cancelarla en DHL es un trámite manual en su portal.
Completa tu sucursal principal antes de la primera guía: es el remitente de todas.