Saltar al contenido principal
GET
Obtiene un único envío por su ID de referencia. La respuesta procede de nuestra base de datos y nunca llama al transportista. Una sincronización en segundo plano actualiza cada envío (cada 10 minutos para GO! y cada hora para DHL) y synced_at te indica cuándo se consultó al transportista por última vez. Requiere el scope shipments_view o shipments_manage.

Solicitud

Parámetros de ruta

string
requerido
ID de referencia del envío (p. ej., P2611194821).

Respuesta

Si tiene éxito, la API devuelve 200 OK con el objeto del envío.
string
requerido
Identificador de referencia del envío.
string
requerido
Estado del ciclo de vida del envío. Uno de pending, in_transit, delivered, fault o cancelled.
string
requerido
Proveedor logístico. Puede ser go, dhl_parcel, dhl_warenpost, rotrunner, rapido, ups o dhl_express. Un paquete de kit a domicilio es dhl_parcel, o dhl_warenpost cuando se envía al extranjero como Warenpost International.
string
Número de seguimiento externo del proveedor logístico. Puede ser null.
string
Descripción en texto libre del contenido del paquete, tal como se indicó al crearlo (p. ej., "Medizinisch freigestellte Probe", "Home test kit"). Solo informativo: si un paquete va dirigido a un laboratorio se consulta en destination, y su envío asociado en paired_with. Puede ser null.
string
requerido
Quién imprimió la etiqueta: aniva o external. Solo los envíos aniva admiten Actualizar y Cancelar; un paquete external tiene seguimiento, pero devuelve 501 en ambos casos.
string
Referencia del otro paquete de una expedición de dos paquetes: el paquete que llevaba una etiqueta de devolución y el paquete que vuelve con esa etiqueta. Definido en ambos. null para un paquete de solo ida.
object
Dirección de recogida. Puede ser null.
object
Dirección de entrega. Misma estructura que origin. Puede ser null.
object
Franja de recogida programada. Puede ser null.
string
Notas opcionales. Puede ser null.
object[]
requerido
Eventos cronológicos del ciclo de vida procedentes del proveedor logístico (del más antiguo al más reciente). Array vacío si el proveedor aún no ha comunicado ningún evento. Úsalo para la interfaz por evento, auditorías y las señales más detalladas del transportista; básate en status para el estado actual canónico.
ShipmentAppointmentLink[]
requerido
Citas vinculadas a este envío, empezando por el vínculo más antiguo. Cada entrada es { id, added_at }; consulta cada id en Obtener cita para obtener los datos completos de la cita. Array vacío cuando no hay citas vinculadas. Solo se muestran las citas dentro de tu contexto de acceso.
ShipmentHomeKitOrderLink[]
requerido
Pedidos de kit de prueba en casa vinculados a este envío, empezando por el vínculo más antiguo, con la misma estructura { id, added_at }. Consulta cada id en Obtener pedido de kit de prueba en casa. Array vacío para paquetes de clínicas. Solo se muestran los pedidos dentro de tu contexto de acceso. Consulta Acceso.
string
Cuándo se contrastó por última vez el envío con su transportista, como instante UTC. Las lecturas nunca llaman al transportista —una sincronización en segundo plano mantiene actualizados los envíos—, así que esto indica la antigüedad de la respuesta. null hasta la primera sincronización.
string
requerido
Marca de tiempo de creación (ISO 8601).
string
Marca de tiempo de la última actualización (ISO 8601). Puede ser null.

Llamadas repetidas

Aniva guarda la respuesta de este endpoint durante 60 minutos por cada clave de API. Una llamada repetida dentro de este plazo recibe la respuesta guardada mientras el envío no cambie. Tras un cambio, obtienes una respuesta nueva. Las cabeceras Cache-Status y Age muestran que la respuesta está guardada y cuál es su antigüedad. En una respuesta guardada, synced_at y updated_at pueden ser más antiguos que en una respuesta nueva. Para enterarte de un cambio al instante, suscríbete a los eventos de webhook shipment.created y shipment.updated. Consulta Lecturas repetidas.

Respuestas de error