Version: Latest

Listado de Oficinas de Transportadoras

Esta API permite consultar las oficinas y puntos de atención de las principales transportadoras en Colombia, a partir del código DANE de una ciudad.

Está diseñada para integrarse desde cualquier sistema que consuma servicios REST (ERP, e-commerce, WMS, integraciones propias, etc.).

Transportadoras Disponibles

Transportadora	Código
Interrápidísimo	1016
TCC	1010
Coordinadora	1009
Envía	29
Servientrega	33

Endpoint de Consulta

Método: GET
URL: https://api.aveonline.co/api-oficinas/public/api/v1/offices/{carrier}/{cityId}

Parámetros

Parámetro	Descripción
`carrier`	Código de la transportadora
`cityId`	Código DANE de la ciudad

Ejemplos de Uso

Respuesta Exitosa

Código HTTP: 200

{
  "status": "success",
  "data": [
    {
      "location": "Calle 50 # 50-25",
      "name": "Centro de Servicio Principal",
      "id": "05001",
      "city": "Medellín"
    },
    {
      "location": "Carrera 70 # 45-30",
      "name": "Centro de Servicio Norte",
      "id": "05001",
      "city": "Medellín"
    }
  ],
  "message": null
}

Descripción de Campos

Campo	Descripción
`status`	Estado de la operación (`success` / `error`)
`data`	Listado de oficinas encontradas
`location`	Dirección de la oficina
`name`	Nombre del punto de atención
`id`	Código DANE de la ciudad
`city`	Nombre de la ciudad
`message`	Mensaje de error o informativo

Respuesta de Error

Código HTTP: 400 / 500

{ "status": "error", "data": [], "message": "Invalid carrier" }

Consideraciones

El código de ciudad debe ser el DANE oficial (9 dígitos).
La API retorna únicamente oficinas activas para atención.
La cantidad de oficinas depende de la cobertura de cada transportadora.
El formato de respuesta es estándar para todas las transportadoras.

Transportadoras Disponibles​

Endpoint de Consulta​

Parámetros​

Ejemplos de Uso​

Interrápidísimo en Medellín​

Coordinadora en Bogotá​

TCC en Cali​

Respuesta Exitosa​

Descripción de Campos​

Respuesta de Error​

Consideraciones​