Saltar al contenido principal

Layouts de email

El layout de email es el sobre HTML que envuelve todo mensaje de cobro enviado por email: encabezado con tu marca, pie con tus datos, y en el medio el contenido de la plantilla de la etapa. La plantilla dice qué dice el mensaje; el layout dice cómo se viste.

Los placeholders​

Un layout es un HTML completo con dos puntos de sustitución:

  • {{content}} (obligatorio): donde entra el cuerpo de la plantilla. Un layout sin ese placeholder es rechazado en la creación (MISSING_CONTENT_PLACEHOLDER) — sin él, el email saldría sin el mensaje.
  • {{subject}} (opcional): el asunto del mensaje, útil en títulos internos del HTML.

La cascada: sucursal → empresa → organización​

Al momento del envío, el sistema resuelve qué layout usar del más específico al más general:

  1. Layout de la sucursal (unidad de negocio) del cobro, si tiene uno;
  2. si no, el layout de la empresa;
  3. si no, el layout estándar de la organización (el marcado como default);
  4. si no, el layout integrado del producto: un HTML responsivo neutro (tarjeta blanca de 600px, pie "Mensagem enviada automaticamente pelo sistema de cobrança").

Esto permite que un grupo con varias marcas envíe cada cobro con la identidad de la empresa correcta, sin duplicar reglas de cobranza ni plantillas. La asociación empresa/sucursal → layout se hace en la estructura organizacional.

Los layouts inactivos o eliminados nunca se usan: la cascada simplemente sigue al siguiente nivel.

Gestionando layouts​

La gestión se hace por la API (/api/v1/email-layouts), con los permisos email_layouts.* del catálogo:

  • Listar (GET) devuelve los layouts de la organización, cuántas empresas usan cada uno y también el HTML del layout integrado, que sirve de punto de partida para el tuyo.
  • Crear (POST) exige name (2 a 80 caracteres) y htmlBody (mínimo 20 caracteres, conteniendo {{content}}). Marcar isDefault: true desmarca automáticamente el default anterior: solo existe un estándar por organización.

Cada creación queda registrada en la auditoría.

Buenas prácticas​

  • Empieza copiando el layout integrado y cambia colores, logo y pie: ya es responsivo y está probado en clientes de correo.
  • Usa tablas HTML y CSS inline: el email no es un navegador, y los clientes de correo más usados ignoran las hojas de estilo externas.
  • Incluye en el pie la razón social y los datos de contacto del acreedor: además de buena práctica, reduce la marcación como spam y sostiene la exigencia de identificación clara de quien cobra.
  • Prueba la cascada: envía un cobro de prueba por una sucursal con layout propio y otro por una empresa sin layout, y confirma que cada uno sale con la vestimenta correcta.