Guía de Instalación spacesrsv.js - Reserva de Espacios en Autoservicio - SpacesRSV

Guía de Instalación spacesrsv.js - Reserva de Espacios en Autoservicio - SpacesRSV

SpacesRSV se puede instalar rápidamente en cualquier página sin necesidad de saber programación. Puede instalarlo en cuaquier CMS (Drupal, Joomla, Wordpress, Wix, SquareSpace, Elementor), o en cualquier infraestructura de código PHP, HTML, Ruby.
Este manual está escrito para el Web Master: la persona o agencia que diseña, gestiona, administra o se encarga de la página Web del hotel.

Descripción General

La librería spacesrsv.js para Reservaciones con hotelRSV de Novohit, facilita la integración del motor de reservaciones de SPACES en el sitio web de su empresa. SpacesRSV se activa a través de Botones para Reservar, conocidos como CTA (Call To Action) o Elementos de Acción.

Instalación

Requerimientos Necesarios

Requerimiento
Estatus
Descripción
DOCTYPEOBLIGATORIO
Los ficheros HTML, XML, XHTML deben tener una declaración de tipo, esta declaración debe ser la primera línea de nuestro documento y es necesaria para indicarle al navegador qué versión de HTML es la que se usa en la página (ver documentación).
Idea
Esto es estándar en todas las páginas Web modernas.


Instalación o Actualización en páginas del sitio Web

Para la integración de la librería de reservación en cualquier página donde desee permitir a sus clientes realizar reservaciones, por ejemplo la Home Page (Pagina de Inicio), se debe incluir el siguiente código antes de la etiqueta de cierre </head> o cierre </footer>, substituyendo los siguientes valores:

VariableValorEjemplo
COLOCAR_CODIGO_DE_OPERACION_AQUIEs un identificador alfanúmerico del tipo de Operación para asignar el valor a nvh_g_id_operation, el staff de Soporte Novohit le proporcionará este valor por ticket.
  1. <script> var nvh_g_id_operation = 101; </script>
DOMINIO_NOVOHIT
El dominio base de la instalación de Novohit, seguido de /apps/spaces-auto para asignar el valor a nvh_g_spc_url
  1. var nvh_g_spc_url = 'https://acme.novohit.com/apps/spaces-auto';
CODIGO_UNICO_DE_ANALYTICS
Identificador numérico del sitio web para analíticos asignando el valor a nvh_g_id_site_analytics. El staff de Soporte Novohit le proporcionará este valor por ticket.
  1. var nvh_g_id_site_analytics = CODIGO_UNICO_DE_ANALYTICS
DOMINIO_SITIO_WEB_OFICIAL
Sitio Web oficial de la empesa.


Código para instalar Spaces spacesrsv.min.js

  1. <head> <!-- no copiar esta linea, es sólo de referencia -->
  2. <!-- otro código en el <head> -->
  3. <!-- SpacesRsv.js Code -->
  4. <script> 
  5.   var nvh_g_id_operation = COLOCAR_CODIGO_DE_OPERACION_AQUI; 
  6.   var nvh_g_id_site_analytics = CODIGO_UNICO_DE_ANALYTICS;
  7.   var nvh_g_spc_url = 'https://DOMINIO_NOVOHIT/apps/spaces-auto';
  8. </script>
  9. <script type="text/javascript" src="https://cdn.novohit.com/static/apps/ibe/plugin/spaces/spacesrsv.min.js"></script>
  10. <!-- analytics.novohit.com -->
  11. <script>
  12.   var U_nvh_g_spc_url = new URL(nvh_g_spc_url);
  13.   var nvh_hostname = U_nvh_g_spc_url.hostname;
  14.   var crossDomainQueryParam;
  15.   var _paq = window._paq = window._paq || [];
  16.   /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
  17.   _paq.push(["setCookieDomain", "*.DOMINIO_SITIO_WEB_OFICIAL.com"]);
  18.   _paq.push(["setDomains", ["*.DOMINIO_SITIO_WEB_OFICIAL.com","*.CUALQUIER_OTRO_DOMINIO_INDICADO_POR_NOVOHIT"]]);
  19.   _paq.push([ function() { crossDomainQueryParam = this.getCrossDomainLinkingUrlParameter(); }]);
  20.   _paq.push(["enableCrossDomainLinking"]);
  21.   _paq.push(["setCampaignNameKey", ["lead_src", "promo_code", "pk_cpn", "pk_campaign", "mtm_campaign", "piwik_campaign", "matomo_campaign", "utm_campaign", "utm_source", "utm_medium"]]);
  22.   _paq.push(["setCampaignKeywordKey", ["promo_code", "pk_kwd", "mtm_kwd", "piwik_kwd", "matomo_kwd", "utm_term"]]);
  23.   _paq.push(['trackPageView']);
  24.   _paq.push(['enableLinkTracking']);
  25.   (function() {
  26.     var u="https://analytics.novohit.com/piwik/";
  27.     _paq.push(['setTrackerUrl', u+'matomo.php']);
  28.     _paq.push(['setSiteId', nvh_g_id_site_analytics]);
  29.     var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
  30.     g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
  31.   })();
  32. </script>
  33. <noscript><p><img referrerpolicy="no-referrer-when-downgrade" src="https://analytics.novohit.com/piwik/matomo.php?idsite=CODIGO_UNICO_DE_ANALYTICS&amp;rec=1" style="border:0;" alt="" /></p></noscript>
  34. <!-- end analytics.novohit.com -->
  35. <!-- end SpacesRSV.js Code-->
  36. </head><!-- no copiar esta linea, es sólo de referencia -->
