📌 Requisitos
Antes de solicitar una etiqueta, debés tener un envío ya creado. El único parámetro necesario es el shippingId completo, que se obtiene al crear el envío.
📥 Formato PDF (por defecto)
Endpoint
GET /shippings/{shippingId}/label?appId={appId}Ejemplo en CURL
curl -X GET "https://api-dev.moova.io/b2b/shippings/b9255870-6166-11ea-914b-ff471ce5170b/label?appId=263c2990-5897-11ea-be4a-07dfc19f6353" \ -H "accept: application/json" \ -H "Authorization: YOUR_TOKEN"
Respuesta
{ "label": "https://s3.amazonaws.com/develop.files.moova.io/shippings/labels/b9255870-6166-11ea-914b-ff471ce5170b_15x10.pdf" }🧾 Formato ZPL (para impresión térmica)
Si necesitás la etiqueta en formato .zpl, podés especificarlo usando el parámetro format=zpl.
Ejemplo en CURL
curl --location 'https://api-dev.moova.io/b2b/shippings/01de9b10-7566-11ed-a4c3-e539b9647fd6/label?format=zpl&appId=2940ea30-5705-aaaa-a3a0-3deac8a54303' \ --header 'Authorization: YOUR_TOKEN'
Respuesta
El contenido será directamente el archivo ZPL, listo para usar con impresoras térmicas.
🧩 Formato data
También es posible solicitar el formato data, que devuelve toda la información estructurada de la etiqueta (dimensiones, direcciones, códigos, etc.).
⚠️ Errores comunes
Si el envío tiene información incorrecta (por ejemplo, una dirección inválida), la API puede devolver un error.
En este caso, será necesario corregir los datos desde el panel o mediante una actualización por API.
📦 Lectura de etiquetas generadas por terceros
Moova puede procesar etiquetas generadas por los clientes siempre y cuando:
Contengan un código de barras o QR que incluya:
El
shippingIdcompleto, oEl
internalCodeprovisto por el cliente al momento de crear el envío.
Opcionalmente, podés pedir a Moova que inserte un código de barras con tu internalCode en la etiqueta generada por nosotros. Esta funcionalidad se activa a pedido.