Skip to main content
Version: Latest

Listado de Oficinas por transportador

Esta API permite consultar los puntos de venta y oficinas de una transportadora específica. Está diseñada para permitir búsquedas globales (a nivel nacional) o filtradas por ciudad, nombre y dirección.

Autenticación​

El acceso requiere un JWT (JSON Web Token) válido firmado por Aveonline en las cabeceras:

  • Authorization: Bearer <data.token>

🔑 Autenticación V3

El token se obtiene por medio de la autenticación V3.

Transportadoras Disponibles​

Para el parámetro operador, puede utilizar tanto el nombre como el código (ID) de la transportadora:

TransportadoraNombre (Slug)Código (ID)
Coordinadoracoordinadora1009
TCCtcc1010
Interrapidisimointer1016
Servientregaservientrega33

Endpoint de Consulta​

Método: GET
URL: https://api.aveonline.co/api-oficinas/public/api/v1/offices/all

Parámetros de Consulta (Query Parameters)​

ParámetroRequeridoTipoDescripción
operadorSÍstringNombre o Código ID de la transportadora (ej. inter, 1016, tcc o 1010).
ciudadNostringCódigo DANE de 8 posiciones.
nombreNostringFiltro de búsqueda parcial por nombre del punto de venta.
direccionNostringFiltro de búsqueda parcial sobre la dirección física.

Ejemplos de Consulta​

Consulta nacional por transportadora​

GET https://api.aveonline.co/api-oficinas/public/api/v1/offices/all?operador=coordinadora

Consulta nacional para TCC​

GET https://api.aveonline.co/api-oficinas/public/api/v1/offices/all?operador=tcc

Consulta por ciudad​

GET https://api.aveonline.co/api-oficinas/public/api/v1/offices/all?operador=coordinadora&ciudad=05001000

Consulta por ciudad para TCC usando código de operador​

GET https://api.aveonline.co/api-oficinas/public/api/v1/offices/all?operador=1010&ciudad=11001000

Consulta por ciudad y nombre​

GET https://api.aveonline.co/api-oficinas/public/api/v1/offices/all?operador=inter&ciudad=11001000&nombre=principal

Consulta por ciudad y dirección​

GET https://api.aveonline.co/api-oficinas/public/api/v1/offices/all?operador=servientrega&ciudad=76001000&direccion=calle

Consulta usando el código ID del operador​

GET https://api.aveonline.co/api-oficinas/public/api/v1/offices/all?operador=1009&ciudad=05001000

Los parámetros se envían por query string en la URL.
Ejemplo correcto: ?operador=coordinadora&ciudad=05001000

Respuesta Exitosa (200 OK)​

La API retorna un campo operadores (un arreglo) que contiene el nombre del operador y su listado de oficinas normalizadas.

{
  "status": "success",
  "operadores": [
    {
      "nombre": "inter",
      "oficinas": [
        {
          "nombre": "CENTRO DE SERVICIO PRINCIPAL",
          "direccion": "AV CALLE 26 # 69-76",
          "ciudad": "BOGOTA"
        }
      ]
    }
  ]
}

Descripción de campos de Respuesta​

Objeto Principal​

  • status: (string) Estado de la petición (success o error).
  • operadores: (array) Lista de transportadoras consultadas.

Detalle de Oficinas​

  • nombre: (string) Nombre comercial o identificado del punto de venta.
  • direccion: (string) Dirección física de la oficina.
  • ciudad: (string) Nombre de la ciudad o localidad donde se ubica el punto.

Respuestas de Error​

CódigoMensajeRazón
401Token invalido o expiradoEl token JWT no fue proporcionado, es inválido o ya caducó.
400El parámetro operador es obligatorio.No se especificó el operador en la petición (parámetro operador vacío).
404No se encontraron oficinas o puntos de venta.La búsqueda con los filtros aplicados no arrojó resultados.