---
title: "Dodawanie lub edycja szablonu dokumentu"
description: "Zbuduj dokument najmu do druku: nadaj mu nazwę, rozplanuj treść i wstaw zmienne rezerwacji, klienta, tabeli pozycji i organizacji."
canonical_url: "https://requiply.com/docs/pl/guides/automations/export-templates/add-or-edit"
---
# Dodawanie lub edycja szablonu dokumentu

> Zbuduj dokument najmu do druku: nadaj mu nazwę, rozplanuj treść i wstaw zmienne rezerwacji, klienta, tabeli pozycji i organizacji.

Na tej stronie budujesz dokument rezerwacji do druku: nazwę, pod którą się pojawia, i treść HTML, którą Requiply przy eksporcie wypełnia danymi rezerwacji.

Przejdź do **Ustawienia → Rezerwacje → Szablony dokumentów** i kliknij **Utwórz szablon**, przycisk na pustej liście lub **ikonę ołówka** na karcie szablonu.

<warning>

**Tylko dla administratorów.** Tylko administratorzy organizacji mogą dodawać, edytować i usuwać szablony dokumentów. Pozostali użytkownicy są przekierowywani na ekran braku dostępu.

</warning>

Ekran ma dwie części: edytowalne pola po lewej i przyklejony **Podgląd na żywo** po prawej, który pokazuje dokument jako wydrukowaną stronę z podstawionymi przykładowymi danymi rezerwacji.

<figure>

