Crear etiquetas de envío
Un paquete para Ada Lovelace en Londres, con el código de seguimiento ABC123 y 1,2 kg de peso, se convierte en una etiqueta lista para imprimir, con el código de barras del tamaño y en el lugar que espera el lector. Paga por uso, sin suscripción.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
Está pensada para el momento exacto en que se empaca un pedido y necesita una etiqueta antes de salir de la bodega.
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.
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. Como cada solicitud es pequeña e independiente, una bodega de alto volumen genera muchas etiquetas en paralelo.
Un precio pensado para el volumen
Una generación fallida nunca se cobra; reintentamos tres veces antes de devolver un error claro. Los datos del envío se eliminan tras la ventana de retención y nunca se usan para entrenamiento.
Qué puede hacer con ella
Etiquetas en lote para una ola de picking
Un centro de distribución genera las etiquetas de toda una ola de pedidos a la vez, imprimiéndolas juntas justo antes de que los paquetes pasen al muelle de carga.
Etiquetas de devolución prepagadas
Un portal de devoluciones emite una etiqueta de envío prepagada en el momento en que se aprueba la solicitud de devolución de un cliente, lista para enviar por correo o descargar.
Generación de etiquetas multi-transportadora
Un agregador de envíos genera una etiqueta con el formato correcto según los requisitos de la transportadora elegida para ese envío en particular.
Preguntas frecuentes
¿El código de barras realmente escanea bien?
Sí. El código de barras se genera a partir de su código de rastreo o referencia y se ubica con el tamaño y los márgenes que espera un escáner estándar, así que se lee correctamente en lectores de mano y de banda transportadora.
¿De qué tamaño o formato son las etiquetas?
Las etiquetas se generan como PDF compactos y listos para imprimir, con el tamaño de los formatos de etiqueta estándar, así que imprimen correctamente en las impresoras de etiquetas comunes sin ajustar el tamaño manualmente.
¿Qué pasa si falla la generación de una etiqueta?
Una tarea fallida nunca se cobra. Reintentamos tres veces antes de devolver un error claro, así que nunca paga por una etiqueta que no se produjo.
¿Cuánto tiempo puedo acceder a una etiqueta generada?
Tras la ventana de retención se elimina y nunca se usa para entrenamiento.
¿Puedo crear muchas etiquetas de una vez?
Sí. Cada entrada de la lista se convierte en una etiqueta, así que un centro de distribución puede generar las de toda una tanda de pedidos juntas e imprimirlas justo antes de que los paquetes salgan hacia el muelle de carga.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/pdf/label \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"labels":[{"text":"Ada Lovelace"}]}'const res = await fetch("https://api.kit.forhosting.com/pdf/label", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"labels": [
{
"text": "Ada Lovelace"
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/label",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"labels": [
{
"text": "Ada Lovelace"
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/label", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"labels":[{"text":"Ada Lovelace"}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"labels":[{"text":"Ada Lovelace"}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/label", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"labels": [
{
"text": "Ada Lovelace"
}
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.label",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 25 |
max_pages | 200 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
413 | input_too_large | El archivo supera el límite de tamaño. |
Notas técnicas
La API Etiqueta de Envío PDF convierte una dirección, los datos del paquete y un código de rastreo en una etiqueta lista para imprimir con un código de barras legible, del tamaño que espera una transportadora.
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
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.
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. 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.
Casos de integración
Impresión de etiquetas al empacar
Una plataforma de comercio electrónico genera una etiqueta de envío en el instante en que un pedido se marca como empacado, enviándola directo a la impresora de la bodega por webhook.
Preguntas técnicas
¿Cómo genero una etiqueta de envío con una API?
Envíe la dirección del destinatario, la del remitente y el código de rastreo a POST /pdf/label y recibe un task_id. La api etiqueta de envio genera el PDF con código de barras de forma asíncrona y lo entrega por webhook firmado o por un enlace firmado válido 24 horas.
¿Esta API es gratis?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Puedo generar etiquetas en lote para todo un envío?
Sí. El endpoint es asíncrono y cada solicitud es independiente, así que un sistema de cumplimiento puede generar etiquetas para toda una ola de picking o un lote de pedidos en paralelo.
¿Por qué el precio es distinto al de otros tipos de documento?
Las etiquetas se cobran a una tarifa plana de $0.002 por solicitud sin recargo por documento, reflejando que una etiqueta es un documento pequeño y simple que se genera en alto volumen.