Solavel Documentos
Español

Referencia del diseñador de PDF: campos y variables

Última actualización

Esta página lista todos los campos (variables) que puede colocar en una plantilla PDF del diseñador de PDF: cómo se llama cada uno en la lista de campos, qué imprime, un ejemplo y cuándo está vacío. Para saber cómo usar el propio diseñador, consulte Diseñador de PDF y Plantillas PDF.

#Cómo funcionan los campos

  • Una plantilla es una maquetación de página. Cada elemento de texto, tabla o imagen está vinculado a un campo. Cuando se imprime, descarga o envía por correo un documento, SolaCount rellena cada elemento vinculado con el valor de ese documento.
  • En el diseñador, el lienzo muestra valores de muestra (los datos de su propia empresa más un documento de muestra) para que pueda valorar la maquetación. La muestra nunca se guarda en la plantilla: solo se guarda el vínculo. Un documento sin valor para un campo lo imprime vacío.
  • Cada campo tiene un nombre visible (lo que ve en la lista de campos, en el idioma del diseñador) y un nombre interno como doc_number. Puede buscar en la lista por el nombre en inglés o árabe, o por el nombre interno. El nombre interno es también lo que se escribe en el texto estático entre llaves, por ejemplo {doc_number}.
  • Los campos que se ofrecen dependen del tipo de documento. Un comprobante de diario no tiene cliente; un recibo de pago no tiene fecha de vencimiento.
  • El mismo campo se puede colocar más de una vez. Los campos se agrupan en el diseñador como Documento, Proyecto, Pago, Organización, Cliente / proveedor, Tablas, Totales, Campos personalizados, Rótulos, Imágenes y QR.
  • La página Variables del diseñador muestra cada campo con su origen (perfil de la empresa, registro del cliente o proveedor, el documento, el proyecto vinculado, el idioma del documento, un campo personalizado), su valor actual y su estado.
  • Todo se imprime en el idioma del documento establecido en Configuración → Plantillas PDF (consulte Plantillas PDF), sea cual sea el idioma de quien imprime.

#Número de campos por tipo de documento

Tipo de documento Campos del catálogo Tablas
factura 80 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Cotización 76 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Orden de venta 79 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Recibo de venta 78 items, items_simple, tax_summary, items_detailed, items_tax_invoice
Nota de crédito 75 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Recibo de reembolso 59 allocations
Factura de proveedor 81 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Orden de compra 75 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Nota de débito 75 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Recibo de pago 62 allocations
Pago a proveedor 62 allocations
Comprobante de gasto 79 items, items_simple, tax_summary, items_detailed, items_tax_invoice
Comprobante de diario 41 journal
Estado de cuenta del cliente 56 statement
Estado de cuenta del proveedor 56 statement

Estos son los campos del catálogo. Cada tipo ofrece además sus campos del sistema y campos personalizados (véase más abajo). El grupo Imágenes y QR siempre está disponible para insertar un logotipo o su propia imagen.

#Grupo de documento

