Saltar al contenido principal

Listar Sucursales

Obtén las sucursales disponibles para envíos.

Todas las Sucursales​

GET /api/sucursales

Permiso requerido: guias.read

Lista todas las sucursales visibles en el sistema.

Respuesta​

{
  "response": "OK",
  "data": [
    { "code": "GDLGL", "descripcion": "GUADALAJARA GONZALES GALLO" },
    { "code": "URU", "descripcion": "URUAPAN" },
    { "code": "MOR", "descripcion": "MORELIA" }
  ]
}

Solo Destinos​

GET /api/sucursales/destinos

Permiso requerido: guias.read

Lista solo las sucursales que pueden recibir envíos. Usa estos códigos en el campo DestinoCode al crear guías.

Respuesta​

{
  "response": "OK",
  "data": [
    { "code": "GDLGL", "descripcion": "GUADALAJARA GONZALES GALLO" },
    { "code": "MOR", "descripcion": "MORELIA" }
  ]
}

Solo Orígenes​

GET /api/sucursales/origenes

Permiso requerido: guias.read

Lista solo las sucursales que pueden enviar paquetes.

Respuesta​

{
  "response": "OK",
  "data": [
    { "code": "URU", "descripcion": "URUAPAN" },
    { "code": "GDLGL", "descripcion": "GUADALAJARA GONZALES GALLO" }
  ]
}

Ejemplo cURL​

# Obtener destinos válidos
curl -X GET "https://ws-api.masaprisaoperativo.com/api/sucursales/destinos" \
  -H "Authorization: Bearer {token}"

Uso Recomendado​

  1. Al inicio de tu integración: Descarga la lista de destinos y guárdala en caché
  2. En tu UI: Muestra un dropdown con los destinos disponibles
  3. Periódicamente: Actualiza la lista (las sucursales pueden cambiar)

:::info Nota sobre Origen El origen de tus envíos está determinado por la sucursal asignada a tu usuario API. No necesitas consultarlo ni enviarlo en las peticiones. :::