# Tagi szablonów BaseLinker / Base.com

> **Źródło:** potwierdzona lista operatora (czerwiec 2026).  
> **Powiązane:** [`BASE_TEMPLATES.md`](BASE_TEMPLATES.md) (mapowanie pól apki), [`AUTO-PUBLISH-BL.md`](AUTO-PUBLISH-BL.md) (publikacja Allegro/OLX).

## Zasada ogólna

**Nie ma jednej globalnej listy tagów** wspólnej dla wszystkich szablonów. Dostępne znaczniki zależą od **typu szablonu**:

| Typ szablonu | Gdzie używać tagów |
|--------------|-------------------|
| E-mail / SMS | treść i tytuł wiadomości |
| Wydruk / eksport | odpowiednia **sekcja** szablonu |
| Szablon aukcji / opisu produktu | opis oferty, parametry |

**Pełna i aktualna lista** dla konkretnego szablonu jest widoczna **bezpośrednio w jego edytorze** w panelu Base.com — przed wdrożeniem nowego tagu zawsze sprawdź edytor danego szablonu.

---

## E-mail i SMS

Tagi działają w **treści** oraz **tytule** wiadomości.

### Zamówienie

| Tag | Znaczenie |
|-----|-----------|
| `[numer_zamowienia]` | numer zamówienia |
| `[numer_zamowienia_zrodlo]` | numer zamówienia w źródle, np. Allegro |
| `[link_zamowienia]` | link do strony informacyjnej zamówienia |
| `[laczna cena]` | łączna cena zamówienia |
| `[pole_dodatkowe_1]` | pole dodatkowe 1 z karty zamówienia |
| `[pole_dodatkowe_2]` | pole dodatkowe 2 z karty zamówienia |
| `[aa_ostatni_komunikat_bledu]` | ostatni komunikat błędu z automatycznych akcji |

### Produkty

| Tag | Znaczenie |
|-----|-----------|
| `[lista_przedmiotow]` | lista zamówionych produktów |
| `[lista_przedmiotow2]` | alternatywna lista produktów |
| `[lista_przedmiotow(X)]` | własny format listy przedmiotów |
| `[lista_produktów(x)]` | lista produktów w zamówieniu; zawartość w jednej linii |
| `[items_list(...)]` | lista pozycji z pod-tagami (patrz poniżej) |

Pod-tagi `[items_list(...)]`:

- `[i_name]`
- `[i_sku]`
- `[i_quantity]`
- `[i_price]`
- `[i_currency]`

### Klient

| Tag | Znaczenie |
|-----|-----------|
| `[imie]` | imię klienta |
| `[klient login]` | login klienta |

### Dostawa / przesyłka

| Tag | Znaczenie |
|-----|-----------|
| `[przesylka_link_sledzenia]` | link do śledzenia przesyłki |
| `[przesylka_link_sledzenia_en]` | link do śledzenia (EN) dla wybranych kurierów |
| `[przesylka_zwrotna_nr_nadania]` | numer nadania przesyłki zwrotnej |

### Płatność i dokumenty

| Tag | Znaczenie |
|-----|-----------|
| `[platnosc_link]` | link do płatności |
| `[link_faktura_pdf]` | link do faktury PDF |
| `[link_zwrotu]` | link do formularza zwrotu |

> **Ważne:** w szablonach e-mail **nie działają modyfikatory** takie jak we własnych wydrukach.

---

## Wydruki i eksporty

Wydruki i eksporty działają **sekcjami** — tag trzeba umieszczać w odpowiedniej sekcji.

### Sekcje szablonu

