Preguntas frecuentes

Viene en la respuesta de Crear pedido: label_zpl_url (ZPL para impresoras Zebra, pensada para 10×15 cm a 203 dpi) y label_pdf_url. Descárgala y guárdala en ese momento: la consulta no vuelve a entregar esas URLs.

Sí puedes generarla en tu sistema. El QR tiene que contener exactamente qr_payload, que es {"id":"<package_id>"}, sin espacios ni otras claves: es lo que lee la app de los repartidores. qr_payload viene al crear el pedido y en Consultar pedido.

Cada pedido es un bulto. La API no tiene campos para cantidad de bultos, peso ni medidas.

Si un envío lleva varias cajas, crea un pedido por caja con un order_id distinto para cada una (por ejemplo 123456-1 y 123456-2). Cada uno es un envío independiente, con su propio número de seguimiento y su propia etiqueta.

Con Cancelar pedido, mientras el operador no lo haya retirado (estados 0 y 100). Es idempotente: si ya estaba cancelado responde 200 con already_cancelled: true. Si ya fue retirado responde 409 invalid_state: desde ahí, coordina la anulación con tu operador. Si tienes webhooks, recibes el evento cancelled.

No. La API tiene un solo ambiente, el de producción, y cada pedido que creas es un envío real que tu operador ve en su operación.

Para validar tu integración, crea una credencial solo para pruebas, usa order_id con un prefijo reconocible (por ejemplo TEST-) y avísale a tu operador antes de empezar. Cancela cada pedido de prueba con Cancelar pedido apenas termines, y al final revoca la credencial desde el portal.

Una vez entregado, Consultar pedido trae delivery: fecha, quién recibió, fotos y ubicación. Si tienes webhooks, el evento delivered trae lo mismo en data.delivery.

La ubicación es la que registra la app del repartidor al confirmar la entrega; si la entrega se marcó por otra vía, viene null. No capturamos firma, y el RUT de quien recibe no se entrega por API.

Probablemente usaste el seguimiento público (/v2/packages/find): no pide credenciales, así que devuelve solo lo que muestra la página de seguimiento, sin identificador interno ni evidencia. Para integrar usa Consultar pedido con tu token: trae package_id, tu order_id, el estado con su nombre y la evidencia de entrega.

El estado 100 significa que la etiqueta se descargó desde el portal. En la API aparece como label_downloaded. Está en la tabla de estados.

Sí: Buscar por order_id devuelve tus pedidos con ese order_id.

Los que tienen nombre en la columna Webhook de la tabla de estados. Para activarlos, escríbenos a [email protected] con la URL que los va a recibir y, si quieres, qué estados te interesan. El detalle del evento, la firma y los reintentos están en Webhooks.