Les variables Dolibarr sont utilisées dans différentes applications du logiciel ERP.
Le but est bien souvent de pouvoir personnaliser des documents en remplaçant ces variables aussi appelées tags, par des données au sein d’un processus comme un devis, une commande, …. Exemple envoi d’une facture par émail.
Ce système permet d’également plus de personnalisation de vos outils de travail notamment en cas d’utilisation de champs personnalisés. Voir Formulaires avec champs personnalisés dans votre logiciel de gestion.
L’utilisation de ces variables se réalisent généralement au moment du paramétrage du logiciel ou d’une nouvelle fonctionnalité. Le but de ce chapitre est d’apporter une synthèse par type d’application.
A noter,
  • La syntaxe des variables différèrent d’une application à l’autre essentiellement pour des raisons historiques,
  • De nouvelles variables voient le jour régulièrement, selon de nouveaux module ou améliorations ou demandes de nos clients,

Pour des raisons techniques indépendantes de DoliPlus, il est fortement recommandé de copier les variables au clavier et non de faire un copié/collé qui peut fonctionner ou non de manière aléatoire.

Variables de  Type 1

Emploi dans :

variables Dolibarr

Facture client

__SOCNAME__ Nom du client
__FACREF__ Réf
__FACREF_CLIENT__ Réf client
__FACREF_INTERNE__ Réf interne
__DATE__ Date
__DATE_LIMIT__ Date échéance
__HT__ Montant HT
__TTC__ Montant TTC
__TVA__ Montant TVA
__REMAIN_TO_PAY__ Reste à payer

Il est également possible de reprendre les intitulés des champs personnalisés selon cette syntaxe : (double tiret bas) CODE DU CHAMP PERSONNALISE EN MAJUSCULE (double tiret bas) , exemple :  __CODE-DE-MON-CHAMP-PERSONNALISE__

Commande client

__SOCNAME__ Nom du client
__ORDERREF__ Réf
__ORDER_CLIENT__ Réf client
__ORDER_INTERNE__ Réf interne
__DATE__ Date
__DATE_DELIVERY__ Date liv.
__HT__ Montant HT
__TTC__ Montant TTC
__TVA__ Montant TVA

Il est également possible de reprendre les intitulés des champs personnalisés  selon cette syntaxe : (double tiret bas) CODE DU CHAMP PERSONNALISE EN MAJUSCULE (double tiret bas) , exemple :  __CODE-DE-MON-CHAMP-PERSONNALISE__

Proposition commerciale

__SOCNAME__ Nom du client
__PROPREF__ Réf
__PROPREF_CLIENT__ Réf client
__PROPREF_INTERNE__ Réf interne
__DATE__ Date
__DATE_DELIVERY__ Date liv.
__HT__ Montant HT
__TTC__ Montant TTC
__TVA__ Montant TVA

Il est également possible de reprendre les intitulés des champs personnalisés  selon cette syntaxe : (double tiret bas) CODE DU CHAMP PERSONNALISE EN MAJUSCULE (double tiret bas) , exemple : __CODE-DE-MON-CHAMP-PERSONNALISE__

Demande de prix Fournisseur

__SOCNAME__ Nom du fournisseur
__SUPPLIERPROPOSALREF__ Réf
__ORDERREF_SUPPLIER__ Réf fourn.
__DATE__ Date facture
__DATE_DELIVERY__ Date liv
__HT__ Montant HT
__TTC__ Montant TTC
__TVA__ Montant TVA

Il est également possible de reprendre les intitulés des champs personnalisés  selon cette syntaxe : (double tiret bas) CODE DU CHAMP PERSONNALISE EN MAJUSCULE (double tiret bas) , exemple : __CODE-DE-MON-CHAMP-PERSONNALISE__

Commande Fournisseur

__SOCNAME__ Nom du fournisseur
__ORDERREF__ Réf
__ORDERREF_SUPPLIER__ Réf fourn.
__DATE__ Date
__DATE_DELIVERY__ Date liv.
__HT__ Montant HT
__TTC__ Montant TTC
__TVA__ Montant TVA

Il est également possible de reprendre les intitulés des champs personnalisés  selon cette syntaxe : (double tiret bas) CODE DU CHAMP PERSONNALISE EN MAJUSCULE (double tiret bas) , exemple : __CODE-DE-MON-CHAMP-PERSONNALISE__

Facture Fournisseur

__FACREF__ Réf
__FACREF_SUPPLIER__ Réf fourn.
__DATE__ Date
__DATE_LIMIT__ Date échéance
__HT__ Montant HT
__TTC__ Montant TTC
__TVA__ Montant TVA

