Beartrack

Referencia de la API

Buscar por order_id

Encuentra tus pedidos por el identificador de tu tienda o sistema.

get
/integrations/public-api/packageshttps://api.beartrackapp.com/api/v1

Devuelve los pedidos de tu comercio con ese order_id, el más reciente primero, con la misma forma que Consultar pedido.

Autenticación

Envía estas cabeceras en cada petición.

Authorizationstringrequerido

Token de acceso: Bearer seguido del access_token que devuelve POST /integrations/oauth/token.

El token se obtiene canjeando tu client_id y tu client_secret en POST /integrations/oauth/token, y dura una hora. Este endpoint exige el scope packages:read. Cómo crear las credenciales y pedir el token: Autenticación.

Parámetros de consulta

order_idstringrequerido

Tu identificador de pedido, el mismo que enviaste al crearlo. Hasta 64 caracteres.

Ejemplo

curl -X GET 'https://api.beartrackapp.com/api/v1/integrations/public-api/packages?order_id=123456' \
  -H 'Authorization: Bearer bta_tu-token'

Respuestas

200OK

La búsqueda se hizo. `items` viene vacío si no hay coincidencias.

Ejemplo
{
  "items": [
    {
      "package_id": "66ed7ae7adb0a4095c126feb",
      "following_number": 268012,
      "order_id": "123456",
      "qr_payload": "{\"id\":\"66ed7ae7adb0a4095c126feb\"}",
      "status": {
        "code": 0,
        "name": "created"
      },
      "…": "mismos campos que Consultar pedido"
    }
  ]
}
400Bad Request

  • Petición incompleta o inválida

    invalid_request

    Falta un dato obligatorio —la cabecera Authorization, grant_type en el token o un campo del pedido como order_id— o el cuerpo no pasó la validación. error_description dice qué falló.

401Unauthorized

  • Petición incompleta o inválida

    invalid_request

    Falta un dato obligatorio —la cabecera Authorization, grant_type en el token o un campo del pedido como order_id— o el cuerpo no pasó la validación. error_description dice qué falló.

  • Token inválido o vencido

    invalid_token

    El token no existe, venció (dura una hora) o la credencial se rotó o revocó después de emitirlo.

403Forbidden

  • Scope insuficiente

    insufficient_scope

    El token no tiene el scope que exige el endpoint: packages:write para crear y cancelar, packages:read para consultar.

429Too Many Requests

  • Demasiadas peticiones

    too_many_requests

    Superaste el límite de tu credencial, por minuto: 10 canjes de token, 120 pedidos, 300 consultas o 60 cancelaciones. Cada límite es independiente.

503Service Unavailable

  • Servicio no disponible

    temporarily_unavailable

    Beartrack no pudo procesar la petición en este momento.

Notas

  • Es una lista porque order_id puede repetirse en el historial de un comercio (pedidos anteriores a la barrera de duplicados o de otros canales). Devuelve hasta 10, el más reciente primero.
  • Sin coincidencias responde 200 con items vacío, no 404.
  • Comparte el límite de 300 consultas por minuto con Consultar pedido.