![Edytor szablonu dokumentu z nazwą szablonu i treścią HTML po lewej oraz podglądem wygenerowanego dokumentu po prawej](https://requiply.com/docs/assets/settings/bookings/export-templates/add-form.png)<figcaption>

Szczegóły szablonu po lewej, podgląd na żywo po prawej: podgląd pokazuje dokument jako wydrukowaną stronę z przykładowymi danymi rezerwacji.

</figcaption>
</figure>

## Dodawanie a edycja

<table>
<thead>
  <tr>
    <th>
      Tryb
    </th>
    
    <th>
      Co się dzieje
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Dodawanie
      </strong>
    </td>
    
    <td>
      Tworzy nowy szablon. Edytor treści startuje w trybie <strong>
        HTML
      </strong>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Edycja
      </strong>
    </td>
    
    <td>
      Wczytuje zapisaną nazwę i treść, wybiera tryb edytora pasujący do zapisanej treści i pokazuje akcję <strong>
        Usuń
      </strong>
      
      .
    </td>
  </tr>
</tbody>
</table>

Podczas zapisywania nakładka na cały ekran blokuje formularz, żeby szablonu nie dało się wysłać dwa razy. Na stronie edycji formularz pojawia się dopiero po wczytaniu szablonu; jeśli nie da się go wczytać, Requiply pokazuje powiadomienie o błędzie i wraca do strony [Własne szablony dokumentów](https://requiply.com/docs/pl/guides/automations/export-templates).

## Szczegóły szablonu

Nad polami widać podpowiedź: *Kliknij zmienną, aby dodać ją do edytowanego pola.*

### Nazwa szablonu

Wyświetlana nazwa dokumentu.

- Wymagana
- Od 1 do 50 znaków
- Służy jako tytuł karty na liście, etykieta w oknie **Eksportuj** rezerwacji i nazwa pobieranego pliku
- Gdy jej brakuje, pojawia się komunikat **Nazwa jest wymagana**, a po przekroczeniu limitu **Nazwa musi mieć mniej niż 50 znaków**

Pracownicy wybierają tę nazwę w oknie eksportu, więc użyj takiej, którą rozpoznają nawet w pośpiechu: `Umowa najmu`, `Protokół wydania`, `Lista pakowania`.

### Treść dokumentu

Treść dokumentu w HTML.

- Bez walidacji długości
- Edytor z dwoma trybami, przełączanymi przełącznikiem **Edytor tekstu / HTML**
- Tryb **Edytor tekstu** to edytor Quill z pogrubieniem, kursywą, podkreśleniem, listą numerowaną, listą punktowaną, linkiem i blokiem kodu
- Tryb **HTML** to pole tekstowe z czcionką o stałej szerokości, które samo dopasowuje wysokość, do pełnych dokumentów i wklejonego kodu

Podpowiedź brzmi: *Tryb HTML sprawdza się w pełnych dokumentach, takich jak umowy. Edytor tekstu wystarczy do prostych stron.*

<tip>

**Wskazówka:** Umowy i protokoły twórz w trybie **HTML**. Edytor tekstu porządkuje kod, którego nie rozpoznaje, a to spłaszcza starannie zbudowaną tabelę lub blok podpisów.

</tip>

### Wstawianie zmiennych

Lista **Wstaw zmienną** znajduje się obok etykiety treści. Można ją przeszukiwać (wpisz część etykiety, tokenu lub klucza, aby zawęzić wyniki), a każda opcja pokazuje czytelną etykietę nad samym tokenem.

Lista zawiera wszystkie wbudowane zmienne rezerwacji, klienta i organizacji oraz po jednej pozycji na każde pole dodatkowe skonfigurowane na poziomie **Klient**, **Rezerwacja** lub **Organizacja**, opisane poziomem (np. `Numer paszportu (Klient)`). Są na niej też zmienne dni najmu, sum pozycji, sum sprzedanych towarów i logo: `{{bookingDays}}`, `{{bookingItemsQuantity}}`, `{{bookingItemsTotal}}`, `{{bookingItemsFullPriceTotal}}`, **Suma sprzedanych towarów** `{{bookingSaleTotal}}`, **Suma rezerwacji bez sprzedanych towarów** `{{bookingRentTotal}}` oraz `{{organizationLogoUrl}}`. Pełna lista jest opisana na stronie [Własne szablony dokumentów](https://requiply.com/docs/pl/guides/automations/export-templates).

Sum liczbowego pola pozycji lub egzemplarza, takich jak `{{groupFieldTotal_weight_kg}}` dla łącznej wagi, nie ma na liście. Wpisz je ręcznie, zobacz [Sumy pól pozycji i egzemplarzy](https://requiply.com/docs/pl/guides/automations/export-templates#sumy-p%C3%B3l-pozycji-i-egzemplarzy).

Sposób wstawiania tokenu zależy od trybu edytora:

- W trybie **HTML** token jest dodawany w nowym wierszu.
- W trybie **Edytor tekstu** prosty token jest dodawany jako osobny akapit; zmienne tabel `{{bookingItems}}` i `{{bookingServices}}` są dodawane po pustym akapicie, żeby tabela stała w osobnym wierszu.

Tokeny są dodawane na końcu treści. Aby je przenieść, edytuj treść bezpośrednio.

#### Zmienne tabel przyjmują listę kolumn

`{{bookingItems}}`, `{{bookingServices}}` i `{{bookingSaleItems}}` przyjmują opcjonalną listę kolumn w nawiasach kwadratowych, więc jeden szablon może drukować krótkie podsumowanie dla klienta, a inny pełny protokół wydania:

```text
{{bookingItems[index, name, serial, qty, price, total]}}
{{bookingItems[index, sku, name, qty, blank:Condition, blank:Signature]}}
{{bookingItems[index, image:Photo, name:Equipment, qty, full_price_total, total, totals]}}
```

Lista wstawia sam token; listę w nawiasach wpisz samodzielnie. Wszystkie dostępne kolumny, w tym zdjęcie pozycji `image`, `full_price_total`, pola dodatkowe egzemplarzy i pozycji oraz kolumna do ręcznego wypełnienia `blank:Label`, są opisane w części [Wybór kolumn tabeli](https://requiply.com/docs/pl/guides/automations/export-templates#wyb%C3%B3r-kolumn-tabeli). Lista kolumn potrafi jeszcze trzy rzeczy:

- **Własny nagłówek.** Wpisz go po nazwie kolumny po dwukropku, np. `name:Equipment` lub `qty:Units`. Nagłówek nie może zawierać przecinka ani `]`. Zobacz [Własne nagłówki kolumn](https://requiply.com/docs/pl/guides/automations/export-templates#w%C5%82asne-nag%C5%82%C3%B3wki-kolumn).
- **Wiersz sumy.** Dodaj `totals`, a tabela zakończy się wierszem *Razem:*, który sumuje ilość, kaucje, łączne ceny zakupu, wartości wierszy i kolumny liczbowych pól dodatkowych. Zobacz [Wiersz sumy](https://requiply.com/docs/pl/guides/automations/export-templates#wiersz-sumy).
- **Zdjęcia.** `image` drukuje domyślne zdjęcie każdej pozycji jako miniaturę i jest pomijane, gdy żadna pozycja w rezerwacji nie ma zdjęcia.

**Podgląd na żywo** pokazuje wybrane kolumny, nagłówki i wiersz sumy z przykładowymi danymi, więc kształt tabeli widać jeszcze przed zapisaniem.

#### Sprzedane towary

Gdy [Sprzedaż](https://requiply.com/docs/pl/guides/sales) jest włączona, `{{bookingSaleItems}}` drukuje towary sprzedane w rezerwacji, np. karty pamięci lub akumulatory, po odjęciu zwrotów, a `{{bookingSaleTotal}}` drukuje ich sumę, która jest już częścią `{{bookingTotal}}`. W rezerwacji bez sprzedanych towarów obie nic nie drukują, więc jeden szablon działa dla każdej rezerwacji. `{{bookingRentTotal}}` drukuje sumę rezerwacji bez sprzedanych towarów (najem, usługi, rabaty i korekty), więc podsumowanie może pokazać najem, towary i kwotę do zapłaty w osobnych wierszach. W podglądzie na żywo widać przykładowe kwoty 525 i 250 w Twojej walucie. Kolumny są opisane w części [Kolumny tabeli sprzedanych towarów](https://requiply.com/docs/pl/guides/automations/export-templates#kolumny-tabeli-sprzedanych-towar%C3%B3w).

<figure>

![Szablon Equipment Handover Act w edytorze szablonu dokumentu w trybie ciemnym, z rozwiniętą listą Wstaw zmienną nad treścią dokumentu HTML i słowem sold wpisanym w wyszukiwarkę. Ramka 1 oznacza opcję Suma sprzedanych towarów z tokenem {{bookingSaleTotal}} pod spodem. Ramka 2 oznacza opcję Suma rezerwacji bez sprzedanych towarów z tokenem {{bookingRentTotal}}. Po prawej podgląd protokołu na żywo](https://requiply.com/docs/assets/settings/bookings/export-templates/insert-variable-sold-totals.png)<figcaption>

Wyszukaj na liście **Wstaw zmienną** frazę *sprzedanych*: **1** suma sprzedanych towarów, **2** suma rezerwacji bez nich.

</figcaption>
</figure>

### Pomoc AI

Pod etykietą treści znajdują się cztery przyciski:

<table>
<thead>
  <tr>
    <th>
      Przycisk
    </th>
    
    <th>
      Co robi
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Utwórz z Asystentem Requiply
      </strong>
    </td>
    
    <td>
      Otwiera wbudowanego <a href="https://requiply.com/docs/pl/ai/requiply-assistant">
        Asystenta Requiply
      </a>
      
       w trybie <strong>
        Projektant dokumentów
      </strong>
      
      , który zna już zmienne tej strony i bieżący szkic. Wygenerowane przez niego dokumenty można zastosować bezpośrednio w edytorze.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Otwórz prompt w ChatGPT
      </strong>
    </td>
    
    <td>
      Otwiera ChatGPT w nowej karcie z promptem, który objaśnia wszystkie dostępne zmienne.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Otwórz prompt w Claude
      </strong>
    </td>
    
    <td>
      Otwiera Claude w nowej karcie z tym samym promptem.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Kopiuj prompt AI
      </strong>
    </td>
    
    <td>
      Kopiuje ten prompt do schowka, do użycia w dowolnym innym narzędziu.
    </td>
  </tr>
</tbody>
</table>

Tylko pierwszy przycisk zapisuje wynik w formularzu. Gdy asystent przygotuje dokument, jego karta podglądu ma przycisk **Zastosuj w edytorze**, który zastępuje nazwę i treść szablonu oraz przełącza edytor w tryb **HTML**. Opcje zewnętrzne wymagają skopiowania i wklejenia wyniku.

<figure>

![Pasek narzędzi treści dokumentu z przełącznikiem Edytor tekstu i HTML, listą Wstaw zmienną i czterema przyciskami AI](https://requiply.com/docs/assets/settings/bookings/export-templates/ai-actions.png)<figcaption>

Cztery przyciski AI od lewej do prawej: Asystent Requiply, ChatGPT, Claude i kopiowanie promptu.

</figcaption>
</figure>

## Podgląd na żywo

Karta podglądu po prawej jest przyklejona na szerokich ekranach i pokazuje treść na białym arkuszu w kształcie strony, żeby można było ocenić wydruk.

Przykładowe wartości powstają z:

- Bieżącego języka interfejsu
- Waluty, nazwy, adresu e-mail i telefonu organizacji
- Wbudowanego, stałego zestawu przykładowych danych rezerwacji: klienta, dat, sum, pozycji i usług. Przykładowa rezerwacja trwa 3 dni i obejmuje 3 egzemplarze, a każda przykładowa pozycja ma w kolumnie `image` szary obraz zastępczy
- Przykładowej wartości dopasowanej do typu każdego pola dodatkowego (np. `123` dla pola liczbowego, `Tak` dla pola wyboru)
- Dla `{{groupFieldTotal_…}}` i `{{itemFieldTotal_…}}`: przykładowej wartości pola razy 3 przykładowe egzemplarze

`{{organizationLogoUrl}}` jest w podglądzie puste, więc logo umieszczone w `{{#if organizationLogoUrl}}` się tam nie pokazuje. Aby sprawdzić logo, wyeksportuj prawdziwą rezerwację.

Podpowiedź nad podglądem informuje, że korzysta on z przykładowych danych rezerwacji.

Bloki warunkowe `{{#if …}}` są rozwiązywane także w podglądzie, więc blok, którego zmienna nie ma przykładowej wartości, znika dokładnie tak jak w prawdziwym eksporcie.

<note>

Podgląd nigdy nie korzysta z prawdziwej rezerwacji i nigdy nie tworzy pliku PDF. Służy do sprawdzenia układu i pisowni: token z literówką wyświetla się dosłownie jako tekst `{{bookingTotl}}`.

</note>

## Walidacja

- **Nazwa szablonu** jest wymagana i musi mieć od 1 do 50 znaków
- **Treść dokumentu** nie ma walidacji

Błędy pojawiają się pod polem, którego dotyczą.

## Zapisywanie zmian

Kliknij **Zapisz**, aby zapisać szablon.

Po udanym zapisie powiadomienie potwierdza: *Utworzono szablon dokumentu „{name}”* lub *Zaktualizowano szablon dokumentu „{name}”*, a Ty wracasz do strony [Własne szablony dokumentów](https://requiply.com/docs/pl/guides/automations/export-templates). Na stronie edycji zapisywane są tylko pola, które faktycznie zmieniono. Jeśli zapis się nie uda, pojawia się powiadomienie o błędzie, a formularz pozostaje otwarty.

Kliknij **Anuluj**, aby wyjść bez zapisywania.

## Usuwanie szablonu

Strona edycji ma czerwoną akcję **Usuń**. Otwiera ona okno potwierdzenia **Usuń szablon dokumentu** z pytaniem *Na pewno chcesz usunąć „{name}”?*.

Potwierdzenie od razu usuwa szablon: szablony dokumentów nie są używane w automatyzacjach, więc nie trzeba czekać na sprawdzenie powiązań. Powiadomienie potwierdza usunięcie i wracasz do listy. Szablon znika z okna **Eksportuj** rezerwacji w całej organizacji.

## Typowe scenariusze

### Umowa najmu od zera

1. Otwórz **Utwórz szablon** i nazwij szablon `Umowa najmu`.
2. Zostaw edytor w trybie **HTML**.
3. Zbuduj sekcje: strony umowy, okres rezerwacji, sprzęt, opłaty, obowiązki, podpisy.
4. Wstaw `{{organizationName}}`, `{{clientName}}`, `{{bookingStartDateTime}}`, `{{bookingEndDateTime}}` i `{{bookingItems[index, name, serial, qty, price, total]}}`.
5. Umieść akapit o kaucji w `{{#if bookingDeposit}}…{{/if}}`.
6. Sprawdź podgląd, a potem zapisz.

### Pierwszy szkic od asystenta

1. Kliknij **Utwórz z Asystentem Requiply**.
2. Użyj podpowiedzi, np. **Przygotuj umowę najmu**, albo opisz potrzebny dokument.
3. Sprawdź podgląd wydruku, który zwraca asystent.
4. Kliknij **Zastosuj w edytorze**, popraw treść i zapisz.

### Tłumaczenie istniejącego dokumentu

1. Otwórz stronę edycji szablonu.
2. Kliknij **Utwórz z Asystentem Requiply** i poproś o tłumaczenie: asystent ma już Twój bieżący szkic.
3. Zastosuj wynik i zapisz albo zapisz go jako drugi szablon, żeby mieć obie wersje językowe.

## Wskazówki i ostrzeżenia

<tip>

**Wskazówka:** Umieść `{{bookingItems}}` w osobnym wierszu. Sam token rozwija się w tabelę z SKU, nazwą, ilością, ceną i wartością; dodaj listę w nawiasach, np. `{{bookingItems[index, name:Equipment, serial, qty, total, totals]}}`, aby wybrać kolumny, zmienić ich nagłówki i dodać wiersz sumy.

</tip>

<warning>

**Uwaga:** Nie ma historii wersji. Edycja szablonu zmienia wynik każdego przyszłego eksportu, a poprzedniej treści nie da się przywrócić.

</warning>

<warning>

**Uwaga:** Zastosowanie dokumentu wygenerowanego przez asystenta zastępuje zarówno nazwę, jak i całą treść. Przed zastosowaniem skopiuj wszystko, co chcesz zachować.

</warning>


## Sitemap

See the full [sitemap](https://requiply.com/docs/sitemap.md) for all pages.