Saltar al contenido principal

Capacidades y estado

Esta página distingue el servicio existente de las integraciones de cliente y del alcance aprobado para etapas posteriores. “Disponible” significa que la ruta está desplegada en el backend de desarrollo; no significa que exista una operación comercial equivalente.

Disponible en SIVA BACK de desarrollo​

  • GET /healthz, GET /readyz y GET /version.
  • Sesión externa a BACK mediante Identidad SIVA; las rutas privadas validan JWT.
  • Consulta y creación idempotente de organizaciones (GET y POST /v1/organizations).
  • Registro de dispositivos y emisión de permisos acotados de uso offline.
  • Escritura de registros JSON flexibles idempotentes y lectura incremental de cambios.

El inicio de sesión desde el portal y la documentación de estas rutas no sustituyen las validaciones de permisos por organización y dispositivo.

Integración parcial de clientes​

  • Inicio de sesión desde el portal: el formulario y la obtención del JWT están implementados. La ruta protegida responde 401 sin sesión; falta verificar una solicitud autenticada con una cuenta real desde este portal.
  • SIVA APP: conserva operaciones localmente y puede sincronizar borradores en draft.catalog-item. Esa colección no implementa el catálogo canónico. La sincronización completa de extremo a extremo depende de una cuenta con organización y dispositivo autorizado.
  • SIVA POS: conserva datos de demostración localmente y prepara demo.sale-intent para sincronización. Esa intención no crea una venta aceptada. Su flujo de autorización debe validarse con una sesión real.
  • SIVA PLANE: mantiene su experiencia de demostración y una base Neon separada preparada; no consulta datos privados ni tiene una API conectada.

Planeado según el alcance aprobado​

  • Modelos y API canónicos para catálogo, precios, caja, ventas, pagos y cierres, con permisos y reglas de negocio revisados.
  • Integración privada de PLANE para personal interno con permisos y auditoría separados de los usuarios comerciales.
  • Proyecciones e integración entre APP y POS después de acordar los contratos canónicos.

Hasta que esas capacidades estén implementadas y publicadas, no se deben tratar como endpoints disponibles. Consulta la referencia REST para la lista exacta de rutas que describe el backend actual.