| Sekcja | Rola |
|--------|------|
| `[ROOT]` | sekcja główna, wykonywana raz |
| `[ZAMOWIENIA]` | dane zamówienia, dla każdego zamówienia |
| `[ZAMOWIENIE_POZYCJE]` | dane produktu/pozycji, dla każdej pozycji |
| `[ZAMOWIENIE_PACZKI]` | dane paczki |
| `[NOWA_STRONA]` | wymuszenie nowej strony w PDF |
| `[SPIS_PRODUKTOW]` | grupowanie produktów z wielu zamówień |
| `[STATYSTYKI]` | statystyki; wymaga wcześniejszej sekcji `[ZAMOWIENIA]` |
| `[FAKTURA]` | dane faktury; nie działa dla faktury pro forma |
| `[RECEIPT]` / `[PARAGON]` | dane paragonu |

### Przykładowe tagi w sekcji `[ZAMOWIENIA]`

`[numer_zamowienia]`, `[numer_transakcji]`, `[numer_transakcji2]`, `[data_zakupu]`, `[pochodzenie]`, `[pochodzenie_nazwa]`, `[status_nazwa]`, `[status_nazwa_krotka]`, `[status_nazwa_pelna]`, `[status_data]`, `[wartosc_produktow]`, `[wartosc_calkowita]`, `[waga_calkowita]`, `[waluta]`, `[ilosc_pozycji]`, `[ilosc_pozycji_sku]`, `[ilosc_sztuk_calkowita]`, `[uwagi_kupujacego]`, `[uwagi_sprzedawcy]`, `[pole_dodatkowe_1]`, `[pole_dodatkowe_2]`

### Klient / dostawa / dane do faktury

`[klient_login]`, `[klient_email]`, `[klient_telefon]`, `[dostawa_imie_nazwisko]`, `[dostawa_imie]`, `[dostawa_nazwisko]`, `[dostawa_firma]`, `[dostawa_adres]`, `[dostawa_kod_pocztowy]`, `[dostawa_miasto]`, `[dostawa_kraj]`, `[dostawa_kraj_kod]`, `[dostawa_wojewodztwo]`, `[dostawa_punkt_nazwa]`, `[dostawa_punkt_pni]`, `[dostawa_punkt_adres]`, `[dostawa_punkt_kod_pocz]`, `[dostawa_punkt_miasto]`, `[platnik_imie_nazwisko]`, `[platnik_firma]`, `[platnik_adres]`, `[platnik_kod_pocztowy]`, `[platnik_miasto]`, `[platnik_kraj]`, `[platnik_kraj_kod]`, `[platnik_nip]`, `[platnik_chce_fakture]`

### Płatność, faktura, paragon, wysyłka

`[platnosc_link]`, `[platnosc_nazwa]`, `[platnosc_wplacono]`, `[platnosc_status]`, `[platnosc_pozostalo]`, `[link_do_faktury]`, `[numer_faktury]`, `[numer_faktura_proforma]`, `[numer_korekty]`, `[numery_korekt]`, `[numer_paragonu]`, `[wysylka_nazwa]`, `[wysylka_cena]`, `[wysylka_nr_nadania]`, `[wysylka_kurier_kod]`, `[wysylka_pobranie]`, `[wysylka_pobranie_kwota]`

### Przykładowe tagi w sekcji `[ZAMOWIENIE_POZYCJE]`

`[produkt_id]`, `[produkt_wariant_id]`, `[produkt_nazwa]`, `[produkt_sku]`, `[produkt_ean]`, `[ilosc]`, `[cena_brutto_szt]`, `[cena_brutto_laczna]`, `[cena_netto_szt]`, `[cena_netto_laczna]`, `[cena_vat_szt]`, `[cena_vat_laczna]`, `[stawka_vat]`, `[waga]`, `[atrybuty]`, `[produkt_link]`, `[produkt_lokalizacja]`, `[zdjecie_duze]`, `[zdjecie_srednie]`, `[zdjecie_male]`, `[numer_aukcji]`, `[numer_transakcji_produktu]`, `[produkt_numer_transakcji]`, `[katalog_id]`, `[katalog_nazwa]`, `[magazyn_typ]`, `[magazyn_zrodlowy_nazwa]`, `[katalog=X]` — np. `[katalog=produkt_nazwa]`; tag z sekcji `[PRODUKT]` eksportów magazynu; działa dla produktów z katalogu Base.com

