Etiquetas del cliente: envío por API o carga en el almacén

Algunos clientes compran sus propias etiquetas y envían el PDF con el pedido. Registre ese PDF como la etiqueta del pedido — por API al crear el pedido o cargándolo en la página del pedido — y el almacén lo imprimirá y pegará tal cual, sin comprar otra etiqueta.

Una etiqueta del cliente solo cuenta como etiqueta cuando el PDF viene con tres cosas: el número de guía, el transportista y un archivo de etiqueta estándar de 4×6 pulgadas y una página. Un PDF sin número de guía es solo un archivo: el sistema no lo tratará como etiqueta. Una vez registrada, la tarjeta de etiqueta del pedido muestra transportista, servicio y número de guía, y el envío por lotes (WMS → Órdenes de salida → Envío con etiqueta primero) usará primero esta etiqueta sin cobrar flete por el pedido; solo aplica el manejo de impresión y pegado del almacén.

Opción A: el cliente envía la etiqueta con el pedido (API)#

1. Al crear el pedido por la API de pedidos, añada el bloque de etiqueta: el PDF (como referencia de archivo o base64), el número de guía y el código del transportista; el código de servicio es opcional. Su equipo de integración encontrará los campos exactos en la documentación de la API de creación de pedidos.
2. El pedido siempre se crea. Si la etiqueta no se puede registrar — tamaño incorrecto, más de una página o un número de guía ya usado por otro pedido — la respuesta lo dice claramente en el resultado de la etiqueta, y el pedido sigue válido. Corrija el archivo y regístrelo después desde la página del pedido (Opción B), sin volver a crear el pedido.
3. Un número de guía solo puede pertenecer a un pedido a la vez. Si el mismo número llega dos veces, el segundo registro se rechaza con un mensaje claro: compruebe si el archivo se envió al pedido equivocado antes de reintentar.

Opción B: carga en el almacén#

1. Abra el pedido (OMS → Pedidos → abrir el pedido) o su orden de salida (WMS → Órdenes de salida → abrir la orden). Ambas páginas llevan la misma tarjeta «Etiqueta del cliente»: lo que carga en un lado se ve en el otro.
2. Elija el archivo PDF, confirme el número de guía y el transportista (la tarjeta precarga lo que el pedido ya declara; contrástelo con la etiqueta en papel) y cargue. Una carga nueva reemplaza automáticamente la etiqueta actual; la anterior deja de ser válida, así nunca hay confusión sobre cuál está vigente.
3. ¿Archivo equivocado? Use «Anular» en la tarjeta para liberar el número de guía y cargue el correcto. Si el número de la etiqueta difiere del declarado en el pedido, manda la etiqueta registrada y el pedido se actualiza con ese número: el número de la etiqueta física es el que reconoce el transportista.

Funciones de Docklify usadas en este artículo#

• Tarjeta de etiqueta del cliente (ver, cargar, reemplazar, anular) — OMS → Pedidos → detalle del pedido (/oms/orders) y WMS → Órdenes de salida → detalle de la orden (/wms/orders)
• Bloque de etiqueta en la API de creación de pedidos — vea la documentación de la API de creación (/api/oms/orders)
• El envío por lotes con etiqueta primero usa antes la etiqueta registrada — WMS → Órdenes de salida → Envío con etiqueta primero (/wms/orders)