Colocar el código en el orden proporcionado.

Configuración de Elementos de Acción o botones de “Reservar Ahora”

Configurar los Botones de “Reservar” o Elementos de Acción. Para esto, simplemente coloque la clase spc-app-launcher
 en el elemento HTML que mostrará el motor de reservaciones de SPACES.

Ejemplo: 
  1. <button class="clase-ya-existente-1 clase-ya-existente-2 spc-app-launcher">Reservar Ahora</button>
Pueden agregar la clase a cualquier elemento html

Casos de Múltiples Operaciones

En las empresas que tienen múltiples operaciones se pueden implementar, en una misma página Web, diferentes botones que redoreccionan al usuario para reservar en las diferentes operaciones.
Ejemplos de múltiples operaciones o múltiples unidades de negocio son:
  1. diferentes atracciones,
  2. diferentes venues de eventos,
  3. diferentes restaurantes,
  4. diferentes parques,
  5. diferentes estadios o clubes deportivos
Para que en una misma página puedan poner múltiples botones y que cada uno apunte a una operación diferente, deben usar el atributo html data-spaces-id-operation. Ejemplo:
  1. <button class="clase-ya-existente-1 clase-ya-existente-2 spc-app-launcher" data-spaces-id-operation="ID_OPERACION_PROPORCIONADO_POR_NOVOHIT">Reservar Ahora</button>
Pueden agregar el atributo a cualquier elemento html

Parámetros adicionales para CTA: Call To Action 

Para que estos parámetros funcionen, es requisito que esté instalado spacesrsv.min.js en la landing page. 

Parámetros adicionales para Elementos HTML (Botones dentro de la página)

Atributo HTML
Detalle
Ejemplo
data-spaces-dt-begin
Fecha en formato AAAMMDD. 
Idea
Opcional. En caso de no colocar dato, tomará la fecha actual del navegador.
Notes
Según su logica de negocios, debe ser menor o igual a data-spaces-dt-end. De lo contrario la app redireccionará a la fecha y hora actual sea para la llegada que para la salida
Ejemplo data-spaces-dt-begin="20270101"
data-spaces-tm-begin
Warning
Solo para operaciones que usen hora de llegada para filtrar los resultados de búsqueda. Consulte con el staff de Soporte Novohit si aplica para su caso. 
Hora en formato HH:MM (24 horas).
Idea
Opcional. En caso de no colocar dato, tomará la hora actual del navegador.
Notes
Debe ser menor que data-spaces-tm-end. De lo contrario la app redireccionará a la fecha y hora actual sea para la llegada que para la salida
Ejemplo: data-spaces-tm-begin="15:10" para las 3:10 pm
Ejemplo: data-spaces-tm-begin="00:30" para las 12:30 am
data-spaces-dt-end
Warning
Solo para operaciones que usen fecha de check-out o de salida. Consulte con el staff de Soporte Novohit si aplica para su caso.
Fecha en formato AAAMMDD.
Idea
Opcional. En caso de no colocar dato, tomará la fecha actual del navegador.
Notes
Según su lógica de negocios, debe ser mayor o igual a data-spaces-dt-begin. De lo contrario la app redireccionará a la fecha y hora actual sea para la llegada que para la salida.
Ejemplo data-spaces-dt-end="20270102"
data-spaces-tm-end
Warning
Solo para operaciones que usen hora de salida para filtrar los resultados de búsqueda. Consulte con el staff de Soporte Novohit si aplica para su caso.
Hora en formato HH:MM (24 horas).
Idea
Opcional. En caso de no colocar dato, tomará la hora actual del navegador.
Notes
Debe ser mayor que data-spaces-tm-end. De lo contrario la app redireccionará a la fecha y hora actual sea para la llegada que para la salida
Ejemplo: data-spaces-tm-end="16:10" para las 4:10 pm
Ejemplo: data-spaces-tm-end="05:30" para las 5:30 am
data-spaces-qty-people
Warning
Solo para operaciones que usen número de personas para filtrar los resultados de búsqueda. Consulte con el staff de Soporte Novohit si aplica para su caso.
Numero de personas en dato numérico
Idea
Opcional. Si lo coloca, debe ser mayor a 1. En caso de no colocar dato, no aplicará este filtro y se mostrarán todos los resultados

Ejemplo: data-spaces-qty-people="50" para filtrar por espacios de al menos 50 personas

