Étapes du bundle

Cette page décrit les champs de la carte Lignes de facture supplémentaires sur la page du produit. La manière de construire un bundle est expliquée dans Configurer des lignes de facture supplémentaires.

Étape de produitCopier le lien vers cette section

Tillor transforme une étape de produit en zéro, une ou plusieurs lignes de facture avec ce produit. Sans formule, il s'agit d'une seule ligne avec la quantité définie ; avec une formule, vous déterminez vous-même si des lignes sont créées, combien et lesquelles.

Étape d'informationCopier le lien vers cette section

Une étape d'information n'est que du texte, sans produit ni montant. Tillor l'affiche comme ligne d'explication.

Lorsqu'une étape d'information se trouve sous une ligne principale, le PDF place automatiquement ↳ devant le texte.

Formule par étapeCopier le lien vers cette section

Chaque étape peut avoir une Formule : du TypeScript, comme la formule de tarif, que Tillor exécute lors de l'enregistrement d'une facture contenant ce bundle. Ainsi, une étape dépend du client, de l'occupation, du terrain, des compteurs ou des méthodes d'accès, par exemple via un champ personnalisé dans lequel vous notez une exception.

Ce que la formule renvoieCopier le lien vers cette section

Une ligne d'une telle liste est un objet avec ces champs :

Ce que la formule peut lireCopier le lien vers cette section

Vous lisez les champs avec des accolades, comme dans les automatisations. Le menu Variable à côté du champ affiche tout ce qui est disponible, y compris vos propres champs.

Tillor ne charge les listes {meters} et {accessMethods} que si la formule les utilise.

ExemplesCopier le lien vers cette section

Ignorer une étape pour les clients exemptés :

if ({customer.customFields.exemptFromSurcharges} === true) return false;
return true;

Une ligne par compteur d'électricité ICY avec alimentation activée, et pour les clients depuis 2026 aussi avec alimentation coupée :

const newCustomer = new Date({customer.createdAt} ?? 0) >= new Date("2026-01-01T00:00:00+01:00");
return {meters}
  .filter((m) => m.provider === "ICY" && m.type === "ELECTRICITY")
  .filter((m) => m.icyMetadata?.switchState === true || newCustomer)
  .map((m) => ({ quantity: 1, description: `Huur digitale elektriciteitsmeter ${m.name}` }));

Le premier badge NFC gratuit comme explication, chacun des suivants au tarif du produit (deux étapes avec le même produit, ou une seule étape qui renvoie les deux sortes de lignes) :

const nfc = {accessMethods}.filter((a) => a.type === "NFC" && a.status === "ACTIVE");
return nfc.map((a, i) => ({
  quantity: i === 0 ? 0 : 1,
  unitPrice: i === 0 ? 0 : undefined,
  accessMethodValue: a.value,
  description: i === 0 ? `Toegangsmethode inclusief: ${a.label}` : `Toeslag extra toegangsmethode: ${a.label}`,
}));

Une ligne avec le nombre de chiens tiré d'un champ personnalisé du client, aucune ligne sans chien :

const dogs = Math.max(0, Math.floor(Number({customer.customFields.animals.dogs}) || 0));
return dogs === 0 ? false : [{ quantity: dogs, description: `Honden (${dogs})` }];

Avec Insérer un exemple sous le champ, vous obtenez un point de départ contenant ces formes en commentaire.

ErreursCopier le lien vers cette section

Vous ne pouvez pas enregistrer une formule qui ne compile pas ; le message sous le champ indique ce qui ne va pas. Si une formule se bloque lors de l'enregistrement d'une facture, ou renvoie autre chose que true, false, un nombre ou des lignes valides, l'enregistrement échoue avec le nom de l'étape dans le message d'erreur, afin qu'une formule défectueuse n'ajoute ou ne supprime jamais une ligne en silence.

Voir aussiCopier le lien vers cette section