Kroki pakietu

Ta strona opisuje pola w karcie Dodatkowe linie faktury na stronie produktu. Jak zbudować pakiet, wyjaśniono w Ustawianiu dodatkowych linii faktury.

Krok produktuKopiuj link do tej sekcji

Krok produktu Tillor zamienia na zero, jedną lub kilka linii faktury z tym produktem. Bez formuły jest to jedna linia z ustawioną ilością; za pomocą formuły sam decydujesz, czy, ile i jakie linie powstaną.

Krok informacyjnyKopiuj link do tej sekcji

Krok informacyjny to sam tekst, bez produktu i kwoty. Tillor pokazuje go jako linię objaśnienia.

Jeśli krok informacyjny znajduje się pod linią główną, PDF automatycznie dodaje ↳ przed tekstem.

Formuła dla krokuKopiuj link do tej sekcji

Każdy krok może mieć Formułę: TypeScript, tak jak formuła taryfy, który Tillor wykonuje przy zapisie faktury z tym pakietem. Dzięki temu krok może zależeć od klienta, zajęcia miejsca, terenu, liczników lub metod dostępu, na przykład poprzez własne pole, w którym zapisujesz wyjątek.

Co zwraca formułaKopiuj link do tej sekcji

Linia na takiej liście to obiekt z następującymi polami:

Co formuła może czytaćKopiuj link do tej sekcji

Pola czytasz w nawiasach klamrowych, tak jak w automatyzacjach. Menu Zmienna przy polu pokazuje wszystko, co jest dostępne, łącznie z Twoimi własnymi polami.

Listy {meters} i {accessMethods} Tillor ładuje tylko wtedy, gdy formuła z nich korzysta.

PrzykładyKopiuj link do tej sekcji

Pominięcie kroku dla klientów zwolnionych:

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

Jedna linia na każdy licznik energii elektrycznej ICY z włączonym zasilaniem, a dla klientów od 2026 także z wyłączonym:

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}` }));

Pierwszy tag NFC za darmo jako objaśnienie, każdy kolejny według taryfy produktu (dwa kroki z tym samym produktem albo jeden krok, który zwraca oba rodzaje linii):

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}`,
}));

Jedna linia z liczbą psów z własnego pola klienta, bez linii, gdy nie ma psów:

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

Za pomocą Wstaw przykład pod polem dostajesz punkt wyjścia z tymi postaciami w komentarzu.

BłędyKopiuj link do tej sekcji

Formuły, która się nie kompiluje, nie można zapisać; komunikat pod polem mówi, co jest nie tak. Jeśli formuła zawiesza się przy zapisie faktury albo zwraca coś innego niż true, false, liczbę lub poprawne linie, zapis się nie udaje, a komunikat błędu zawiera nazwę kroku, żeby zepsuta formuła nigdy po cichu nie dodała ani nie pominęła linii.

Zobacz teżKopiuj link do tej sekcji