Guía completa: Personalizar Correos con HTML

¿Qué es y cómo funciona por dentro?

Cuando AdmCloud envía por correo una factura, una cotización, una orden de compra, un estado de cuenta, etc., usa un cuerpo de correo por defecto. Un Formato de Envío de Correo te permite reemplazar ese cuerpo estándar por uno propio: diseñas el correo (con tu logo, tus colores, tus textos) e insertas los datos reales del documento (número, cliente, total, etc.).

El ciclo completo es:

1. Asocias el formato a un tipo de documento (el campo Objeto). Ese tipo determina qué datos estarán disponibles: cada tipo de documento tiene su propio "modelo" de datos, exactamente igual que en los formatos de impresión.
2. Escribes el cuerpo del correo, ya sea con el editor Visual (arrastrar y escribir) o con el editor HTML/Razor (código).
3. Lo activas como formato por defecto de ese tipo de documento (en Formatos de Envío de Correos por Defecto).
4. Al enviar el documento, AdmCloud carga el documento real, construye su modelo de datos, compila tu formato reemplazando cada expresión por el valor real y usa el resultado como cuerpo del correo.

Los dos tipos de editor

Al crear un formato eliges entre dos editores, y esta decisión determina qué puedes hacer y cómo se usa el formato:

Lenguaje que soportan los formatos HTML

Los formatos de tipo HTML se escriben en HTML para la estructura y el estilo, combinado con Razor (la sintaxis de las vistas de ASP.NET, basada en C#) para insertar datos y aplicar lógica. Puedes usar:

• Cualquier HTML y CSS: tablas, imágenes, estilos en línea o en una etiqueta <style>, colores, tipografías, etc. (procura HTML compatible con clientes de correo).
• Expresiones de datos con @Model.Propiedad (por ejemplo @Model.Relationship.Name).
• Condicionales con @if (...) { ... }.
• Ciclos con @foreach (var linea in Model.Header.Items) { ... }.
• Formato de valores con métodos de .NET, por ejemplo @Model.Header.DocDate.ToString("dd/MM/yyyy") o @Model.Header.TotalAmount.ToString("#,##0.00").

Cómo crear un formato, paso a paso

1. Entra a Formatos de Envío de Correos y usa el menú Nuevo. Puedes elegir Correo Vacío (Editor Visual), Correo Vacío (Editor HTML), o partir de un formato de ejemplo ya armado para un documento concreto (la lista solo muestra los documentos habilitados en tu plan).
2. En Nombre, escribe un nombre único y descriptivo. Ten en cuenta que el Nombre hace también de asunto sugerido: al cargar el formato en la ventana de envío, su Nombre se coloca en el campo Asunto del correo. Por eso conviene un nombre que funcione como asunto (por ejemplo, "Su factura de [Empresa]").
3. En Objeto, selecciona el tipo de documento al que aplica. Define qué variables tendrás disponibles.
4. Escribe el cuerpo en la pestaña correspondiente: Cuerpo (editor Visual) o HTML Cuerpo (editor HTML). Apóyate en la plantilla de ejemplo y en el Diccionario de Datos.
5. Pulsa Guardar.
6. Actívalo en Formatos de Envío de Correos por Defecto para el tipo de documento correspondiente. Hasta que no lo asignes ahí, el formato guardado no cambia el cuerpo de los correos.

Cómo se configura

Las variables del Model: cómo funcionan

El objeto Model representa el documento del correo. Accedes a sus datos con @Model. seguido del nombre de la propiedad, encadenando con puntos: @Model.Relationship.Name (el cliente), @Model.CompanyInfo.CompanyName (tu empresa), @Model.Header.DocID (el número del documento). Es el mismo modelo de datos que usan los formatos de impresión, con algunas variables propias del correo:

Ejemplo de formato HTML

Este es un cuerpo de correo sencillo para el envío de una factura a crédito. Muestra el logo (o el nombre de la empresa), un saludo con el mensaje personalizado del usuario, y los datos del comprobante:

<div style="font-family:Arial,sans-serif; color:#333;">
    @if (Model.Logo != null)
    {
        <img src="@Model.Logo.URI" alt="Logo" style="max-height:60px;" />
    }
    else
    {
        <h2>@Model.CompanyInfo.CompanyName</h2>
    }

    <p>Estimado(a) @Model.Relationship.Name,</p>

    @if (!string.IsNullOrEmpty(Model.Message))
    {
        <p>@Model.Message</p>
    }

    <p>
        Le adjuntamos la factura <strong>@Model.Header.DocID</strong>,
        de fecha @Model.Header.DocDate.ToString("dd/MM/yyyy"),
        por un total de @Model.Header.TotalAmount.ToString("#,##0.00").
    </p>

    @if (!string.IsNullOrEmpty(Model.CreditCardPaymentLink))
    {
        <p><a href="@Model.CreditCardPaymentLink">Pagar en línea</a></p>
    }

    <p>Saludos cordiales,<br />@Model.CompanyInfo.CompanyName</p>
</div>

Dónde consultar las variables disponibles

Los Formatos de Envío de Correos no tienen su propio diccionario de datos ni vista previa; comparten el modelo de datos con los formatos de impresión, así que consultas las variables ahí:

• Abre el mismo tipo de documento en Formatos de Impresión con HTML y usa su pestaña Diccionario de Datos para ver el nombre y el tipo de cada propiedad.
• O consulta la pantalla Variables HTML para Formatos de Impresión (dirección /PFDocumentation), que documenta, documento por documento, cada campo y su tipo.
• Recuerda además las variables propias del correo listadas arriba (Model.Message, Model.Host, Model.CreditCardPaymentLink, Model.Logo).

Cómo probar el resultado

A diferencia de los formatos de impresión, la pantalla de Formatos de Envío de Correos no tiene vista previa en vivo. La forma recomendada de probar un formato es:

1. Guarda el formato.
2. Ve a un documento real de ese tipo y envíalo por correo eligiendo manualmente tu formato en la ventana de Redacción y Envío de Correos (idealmente a tu propia dirección).
3. Revisa el correo recibido y ajusta el formato si es necesario, antes de asignarlo como predeterminado.

Activar el formato y otras opciones

• Activarlo por documento: asígnalo en Formatos de Envío de Correos por Defecto, que tiene un espacio por cada tipo de documento (factura a crédito, factura de contado, notas, cotización, pedido, orden de compra, estado de cuenta, comprobante de pago, solicitudes de servicio, permisos, etc.).
• Notificaciones por cambio de estado: un formato puede adjuntarse a la notificación por correo de un cambio de estado de documento (por ejemplo, en solicitudes de servicio).
• Plugins: un formato puede empaquetarse dentro de un Plugin publicado.
• Control de acceso por Propietario, con la opción de restringir la edición y consulta del código solo a esa persona.
• Transferir a otra empresa que administras (requiere edición Enterprise con la función "Crear Plugins").

Consejos y errores comunes