Las variables de Dolibarr se utilizan en diferentes aplicaciones del software ERP.
El objetivo es poder personalizar documentos reemplazando estas variables, también llamadas etiquetas, por datos dentro de un proceso como un presupuesto, un pedido, etc. Ejemplo: envío de una factura por correo electrónico.
Este sistema también permite una mayor personalización de sus herramientas de trabajo, especialmente en caso de uso de campos personalizados. Consulte Formularios con campos personalizados en su software de gestión.
El uso de estas variables generalmente se realiza en el momento de la configuración del software o de una nueva funcionalidad. El objetivo de este capítulo es proporcionar una síntesis por tipo de aplicación.
Tenga en cuenta,
  • La sintaxis de las variables difiere de una aplicación a otra, principalmente por razones históricas,
  • Nuevas variables aparecen regularmente, según nuevos módulos, mejoras o solicitudes de nuestros clientes,

Por razones técnicas independientes de DoliPlus, se recomienda encarecidamente copiar las variables manualmente y no hacer copiar/pegar, que puede funcionar o no de manera aleatoria.

Variables de Tipo 1

Uso en:

  • Bibliotecas de mensajes o textos de Dolibarr – Modelos de correos electrónicos

  • Mensajes estándar de acompañamiento de correos electrónicos de Dolibarr

variables Dolibarr

Factura al cliente

__SOCNAME__ Nombre del cliente
__FACREF__ Ref
__FACREF_CLIENT__ Ref cliente
__FACREF_INTERNE__ Ref interna
__DATE__ Fecha
__DATE_LIMIT__ Fecha de vencimiento
__HT__ Importe sin IVA
__TTC__ Importe con IVA
__TVA__ Importe de IVA
__REMAIN_TO_PAY__ Resto a pagar

También es posible recuperar los títulos de los campos personalizados según esta sintaxis: (doble guión bajo) CÓDIGO DEL CAMPO PERSONALIZADO EN MAYÚSCULAS (doble guión bajo), ejemplo: __CODIGO-MI-CAMPO-PERSONALIZADO__

Pedido al cliente

__SOCNAME__ Nombre del cliente
__ORDERREF__ Ref.
__ORDER_CLIENT__ Ref. del cliente
__ORDER_INTERNE__ Ref. interna
__DATE__ Fecha
__DATE_DELIVERY__ Fecha de entrega
__HT__ Importe sin IVA
__TTC__ Importe total
__TVA__ Importe de IVA

Il es también posible utilizar los títulos de los campos personalizados según esta sintaxis: (doble guión bajo) CÓDIGO DEL CAMPO PERSONALIZADO EN MAYÚSCULAS (doble guión bajo), ejemplo: __CODIGO-DE-MI-CAMPO-PERSONALIZADO__

Propuesta comercial

__SOCNAME__ Nombre del cliente
__PROPREF__ Ref.
__PROPREF_CLIENT__ Ref. del cliente
__PROPREF_INTERNE__ Ref. interna
__DATE__ Fecha
__DATE_DELIVERY__ Fecha de entrega
__HT__ Importe sin IVA
__TTC__ Importe total
__TVA__ Importe de IVA

Il es también posible utilizar los títulos de los campos personalizados según esta sintaxis: (doble guión bajo) CÓDIGO DEL CAMPO PERSONALIZADO EN MAYÚSCULAS (doble guión bajo), ejemplo: __CODIGO-DE-MI-CAMPO-PERSONALIZADO__

Solicitud de presupuesto a proveedor

__SOCNAME__ Nombre del proveedor
__SUPPLIERPROPOSALREF__ Ref.
__ORDERREF_SUPPLIER__ Ref. proveedor
__DATE__ Fecha de la factura
__DATE_DELIVERY__ Fecha de entrega
__HT__ Importe sin IVA
__TTC__ Importe con IVA
__TVA__ Importe de IVA

Es posible también utilizar los títulos de los campos personalizados según esta sintaxis: (doble guión bajo) CÓDIGO DEL CAMPO PERSONALIZADO EN MAYÚSCULAS (doble guión bajo), ejemplo: __CODIGO-DE-MI-CAMPO-PERSONALIZADO__

Orden de Compra

__SOCNAME__ Nombre del proveedor
__ORDERREF__ Ref.
__ORDERREF_SUPPLIER__ Ref. proveedor
__DATE__ Fecha
__DATE_DELIVERY__ Fecha de entrega
__HT__ Importe sin IVA
__TTC__ Importe con IVA
__TVA__ Importe de IVA