Nombre visible Nombre interno Qué imprime Ejemplo Notas
Título del documento doc_title El nombre del tipo de documento en el idioma del documento Factura / فاتورة Tipos: Factura, Cotización, Orden de venta, Recibo de venta, Nota de crédito, Recibo de reembolso, Factura de proveedor, Orden de compra, Nota de débito, Recibo de pago, Pago a proveedor, Comprobante de gasto, Comprobante de diario, Estado de cuenta del cliente, Estado de cuenta del proveedor
Número doc_number El número del documento INV-00042 El texto de izquierda a derecha se mantiene en orden dentro de los documentos en árabe
Fecha doc_date Fecha de emisión (en los pagos, la fecha de pago) 2026-11-20 Sigue el formato de fecha de la plantilla (consulte Fechas)
Fecha de vencimiento doc_due_date Fecha de vencimiento; en una cotización, la fecha de caducidad; en una orden de venta, la fecha prevista 2026-12-20 Solo en factura, cotización, orden de venta, factura de proveedor y orden de compra. Vacío cuando no hay ninguna
Referencia doc_reference La referencia guardada en el documento PO-7781 No en los comprobantes de diario. Vacío cuando no hay ninguna
Estado doc_status Estado en el idioma del documento Pagada, Borrador, Anulada
Moneda doc_currency Código de moneda AED
Modo de precios doc_tax_mode "Los precios incluyen impuestos" o "Los precios no incluyen impuestos" Los precios no incluyen impuestos Solo en los tipos con líneas de artículos; vacío cuando el documento no tiene modo de impuestos
Notas doc_notes Texto de las notas Gracias por su confianza Varias líneas
Términos y condiciones doc_terms Texto de los términos Pago en un plazo de 30 días Solo en los tipos con líneas de artículos. Varias líneas
Importe en letras doc_amount_words El total general escrito con palabras UAE Dirhams One Thousand Two Hundred Fifty and 50/100 Only Escrito en inglés o árabe; los demás idiomas de documento imprimen la redacción en inglés. Vacío cuando el documento no tiene moneda ni total
Marca de agua de estado doc_watermark El texto de la marca de agua de estado que llevaría el documento DRAFT Vacío cuando el documento no tiene ninguna
Generado doc_generated_at Fecha y hora en que se produjo el PDF 2026-11-20 14:05 Siempre Y-m-d H:i, no le afecta el formato de fecha de la plantilla
Nota del origen importado doc_source_note Nota sobre el sistema original del que procede una factura importada — Solo facturas. Si una plantilla la omite, la nota se añade en su propia última página
N.º de factura original / N.º de factura de proveedor original / N.º de nota de crédito / N.º de cotización de origen doc_original_number El número del documento original vinculado INV-00042 Nota de crédito (factura), nota de débito (factura de proveedor), recibo de reembolso (nota de crédito), orden de venta (cotización). Vacío cuando no está vinculado
N.º de nuestra orden de compra (al proveedor) doc_po_number La orden de compra que esta organización emitió al proveedor PO-00017 Solo facturas de proveedor. El número de orden de compra propio de un cliente no se guarda, por lo que no existe ese campo
Tipo de cambio doc_exchange_rate Tipo respecto a la moneda base 3.6725 Tipos con líneas y pagos. Vacío cuando el tipo es 1. Hasta 6 decimales, sin ceros finales
Fecha de envío doc_shipment_date Fecha de envío 2026-12-01 Solo órdenes de venta
N.º de revisión doc_revision Número de revisión de la cotización 2 Solo cotizaciones; vacío para la revisión 1
Beneficiario doc_payee_name El beneficiario Gulf Utilities Solo comprobantes de gasto
Motivo del reembolso doc_refund_reason El motivo introducido en el reembolso Mercancía devuelta Solo recibos de reembolso
Preparado por · Nombre approval_prepared_by El nombre de la persona que creó el documento Sara Haddad Vacío cuando se desconoce

#Grupo de proyectos

Disponible en factura, cotización, orden de venta, nota de crédito, factura de proveedor, orden de compra, nota de débito y comprobante de gasto. Leen el vínculo real del documento con el proyecto (no un campo de texto libre). Varios proyectos en un mismo comprobante de gasto se unen con comas. Un proyecto eliminado se sigue imprimiendo. En la muestra están vacíos y el lienzo muestra "Ningún proyecto seleccionado".

Nombre visible Nombre interno Qué imprime Ejemplo
Nombre del proyecto (vinculado) doc_project_name Nombre del proyecto Reforma de villa
Código del proyecto (vinculado) doc_project_code Código del proyecto PRJ-014
Proyecto (código — nombre) (vinculado) doc_project Código y nombre PRJ-014 — Reforma de villa

#Grupo de pago

Disponible en recibo de pago, pago a proveedor, comprobante de gasto, recibo de venta y recibo de reembolso.

Nombre visible Nombre interno Qué imprime Ejemplo Notas
Método de pago doc_payment_method El método Transferencia bancaria Los nombres de los métodos están en el idioma del documento
N.º de cheque / Referencia de transacción doc_payment_reference Número de cheque y referencia de transacción, unidos con " · " CHQ-5521 · TRX-908 Las partes vacías se omiten
Fecha de pago doc_payment_date La fecha del documento 2026-11-20

#Grupo de organización (empresa)

Disponible en todos los tipos de documento. Consulte "Variables de la empresa" más abajo para saber cuáles de estas puede sustituir una plantilla.

Nombre visible Nombre interno Qué imprime Ejemplo Notas
Logotipo org_logo La imagen del logotipo de la empresa (imagen) Vacío (no se imprime nada) cuando no hay logotipo. Se convierte a PNG/JPEG y se mantiene en un máximo de 1600 px en el lado largo
Nombre de la empresa org_name El nombre comercial Palm Grove Furnishings
Razón social org_legal_name Razón social registrada Palm Grove Furnishings LLC Vacío cuando es igual al nombre de la empresa
Dirección de la empresa org_address Dirección registrada en una sola línea Calle 4, Dubái, Emiratos Árabes Unidos Elemento de varias líneas
Teléfono de la empresa org_phone Teléfono +971 4 000 0000
Correo electrónico de la empresa org_email Correo electrónico accounts@example.com
Sitio web org_website Sitio web www.example.com
N.º fiscal org_tax_number Solo el número de registro fiscal (sin rótulo) 100123456700003 Añada su propio rótulo o use la etiqueta N.º fiscal
N.º de registro org_registration Solo el número de registro mercantil 1234567
Línea de contacto (teléfono · correo electrónico · sitio web) org_contact_line Los tres unidos con " · " +971 4 000 0000 · accounts@example.com · www.example.com Las partes vacías se omiten
Datos de la empresa (dirección, teléfono, correo electrónico, n.º fiscal) org_details Un bloque con un valor por línea; la línea fiscal dice "N.º fiscal: …" (4 líneas) Varias líneas
Línea de pie de página (nombre • correo electrónico • teléfono • sitio web) footer_line Nombre, correo electrónico, teléfono y sitio web unidos con " • "

