Le variabili Dolibarr vengono utilizzate in diverse applicazioni del software ERP.
L’obiettivo è spesso quello di personalizzare i documenti sostituendo queste variabili, chiamate anche tag, con dati all’interno di un processo come un quote, un ordine, ecc. Esempio: invio di un’invoice via email.
Questo sistema permette anche una maggiore personalizzazione dei vostri strumenti di lavoro, soprattutto in caso di utilizzo di campi personalizzati. Vedi Moduli con campi personalizzati nel vostro software di gestione.
L’utilizzo di queste variabili avviene generalmente durante la configurazione del software o di una nuova funzionalità. Lo scopo di questo capitolo è fornire una sintesi per tipo di applicazione.
Da notare,
  • La sintassi delle variabili differisce da un’applicazione all’altra principalmente per ragioni storiche,
  • Nuove variabili vengono introdotte regolarmente, in base a nuovi moduli, miglioramenti o richieste dei nostri clienti,

Per motivi tecnici indipendenti da DoliPlus, si consiglia vivamente di copiare le variabili tramite tastiera e non di effettuare un copia/incolla che potrebbe funzionare in modo casuale.

Variabili di Tipo 1

Utilizzo in:

  • Librerie Dolibarr di messaggi o testi – Modelli di email

  • Messaggi standard di accompagnamento delle email Dolibarr

variables Dolibarr

Invoice cliente

__SOCNAME__ Nome del cliente
__FACREF__ Rif
__FACREF_CLIENT__ Rif cliente
__FACREF_INTERNE__ Rif interno
__DATE__ Data
__DATE_LIMIT__ Data scadenza
__HT__ Importo netto
__TTC__ Importo lordo
__TVA__ Importo VAT
__REMAIN_TO_PAY__ Residuo da pagare

È inoltre possibile riprendere le intestazioni dei campi personalizzati secondo questa sintassi: (doppio trattino basso) CODICE DEL CAMPO PERSONALIZZATO IN MAIUSCOLO (doppio trattino basso), esempio:  __CODICE-DEL-MIO-CAMPO-PERSONALIZZATO__

Ordine cliente

__SOCNAME__ Nome del cliente
__ORDERREF__ Rif.
__ORDER_CLIENT__ Rif. cliente
__ORDER_INTERNE__ Rif. interno
__DATE__ Data
__DATE_DELIVERY__ Data di consegna
__HT__ Importo esente IVA
__TTC__ Importo totale
__TVA__ Importo IVA

Il è anche possibile riprendere le intestazioni dei campi personalizzati secondo questa sintassi: (doppio trattino basso) CODICE DEL CAMPO PERSONALIZZATO IN MAIUSCOLO (doppio trattino basso), esempio: __CODICE-MIO-CAMPO-PERSONALIZZATO__

Proposta commerciale

__SOCNAME__ Nome del cliente
__PROPREF__ Rif.
__PROPREF_CLIENT__ Rif. cliente
__PROPREF_INTERNE__ Rif. interno
__DATE__ Data
__DATE_DELIVERY__ Data di consegna
__HT__ Importo esente IVA
__TTC__ Importo totale
__TVA__ Importo IVA

Il è anche possibile riprendere le intestazioni dei campi personalizzati secondo questa sintassi: (doppio trattino basso) CODICE DEL CAMPO PERSONALIZZATO IN MAIUSCOLO (doppio trattino basso), esempio: __CODICE-MIO-CAMPO-PERSONALIZZATO__

Richiesta di preventivo al fornitore

__SOCNAME__ Nome del fornitore
__SUPPLIERPROPOSALREF__ Rif.
__ORDERREF_SUPPLIER__ Rif. forn.
__DATE__ Data fattura
__DATE_DELIVERY__ Data consegna
__HT__ Importo esente IVA
__TTC__ Importo IVA inclusa
__TVA__ Importo IVA

Il è anche possibile riprendere le intestazioni dei campi personalizzati secondo questa sintassi: (doppio trattino basso) CODICE DEL CAMPO PERSONALIZZATO IN MAIUSCOLO (doppio trattino basso), esempio: __CODICE-MONO-CAMPO-PERSONALIZZATO__

Ordine al Fornitore

__SOCNAME__ Nome del fornitore
__ORDERREF__ Rif.
__ORDERREF_SUPPLIER__ Rif. forn.
__DATE__ Data
__DATE_DELIVERY__ Data consegna
__HT__ Importo esente IVA
__TTC__ Importo IVA inclusa
__TVA__ Importo IVA

Il è anche possibile riprendere le intestazioni dei campi personalizzati secondo questa sintassi: (doppio trattino basso) CODICE DEL CAMPO PERSONALIZZATO IN MAIUSCOLO (doppio trattino basso), esempio: __CODICE-MONO-CAMPO-PERSONALIZZATO__

Fattura del Fornitore

__TTC__Importo IVA inclusa

__FACREF__ Rif.
__FACREF_SUPPLIER__ Rif. forn.
__DATE__ Data
__DATE_LIMIT__ Data di scadenza
__HT__ Importo esente IVA
__TVA__ Importo IVA

Il è anche possibile riprendere le intestazioni dei campi personalizzati secondo questa sintassi: (doppio trattino basso) CODICE DEL CAMPO PERSONALIZZATO IN MAIUSCOLO (doppio trattino basso), esempio: __CODICE-MONO-CAMPO-PERSONALIZZATO__

Opportunità di Vendita (Lead)

Dall’invio di un’email dalla scheda del cliente o fornitore tramite un messaggio personalizzato contenente queste variabili nell’oggetto o nel corpo del messaggio.