---

## Szablony aukcji / opisy produktu

### Dane podstawowe

| Tag | Znaczenie |
|-----|-----------|
| `[nazwa]` | nazwa produktu |
| `[nazwa_aukcji]` | nazwa aukcji |
| `[nazwa_wariantu]` | nazwa wariantu |
| `[producent]` | producent |
| `[ean]` | EAN |
| `[sku]` | SKU |
| `[id_produktu]` | ID produktu |
| `[cena]` | cena |
| `[kategoria]` | kategoria |

### Opisy (mapowanie API → tag)

| Tag szablonu | Pole API (`text_fields`) |
|--------------|--------------------------|
| `[opis]` | `description` |
| `[opis_dodatkowy1]` | `description_extra1` |
| `[opis_dodatkowy2]` | `description_extra2` |
| `[opis_dodatkowy3]` | `description_extra3` |
| `[opis_dodatkowy4]` | `description_extra4` |
| `[pole dodatkowe_1234_X]` | pole dodatkowe magazynu (numer pola w tagu) |

> **Uwaga:** lista tagów zależy od typu szablonu — pełna lista dla danego szablonu jest w edytorze panelu. Na koncie Dywanowy Bazar (szablon *SZABLON Prawidłowy*) potwierdzone są wszystkie cztery tagi `[opis_dodatkowy1]`…`[4]`.

### Cechy i parametry

| Tag | Znaczenie |
|-----|-----------|
| `[cechy_lista]` | lista cech |
| `[cechy_lista-kolor-rozmiar]` | lista cech z wykluczeniami |
| `[cecha\|X]` | konkretna cecha, np. `[cecha\|długość]` |
| `[cecha_i_nazwa\|X]` | cecha z nazwą parametru, np. `[cecha_i_nazwa\|kolor]` |

### Wymiary i multimedia

`[waga]`, `[wysokosc]`, `[szerokosc]`, `[dlugosc]`, `[obrazek]`, `[dodatkowe_obrazki]`, `[producent_logo]`

### Inne

| Tag | Znaczenie |
|-----|-----------|
| `[przesylkaX]` | cena wybranej wysyłki |

---

## Mapowanie Dywanowy Bazar (apka → BL)

Szczegóły modułowego układu opisów: [`BASE_TEMPLATES.md`](BASE_TEMPLATES.md).

| Pole API | Tag w szablonie aukcji | Rola w apce |
|----------|------------------------|-------------|
| `description` | `[opis]` | Nagłówek zaufania + narracja OLX (składane) |
| `description_extra1` | `[opis_dodatkowy1]` | Pakiet zaufania (kontrola przed wysyłką) |
| `description_extra2` | `[opis_dodatkowy2]` | Pełny opis produktu Base (AI) |
| `description_extra3` | `[opis_dodatkowy3]` | Opis aukcji Allegro (AI) |
| `description_extra4` | `[opis_dodatkowy4]` | Ogłoszenie OLX (AI, plain text) |

### Przykładowy szablon oferty Allegro

```text
[opis_dodatkowy1]
[opis_dodatkowy3]
```

### Przykładowy szablon oferty OLX

Szczegóły, warianty i checklista: [`szablon_olx`](szablon_olx) · PREMIUM: [`szablon_olx_PREMIUM.md`](szablon_olx_PREMIUM.md).

```text
[opis_dodatkowy1]

PARAMETRY
[cechy_lista]

Wymiar: [szerokosc] x [dlugosc] cm
EAN: [ean]

[opis_dodatkowy4]

Dywanowy Bazar · dywanowy-bazar.pl
Wysyłka kurierem. Zapytaj przez OLX — odpowiadamy szybko.
```

Tytuł ogłoszenia: `[nazwa]` (magazyn) lub ręcznie z apki. Opis OLX = **plain text**, bez HTML.

---

*Ostatnia aktualizacja: czerwiec 2026.*