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
`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.

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": [
    "compras@cliente.com"
  ],
  "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"
  },
  "content": {
    "attachments": [
      {
        "filename": "z09001234560002600000123.zip",
        "content": "UEsDBBQAAAAIA…(base64)"
      }
    ]
  },
  "idempotencyKey": "midivisa:factura:SETP990000123"
}