API de JavaScript (versión nueva)

Descripción general

La API de JavaScript de Pandectes te permite interactuar con el banner de consentimiento de forma programática desde el tema de tu tienda o desde scripts personalizados. Sin necesidad de escribir código complejo, entender lo que ofrece la API te ayuda a saber qué es posible y cuándo pedir a un desarrollador que lo implemente por ti.
Esta función está disponible en el New Banner y se accede a ella desde Settings → JavaScript API.

¿Qué puedes hacer con la API de JavaScript?

Leer el estado de consentimiento actual del visitante

La API permite que tu tienda sepa siempre, en tiempo real, a qué ha dado su consentimiento un visitante. Puedes comprobar:

• Si un visitante ha permitido el seguimiento de analítica (p. ej., Google Analytics, Microsoft Clarity)
• Si un visitante ha permitido las cookies de marketing (p. ej., Facebook Pixel, TikTok)
• Si un visitante ha permitido las cookies de preferencias/funcionalidad
• La decisión de consentimiento completa del visitante como un único objeto

Esto es útil cuando quieres que otras partes de tu tienda se comporten de forma distinta según lo que el visitante haya aceptado.

Controlar el cuadro de diálogo de consentimiento

La API te permite abrir o cerrar el cuadro de diálogo del banner de consentimiento desde cualquier acción de tu tienda. Por ejemplo, un botón en el pie de página, un enlace en una página de política de privacidad o una opción personalizada "Cookie settings" en tu menú. Funciona junto con la función de enlace de menú integrada, pero ofrece a los desarrolladores más flexibilidad para activarlo desde cualquier elemento de la página.

Establecer o actualizar el consentimiento de forma programática

En escenarios avanzados, tu tienda puede establecer directamente la decisión de consentimiento de un visitante. Por ejemplo, cuando un visitante toma una decisión de consentimiento a través de una interfaz personalizada que has creado, o cuando el consentimiento se recopila mediante otro mecanismo y hay que pasárselo a Pandectes para que lo aplique.

Cambiar el idioma del banner

La API permite cambiar dinámicamente el idioma del cuadro de diálogo de consentimiento. Si tu tienda atiende a visitantes en varios idiomas y detecta su preferencia, el banner puede mostrarse en el idioma correcto sin depender únicamente del idioma predeterminado del navegador.

Reaccionar a los eventos de consentimiento

La API puede notificar a tu tienda en el mismo momento en que ocurra algo relacionado con el consentimiento, como:

• Cuando el banner se ha cargado por completo y está listo
• Cuando el visitante abre el cuadro de diálogo de consentimiento
• Cuando se cierra el cuadro de diálogo de consentimiento
• Cuando el visitante cambia o envía sus preferencias de consentimiento

Esto significa que puedes crear flujos que reaccionen al instante a la decisión de un visitante. Por ejemplo, cargar un script de seguimiento en el momento en que se da el consentimiento, sin necesidad de actualizar la página.

¿A quién va dirigida?

La API de JavaScript está pensada para comerciantes con un desarrollador o para quienes usan una tienda personalizada (custom storefront). No necesitas usar ni entender la API para que el banner funcione. Funciona por completo por sí solo desde el primer momento. Sin embargo, si quieres una integración más profunda entre el banner de consentimiento y el resto del comportamiento de tu tienda, la API es la herramienta adecuada.

Primeros pasos

Para explorar la API y ver la referencia completa, ve a Settings → JavaScript API dentro de la aplicación Pandectes. La página incluye la lista completa de propiedades, funciones y eventos disponibles, con sus descripciones. Si necesitas ayuda para implementar un caso de uso concreto, no dudes en ponerte en contacto con nuestro equipo de soporte.

Actualizado el: 19/10/2026