Referencia técnica
Tags de plantillas de comunicación
Catálogo de variables disponibles en plantillas de email y en el endpoint público POST /api/public/v1/cases/{reference}/communications.
Reglas de uso
Aplica a todas las plantillas y al envío directo con subject + contenido.
- El renderizado usa estrategia at_send: los tags se resuelven con los datos vigentes al momento del envío.
- Los tags que no encuentran valor se sustituyen por cadena vacía; no se emite error.
- El renderizado es por destinatario: nunca se filtran datos de un destinatario a otro.
- Sólo se aceptan variables declaradas en el catálogo de la plantilla (communication_template_variables) o pasadas por 'variables' en el request.
- Los tags funcionan igual en subject, contentText y contentHtml.
expediente
ExpedienteDatos del expediente sobre el que se envía la comunicación. Disponibles tanto en el asunto como en el cuerpo (texto o HTML).
| Tag | Tipo | Descripción | Ejemplo |
|---|---|---|---|
{{expediente.id}} | uuid | Identificador interno del expediente. | — |
{{expediente.codigo}} | string | Código público (public_code) o número del expediente. | AR-2026-00001234 |
{{expediente.caratula}} | string | Carátula / título del expediente. | Pérez, Juan c/ ACME SA |
{{expediente.monto}} | number | Monto actual del expediente. | 148750 |
{{expediente.moneda}} | string | Código ISO de moneda. | ARS |
destinatario
DestinatarioDatos del destinatario individual. Se renderizan por destinatario, nunca se mezclan entre uno y otro.
| Tag | Tipo | Descripción | Ejemplo |
|---|---|---|---|
{{destinatario.nombre}} | string | Nombre visible del destinatario (displayName). | Juan Pérez |
{{destinatario.email}} | string | Email de destino normalizado (lowercase). | juan.perez@example.com |
{{destinatario.rol}} | string | Rol en el expediente (TITULAR, GARANTE, etc.). | TITULAR |
sistema
SistemaMetadatos del envío, generados por la plataforma.
| Tag | Tipo | Descripción | Ejemplo |
|---|---|---|---|
{{sistema.fecha}} | ISO 8601 | Fecha y hora (UTC) al momento del envío. | 2026-07-29T01:15:00.000Z |
variables
Variables customTodo lo que envíes en el campo variables del request se expone como una sección más del contexto. Ejemplo: variables: { extra: { vencimiento: '2026-08-15' } } habilita {{extra.vencimiento}}.
| Tag | Tipo | Descripción | Ejemplo |
|---|---|---|---|
{{extra.*}} | libre | Todo lo pasado en 'variables.extra' es accesible por su clave. | {{extra.vencimiento}} |
{{<seccion>.*}} | libre | Cualquier clave de primer nivel enviada en 'variables' crea su propia sección. | — |
Recursos relacionados
Documentación completa de la API pública.