Qué resuelve
Sucursales define los lugares físicos del tenant y sus características operativas. La misma pantalla sirve para locales, puntos de retiro, dark stores, dark kitchens, depósitos y centros de distribución cuando el perfil del negocio los permite.
Límite de plan
La primera sucursal puede existir sin multi-sucursal. Para agregar más de una, el runtime exige multi_location; la UI informa que requiere Pro o superior.
No intentes crear una segunda sucursal desde la interfaz si la capability está bloqueada.
Campos
| Campo | Regla |
|---|---|
| Nombre | Obligatorio |
| Tipo de sucursal | Depende del perfil de negocio |
| Dirección | Debe seleccionarse/geocodificarse |
| Teléfono | Opcional |
| Horario | Opcional |
| Sucursal principal | Booleano |
| Ventanas operativas | Configuración especializada |
Tipos
- Local de venta: atención y venta directa.
- Punto de retiro: retiro de pedidos.
- Dark Store: almacén interno para delivery.
- Dark Kitchen: cocina sin salón.
- Depósito: almacenamiento general.
- Centro de distribución: distribución a otras sucursales.
La lista disponible se filtra por businessProfile; no todos los comercios ven todos los tipos.
Dirección y geolocalización
La dirección se valida con requireGeocoded. Para guardar deben existir coordenadas válidas. Structura normaliza el código postal argentino y genera una URL de Google Maps a partir de placeId o lat/lng.
Una sucursal sin coordenadas queda marcada como sin mapa y no debe considerarse lista para operaciones que necesiten radio geográfico.
Principal y activa
Principal determina la sucursal principal. La acción Hacer principal actualiza el servidor y refleja el cambio en la lista.
Activa/Inactiva controla disponibilidad operativa. Cambiar este estado no elimina la sucursal.
Ventanas operativas
La configuración de ventanas operativas se guarda solo cuando está habilitada. Si se desactiva, el backend recibe null para la configuración.
Crear / editar / eliminar
Crear usa POST /api/locations; editar usa PATCH /api/locations?id=...; eliminar usa DELETE /api/locations?id=....
Eliminar requiere confirmación y es irreversible desde la UI. Antes de eliminar, comprobá dependencias operativas.
Diagnóstico
No puedo agregar otra: revisá multi_location y plan.
No guarda dirección: elegí una sugerencia geocodificada y verificá lat/lng.
Tipo no aparece: depende del business profile.
No se activa: revisá el estado de la sucursal y la respuesta del endpoint.