#Grupo de cliente / proveedor

Disponible en todos los tipos excepto los comprobantes de diario. En los tipos de compra (factura de proveedor, orden de compra, nota de débito, pago a proveedor, comprobante de gasto, estado de cuenta del proveedor) los valores proceden del proveedor; en todos los demás, del cliente.

Nombre visible Nombre interno Qué imprime Ejemplo Notas
Encabezado de la parte party_label El rótulo del bloque Facturar a / Proveedor "Cliente" o "Proveedor" en los estados de cuenta
Cliente / Proveedor party_name Nombre legal o visible actual Harbor Grill Restaurants Siempre el nombre actual del cliente, no una copia guardada
Código de cliente / Código de proveedor party_code El código de la parte CUS-0012
Cliente · Dirección party_address Partes de la dirección de facturación unidas con comas Oficina 12, Dubái, EAU Elemento de varias líneas
Cliente · Teléfono party_phone Teléfono (o móvil) +971 50 000 0000
Cliente · Correo electrónico party_email Correo electrónico buyer@example.com
Cliente · N.º fiscal party_tax_number Solo el número fiscal / de IVA 100987654300003 Vea el ejemplo de TRN del cliente
Nombre del principal party_parent_name Nombre de la casa matriz cuando el cliente o proveedor es una sucursal Head Office Co. Vacío cuando no es una sucursal
Sucursal de label_parent El rótulo "Sucursal de" en el idioma del documento Sucursal de Se imprime solo cuando hay un principal; en blanco en caso contrario
Código del principal party_parent_code Código de la casa matriz HQ-001 Vacío cuando no es una sucursal
Cliente · Detalles (dirección, teléfono, correo electrónico, n.º fiscal) party_details Un bloque, un valor por línea; la línea fiscal dice "N.º fiscal: …" (4 líneas) Varias líneas

El cliente de muestra del diseñador es una sucursal de "Head Office Co." (HQ-001), así que los campos del principal muestran valores reales en el lienzo.

Los campos personalizados llamados custom_deliver_to_name y custom_deliver_to_address imprimen el nombre y la dirección del cliente cuando se dejan vacíos en el documento.

#Grupo de tablas

Las tablas repiten sus filas en todas las páginas y pueden repetir el encabezado. En las celdas de las tablas los importes no llevan sufijo de moneda (la moneda se imprime una sola vez en los totales); una línea en otra moneda conserva su propio código. Las celdas son números con separadores de miles, por ejemplo 1,250.00. El panel Columnas del diseñador permite mostrar, ocultar y reordenar columnas; los encabezados están en el idioma del documento.

Tabla Nombre interno Tipos Columnas (clave interna = encabezado)
Líneas de artículos items Tipos con líneas de artículos no = N.º, description, qty = Cant., unit, unit_price, discount, tax, amount
Líneas de artículos (simple) items_simple Tipos con líneas de artículos no, description, qty, unit_price, amount
Resumen de impuestos tax_summary Tipos con líneas de artículos tax ("Impuesto 5%"), taxable, amount
Líneas de artículos con proyecto items_project Factura, cotización, orden de venta, nota de crédito, factura de proveedor, orden de compra, nota de débito no, description, project, qty, unit_price, amount
Líneas de artículos (detallado) items_detailed Tipos con líneas de artículos no, code, description, project, division, dimensions, qty, unit, unit_price, discount_percent (% Dto.), discount, tax_rate (% Impuesto), tax, amount. Empieza mostrando 9 columnas; el resto están en Columnas ocultas
Líneas de artículos (factura fiscal) items_tax_invoice Tipos con líneas de artículos no, code (n.º de artículo), barcode (Código de barras / GTIN), description, unit, qty, unit_price, discount, after_discount, tax_rate, tax, amount
Documentos aplicados allocations Recibo de reembolso, recibo de pago, pago a proveedor no, document, date, document_total (Total original), amount (Este pago / Aplicado), remaining
Líneas de asiento journal Comprobante de diario no, account, description, debit, credit (el lado vacío imprime "—")
Movimientos del estado de cuenta statement Estado de cuenta del cliente y del proveedor fecha, documento, descripción, débito, crédito, saldo

