Email templates

Send branded emails by referencing a template, a design and your brand; Deliver builds the subject, HTML and plain text.

Send template: { slug, design }, brand and data. Deliver builds the subject, the HTML and the plain text with your brand’s logo, colors and legal details. See them live in the template gallery.

Templates

`slug`	Description (from the catalog)
`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 returns the available templates with their designs and a sample data. If data is missing a field the template needs, the API answers 422 with VARIABLES_FALTANTES.

Designs

Designs: clasico (Clásico), moderno (Moderno), minimal (Minimal). The default is moderno.

Brand

The brand (brand) is registered by Piensa IT for your company, and it defines which applications may use it. The default is piensa-it. An unknown brand, or one your application isn’t authorized for, answers 404 with MARCA_NO_ENCONTRADA.

Overriding and attachments

With a template, content can override subject, fromName and replyTo, and add attachments (up to 10, 10 MB in total once decoded, in base64 without a data: prefix). The sender address is set by Deliver; you choose the visible name.

Invoice with template and attachment

{
  "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"
}