Modificar sucursal (PATCH)

PATCH/api/v1/sucursales/:branchId

Aplica cambios parciales a los campos administrativos de una sucursal local.

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

Contrato de la operación

Aplica cambios parciales a los campos administrativos de una sucursal local.

URL

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

Cuerpo

Incluye sólo los campos a modificar: nombre, direccion, ciudad y/o estado. estado admite únicamente activo e inactivo. Para quitar ciudad, envía una cadena vacía.

Nota sobre casa matriz

No se puede modificar el nombre de la casa matriz (sucursal con codigo SIAT 0); su dirección, ciudad y estado sí pueden actualizarse. Nunca se puede modificar codigoSiat.

Respuestas

200 OK devuelve la sucursal modificada.
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

{
  "direccion": "MI CASA",
  "estado": "activo"
}

Respuesta

Ejemplo de respuesta

200 OKapplication/json

JSON

{
  "message": "sucursal actualizada correctamente",
  "data": {
    "id": "00000000-0000-4000-8000-000000000021",
    "codigoSiat": 1,
    "nombre": "Sucursal Sur",
    "direccion": "Calle Nueva 123",
    "ciudad": "Cochabamba",
    "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