Interface
Transactions liées : déclarer le montant TTC
Afficher le montant HT et le montant TTC sur les cartes des transactions liées d'un formulaire, avec la clé timeline_amount_with_tax.
Transactions liées : déclarer le montant TTC
Le bloc Transactions liées de la barre latérale d'un formulaire affiche une carte par transaction. Pour le comportement côté utilisateur, voir Frise chronologique de l'activité.
Configuration
Les transactions liées sont décrites par une configuration par type de document, enregistrée dans frappe.ui.document_timeline_settings. En plus de timeline_amount (champ du montant principal), une entrée de configuration accepte timeline_amount_with_tax : le nom du champ qui contient le montant TTC.
- Le serveur (
frappe.utils.document_timeline.get_document_timeline) lit ce champ avec les autres champs de la configuration et renseigneamount_with_taxsur les transactions du type concerné. Le champ doit exister sur le type de document, sinon il est ignoré. - Sans la clé, ou avec une valeur vide, la carte n'affiche qu'un montant.
- Dans Dokos v5, les configurations standard des transactions (ventes, achats, paiements) ne déclarent pas
timeline_amount_with_tax: leurs cartes affichent un seul montant. - Les cartes produites par
frappe.ui.document_timeline.render_card, par exemple celles de la fenêtre contextuelle d'un événement du calendrier, utilisent le même rendu : une entrée qui fournitamount_with_taxaffiche aussi les deux montants.
Exemple fictif d'entrée de configuration, avec des champs existants d'une facture de vente :
frappe.provide("frappe.ui.document_timeline_settings");
frappe.ui.document_timeline_settings["Sales Invoice"] = [
{
doctype: "Sales Invoice",
fields: ["currency"],
timeline_date: "posting_date",
timeline_amount: "net_total",
timeline_amount_with_tax: "grand_total",
},
];