Tipos "con líneas de artículos": factura, cotización, orden de venta, recibo de venta, nota de crédito, factura de proveedor, orden de compra, nota de débito, comprobante de gasto.

Cómo se imprimen las columnas de línea:

Columna Qué imprime
no Número de línea
code Código de artículo / SKU (también se añade bajo la descripción en las tablas estándar)
barcode El código de barras de la línea, o el código de barras / GTIN del artículo
description Descripción de la línea (una línea histórica de artículo no inventariable añade una segunda línea con su nombre guardado)
qty Cantidad, de 0 a 3 decimales, solo los necesarios
unit Nombre de la unidad
unit_price Precio unitario con la precisión de visualización, con los ceros finales recortados hasta la precisión de contabilización
discount Importe del descuento
discount_percent Descuento como porcentaje de la línea
after_discount Importe de la línea antes de impuestos
tax_rate Tasa como 5%; vacío cuando es 0
tax Importe del impuesto
project, division El proyecto de la línea (o el del documento cuando la línea no tiene) y su división en el idioma del documento
dimensions Valores de dimensión guardados, "Dimensión: Valor; Dimensión: Valor"
amount Total de línea

El rótulo Resumen de impuestos se deja en blanco cuando el documento no tiene filas de impuestos, y un elemento de resumen de impuestos sin filas se elimina de la página impresa.

#Grupo de totales

Los totales se imprimen con el código de moneda del documento, por ejemplo 1,250.00 AED. Un total que no se aplica imprime "—". Cada total tiene un rótulo correspondiente en el grupo Rótulos (label_*) cuya redacción sigue al tipo.

Nombre visible Nombre interno Rótulo (label_*) Tipos
Subtotal totals_subtotal Subtotal Tipos con líneas de artículos
Descuento totals_discount Descuento Tipos con líneas de artículos
Impuesto totals_tax Impuesto Tipos con líneas de artículos
Envío totals_shipping Envío Tipos con líneas de artículos
Total general totals_total Total general (label_total) Tipos con líneas de artículos y recibo de reembolso
Pagado totals_paid Pagado Factura, factura de proveedor, recibo de venta
Importe pendiente totals_balance Importe pendiente (label_balance_due) Factura, factura de proveedor, recibo de venta
Total recibido totals_total Total recibido Recibo de pago, pago a proveedor
Total aplicado totals_paid Total aplicado Recibo de pago, pago a proveedor
Importe sin aplicar totals_balance Importe sin aplicar Recibo de pago, pago a proveedor
Total débito / Total crédito / Diferencia totals_debit, totals_credit, totals_difference Total débito, Total crédito, Diferencia Comprobante de diario
Saldo inicial / Total débito / Total crédito / Saldo final totals_opening, totals_debit, totals_credit, totals_closing mismos nombres Estado de cuenta del cliente y del proveedor

La factura o factura de proveedor de muestra del diseñador muestra el saldo totalmente abierto (igual al total).

#Grupo de rótulos

Los rótulos son leyendas en el idioma del documento (en español "Fecha de vencimiento", en árabe "تاريخ الاستحقاق"…). Úselos para que la misma maquetación funcione en todos los idiomas. Un rótulo que depende de un valor se deja en blanco cuando ese valor está vacío, de modo que no se imprime ninguna leyenda huérfana: Notas, Términos, Importe en letras, Referencia, Fecha de vencimiento, Resumen de impuestos, los rótulos de pago, Moneda, Sucursal de, Proyecto, Documento original, Orden de compra, Tipo de cambio, Fecha de envío.

