Formatos de Cartas

¿Qué es y para qué sirve?

Los Formatos de Cartas te permiten escribir tu propio código HTML mezclado con Razor (por ejemplo @Model.CompanyInfo.CompanyName) para dibujar un documento completo de principio a fin, igual que los Formatos de Impresión con HTML. AdmCloud compila tu código al momento de imprimir, sustituyendo cada expresión por el dato real del registro que estás imprimiendo (una factura, una orden de compra, una acción de empleado, una asignación de activo, etc.).

La diferencia es que los Formatos de Cartas viven en su propia lista, separada del catálogo general de Formatos de Impresión con HTML, y su editor es deliberadamente más simple: no tiene encabezado y pie de página independientes, no tiene interruptor de PDF (una carta siempre se imprime como un documento paginado completo), no tiene panel de vista previa en vivo, ni pestaña de Diccionario de Datos, ni botón de "Modificar con IA". Está pensado para documentos sencillos y de una sola pieza, a diferencia de las facturas y órdenes más elaboradas, con encabezado repetido, para las que se suelen usar los Formatos de Impresión con HTML.

Igual que los Formatos de Impresión con HTML, un Formato de Carta solo entra en uso cuando lo asignas como formato por defecto de su tipo de documento en Formatos de Impresión por Defecto; guardarlo aquí no cambia lo que ven tus usuarios al imprimir hasta que hagas eso.

Cómo se usa

1. Abre el listado. Entra a Formatos de Cartas, dentro de Personalización, y haz clic en Nuevo.
2. Ponle nombre. Escribe un Nombre descriptivo; debe ser único entre tus demás Formatos de Cartas.
3. Indica a qué registro aplica. En el campo Objeto selecciona el tipo de documento o registro (factura, orden de compra, acción de empleado, asignación de activo, etc.) para el que es esta carta; la lista solo muestra los tipos habilitados en tu plan y módulos activos.
4. Ajusta los márgenes. Los campos Margen Superior, Izquierdo, Derecho y Inferior (10 mm por defecto) controlan el espacio en blanco alrededor del contenido impreso.
5. Confirma el Propietario. Por defecto eres tú, pero puedes asignarlo a otro usuario; esa persona queda como responsable y, si la proteges (siguiente paso), como la única que puede abrir su código.
6. Escribe el código de la carta. En el recuadro grande de texto, escribe tu HTML combinado con expresiones Razor (@Model.Propiedad) para insertar los datos reales del registro. Si no estás seguro de qué propiedades tienes disponibles para el Objeto elegido, abre ese mismo tipo de documento en Formatos de Impresión con HTML y consulta su pestaña Diccionario de Datos, si la tienes habilitada — ambas pantallas comparten el mismo modelo de datos por tipo de documento.
7. Restringe quién puede editarla, si lo necesitas. Activa Solo permitir acceso a la estructura al propietario para que únicamente el Propietario pueda entrar a editar o consultar el código de esta carta.
8. Guarda. Con el botón Guardar. Después puedes volver a abrirla desde el listado y Editarla.
9. Actívala como formato por defecto. Entra a Formatos de Impresión por Defecto y selecciona tu Formato de Carta para el tipo de documento correspondiente. Desde ese momento, AdmCloud lo usará cada vez que imprimas o generes el PDF de ese tipo de documento.

Capacidades principales

• Diseño libre en HTML/Razor sobre el documento completo, con el mismo motor de renderizado que los Formatos de Impresión con HTML.
• Catálogo dedicado y simplificado, separado de la lista general de Formatos de Impresión con HTML, para que tus cartas, certificados y avisos de una sola pieza no se mezclen con tus formatos de documentos transaccionales.
• Aplica al mismo rango amplio de tipos de documento y registro que los Formatos de Impresión con HTML (facturas, órdenes de compra, acciones de empleado, asignaciones de activos, y más), según los módulos activos en tu plan.
• Siempre se genera como un documento paginado completo, con sus propios márgenes — no hay interruptor de PDF ni encabezado/pie de página repetido que configurar.
• Control de acceso por Propietario, con la opción de restringir la edición y consulta del código solo a esa persona.
• Auditoría completa: cada guardado queda registrado en la pestaña de Registro de Seguridad de la carta, incluyendo qué campos cambiaron cuando ese detalle está habilitado para tu empresa.
• Puedes transferir un Formato de Carta que sea tuyo a otra empresa que administres, desde su pantalla de Detalle.

Campos clave

Validaciones al guardar

• Nombre obligatorio: no se puede guardar una carta sin nombre.
• Nombre único: no se permite crear una carta con un nombre que ya use otro Formato de Carta existente.
• Código obligatorio: el recuadro de código no puede quedar vacío.
• Propietario obligatorio y activo: la carta debe tener asignado un usuario responsable, y ese usuario debe estar activo en el sistema.
• Cartas protegidas: si está marcado "Solo permitir acceso a la estructura al propietario", únicamente el Propietario puede editarla o eliminarla.
• No se puede eliminar una carta en uso: si está asignada como formato por defecto de un tipo de documento (a nivel de empresa o de alguna sucursal), usada como formato de cheque de una cuenta bancaria, o forma parte de un Plugin publicado, el sistema bloquea la eliminación hasta que la desasignes.

Disponibilidad, plan y permisos

• Los Formatos de Cartas requieren el plan Enterprise. En otros planes, esta pantalla y su enlace de menú no están disponibles.
• El acceso a agregar, editar o eliminar Formatos de Cartas está controlado por el permiso "Formatos de Impresión de Documentos", asignable por usuario o por grupo de usuarios en Seguridad.
• Los tipos de documento disponibles en el campo Objeto dependen de los módulos y capacidades activos en tu plan; por ejemplo, las Acciones de Empleado y las Asignaciones de Activos requieren el módulo de Nómina/RRHH.
• Transferir una carta a otra empresa que administras requiere tener activa la función "Crear Plugins", y no está disponible en empresas de evaluación.
• Para que una carta tenga efecto al imprimir, debe asignarse en Formatos de Impresión por Defecto.

Consejos y errores comunes