Sitios y caras
Última actualización:
Lo que aprenderás
- Secuencia del asistente de alta y origen de la clasificación OpenOOH.
- Campos de Face y su uso aguas abajo.
- Versionado de costos, alertas de arriendo y documentos privados.
Antes de empezar
- Rol
- Superadministrador · Administrador · Gerente
- Permiso
- inventory.write
- Inventario
- static-only o mixed
Ruta: /inventory/sites. API: api/Sites, api/Faces.
- UsuarioDirecciónPlaces autocomplete → lat/lng, primaryType, types
- evidenciaSistemaSugerencia OpenOOHPOST api/venue-suggestions/classify
- revisiónUsuarioConfirmacióntaxonomía + caras
/inventory/sites→ Nuevo inventario → Ubicación fija. («Vehículo» abre Vehículos y flotas.)- Dirección. Las coordenadas salen del marcador; se puede reubicar.
- Clasificación sugerida (categoría, subcategoría, tipo). El clasificador distingue pieza dentro
del lugar vs. cercana a él; un
primaryTypede Places no se toma como respuesta. - Nombre y código interno.
- Caras (ver campos abajo).
- Guardar →
POST api/Sites. La evidencia de Places se persiste enStaticSite.GooglePlace*.
Campos de Face
Sección titulada «Campos de Face»| Grupo | Campos | Consumidor |
|---|---|---|
| Formato | ancho, alto, orientación, material | orden de producción, filtros de catálogo |
| Iluminación | flag, días, horas | cotización, checklist de campo |
| Emplazamiento | posición, azimut, elevación, distancia, tipo de tráfico | VAC, ficha del comprador |
| Tarifa | diaria, semanal, quincenal, mensual, moneda | catálogo compartido, CRM |
| Producción | sangrado, zona segura, notas | orden al taller |
| Restricciones | categorías bloqueadas | aprobación de demanda |
| Fotos | imágenes | catálogo, ficha |
Detalle: /inventory/faces/{id}, mismo layout para static y digital.
Página del sitio (/inventory/sites/{id})
Sección titulada «Página del sitio (/inventory/sites/{id})»| Sección | Contenido | API |
|---|---|---|
| Ficha | estructura, altura, energía (true/false/null), conectividad |
PUT api/Sites/{id}/profile |
| Caras | ocupación por cara | api/Faces |
| Arriendo | inicio, vencimiento, preaviso, renovaciones | GET api/Sites/lease-alerts, POST api/Sites/{id}/lease/renew |
| Órdenes | órdenes de trabajo del sitio | GET api/WorkOrders?siteId= |
| Documentos | almacenamiento privado (S3 site-documents/) |
api/Sites/{id}/documents |
| Rentabilidad | requiere billing.read |
GET api/Sites/{id}/profitability |
PUT api/Sites/{id}/profile reemplaza la ficha completa; el PUT general aplica sólo campos con
valor y no puede limpiar un campo.
- Conceptos: arriendo, impuesto municipal, energía, opex. Cada uno con moneda.
- Cada cambio crea una
SiteCostVersionconcostsEffectiveFrom. Un día usa la versión vigente ese día. Antes de la primera vigencia el costo es nulo, no cero.
Borrado
Sección titulada «Borrado»| Operación | Bloqueo | Respuesta |
|---|---|---|
DELETE api/Faces/{id} |
reservas, órdenes de trabajo, solicitudes de catálogo, venta vigente en su pantalla | 409 con la referencia |
DELETE api/Sites/{id} |
cualquier cara con historia comercial | 409 |
La membresía en un catálogo compartido no bloquea el borrado.