Biblioteca de plantillas
Prepara etiquetas PDF con remitente, destinatario y referencias del pedido. Ajusta el tamaño de impresión y conecta los datos de dirección a un diseño reutilizable.
Etiquetas de envío
4 × 6 inch portrait shipping label inspired by classic Priority Mail labels, with a replaceable carrier logo, editable service and address fields, and a data-bound Code 128 barcode. Sample design only—not valid postage or a carrier-certified label.
Usar plantillaNo encontramos diseños con esa búsqueda.
Identifica cada paquete
Prepara la información que identifica tu paquete y comprueba el resultado en el tamaño de etiqueta que vas a usar.
Separa nombre, calle, ciudad, código postal y país. Prueba direcciones largas y varias líneas antes de publicar.
Ajusta el tamaño de página al papel de etiquetas. Imprime una prueba a escala real y comprueba que nada quede recortado.
Añade el número de pedido y, si lo necesitas, un código de barras o QR. Comprueba que el valor y formato coincidan con tu sistema.
Incluye referencias internas, peso o número de bulto si tu flujo los necesita. Obtén los códigos de seguimiento y el franqueo de tu transportista.
Abre el diseño y guarda una copia en tu proyecto. Comprueba su tamaño de página.
Asocia las direcciones y referencias a tus campos y prueba la legibilidad de los códigos en una impresión.
Publica tu copia y genera una etiqueta por paquete desde la app o la API. Usa el proceso de tu transportista para el franqueo.
Tus datos, tu diseño
El ejemplo incluye remitente, destinatario y una referencia interna de envío. El código identifica el paquete en este ejemplo; no es un número de seguimiento emitido por un transportista.
Los campos de shipment son ilustrativos: cada diseño puede usar un esquema distinto. Haz que los nombres coincidan con «Esquema y datos de ejemplo» en tu copia y reemplaza template_id por el ID de tu plantilla publicada.
Descargar shipping-label-request.json Entender los campos de datos{
"template_id": "YOUR_PUBLISHED_TEMPLATE_ID",
"expiry_minutes": 60,
"data": {
"shipment": {
"reference": "SHP-2048",
"order_number": "ORD-2048",
"sender": {
"name": "Northstar Store",
"address": "10 Example Avenue",
"city": "Seattle",
"postal_code": "98101",
"country": "US"
},
"recipient": {
"name": "Alex Morgan",
"address": "18 Example Street",
"city": "Portland",
"postal_code": "97201",
"country": "US"
},
"package": {
"weight_kg": 1.2,
"number": 1,
"total_packages": 1
},
"barcode_value": "SHP-2048",
"handling_note": "Keep dry"
}
}
}De la plantilla al PDF
Guarda el archivo como shipping-label-request.json, reemplaza el ID de plantilla y adapta sus datos. Crea un token de API con documents:create y documents:read y acceso a esa plantilla. Ejecuta los comandos desde tu terminal o servidor.
export SHIPPDF_API_TOKEN='YOUR_API_TOKEN'
curl --fail-with-body https://api.shippdf.com/v1/documents \
-H "Authorization: Bearer $SHIPPDF_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: label-SHP-2048" \
--data-binary @shipping-label-request.jsonUna solicitud correcta consume un crédito de generación y devuelve HTTP 202 con un documento en cola. Mantén el token fuera del código del navegador. Reutiliza la clave de idempotencia solo al reintentar la misma solicitud; usa una nueva para un documento distinto.
{"id":"doc_example","status":"queued","pdf_url":null}export SHIPPDF_DOCUMENT_ID='YOUR_RETURNED_DOCUMENT_ID'
curl --fail-with-body \
"https://api.shippdf.com/v1/documents/$SHIPPDF_DOCUMENT_ID" \
-H "Authorization: Bearer $SHIPPDF_API_TOKEN"Usa el ID real de la respuesta. Si el estado es queued o processing, espera antes de consultar de nuevo. Cuando sea completed, abre el pdf_url devuelto. Si es failed, revisa failure antes de volver a generar.
{"id":"doc_example","status":"completed","expiry_minutes":60,"pdf_url":"https://…/document.pdf"}El ejemplo usa expiry_minutes: 60 para enlaces de descarga de una hora. Consulta el mismo documento otra vez para obtener un enlace nuevo sin generar otro PDF.
No. ShipPDF genera el documento a partir de tus datos. Compra el franqueo y obtén las etiquetas o códigos oficiales a través de tu transportista o proveedor de envíos.
Sí. Ajusta el tamaño de página en el editor y revisa los márgenes. Haz una impresión de prueba a escala real con la impresora que vas a usar.
Sí. Conecta el valor del código a tus datos y comprueba su formato, tamaño y lectura. Un código generado no crea por sí solo un envío o un registro de seguimiento.
La etiqueta identifica el paquete y su dirección. El albarán detalla los artículos y cantidades que van dentro; puedes generar ambos documentos con plantillas separadas.
Elige un diseño y pruébalo con tus direcciones y tu impresora.