Nombre interno Imprime (en español) Notas
label_number No.
label_date Fecha de emisión
label_due_date Fecha de vencimiento Tipos con fecha de vencimiento
label_reference Referencia No en los comprobantes de diario
label_status Estado
label_currency Moneda
label_from De Rótulo del bloque de la empresa
label_subtotal, label_discount, label_tax, label_shipping, label_total, label_paid, label_balance_due Subtotal, Descuento, Impuesto, Envío, Total general (Total recibido en los pagos), Pagado (Total aplicado), Importe pendiente (Importe sin aplicar) Presente cuando existe el total correspondiente
label_opening, label_debit, label_credit, label_closing, label_difference Saldo inicial, Total débito, Total crédito, Saldo final, Diferencia Estados de cuenta y comprobante de diario
label_notes, label_terms, label_amount_words, label_tax_summary Notas, Términos y condiciones, Importe en letras, Resumen de impuestos Términos y Resumen de impuestos solo en los tipos con líneas de artículos
label_page Página Usado por los números de página
label_prepared_by Preparado por
label_received_by Recibido por en los tipos de venta; Firma del proveedor en los tipos de compra; Revisado por en un comprobante de diario Rótulo de la segunda firma
label_approved_by Aprobado por
label_signature Firma
label_project Proyecto Tipos con proyecto
label_original_number Documento original Nota de crédito, nota de débito, recibo de reembolso, orden de venta
label_po_number Orden de compra Factura de proveedor
label_exchange_rate Tipo de cambio Tipos con líneas y pagos
label_shipment_date Fecha de envío orden de venta
label_payment_method, label_payment_reference, label_payment_date Método de pago, Número de cheque o Referencia de transacción, Fecha de pago Tipos de pago
label_parent Sucursal de En el grupo Cliente / proveedor

#Grupo Imágenes y QR, firma y sello

  • Logotipo (org_logo) es la única imagen vinculada. También puede insertar su propia imagen (por ejemplo, un sello, una imagen de firma o una marca de certificación) con Insertar → Imagen; es una imagen fija que se imprime en todos los documentos.
  • Insertar → Más añade formas fijas (rectángulo, línea, elipse) y códigos fijos (código QR, Code 128, EAN-13) cuyo contenido usted escribe.
  • No hay campo de firma ni de sello. Para un bloque de firma, coloque los campos de rótulo label_prepared_by, label_received_by, label_approved_by o label_signature con una forma de línea encima o debajo de cada uno, y approval_prepared_by para el nombre de quien creó el documento. Un sello es una imagen fija.
  • No está disponible un campo de código QR para la facturación electrónica: la clave doc_qr existe, pero siempre se imprime vacía y no se ofrece en la lista de campos.

#Números de página

Los números de página son elementos de texto que usan los marcadores {currentPage}, {totalPages} y {label_page}. Elija el formato en el ajuste de números de página del diseñador; reescribe todos los elementos de número de página a la vez.

Formato English Árabe
Página x de y Página 1 de 2 الصفحة 1 من 2
x de y 1 de 2 1 من 2
Página x / y Página 1 / 2 الصفحة 1 / 2
x / y 1 / 2 1 / 2
x/y 1/2 1/2
Página x Página 1 الصفحة 1
x 1 1
- x - - 1 - - 1 -

La palabra entre los números sigue el idioma del documento: of, من, sur, von, de, di, de, из, از (el turco y el chino usan "/"). Cualquier otro texto que escriba se conserva como "Texto personalizado".

#Campos personalizados

  • Los campos personalizados que defina para un tipo de documento aparecen en el grupo Campos personalizados con su etiqueta, e imprimen el valor introducido en cada documento.
  • El nombre interno es custom_ más el nombre del campo con cada carácter que no sea letra, dígito o guion bajo sustituido por _, por ejemplo custom_delivery_terms.
  • En el lienzo, la muestra enseña la etiqueta del campo. Un campo con varios valores los imprime separados por comas.
  • Un campo personalizado cuya etiqueta coincide con un campo integrado (por ejemplo, un "Proyecto" de texto libre) recibe "(campo personalizado)" añadido a su nombre en la lista para que pueda distinguirlos.
  • Compatible con: factura, cotización, orden de venta, recibo de venta, nota de crédito, recibo de reembolso, factura de proveedor, orden de compra, nota de débito, recibo de pago, pago a proveedor, comprobante de gasto, comprobante de diario. Los estados de cuenta no tienen campos personalizados.

#Campos del sistema (cada columna almacenada)

Para cada tipo de documento, el diseñador ofrece además las columnas almacenadas del documento, de su cliente o proveedor y de la organización como campos que se pueden colocar. Así se accede a datos que no tienen un campo propio.

