Skip to Content

Envío de emails

Los metadatos email_* que rellenan la vista previa del correo, cuándo el documento viaja como PDF adjunto y desde qué remitente sale.

Los metadatos email_* que fija un documento dinámico con F.MetaData_Set rellenan la vista previa de Enviar por email en el visor de Play: remitente, destinatario, copias, asunto, cuerpo y nombre del adjunto.

Todos son opcionales: lo que falte lo escribe quien envía. Los metadatos rellenan el correo, no lo envían.

Cuerpo o adjunto

Lo decide email_body:

email_bodyCuerpo del correoAdjunto
Sin fijarEl documento renderizadoNinguno
Con textoEse texto, en HTMLEl documento convertido a PDF
Con el ID de otro documento dinámicoEl HTML de ese documento, ejecutado con las mismas respuestasEl documento convertido a PDF

El PDF sale como en Cómo convierte Dinaup a PDF. En DemoUp, Factura - Moderna se imprime y apunta por su ID a Factura - Plantilla de Email, que es el cuerpo:

F.MetaData_Set('email_body', S.DynamicDocuments.Correos.FacturaPlantilladeEmail.ID)

Metadatos

ClaveQué rellena
email_subjectAsunto.
email_bodyCuerpo al adjuntar: HTML o el ID de otro documento dinámico.
email_toDirección del destinatario. Hasta 100.
email_to_nameNombre del destinatario. Con varias direcciones, va con la primera.
email_fromDirección del remitente. Exige dominio verificado.
email_from_nameNombre visible del remitente.
email_ccDirecciones en copia, CC.
email_bccDirecciones en copia oculta, CCO.
email_replytoLa dirección de Responder a. En el SDK es Email_ReplyTo.
email_attachment_nameNombre del PDF adjunto. Sin él se usa el metadato titulo.

email_to, email_cc, email_bcc y email_replyto admiten varias direcciones separadas por comas y se pueden fijar varias veces: F.MetaData_Set numera la clave repetida (email_bcc1, email_bcc2), también vale numerarla a mano (email_bcc_1) y Play las reúne.

F.MetaData_Set('email_cc', '[email protected]')
F.MetaData_Set('email_bcc', '[email protected]')
F.MetaData_Set('email_bcc', '[email protected]')
F.MetaData_Set('email_replyto', '[email protected]')

Con varias direcciones en email_to, cada una recibe su propio correo y solo ve la suya en Para. La primera lo recibe con el CC y el CCO; las demás, sin CC. Con un solo destinatario, email_to_name pone su nombre en Para; el saludo del cuerpo lo escribe la plantilla.

Remitente

La vista previa usa el primero que valga:

  1. email_from y email_from_name del documento.
  2. El remitente predeterminado de la empresa, configurado en Play.
  3. [email protected] con nombre Dinaup.

Una dirección propia solo vale si su dominio está verificado en la licencia. Si no, la vista previa pasa a la siguiente y avisa: No se puede enviar desde X porque su dominio todavía no está verificado. Desde una dirección propia, el remitente recibe copia oculta.

La vista previa

Deja corregir el Email destinatario, el Nombre destinatario, el Asunto y el cuerpo, y abre CC, CCO y Responder a si la plantilla trae alguno. Enviar correo exige dirección y asunto, y no envía con una dirección mal escrita, más de 100 destinatarios, más de 48 en CC ni más de 500 en CCO.

Vista previa de un correo con dos destinatarios, CC, Responder a y CCO abiertos, el aviso de una dirección mal escrita, el cuerpo editable, el adjunto y el botón Enviar correo

Un correo por destinatario

Con la marca {{email_to}} en el asunto o el cuerpo, cada dirección de Para, CC y CCO recibe su propio correo con su dirección en el sitio de la marca. Dentro de un enlace, usa {{email_to_urlencode}}, la misma dirección codificada para URL.

<a href="https://miweb.com/alta?email={{email_to_urlencode}}">Darme de alta</a>

{{email_destinatario}} equivale a {{email_to}}. Play cambia la marca al enviar: en el documento y en la vista previa se ve tal cual.

Ejemplo

F.MetaData_Set('email_subject', F.Concat('Factura ', D.EmpresaActual.TextoPrincipal, ' nº ', v.Factura.NumeroDeFacturaCompleto, ' - ', v.Factura.DenominacionRazonSocialCliente))
F.MetaData_Set('email_body', 'Hola,<br>te envío la factura para que la revises.<br>Un saludo.')
F.MetaData_Set('email_to', v.Factura.ReferenciaCliente.CuentaDeCorreoPrincipal)
F.MetaData_Set('email_to_name', v.Factura.DenominacionRazonSocialCliente)
F.MetaData_Set('email_attachment_name', F.Concat('Factura ', v.Factura.NumeroDeFacturaCompleto, '.pdf'))

En esta página