Es posible también utilizar los títulos de los campos personalizados según esta sintaxis: (doble guión bajo) CÓDIGO DEL CAMPO PERSONALIZADO EN MAYÚSCULAS (doble guión bajo), ejemplo: __CODIGO-DE-MI-CAMPO-PERSONALIZADO__

Factura de Proveedor

__TTC__Importe con IVA

__FACREF__ Ref.
__FACREF_SUPPLIER__ Ref. proveedor
__DATE__ Fecha
__DATE_LIMIT__ Fecha de vencimiento
__HT__ Importe sin IVA
__TVA__ Importe de IVA

Es posible también utilizar los títulos de los campos personalizados según esta sintaxis: (doble guión bajo) CÓDIGO DEL CAMPO PERSONALIZADO EN MAYÚSCULAS (doble guión bajo), ejemplo: __CODIGO-DE-MI-CAMPO-PERSONALIZADO__

Oportunidad de Negocio (Lead)

Desde el envío de un correo electrónico desde el registro del cliente o proveedor mediante un mensaje personalizado que contenga estas variables en el asunto o en el cuerpo del mensaje.

__TIERS__ Nombre del cliente o proveedor
__TEL__ Teléfono
__MAIL__ Correo electrónico
__ADRESSE__ Dirección
__CP__ Código postal
__VILLE__ Ciudad
__CODE_CLIENT__ Código de cliente
__REF__ Ref. oportunidad
__DATE_CLOTURE__ Fecha
__HT__ Estimación sin IVA

También es posible incluir los títulos de los campos personalizados según esta sintaxis: (doble guión bajo) CÓDIGO DEL CAMPO PERSONALIZADO EN MAYÚSCULAS (doble guión bajo), ejemplo: __CODE-DE-MON-CHAMP-PERSONNALISÉ__

Cliente o proveedor

Desde el envío de un correo electrónico desde el registro del cliente o proveedor mediante un mensaje personalizado que contenga estas variables en el asunto o en el cuerpo del mensaje.

__TIERS__ Nombre del cliente o proveedor
__TEL__ Teléfono
__MAIL__ Correo electrónico
__ADRESSE__ Dirección
__CP__ Código postal
__VILLE__ Ciudad
__CODE_CLIENT__ Código de cliente

También es posible incluir los títulos de los campos personalizados según esta sintaxis: (doble guión bajo) CÓDIGO DEL CAMPO PERSONALIZADO EN MAYÚSCULAS (doble guión bajo), ejemplo: __CODE-DE-MON-CHAMP-PERSONNALISÉ__

Variables de Tipo 2

Nota: se añaden variables regularmente, esta lista puede no ser exhaustiva, consúltenos mediante ticket si falta algún elemento para su modelo.

Uso en:

Información sobre la empresa

Una lista de etiquetas:

mycompany_logo : Su logotipo de empresa
mycompany_name : Su nombre de empresa
mycompany_address : Su dirección de empresa
mycompany_zip : Su código postal de empresa
mycompany_town : Su localidad de empresa
mycompany_country : Su país de empresa (etiqueta)
mycompany_country_code : Su país de empresa (código: ES, FR, US…)
mycompany_state : Su provincia de empresa (etiqueta)
mycompany_state_code : Su provincia de empresa (código)
mycompany_phone
mycompany_fax
mycompany_email
mycompany_web
mycompany_barcode
mycompany_capital
mycompany_juridicalstatus
mycompany_idprof1
mycompany_idprof2
mycompany_idprof3
mycompany_idprof4
mycompany_idprof5
mycompany_idprof6
mycompany_vatnumber : Su número de IVA de empresa
mycompany_note : Su nota de empresa

Campos personalizados: Ninguno

Información sobre el cliente o proveedor

  • Plantillas de documentos en formato Word con Dolibarr: etiquetas a añadir entre ${}.
  • Plantillas de documentos en formato ODT/ODS con Dolibarr: etiquetas a añadir entre {}.

Una lista de etiquetas:

company_name : Nombre de la empresa del cliente o proveedor
company_address
company_zip
company_town
company_country : País de la empresa del cliente o proveedor (etiqueta)
company_country_code : País de la empresa del cliente o proveedor (código: ES, FR, US…)
company_state
company_state_code
company_phone
company_fax
company_email
company_web
company_barcode
company_customercode : Código de cliente de la empresa
company_suppliercode : Código de proveedor de la empresa
company_customeraccountancycode : Código contable de cliente
company_supplieraccountancycode : Código contable de proveedor
company_capital
company_juridicalstatus
company_idprof1
company_idprof2
company_idprof3
company_idprof4
company_idprof5
company_idprof6
company_vatnumber : Número de IVA del cliente o proveedor
company_note_public : Nota pública del cliente o proveedor