Prefijo Fuente Ejemplo de nombre interno
doc_f_ La tabla propia del documento doc_f_exchange_rate, doc_f_payment_terms
party_f_ El registro del cliente o proveedor party_f_credit_limit
org_f_ El registro de la organización org_f_default_document_language
  • El nombre visible es el nombre de la columna con los guiones bajos como espacios y la primera letra en mayúscula (solo en inglés); aparecen en los grupos Documento, Cliente / proveedor y Organización.
  • Los valores son de solo lectura: siempre proceden del registro y no se pueden sustituir en una plantilla. Se imprimen exactamente como están almacenados. Las fechas se imprimen como Y-m-d (con la hora H:i solo cuando se almacena una hora), los decimales se recortan a la precisión de contabilización, los valores sí/no se imprimen como Sí / No, y un nombre almacenado en varios idiomas se imprime en el idioma del documento.
  • Están vacíos en la muestra del lienzo y vacíos cuando el registro no tiene valor.
  • Nunca se ofrecen: los identificadores de registro y cualquier columna que termine en _id, _ids, _token, _secret, _hash, _key, _json, _snapshot, _payload, _meta; contraseñas y tokens; columnas de auditoría (creado, actualizado, eliminado por); configuración, metadatos, opciones y otros datos estructurados. Los datos de campos personalizados se ofrecen mediante los campos personalizados.
  • Un campo del sistema nunca sustituye a un campo dedicado del mismo nombre: solo se añaden las columnas que no tienen uno.

La lista exacta depende de las columnas de las tablas de su organización, por lo que no se reproduce aquí; busque el nombre de la columna en la lista de campos.

#Variables de la empresa

Los valores de la empresa proceden del perfil de su organización. Una plantilla puede llevar un valor propio para algunos de ellos (por ejemplo, la dirección de una sucursal solo en una plantilla) en la página Variables del diseñador.

Variable Nombre interno Se puede sustituir por plantilla
Logotipo org_logo Sí. Suba un PNG o JPEG; déjelo en blanco para no imprimir logotipo
Nombre de la empresa org_name si
Razón social org_legal_name si
Dirección de la empresa org_address si
Teléfono de la empresa org_phone si
Correo electrónico de la empresa org_email si
Sitio web org_website si
N.º fiscal org_tax_number si
N.º de registro org_registration si
Línea de contacto, Datos de la empresa, Línea de pie de página org_contact_line, org_details, footer_line No (líneas combinadas), pero siguen las sustituciones de los valores que combinan

Reglas:

  • Sin sustitución = la plantilla sigue el perfil de la empresa; los cambios posteriores en el perfil se reflejan automáticamente.
  • Sustitución vacía = un espacio en blanco intencionado: el valor no imprime nada, aunque el perfil tenga uno.
  • Una sustitución está limitada a 1000 caracteres; la sustitución de un logotipo debe ser una imagen PNG o JPEG.
  • Estados en la página Variables: Sustituido en la plantilla, Dejado en blanco, Predeterminado de la empresa, Falta, Línea combinada, Del documento, Vacío en la muestra, Idioma del documento. Use Restablecer para quitar una sustitución.
  • No sustituibles: todos los campos de documento, pago, proyecto, cliente / proveedor, total, rótulo, tabla, personalizados y del sistema. Los valores de las transacciones siempre proceden del documento.

#Formato

Importes y decimales

  • El dinero se imprime con separadores de miles y punto decimal: 1,250.00. Los totales añaden el código de moneda (1,250.00 AED); las celdas de tabla no.
  • Los decimales siguen la precisión de contabilización de la organización, pero no se imprimen los decimales sin usar: un documento en una moneda de 2 decimales imprime 190,000.00 aunque la contabilidad registre con 3 decimales, y sube a 3 solo cuando un importe de ese documento realmente necesita el tercero. Se aplica una única precisión a todo el documento para que las columnas queden alineadas.
  • Las cantidades se imprimen con de 0 a 3 decimales según haga falta. Los precios unitarios pueden mostrar más decimales (la precisión de visualización), recortados hasta la precisión de contabilización.
  • Los dígitos son occidentales (0–9) en todos los idiomas de documento, incluido el árabe.

Fechas

  • El formato de fecha de la plantilla se aplica a las fechas de emisión, vencimiento, caducidad, prevista y de envío: Y-m-d (2026-11-20, el predeterminado), d/m/Y, m/d/Y o F j, Y (20 de noviembre de 2026). La hora de generación es siempre Y-m-d H:i. Los campos del sistema imprimen las fechas tal como están almacenadas (Y-m-d).

Moneda

  • El código de moneda (AED, SAR, JOD, USD…) se imprime después de cada total. Una línea en otra moneda conserva su código en las celdas de la tabla. El importe en letras usa el nombre de la moneda (en inglés o árabe).

Idioma y escritura de derecha a izquierda

  • Los rótulos, estados, nombres de tipos, métodos de pago y palabras de las fechas siguen el idioma del documento. Los nombres, direcciones, notas y otros textos que usted o sus clientes escribieron se imprimen tal como están almacenados; no se traducen.
  • Los documentos en árabe se maquetan de derecha a izquierda. Los números, códigos, correos electrónicos, teléfonos, números fiscales y URL se envuelven para que conserven su orden de izquierda a derecha dentro del texto de derecha a izquierda. Un valor escrito en alfabeto árabe se deja con la dirección normal del texto.
  • En una plantilla en árabe, el diseñador refleja las columnas de las tablas y alinea a la derecha el texto nuevo.

