Actualizar sucursal (PUT)

PUT/api/v1/sucursales/:branchId

Reemplaza los datos descriptivos de una sucursal local (solo nombre y direccion). Se requiere X-API-Key con permiso sucursales.administrar.

Header requerido X-API-KeyVer operaciones de Sucursales y puntos de venta

Contrato de la operación

Reemplaza los datos descriptivos de una sucursal local (solo nombre y direccion). Se requiere X-API-Key con permiso sucursales.administrar.

URL

PUT /api/v1/sucursales/{branchId} donde branchId es el UUID de la sucursal perteneciente a la empresa determinada por la clave API.

Cuerpo

En PUT todos los campos obligatorios son: nombre y direccion.

Nota sobre casa matriz

El nombre de la sucursal cuya codigo SIAT es 0 (casa matriz) no se puede modificar; su direccion sí puede actualizarse.

Respuestas

200 OK devuelve la sucursal actualizada.
400 solicitud inválida o validación fallida.
401 clave API inválida.
403 permiso insuficiente.
404 sucursal no encontrada.

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

JSON · cuerpo de solicitud

{
  "nombre": "CLIENTE DE DEMOSTRACIÓN",
  "direccion": "Av. Ejemplo 456"
}

Respuesta

Ejemplo de respuesta

200 OKapplication/json

JSON

{
  "message": "sucursal actualizada correctamente",
  "data": {
    "id": "00000000-0000-4000-8000-000000000021",
    "codigoSiat": 1,
    "nombre": "Sucursal Sur Modificada",
    "direccion": "Av. Ejemplo 456",
    "ciudad": "La Paz",
    "estado": "activo",
    "esCasaMatriz": false,
    "creadoEn": "2026-08-20T09:00:00-04:00",
    "actualizadoEn": "2026-08-30T16:10:00-04:00"
  }
}

Datos ficticios; los identificadores y valores cambian en cada respuesta.

Volver a Sucursales y puntos de venta