Crear etiquetas de envío

Una etiqueta tiene un solo trabajo: escanear bien, siempre

A diferencia de la mayoría de los documentos, una etiqueta de envío no la lee principalmente una persona, sino un lector de mano o de banda transportadora, así que el código de barras debe generarse correctamente y ubicarse donde un escáner lo espera. La api etiqueta de envio está construida alrededor de esa restricción: envía los datos del envío y recibe una etiqueta pensada tanto para una persona que la mira de reojo como para una máquina que la lee en un instante.

Qué lleva una solicitud de etiqueta

Envía la dirección del destinatario, la del remitente, los datos del paquete si su diseño los usa, y el código de rastreo que se debe codificar. El servicio renderiza un PDF compacto con el tamaño de los formatos de etiqueta estándar, con el código de barras ubicado con los márgenes que espera tanto un escáner como el sistema de una transportadora — sin alineación manual, sin adivinar la resolución.

Cómo funcionan la generación y la entrega

Llama a POST /pdf/label y recibe de inmediato un task_id, sin mantener una conexión abierta mientras se genera. Se construye de forma asíncrona en nuestra red global, y en cuanto está lista le avisamos por webhook firmado — natural para un sistema de bodega que envía la etiqueta directo a la impresora al empacar un pedido — o por un enlace firmado válido 24 horas cuando alguien solo necesita imprimir una etiqueta.

Dónde encajan las etiquetas en el cumplimiento de pedidos

Las etiquetas con código de barras se volvieron estándar porque la clasificación manual no escala más allá de un puñado de paquetes al día; un código escaneable permite que un paquete avance por un centro de clasificación sin que una persona lea la dirección. Este endpoint vive dentro de esa misma automatización: comercio electrónico que genera una etiqueta al marcar un pedido listo para enviar, un centro de distribución que genera etiquetas en lote para una ola de picking, devoluciones que emiten una etiqueta prepagada al aprobarse. Como cada solicitud es pequeña e independiente, una bodega de alto volumen genera muchas etiquetas en paralelo.

Un precio pensado para el volumen

Las etiquetas se cobran a una tarifa plana de $0.002 por solicitud — sin recargo por documento, pensada para operaciones que generan etiquetas por cientos o miles. Una generación fallida nunca se cobra; reintentamos tres veces antes de devolver un error claro. El acceso requiere saldo prepago, sin plan gratuito ni prueba, lo que mantiene el endpoint rápido y libre de abuso; las solicitudes sin saldo reciben un 402. Los datos del envío se eliminan tras la ventana de retención y nunca se usan para entrenamiento.