company_note

company_default_bank_iban

Campos personalizados: company_code-de-mon-champ-personnalisé

Información sobre el usuario

  • Plantillas de documentos en formato Word con Dolibarr: etiquetas a añadir entre ${}.
  • Plantillas de documentos en formato ODT/ODS con Dolibarr: etiquetas a añadir entre {}.

myuser_lastname
myuser_firstname
myuser_fullname
myuser_login
myuser_phone
myuser_address
myuser_zip
myuser_town
myuser_country
myuser_country_code
myuser_state
myuser_state_code
myuser_fax
myuser_mobile
myuser_email
myuser_logo
myuser_job
Campos personalizados: myuser_code-de-mon-champ-personnalisé

Otra información

  • Plantillas de documentos en formato Word con Dolibarr: etiquetas a añadir entre ${}.
  • Plantillas de documentos en formato ODT/ODS con Dolibarr: etiquetas a añadir entre {}.

current_date
current_datehour
current_server_date
current_server_datehour
current_date_locale
current_datehour_locale
current_server_date_locale
current_server_datehour_locale

 

Información sobre el documento (factura, propuesta comercial, pedido, …)

  • Plantillas de documentos en formato Word con Dolibarr: etiquetas a añadir entre ${}.
  • Plantillas de documentos en formato ODT/ODS con Dolibarr: etiquetas a añadir entre {}.

object_id
object_ref
object_ref_customer
object_ref_supplier
object_date
object_date_creation
object_date_modification
object_date_validation
object_note_private
object_note_public
object_note
Importes (datos numéricos):
object_total_ht
object_total_vat
object_total_localtax1
object_total_localtax2
object_total_ttc
object_total_discount_ht
object_total_vat_x
Importes (en formato del idioma de salida):
object_total_ht_locale
object_total_vat_locale
object_total_localtax1_locale
object_total_localtax2_locale
object_total_ttc_locale
object_total_discount_ht_locale
object_total_vat_locale_x.x
Específico para propuestas:
object_date_end
Específico para pedidos:
object_date_delivery_planed
Específico para facturas:
object_date_limit
object_payment_mode
object_payment_term
object_source_invoice_ref
object_already_payed
object_remain_to_pay
object_already_payed_locale
object_remain_to_pay_locale
Campos personalizados: object_code-de-mon-champ-personnalisé

Líneas de los documentos

Así es cómo utilizar las tablas de líneas de objetos (líneas de facturas, pedidos, etc.). Debe crear una tabla en el documento y usar una etiqueta “begin” y “end” para definir la línea de la tabla. Esta línea se repetirá tantas veces como sea necesario al generar el documento.

[!– BEGIN row.lines –] …
[!– END row.lines –]

Ejemplo

Descripción

Tasa de IVA

Precio unitario €

Cantidad

Descuento

Total € sin IVA

[!– BEGIN row.lines –]{line_fulldesc}

{line_vatrate}

{line_up}

{line_qty}

{line_discount_percent}

{line_price_ht}

[!– END row.lines –]

Luego, añada las etiquetas que desee entre las líneas entre estas opciones:

line_fulldesc
line_product_ref
line_product_label
line_desc
line_vatrate
line_up
line_up_locale
line_qty
line_discount_percent
line_price_ht
line_price_ht_locale
line_price_vat
line_price_vat_locale
line_price_ttc
line_price_ttc_locale
line_date_start
line_date_start_rfc
line_date_end
line_date_end_rfc

Especial Proyectos y Tareas

Proyecto {object_ref} del {object_datec}

Descripción: {object_description}

Nota privada: {object_note_private}

Nota pública: {object_note_public}

Para las Tareas

Descripción Ref. Etiqueta

Inicio

 Prev. Progreso
[!– BEGIN row.lines –]{line_desc}

{line_ref}

{line_label}

{line_date_start}

{line_planned_workload}

{line_progress}

[!– END row.lines –]

ref = {line_ref}
fk_project = {line_fk_projet}
fk_task_parent = {line_fk_task_parent}
label = {line_label}
description = {line_description}
duration_effective = {line_duration_effective}
date_c = db->jdate({line_datec})
date_start = db->jdate({line_dateo})
date_end = db->jdate({line_datee})
fk_user_creat = {line_fk_user_creat}
fk_user_valid = {line_fk_user_valid}
fk_statut = {line_fk_statut}
progress = {line_progress}
priority = {line_priority}
note_private = {line_note_private}
note_public = {line_note_public}
planned_workload = {line_planned_workload}

Print Friendly, PDF & Email