SDK y llaves de integración

Consolida, desde un ángulo puramente técnico, todo lo relacionado con cómo un sitio o sistema cliente se conecta a PDP Suite. No duplica Módulo Configuración API y Sistemas — lo complementa con la vista de integrador/desarrollador.

---

Qué es el SDK

Software Development Kit de PDP Suite. Código que el equipo técnico integra en el sitio del cliente para conectarlo con la suite. Se inicializa con la llave pública (pdp_pk_live_...) de la integración correspondiente (definición confirmada en Glosario PDP Suite).

---

Qué es una llave de integración

Identificador público (formato pdp_pk_live_...) que conecta un sitio o sistema cliente con el SDK. Se crea en Plataformas → Configuración API y Sistemas. Es pública por diseño — la seguridad no depende de mantenerla secreta, sino de la lista de “Orígenes permitidos” configurada en la llave (ver Módulo Configuración API y Sistemas, sección 6).

---

Los 4 tipos de API (qué habilita cada llave)

Tipo de API	Qué habilita	Centro que conecta
Cookies y preferencias	Banner de cookies	Centro de Preferencias
Consentimiento legal	Formularios de contacto, aceptación de términos	Centro de consentimiento
Documentos	Renderizar políticas y términos publicados	Políticas y Procedimientos directamente
Uso de datos server-side	Integraciones desde el lado del servidor	Depende del contexto

---

Ejemplo mínimo de integración (confirmado en la fuente)

import { bootstrapConsent } from '@pdpsuite/consent-sdk';

const consent = await bootstrapConsent({
  tenantPublicKey: 'pdp_pk_live_sgWGZm0is3FWx55WNcf2FOBkSGnRVkl5'
});

---

Cadena técnica completa (de la llave al banner)

Llave de integración (pdp_pk_live_...)
    → Tipo de API: Cookies y preferencias
        → conecta a un Centro de Preferencias
            → que agrupa uno o más Propósitos de Negocio tipo Cookies
                → publicados con su policyVersion oficial
                    → que el SDK valida en tiempo real en el sitio del cliente

Ver el recorrido funcional completo (no solo técnico) en Flujo de consentimiento y cookies (proceso transversal).

---

Checklist de integración técnica

1. Confirmar que el Centro de Preferencias tiene una versión Publicada (no “Sin versión publicada”).
2. Crear la llave de integración con el tipo de API correcto.
3. Agregar todos los dominios relevantes en “Orígenes permitidos” desde el inicio — agregar un dominio nuevo después requiere editar la llave.
4. Instalar el paquete del SDK (@pdpsuite/consent-sdk o equivalente) en el proyecto del sitio.
5. Inicializar con bootstrapConsent({ tenantPublicKey: '...' }).
6. Probar en un dominio de QA antes de producción — no compartir la misma llave entre entornos.

---

Errores técnicos frecuentes

Situación	Causa	Solución
El SDK no valida el consentimiento	La llave conecta al Centro de Preferencias equivocado	Verificar el campo “Centro funcionario” de la llave
El banner no aparece en un dominio nuevo	El dominio no está en “Orígenes permitidos”	Editar la llave y agregarlo
La llave muestra “No aplica” en Versión activa	El Centro conectado no tiene versión publicada	Publicar una versión en Centros de Preferencias

---