__TIERS__ Nome del cliente/fornitore
__TEL__ Telefono
__MAIL__ Email
__ADRESSE__ Indirizzo
__CP__ Codice postale
__VILLE__ Città
__CODE_CLIENT__ Codice cliente
__REF__ Rif. opportunità
__DATE_CLOTURE__ Data
__HT__ Preventivo IVA esclusa

È inoltre possibile utilizzare le etichette dei campi personalizzati con questa sintassi: (doppio trattino basso) CODICE DEL CAMPO PERSONALIZZATO IN MAIUSCOLO (doppio trattino basso), esempio: __CODICE-DEL-MIO-CAMPO-PERSONALIZZATO__

Cliente/Fornitore

Dall’invio di un’email dalla scheda del cliente o fornitore tramite un messaggio personalizzato contenente queste variabili nell’oggetto o nel corpo del messaggio.

__TIERS__ Nome del cliente/fornitore
__TEL__ Telefono
__MAIL__ Email
__ADRESSE__ Indirizzo
__CP__ Codice postale
__VILLE__ Città
__CODE_CLIENT__ Codice cliente

È inoltre possibile utilizzare le etichette dei campi personalizzati con questa sintassi: (doppio trattino basso) CODICE DEL CAMPO PERSONALIZZATO IN MAIUSCOLO (doppio trattino basso), esempio: __CODICE-DEL-MIO-CAMPO-PERSONALIZZATO__

Variabili di Tipo 2

Nota: le variabili vengono regolarmente aggiunte, questa lista potrebbe non essere esaustiva. Contattarci tramite ticket se manca un elemento per il vostro modello.

Utilizzo in:

Le informazioni relative all’azienda

Una lista di tag:

mycompany_logo : Il logo della Sua azienda
mycompany_name : Il nome della Sua azienda
mycompany_address : L’indirizzo della Sua azienda
mycompany_zip : Il CAP della Sua azienda
mycompany_town : La città della Sua azienda
mycompany_country : Il Paese della Sua azienda (nome)
mycompany_country_code : Il Paese della Sua azienda (codice: FR, US, IT…)
mycompany_state : La regione della Sua azienda (nome)
mycompany_state_code : La regione della Sua azienda (codice)
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 : La partita IVA della Sua azienda
mycompany_note : Una nota sulla Sua azienda

Campi personalizzati: Nessuno

Informazioni sul cliente o fornitore

  • Modelli di lettere in formato Word con Dolibarr: inserire i tag tra ${}.
  • Modelli di lettere in formato ODT / ODS con Dolibarr: inserire i tag tra {}.

Una lista di tag:

company_name : Nome dell’azienda cliente o fornitore
company_address
company_zip
company_town
company_country : Paese dell’azienda cliente o fornitore (nome)
company_country_code : Paese dell’azienda cliente o fornitore (codice: FR, US, IT…)
company_state
company_state_code
company_phone
company_fax
company_email
company_web
company_barcode
company_customercode : Codice cliente dell’azienda
company_suppliercode : Codice fornitore dell’azienda
company_customeraccountancycode : Codice contabile cliente dell’azienda
company_supplieraccountancycode : Codice contabile fornitore dell’azienda
company_capital
company_juridicalstatus
company_idprof1
company_idprof2
company_idprof3
company_idprof4
company_idprof5
company_idprof6
company_vatnumber : Partita IVA dell’azienda cliente o fornitore
company_note_public : Nota pubblica sull’azienda cliente o fornitore

company_note

company_default_bank_iban

Campi personalizzati: company_code-de-mon-champ-personnalisé

Informazioni sull’utente

  • Modelli di lettere in formato Word con Dolibarr: inserire i tag tra ${}.
  • Modelli di lettere in formato ODT / ODS con Dolibarr: inserire i tag tra {}.

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
Campi personalizzati: myuser_code-de-mon-champ-personnalisé

Altre informazioni

  • Modelli di lettere in formato Word con Dolibarr: inserire i tag tra ${}.
  • Modelli di lettere in formato ODT / ODS con Dolibarr: inserire i tag tra {}.

current_date
current_datehour
current_server_date
current_server_datehour
current_date_locale
current_datehour_locale
current_server_date_locale
current_server_datehour_locale

 

Informazioni sull’oggetto (fattura, proposta commerciale, ordine, …)

  • Modelli di lettere in formato Word con Dolibarr: inserire i tag tra ${}.
  • Modelli di lettere in formato ODT / ODS con Dolibarr: inserire i tag tra {}.

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
Importi (dati numerici):
object_total_ht
object_total_vat
object_total_localtax1
object_total_localtax2
object_total_ttc
object_total_discount_ht
object_total_vat_x
Importi (nel formato della lingua di output):
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
Specifico per le proposte:
object_date_end
Specifico per gli ordini:
object_date_delivery_planed
Specifico per le fatture:
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
Campi personalizzati: object_code-de-mon-champ-personnalisé

Righe degli oggetti

Ecco come utilizzare le tabelle delle righe degli oggetti (righe di fatture, ordini, ecc.). È necessario creare una tabella nel documento e utilizzare un tag “begin” e “end” per definire la riga della tabella. Questa riga verrà ripetuta quante volte necessario al momento della generazione.

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

Esempio

Descrizione

Aliquota IVA

Prezzo unitario €

Quantità

Sconto

Totale € IVA esclusa

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

{line_vatrate}

{line_up}

{line_qty}

{line_discount_percent}

{line_price_ht}

[!– END row.lines –]

Successivamente, aggiungere i tag di Sua scelta tra le righe tra questi:

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

Speciale Progetti e Attività

Progetto {object_ref} del {object_datec}

Descrizione: {object_description}

Nota privata: {object_note_private}

Nota pubblica: {object_note_public}

Per le Attività

Descrizione Ref Etichetta

Inizio

 Prev. Avanzamento
[!– 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