Stage 6 — Rationale Packaging (Entrega + trazabilidad)

Sexta etapa. Garantiza que la plantilla configurada se entregue con su mapa de variables y el racional de las decisiones, para auditoría y para que cualquiera del equipo entienda y mantenga la configuración después.

Responsabilidad

Una sola cosa: empaquetar el entregable. El archivo configurado se entrega limpio (es el que se sube a Trébol); aparte se entrega un documento de trazabilidad con el mapa de variables y el racional.

Input

state.configured_template (de Stage 5: ruta + métricas).
state.panel_decisions (decisiones, disensos, notas).
state.user_answers.

Proceso

Paso 1 — Mapa de variables (auditable)

Tabla, una fila por campo del cliente:

Campo (etiqueta)	Ubicación	Variable de Trébol	Forma	Confianza	Nota

Incluye TODOS los campos, también los SIN_VARIABLE (con ”—” en variable y la nota de tratamiento).

Paso 2 — Racional corto (3–6 bullets)

Solo las decisiones que importan: ambigüedades resueltas, gotchas aplicados (numeración, delegate, separador Colombia), campos sin variable y por qué, y cualquier precedente que marcó el CPO. No narres todo el pipeline.

Paso 3 — Pendientes de verificación

Lista los tokens marcados como “verificar contra una verificación real” (ej. delegate, variantes no documentadas, separador Colombia). Estos son candidatos a corrections.md una vez confirmados, y deben probarse exportando una verificación de prueba antes de dar la plantilla por cerrada.

Paso 4 — Cómo probar (recordatorio operativo)

Paso 4a — Subir la plantilla al dashboard. Ve a Ajustes → “Plantillas de formatos” en la app de Trébol y sube el archivo configurado. El dashboard te mostrará el doc-template-id asignado a esa plantilla (ID visible en la tabla de plantillas). Limitación conocida: no hay endpoint de API para subir ni listar plantillas — es exclusivamente vía dashboard.

¿No tienes una verificación lista? Sigue el flujo end-to-end de ../../flows/kyb-mexico.md para crear una verificación con estado finished en el entorno de pruebas. Necesitas una verificación con datos antes de poder probar la exportación.

Paso 4b — Exportar (plantilla sin apoderados o con GET simple).

curl -s -X GET "https://api.gotrebol.com/v2/verifications/{verification-id}/export/{doc-template-id}" \
  -H "x-api-key: treb_sk_live_..."

La respuesta NO es el documento — es un JSON:

{ "success": true, "message": "File generated successfully. Download URL provided.",
  "download_url": "https://...", "expires_in": 3600000, "size": 1000000 }

expires_in está en milisegundos (3 600 000 ms = 1 hora). Descarga el archivo desde download_url dentro de ese período (no requiere auth adicional: es una URL prefirmada). Ábrelo y verifica que los tokens se reemplazaron. Si algún token quedó literal, revisar llaves/espacios/numeración (ver grounding/sintaxis-plantillas.md sección 7). Paso 4c — Exportar con apoderados (key_person_N). Si la plantilla usa variables de apoderado ({key_person_1_name}, etc.), el GET simple puede no llenarlas. Usa el POST con el mapeo explícito:

curl -s -X POST "https://api.gotrebol.com/v2/verifications/{verification-id}/export/{doc-template-id}" \
  -H "x-api-key: treb_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "key_people": [
      { "key": "key_person_1", "person_id": 123, "role_id": "abc-role-id" },
      { "key": "key_person_2", "person_id": 456, "role_id": "def-role-id" }
    ]
  }'

Obtén person_id y role_id del endpoint GET /v2/verifications/{verification-id}/people → array key_people: person_id = campo people_id; role_id = campo id dentro de roles. La respuesta es el mismo JSON con download_url. Ver spec en ../../reference/openapi.yaml.

Paso 5 — Formato del documento de trazabilidad

Markdown por defecto (rápido y editable). Si el usuario pide Word, genera un .docx Trébol-branded (este documento es interno, no es la plantilla del cliente, así que aquí sí aplican los brand guidelines de trebol-brand-guidelines). El documento de trazabilidad debe llevar visible “DOCUMENTO INTERNO — TRAZABILIDAD DE CONFIGURACIÓN”.

Paso 6 — Entregar

Usa present_files con, en este orden:

El archivo configurado (la plantilla lista para subir a Trébol) — es lo más relevante.
El documento de mapa de variables + racional.

Output al usuario (estructura)

# Plantilla configurada — {client_name}

[present_files: plantilla_configurada.docx/pdf, mapa_variables_y_racional.md]

## Racional (resumen)
- ...
- ...

## Pendientes de verificación
- ...

Reglas duras

Dos artefactos separados: plantilla limpia (a Trébol) y trazabilidad (interna). No mezclar el racional dentro de la plantilla del cliente.
Mapa completo: todos los campos, incluidos los sin variable.
Racional corto y útil, no un relato del proceso.
Pendientes de verificación explícitos, con recordatorio de probar contra una verificación real.
Brand guidelines solo en el documento interno si se genera en Word, nunca en la plantilla del cliente.

Checklist

Archivo configurado entregado limpio (sin anotaciones internas).
Mapa de variables completo (incluye SIN_VARIABLE).
Racional de 3–6 bullets con las decisiones clave.
Pendientes de verificación listados.
Recordatorio de cómo subir y probar la plantilla.
present_files con la plantilla primero.

Intro al API de Trébol

Stage 6 rationale packaging

Stage 6 — Rationale Packaging (Entrega + trazabilidad)

Responsabilidad

Input

Proceso

Paso 1 — Mapa de variables (auditable)

Paso 2 — Racional corto (3–6 bullets)

Paso 3 — Pendientes de verificación

Paso 4 — Cómo probar (recordatorio operativo)

Paso 5 — Formato del documento de trazabilidad

Paso 6 — Entregar

Output al usuario (estructura)

Reglas duras

Checklist

​Stage 6 — Rationale Packaging (Entrega + trazabilidad)

​Responsabilidad

​Input

​Proceso

​Paso 1 — Mapa de variables (auditable)

​Paso 2 — Racional corto (3–6 bullets)

​Paso 3 — Pendientes de verificación

​Paso 4 — Cómo probar (recordatorio operativo)

​Paso 5 — Formato del documento de trazabilidad

​Paso 6 — Entregar

​Output al usuario (estructura)

​Reglas duras

​Checklist

Stage 6 — Rationale Packaging (Entrega + trazabilidad)

Responsabilidad

Input

Proceso

Paso 1 — Mapa de variables (auditable)

Paso 2 — Racional corto (3–6 bullets)

Paso 3 — Pendientes de verificación

Paso 4 — Cómo probar (recordatorio operativo)

Paso 5 — Formato del documento de trazabilidad

Paso 6 — Entregar

Output al usuario (estructura)

Reglas duras

Checklist