Plantillas de email

Envía correos con tu marca indicando una plantilla, un diseño y la marca; Deliver arma el asunto, el HTML y el texto plano.

Envía template: { slug, design }, brand y data. Deliver arma el asunto, el HTML y el texto plano con el logo, los colores y los datos legales de tu marca. Míralas en vivo en la galería de plantillas.

Plantillas

`slug`	Descripción
`mensaje`	Para quien ya tiene el texto escrito y solo necesita que salga con la marca: título, párrafos y un botón opcional. No redacta nada.
`factura-electronica`	Factura, nota crédito o nota débito con total, datos DIAN y aviso del ZIP adjunto.
`codigo-otp`	Código grande y legible, vigencia, datos del intento y aviso de seguridad.
`invitacion-acceso`	Invitación con enlace único para ingresar a una plataforma, con rol y vigencia opcionales.
`aprobacion`	Pedir una aprobación de factura, contrato o gasto con Aprobar y Rechazar, o contar la decisión ya tomada (evento «decidida»).
`recibo-de-caja`	Confirma al pagador un pago recibido, con valor, concepto, medio de pago y saldo.
`estado-de-cuenta`	Saldo y lista de movimientos del cliente en una tabla, con opción de pagar o descargar.
`aviso-comunidad`	Comunicado de la administración de una copropiedad: tipo, vigencia, fecha del evento y enlace al portal. Sin enlace de baja.
`propuesta-comercial`	Cotización emitida con su número, versión y enlace al documento con vigencia. Transaccional: sin enlace de baja.
`orden-de-trabajo`	El trabajo que se hizo: espacio, actividades, horas, materiales y costo, con la tirilla adjunta. Transaccional: sin enlace de baja.
`ticket-avance`	El tiquete cambió de estado: recibido, en curso, resuelto o pasado de plazo. El vencido habla a la administración, no al tercero.
`calendario-semanal`	La semana de una persona: lo programado por día y lo asignado sin fecha. Correo de trabajo, sin enlace de baja.
`solicitud-de-cotizacion`	La petición de cotización a un proveedor: qué se pide, para qué trabajo, dónde, para cuándo y a quién responder. Sin monto, a propósito.
`certificado-tributario`	El correo que acompaña un certificado de retención (fuente, IVA, ICA) o de IVA facturado, adjunto en PDF. Transaccional: sin enlace de baja.
`marketing`	Campaña con banner, mensaje y llamado a la acción, con enlace de baja obligatorio.

GET /v1/templates devuelve las plantillas disponibles con sus diseños y un ejemplo de data. Si a data le falta un dato que la plantilla necesita, la API responde 422 con VARIABLES_FALTANTES.

Diseños

Diseños: clasico (Clásico), moderno (Moderno), minimal (Minimal). Por defecto, moderno.

Marca

La marca (brand) la registra Piensa IT para tu empresa y define qué aplicaciones pueden usarla. Por defecto, piensa-it. Una marca que no existe, o que tu aplicación no puede usar, responde 404 con MARCA_NO_ENCONTRADA.

Sobrescribir y adjuntar

Con plantilla, content puede sobrescribir subject, fromName y replyTo, y agregar attachments (hasta 10, 10 MB en total ya decodificados, en base64 sin prefijo data:). La dirección del remitente la fija Deliver; tú eliges el nombre visible.

Factura con plantilla y adjunto

{
  "channel": "email",
  "to": [
    "[email protected]"
  ],
  "template": {
    "slug": "factura-electronica",
    "design": "moderno"
  },
  "brand": "sudivisa",
  "data": {
    "tipoDocumento": "factura",
    "numero": "SETP990000123",
    "fechaEmision": "14 de septiembre de 2026",
    "fechaVencimiento": "14 de octubre de 2026",
    "cliente": {
      "nombre": "Laura Gómez"
    },
    "total": "$ 1.250.000",
    "resumen": [
      {
        "etiqueta": "Subtotal",
        "valor": "$ 1.050.420"
      },
      {
        "etiqueta": "IVA 19 %",
        "valor": "$ 199.580"
      },
      {
        "etiqueta": "Forma de pago",
        "valor": "Crédito 30 días"
      }
    ],
    "cufe": "a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f6071829",
    "nombreAdjunto": "z09001234560002600000123.zip",
    "eventosDian": {
      "acuseRecibo": "https://plataforma.example/dian/acuse?doc=SETP990000123",
      "aceptacion": "https://plataforma.example/dian/aceptar?doc=SETP990000123",
      "rechazo": "https://plataforma.example/dian/reclamar?doc=SETP990000123"
    }
  },
  "content": {
    "attachments": [
      {
        "filename": "z09001234560002600000123.zip",
        "content": "UEsDBBQAAAAIA…(base64)"
      }
    ]
  },
  "idempotencyKey": "midivisa:factura:SETP990000123"
}