Plantillas de documentos: texto estándar diferente para diferentes tipos de salida
Cómo el sistema de plantillas J5 muestra un BOL diferente para una venta frente a una transferencia interna, sin copiar y pegar del mes pasado.
Un conocimiento de embarque para una venta no es lo mismo que un conocimiento de embarque para un envío de reciclaje. El lenguaje legal difiere, los campos obligatorios difieren y la parte de destino difiere. Usar una plantilla para ambos significa que alguien debe recordar quitar las partes que no aplican, y alguien finalmente lo olvida.
Plantillas por tipo
/settings/core/templates es la biblioteca de plantillas de la plataforma. Cada plantilla tiene como alcance un tipo de documento (BOL, albarán, informe de carga, certificado de reciclaje, resumen de paquete de evidencia, certificado de eliminación, etc.). Los documentos imprimibles de outbound también usan el contexto del tipo de salida (venta, reciclaje, transferencia interna, devolución al cliente, donación). La plantilla se selecciona automáticamente cuando el operador imprime un documento o genera un paquete de evidencia.
Sello de salida
Los documentos imprimibles y los PDFs de resumen de evidencia muestran el nombre y la versión de la plantilla usados para esa salida. Si no existe una plantilla activa del tenant, la salida indica que se usó el valor predeterminado de la plataforma. Esto da a los auditores una pista de origen sin pedir al operador que reconstruya la configuración después.
Variables
Las plantillas son HTML con variables de estilo mustache: {{client.name}}, {{outbound.id}}, {{contract.terms}}. El resolvedor de variables se ejecuta del lado del servidor en el momento de la generación, leyendo las filas de entidad relevantes. Se pueden definir variables personalizadas (por tenant) en la configuración de la plantilla, útiles para texto legal específico de una región.
Versionamiento
Cada plantilla lleva una versión. Guardar una nueva versión no sobrescribe la anterior: los documentos históricos hacen referencia a la versión que estaba activa cuando se generaron, por lo que un BOL renderizado seis meses después tiene el mismo aspecto que en el momento de generación.
Predeterminado frente a tenant personalizado
La plataforma incluye una plantilla predeterminada para cada tipo de documento: texto estándar genérico y legalmente adecuado. Los tenants pueden anularla con plantillas personalizadas que incluyen su membrete, sus términos específicos y las divulgaciones requeridas en su región. La anulación es por tenant, por lo que la plataforma predeterminada permanece como alternativa para los nuevos tenants que aún no han personalizado nada.