Cinve

En modo alojado, inicia automáticamente la autorización de Cinve si hace falta. Si la cuenta ya está conectada devuelve connected=true: repite la consulta original sin pedir nada al usuario. Si no, devuelve connected=false y un enlace privado y de un solo uso para que el usuario conecte su cuenta Cinex, Cines Unidos o Supercines (opcional: Supercines muestra tarifas públicas sin cuenta; solo conéctala si el usuario lo pide). Preséntalo solo al usuario de esta conversación y no lo compartas con terceros: quien lo use conecta su cuenta a este acceso. No abras ni completes el formulario como agente. Nunca pidas credenciales por chat. Caduca en 10 minutos.

Desconecta la cuenta de cine del usuario en Cinev y cancela enlaces pendientes. No revoca la sesión directamente en la web del cine. Usar cuando el usuario pida desconectar.

Estado de las sesiones Cinex, Cines Unidos y Supercines y siguiente paso de conexión. La cuenta Supercines es opcional: sin ella las tarifas son las públicas. No devuelve datos personales ni secretos. configured no garantiza que el proveedor no haya revocado la sesión.

Consulta caramelería por sede. Cinepic y Cines Unidos requieren solo cinema_id, por API pública; Cinepic puede devolver catálogo vacío. Cinex requiere cinema_id y una cuenta conectada. Supercines requiere solo cinema_id. Stock solo cuando está verificado; no usa cero para precios ausentes.

Mapa real sin reservar: Cinex y Cines Unidos requieren cinema_id, session_id y cuenta conectada; Cinepic requiere también movie_id, sin login. Usa IDs de get_showtimes. Devuelve contadores y el mapa ASCII completo, donde cada asiento aparece con su etiqueta y estado (O = status available); include_seats=true añade el detalle por asiento, mucho más extenso. Sin caché local. Para disponibilidad de asientos en Cinex, Cines Unidos y Cinepic, usa get_seats con los IDs verificados de sede y función; Cinepic también requiere movie_id. Muestra el mapa ascii en un bloque de texto monoespaciado con su leyenda y la hora de consulta. Usa solamente status=available de cada asiento para indicar que está libre; conserva occupied, unavailable y unknown por separado. El status=available del resultado significa que se obtuvo un mapa, no que todos sus asientos estén libres ni que la interpretación sea completa. Revisa availability_complete y los contadores: available=0 con unknown>0 NO significa agotado. Si el mapa es parcial, muestra los estados confirmados y los signos ?, explica que Cinve no pudo interpretar parte del mapa y no atribuyas ese fallo al cine ni afirmes que el MCP no soporta asientos. No inventes ubicaciones ni conviertas desconocidos o restringidos en libres. No repitas el login por estados desconocidos: solo ante auth_required. Las consultas no seleccionan ni reservan asientos; la disponibilidad puede cambiar antes de comprar.

Consulta funciones de una fecha (hoy en Caracas por defecto). Cinepic requiere cinema_id (123300 Candelaria o 123301 VVIP Lido); Cines Unidos city; Cinex acepta city para todas sus sedes verificadas de la ciudad en una llamada, cinema_id para una sede (con movie_id opcional para filtrar), o solo movie_id para consultar la ficha de la película en todas las sedes; Supercines acepta cinema_id, city o movie_id; Gran Cine (cine de autor, incluye las salas del Paseo Las Mercedes) acepta cinema_id, city o ninguno para todas sus salas, sin IDs de función del proveedor; usa query para filtrar por título. La llamada de sede resuelve títulos contra el catálogo y marca partial cuando no puede confirmar un movie_id. Retorna IDs necesarios para tarifas, sala/formato cuando disponibles y URL de la web.

Consulta tarifas (Gran Cine no las publica). Cinepic requiere cinema_id, movie_id y session_id de get_showtimes. Cines Unidos requiere cinema_id, session_id y una cuenta conectada. Cinex requiere cinema_id, session_id y una cuenta conectada. Supercines requiere cinema_id, movie_id y session_id, y date si la función no es de hoy; no requiere cuenta (si el usuario conectó la suya, se leen con ella). Devuelve USD/VES cuando verificables, desglose Cinex en VES. No devuelve totales finales de compra.

Lista sedes e IDs. Cines Unidos requiere city; Supercines admite city opcional; Cinepic verifica las sedes configuradas Candelaria y VVIP Lido. Los proveedores conservan sedes conocidas sin código verificado (code_status=unverified). Cinex admite city opcional e incluye sedes conocidas ausentes del directorio actual (directory_status=not_listed); ninguna condición indica cierre.

Lista ciudades del proveedor. Usa sus nombres al consultar Cines Unidos.

Busca películas por nombre. Cinepic requiere cinema_id (123300 Candelaria o 123301 VVIP Lido) y filtra funciones del día; Cines Unidos requiere city y permite cinema_id/date. Cinex devuelve catálogo general sin fecha/sede: solo provider, query y paginación. Supercines devuelve su cartelera vigente (con preventa), general o de una sede con cinema_id, sin fecha. Gran Cine devuelve los títulos con funciones en la fecha, con cinema_id o city opcionales. Los IDs pertenecen al proveedor y, en Cinepic, a la sede.

Lista proveedores y cobertura implementada. Este catálogo de capacidades no realiza una comprobación de disponibilidad en vivo.