Ejemplo:
  1. <button class="clase-ya-existente-1 clase-ya-existente-2 spc-app-launcher" data-spaces-dt-begin="20270101">Reservar Ahora</button>
Idea
Pueden agregar el atributo a cualquier elemento html
Es necesario agregar el parámetro 
Parámetro qryDetalleEjemplo
f_name
Valor fijo nvh_spc_launcher
Idea
Obligatorio. Es necesario colocar este parametro en el qry del navedor si se desea que se abra el aplicativo de reservas.
sitiodereservas.com/?f_name=nvh_spc_launcher
dt_begin
Fecha en formato AAAMMDD. 
Idea
Opcional. En caso de no colocar dato, tomará la fecha actual del navegador.
Notes
Según su logica de negocios, debe ser menor o igual a dt_end. De lo contrario la app redireccionará a la fecha y hora actual sea para la llegada que para la salida
sitiodereservas.com/?f_name=nvh_spc_launcher&dt_begin=20270101
tm_begin
Warning
Solo para operaciones que usen hora de llegada para filtrar los resultados de búsqueda. Consulte con el staff de Soporte Novohit si aplica para su caso. 
Hora en formato HH:MM (24 horas).
Idea
Opcional. En caso de no colocar dato, tomará la hora actual del navegador.
Notes
Debe ser menor que data-spaces-tm-end. De lo contrario la app redireccionará a la fecha y hora actual sea para la llegada que para la salida
Para las 3:10 pm:

sitiodereservas.com/?f_name=nvh_spc_launcher&dt_begin=20270101&tm-begin=15:10

Para las 12:30 AM: &tm-begin=00:30
dt_end
Warning
Solo para operaciones que usen fecha de check-out o de salida. Consulte con el staff de Soporte Novohit si aplica para su caso.
Fecha en formato AAAMMDD.
Idea
Opcional. En caso de no colocar dato, tomará la fecha actual del navegador.
Notes
Según su lógica de negocios, debe ser mayor o igual a data-spaces-dt-begin. De lo contrario la app redireccionará a la fecha y hora actual sea para la llegada que para la salida.
Para busquedas del 1 al 2 de enero 2027

sitiodereservas.com/?f_name=nvh_spc_launcher&dt_begin=20270101&dt_end=20270102
tm_end
Warning
Solo para operaciones que usen hora de salida para filtrar los resultados de búsqueda. Consulte con el staff de Soporte Novohit si aplica para su caso.
Hora en formato HH:MM (24 horas).
Idea
Opcional. En caso de no colocar dato, tomará la hora actual del navegador.
Notes
Debe ser mayor que data-spaces-tm-end. De lo contrario la app redireccionará a la fecha y hora actual sea para la llegada que para la salida
Para las 4:10 pm:

sitiodereservas.com/?f_name=nvh_spc_launcher&...&tm_end=16:10

Para las para las 5:30 am:
...&tm_end=05:30 
qty_people
Warning
Solo para operaciones que usen número de personas para filtrar los resultados de búsqueda. Consulte con el staff de Soporte Novohit si aplica para su caso.
Numero de personas en dato numérico
Idea
Opcional. Si lo coloca, debe ser mayor a 1. En caso de no colocar dato, no aplicará este filtro y se mostrarán todos los resultados

Ejemplo:
sitiodereservas.com/?f_name=nvh_spc_launcher&qty_people=50 para filtrar por espacios de al menos 50 personas

Detalles Hardware


    • Related Articles

    • Reserva Espacios en Autoservicio

      Esta funcionalidad le permitirá recibir reservaciones de cualquier espacio configurado en las Operaciones de Spaces (Canchas deportivas, Tours, Excursiones, Renta de equipo recreativo) todo desde su propia página web. Requisitos Es necesario haber ...

    • Reserva de Mesas en POS con Spaces

      Reserva de Mesas en POS con Spaces Introducción Esta funcionalidad le permite reservar mesas del POS para la unidad de negocios de Alimentos y Bebidas. Requisitos Es necesario haber realizado la configuración del módulo antes de ser usado. Ver la ...

    • Reserva de Espacios

      Este documento explica cómo realizar reservas en el módulo Spaces Management. Debe dirigirse a: Spaces → Reserva de espacios La ruta también se puede encontrar como: Areas-Eventos→ Reservas de Espacios y/o Equipos Se abrirá una nueva ventana que le ...

    • Espacios Fuera de Servicio

      Espacios Fuera de Servicio Para dejar un espacio fuera de servicio debe realizar lo siguiente: Abrir el Módulo de Spaces y en caso de tener varias operaciones seleccionar, en la que se encuentre el espacio que quiere dejar fuera de servicio. Hacer ...

    • Asociar, desasociar Cliente CxC a reserva de SPACES existente

      Para los Tipos de Operación de la aplicación SPACES de Novohit que tienen habilitada la captura de Clientes de Cuentas por Cobrar (CxC) en el flujo de reservación, aplican las siguientes restricciones: Una vez creada una reserva sin Cliente CxC ya no ...