Valores vacíos

  • Un campo vacío no imprime nada. Los rótulos condicionales se dejan en blanco por sí solos (véase Rótulos). En un elemento de texto puede establecer un texto alternativo que se imprime cuando el campo está vacío, por ejemplo "Sin proyecto".

#Ejemplos prácticos

Encabezado bilingüe (inglés y árabe)

  1. Coloque doc_title y establezca el idioma del documento en árabe para el título en árabe, o use el texto estático "FACTURA FISCAL | فاتورة ضريبية" para un título bilingüe fijo.
  2. Coloque label_number y doc_number uno al lado del otro, y después label_date y doc_date. Los rótulos siguen el idioma del documento, así que una sola plantilla sirve para ambos.
  3. Coloque org_name y, debajo, org_legal_name. Si el nombre de la empresa en árabe no está en su perfil, establézcalo como sustitución de plantilla para org_name en la página Variables.

Bloque de datos bancarios

No hay un campo de cuenta bancaria. Añada un elemento de texto estático, por ejemplo:

Bank: Example Bank — IBAN: AE00 0000 0000 0000 0000 000
Payment reference: {doc_number}

El texto estático puede contener nombres de campo entre llaves; aquí {doc_number} imprime el número de factura. En los documentos de pago, doc_payment_method y doc_payment_reference imprimen el método y la referencia del cheque o de la transacción del documento.

Línea del TRN del cliente

Coloque el texto estático Customer TRN: {party_tax_number} o use dos elementos: un rótulo estático y el campo party_tax_number. Para imprimir la misma línea de la empresa, use Tax No.: {org_tax_number}. Si el cliente no tiene número fiscal, establezca un texto alternativo como "—" en el elemento, o use party_details, que imprime "N.º fiscal: …" solo cuando hay un número.

Facturas de sucursal

Los diseños integrados ya imprimen esta línea como última línea del panel de la parte. En una copia guardada y editada, coloque label_parent y party_parent_name bajo party_name. Para un cliente de casa matriz ambos están vacíos y la leyenda desaparece; para una sucursal se imprime "Sucursal de Head Office Co.".

Línea de proyecto

Coloque label_project y doc_project. Establezca el texto alternativo de doc_project en "General" para que los documentos sin proyecto impriman "General" (el rótulo sigue entonces al valor vacío y queda en blanco).

#Lo que no está disponible

  • Un campo de cuenta bancaria / IBAN, un campo de código QR de factura electrónica (doc_qr siempre está vacío), un campo de firma o de sello, el número de orden de compra propio de un cliente en las facturas (solo las facturas de proveedor tienen la orden de compra emitida al proveedor), y lógica condicional o cálculos a nivel de página (las plantillas usan solo los valores aquí enumerados; sin expresiones).
  • Los valores no se recalculan en el PDF: los importes, impuestos, saldos y palabras imprimen exactamente lo que contiene el documento.
  • Ningún dato de otros documentos salvo el original vinculado (nota de crédito, nota de débito, reembolso, orden de venta), el proyecto y sus divisiones, y la orden de compra de la factura de proveedor.
  • Las variables de la empresa se pueden sustituir por plantilla; todo lo demás está fijado a su origen.

#Lista completa de campos por tipo de documento

Las tablas siguientes enumeran los campos del catálogo de cada tipo de documento por nombre interno. Busque cada nombre en las secciones anteriores.

#factura

80 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_due_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_source_note, doc_exchange_rate, approval_prepared_by 16
Proyecto doc_project_name, doc_project_code, doc_project 3
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totales totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total, totals_paid, totals_balance 7
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_paid, label_balance_due, label_number, label_date, label_due_date, label_reference, label_project, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 25

#Cotización

76 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_due_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_exchange_rate, doc_revision, approval_prepared_by 16
Proyecto doc_project_name, doc_project_code, doc_project 3
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totales totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total 5
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_number, label_date, label_due_date, label_reference, label_project, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 23

#Orden de venta

79 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_due_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_original_number, doc_exchange_rate, doc_shipment_date, approval_prepared_by 17
Proyecto doc_project_name, doc_project_code, doc_project 3
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totales totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total 5
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_number, label_date, label_due_date, label_reference, label_project, label_original_number, label_exchange_rate, label_shipment_date, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 25

#Recibo de venta