Il est également possible de reprendre les intitulés des champs personnalisés  selon cette syntaxe : (double tiret bas) CODE DU CHAMP PERSONNALISE EN MAJUSCULE (double tiret bas) , exemple : __CODE-DE-MON-CHAMP-PERSONNALISE__

Opportunité d’Affaires (Lead)

Depuis l’envoi d’un mail depuis fiche de tiers via un message personnalisé contenant ces variables dans le sujet ou le corps du message.

__TIERS__ Nom du tiers
__TEL__ Tel
__MAIL__ Email
__ADRESSE__ Adresse
__CP__ Code postal
__VILLE__ Ville
__CODE_CLIENT__ Code client
__REF__ Réf opportunité
__DATE_CLOTURE__ Date
__HT__ Estimation HT

Il est également possible de reprendre les intitulés des champs personnalisés  selon cette syntaxe : (double tiret bas) CODE DU CHAMP PERSONNALISE EN MAJUSCULE (double tiret bas) , exemple : __CODE-DE-MON-CHAMP-PERSONNALISE__

Tiers

Depuis l’envoi d’un mail depuis fiche de tiers via un message personnalisé contenant ces variables dans le sujet ou le corps du message.

__TIERS__ Nom du tiers
__TEL__ Tel
__MAIL__ Email
__ADRESSE__ Adresse
__CP__ Code postal
__VILLE__ Ville
__CODE_CLIENT__ Code client

Il est également possible de reprendre les intitulés des champs personnalisés  selon cette syntaxe : (double tiret bas) CODE DU CHAMP PERSONNALISE EN MAJUSCULE (double tiret bas) , exemple : __CODE-DE-MON-CHAMP-PERSONNALISE__

Variables de Type 2

Nota : des variables sont régulièrement ajoutées, cette liste n’est peut-être pas exhaustive, nous consulter via ticket si un élément est manquant pour votre modèle.

Emploi dans :

Les informations concernant la société

Une liste de tags :

mycompany_logo : Your company logo
mycompany_name : Your company name
mycompany_address : Your company address
mycompany_zip : Your company zip
mycompany_town : Your company town
mycompany_country : Your company country (label)
mycompany_country_code : Your company country (code: FR, US, IT…)
mycompany_state : Your company state (label)
mycompany_state_code : Your company state (code)
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 : Your company VAT number
mycompany_note : Your company note

Champs personnalisés :  Aucun

Les informations concernant le tiers

Une liste de tags :

company_name : Customer or Supplier company name
company_address
company_zip
company_town
company_country : Customer or Supplier company country (label)
company_country_code : Customer or Supplier company country (code: FR, US, IT…)
company_state
company_state_code
company_phone
company_fax
company_email
company_web
company_barcode
company_customercode : Company customer code
company_suppliercode : Company supplier code
company_customeraccountancycode : Company customer accountancy code
company_supplieraccountancycode : Company supplier accountancy code
company_capital
company_juridicalstatus
company_idprof1
company_idprof2
company_idprof3
company_idprof4
company_idprof5
company_idprof6
company_vatnumber : Customer or Supplier company VAT number
company_note_public : Customer or Supplier company public note

company_note

company_default_bank_iban

Champs personnalisés :  company_code-de-mon-champ-personnalisé

Les informations sur l’utilisateur

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
Champs personnalisés :  myuser_code-de-mon-champ-personnalisé

Autres informations

current_date
current_datehour
current_server_date
current_server_datehour
current_date_locale
current_datehour_locale
current_server_date_locale
current_server_datehour_locale

 

Informations sur l’objet (facture, proposition commerciale, commande, …)

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
Amounts (numeric data):
object_total_ht
object_total_vat
object_total_localtax1
object_total_localtax2
object_total_ttc
object_total_discount_ht
object_total_vat_x
Amounts (in output language format):
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
Specific to proposals:
object_date_end
Specific to order:
object_date_delivery_planed
Specific to invoices:
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
Champs personnalisés :  object_code-de-mon-champ-personnalisé

Lignes des objets

Voici comment utiliser les tableaux de lignes des objets (lignes de factures, commandes, etc…). Vous devez créer un tableau dans le document et utiliser une balise « begin » et « end » pour définir la ligne du tableau. Cette ligne sera répétée autant de fois que requis au moment de la génération.

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

Exemple

Description

Taux de TVA

Tarif unitaire €

Quantité

Remise

Total € HT

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

{line_vatrate}

{line_up}

{line_qty}

{line_discount_percent}

{line_price_ht}

[!– END row.lines –]

Ensuite, ajouter les tags de votre choix dans les lignes parmi ceux-ci:

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

En rapport Mémos

Print Friendly, PDF & Email