Beartrack

Referencia de la API

Consultar pedido

Recupera los datos y el estado de un envío por su número de seguimiento.

get
/v2/packages/find/{followingNumber}https://api.beartrackapp.com/api/v1

Devuelve el pedido completo: receptor, dirección, repartidor asignado y marcas de tiempo del ciclo de entrega. Es el mismo dato que alimenta la página pública de seguimiento.

Autenticación

Este endpoint no requiere credenciales.

El número de seguimiento es el único secreto: cualquiera que lo tenga puede consultar el pedido. Es el mismo comportamiento de la página pública de seguimiento.

Parámetros de ruta

followingNumberstringrequerido

Número de seguimiento del pedido: el following_number que devuelve la creación.

Ejemplo

El cuerpo sale del spec: si cambia el contrato, cambia este snippet.

curl -X GET 'https://api.beartrackapp.com/api/v1/v2/packages/find/268012'

Respuestas

200OKResponsePackageFindDto

Pedido encontrado.

_idstringsiempre

Identificador interno del paquete en Beartrack.

typestringsiempre

Origen del pedido.

receiver_namestringsiempre

Nombre de quien recibe.

receiver_lastNamestringsiempre

Apellido de quien recibe.

receiver_phonestringsiempre

Teléfono del receptor.

SenderUsersiempre

Datos del comercio que envía.

RealReceiversiempre

Quién recibió realmente el paquete, cuando difiere del destinatario.

objectsiempre

Coordenadas geocodificadas de la dirección de entrega.

ShippingAddresssiempre

Dirección de entrega.

AssignTosiempre

Repartidor asignado al envío.

order_idstringsiempre

El identificador de pedido que enviaste al crearlo.

inDatestringsiempre

Fecha en que el paquete entró a la operación.

createdAtstringsiempre

Fecha de creación del registro.

updatedAtstringsiempre

Fecha de la última modificación.

lastStatusChangestringsiempre

Fecha del último cambio de estado.

deliveredAtstringsiempre

Fecha de entrega.

objectsiempre

Quién entregó el paquete y cuándo.

objectsiempre

Quién devolvió el paquete y cuándo, si aplica.

404Not Found

  • Pedido no encontrado

    The package you are looking for does not exist.

    No hay ningún paquete con ese número de seguimiento.

Notas

  • Este endpoint no pide credenciales: el número de seguimiento es el secreto. No lo publiques en páginas indexables si no quieres que el pedido sea consultable.