API de JavaScript (versión nueva)

Resumen

La API 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 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 la implemente por ti.
Esta función está disponible en New Banner y se accede desde All settings > JavaScript API.

¿Qué puedes hacer con la API JavaScript?

Leer el estado de consentimiento actual del visitante

La API permite que tu tienda sepa en tiempo real lo que el visitante ha consentido. Puedes comprobar:

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

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 diálogo de consentimiento

La API te permite abrir o cerrar el 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 de "Ajustes de cookies" en tu menú. Esto funciona junto con la función de enlace de menú integrada, pero da más flexibilidad a los desarrolladores para activarlo desde cualquier elemento de la página.

Establecer o actualizar el consentimiento mediante programación

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 recoge con otro mecanismo y debe pasarse a Pandectes para aplicarlo.

Cambiar el idioma del banner

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

Reaccionar a los eventos de consentimiento

La API puede notificar a tu tienda en el 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 diálogo de consentimiento
• Cuando se cierra el 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 elección del visitante. Por ejemplo, cargar un script de seguimiento en el momento en que se da el consentimiento, sin necesidad de recargar la página.

¿Para quién es?

La API JavaScript está pensada para comerciantes con un desarrollador o para quienes usan un storefront personalizado. 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 consultar la referencia completa, ve a All settings > JavaScript API dentro de la app 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 contactar con nuestro equipo de soporte.

Actualizado el: 27/10/2026