78 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_exchange_rate, approval_prepared_by 14
Pago doc_payment_method, doc_payment_reference, doc_payment_date 3
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas items, items_simple, tax_summary, items_detailed, items_tax_invoice 5
Totales totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total, totals_paid, totals_balance 7
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_paid, label_balance_due, label_number, label_date, label_reference, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature, label_payment_method, label_payment_reference, label_payment_date 26

#Nota de crédito

75 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_original_number, doc_exchange_rate, approval_prepared_by 15
Proyecto doc_project_name, doc_project_code, doc_project 3
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totales totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total 5
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_number, label_date, label_reference, label_project, label_original_number, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 23

#Recibo de reembolso

59 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_notes, doc_amount_words, doc_watermark, doc_generated_at, doc_original_number, doc_refund_reason, approval_prepared_by 13
Pago doc_payment_method, doc_payment_reference, doc_payment_date 3
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas allocations 1
Totales totals_total 1
Rótulos label_total, label_number, label_date, label_reference, label_original_number, label_status, label_currency, label_from, label_notes, label_amount_words, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature, label_payment_method, label_payment_reference, label_payment_date 18

#Factura de proveedor

81 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_due_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_po_number, doc_exchange_rate, approval_prepared_by 16
Proyecto doc_project_name, doc_project_code, doc_project 3
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totales totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total, totals_paid, totals_balance 7
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_paid, label_balance_due, label_number, label_date, label_due_date, label_reference, label_project, label_po_number, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 26

#Orden de compra

75 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_due_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_exchange_rate, approval_prepared_by 15
Proyecto doc_project_name, doc_project_code, doc_project 3
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totales totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total 5
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_number, label_date, label_due_date, label_reference, label_project, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 23

#Nota de débito

75 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_original_number, doc_exchange_rate, approval_prepared_by 15
Proyecto doc_project_name, doc_project_code, doc_project 3
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totales totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total 5
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_number, label_date, label_reference, label_project, label_original_number, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 23

#Recibo de pago

62 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_notes, doc_amount_words, doc_watermark, doc_generated_at, doc_exchange_rate, approval_prepared_by 12
Pago doc_payment_method, doc_payment_reference, doc_payment_date 3
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas allocations 1
Totales totals_total, totals_paid, totals_balance 3
Rótulos label_total, label_paid, label_balance_due, label_number, label_date, label_reference, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_amount_words, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature, label_payment_method, label_payment_reference, label_payment_date 20

#Pago a proveedor

62 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_notes, doc_amount_words, doc_watermark, doc_generated_at, doc_exchange_rate, approval_prepared_by 12
Pago doc_payment_method, doc_payment_reference, doc_payment_date 3
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas allocations 1
Totales totals_total, totals_paid, totals_balance 3
Rótulos label_total, label_paid, label_balance_due, label_number, label_date, label_reference, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_amount_words, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature, label_payment_method, label_payment_reference, label_payment_date 20

#Comprobante de gasto

79 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_exchange_rate, doc_payee_name, approval_prepared_by 15
Proyecto doc_project_name, doc_project_code, doc_project 3
Pago doc_payment_method, doc_payment_reference, doc_payment_date 3
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas items, items_simple, tax_summary, items_detailed, items_tax_invoice 5
Totales totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total 5
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_number, label_date, label_reference, label_project, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature, label_payment_method, label_payment_reference, label_payment_date 25

#Comprobante de diario

41 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_status, doc_currency, doc_notes, doc_amount_words, doc_watermark, doc_generated_at, approval_prepared_by 10
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Tablas journal 1
Totales totals_debit, totals_credit, totals_difference 3
Rótulos label_debit, label_credit, label_difference, label_number, label_date, label_status, label_currency, label_from, label_notes, label_amount_words, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 15

#Estado de cuenta del cliente

56 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_notes, doc_amount_words, doc_watermark, doc_generated_at, approval_prepared_by 11
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas statement 1
Totales totals_opening, totals_debit, totals_credit, totals_closing 4
Rótulos label_opening, label_debit, label_credit, label_closing, label_number, label_date, label_reference, label_status, label_currency, label_from, label_notes, label_amount_words, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 17

#Estado de cuenta del proveedor

56 campos del catálogo (más campos del sistema y campos personalizados, véase más abajo).

Grupo Campos Cantidad
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_notes, doc_amount_words, doc_watermark, doc_generated_at, approval_prepared_by 11
Organización org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / proveedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tablas statement 1
Totales totals_opening, totals_debit, totals_credit, totals_closing 4
Rótulos label_opening, label_debit, label_credit, label_closing, label_number, label_date, label_reference, label_status, label_currency, label_from, label_notes, label_amount_words, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 17