# Konfiguracja

## Aktywacja subskrypcji

Aby aktywować funkcję subskrypcji dla przedsiębiorstwa, przejdź do Enterprises -> Settings -> [shop preferences](/smaki-wsi-docs/basic-features/enterprise-profile/enterprise-settings.md#shop-preferences).

Na dole strony ustaw Subscriptions na „enabled”.

**Guest orders**: Dla przedsiębiorstw z włączonymi subskrypcjami zalecamy ustawienie „require login to order”. Dzięki temu klienci po zalogowaniu widzą aktywne zamówienia subskrypcyjne, co minimalizuje ryzyko przypadkowego złożenia duplikatu.

**Change orders**: Dla przedsiębiorstw z subskrypcjami opcje tej sekcji wpływają na klienta w następujący sposób:

* *Placed orders cannot be changed/cancelled:* Klient musi *skontaktować się z Tobą*, aby zmienić bieżące zamówienie subskrypcyjne (np. zmienić ilości produktów lub anulować zamówienie na dany tydzień), ponieważ nie może edytować zamówień samodzielnie.
* *Customers can change/cancel orders while order cycle is open:* Klient może samodzielnie zmieniać ilości produktów i/lub anulować zamówienie na dany tydzień bez kontaktu z Tobą.

Pamiętaj, że to ustawienie dotyczy wszystkich zamówień, więc więcej informacji o „change orders” znajdziesz [tutaj](https://guide.openfoodnetwork.org/basic-features/enterprise-profile/enterprise-settings#shop-preferences). Zwykle zalecamy „placed orders cannot be changed/cancelled”.

{% hint style="info" %}
Uwaga: nowe pozycje nie mogą być dodawane do zamówień subskrypcyjnych w trakcie otwartego cyklu — ani przez Ciebie, ani przez klienta. Jeśli klient chce kupić produkt, którego nie ma w stałym zamówieniu, musi złożyć drugie zamówienie i przejść standardowy checkout.
{% endhint %}

## Metody dostawy i płatności dla subskrypcji

Podczas tworzenia subskrypcji klienta musisz wybrać, jaką metodę dostawy i płatności będzie używać. Wybrane opcje będą dotyczyć wszystkich kolejnych zamówień subskrypcyjnych.

### **Metody dostawy**

Do subskrypcji możesz przypisać dowolną [metodę dostawy/odbioru](/smaki-wsi-docs/basic-features/shopfront/shipping-methods.md).

### **Metody płatności**

Do subskrypcji możesz przypisać tylko dwa typy [metod płatności](/smaki-wsi-docs/basic-features/shopfront/payment-methods.md):

1. **Metody płatności ręczne:** gotówka, czek, przelew bankowy (czyli metody bez automatycznej weryfikacji online przez Smaki Wsi).
2. **Stripe:** bramka płatnicza przyjmująca płatności kartą. Instrukcje konfiguracji Stripe znajdziesz [tutaj](/smaki-wsi-docs/basic-features/shopfront/payment-methods.md#integrated-payment-providers).

{% hint style="info" %}
Przy każdym automatycznie złożonym zamówieniu subskrypcyjnym karta klienta zostanie obciążona (po zamknięciu powiązanego cyklu zamówień). Kwota będzie uwzględniać wszystkie zmiany wprowadzone przez Ciebie lub klienta. Klient nie zostanie obciążony, jeśli anuluje zamówienie subskrypcyjne.
{% endhint %}

{% hint style="warning" %}
Aby poprawnie obciążyć klienta, musi on mieć konto na platformie Smaki Wsi. Na swoim koncie musi dodać domyślną kartę płatniczą i udzielić Twojemu przedsiębiorstwu zgody na obciążanie tej karty. Więcej informacji [tutaj](/smaki-wsi-docs/basic-features/subscriptions/subscriptions-the-customers-perspective.md#saving-credit-cards-and-authorising-charges).
{% endhint %}

{% hint style="success" %}
Jeśli używasz Stripe jako metody płatności dla subskrypcji, warto dodać jasne, szczegółowe wyjaśnienie sposobu naliczania opłat.\
\
Na przykład zamiast nazywać metodę [płatności](/smaki-wsi-docs/basic-features/shopfront/payment-methods.md) „Credit card”, możesz nazwać ją „automatyczne obciążanie karty dla subskrypcji”. Opis może brzmieć: „Domyślna karta zapisana na Twoim koncie Smaki Wsi zostanie obciążona po potwierdzeniu zamówienia subskrypcyjnego w środę wieczorem”. Nazwa i opis pojawią się w e-mailu potwierdzającym dla klienta, więc warto je doprecyzować.
{% endhint %}

## Zbieranie informacji od klientów

Aby skonfigurować subskrypcję dla klienta, potrzebujesz następujących informacji:

**Imię i nazwisko**, **numer telefonu** i **adres e-mail:** Pamiętaj, że klient, który chce mieć automatyczne zamówienie subskrypcyjne, MUSI mieć zarejestrowane i potwierdzone konto w Smaki Wsi. Klienci z subskrypcjami muszą być na Twojej liście [Customers](/smaki-wsi-docs/basic-features/shopfront/customer-management-and-conditional-displays-prices/customers.md). Zobacz [poniżej](#add-your-subscribers-to-your-customer-list).

**Adres rozliczeniowy i dostawy**

**Produkty:** Które produkty klient chce włączyć do subskrypcji?

**Metoda dostawy/odbioru:** Jak klient chce otrzymywać produkty?

**Metoda płatności:** Klienci mogą wybrać jedną z Twoich ręcznych metod płatności (np. gotówka, przelew) lub płatność kartą przez Stripe. Jeśli klient chce płacić Stripe, musi dodać domyślną kartę i udzielić zgody. Zobacz [tutaj](/smaki-wsi-docs/basic-features/subscriptions/subscriptions-the-customers-perspective.md#saving-credit-cards-and-authorising-charges).

**Daty rozpoczęcia i zakończenia subskrypcji:** Aby zamówienie subskrypcyjne zostało utworzone dla danego cyklu, data startu musi być przed lub po dacie otwarcia cyklu, a data końca musi być po dacie zamknięcia cyklu.

## Dodaj subskrybentów do listy klientów

Zanim utworzysz subskrypcję dla klienta, musi on zostać dodany do Twojej [listy Customers](/smaki-wsi-docs/basic-features/shopfront/customer-management-and-conditional-displays-prices/customers.md).

**Po dodaniu klientów do listy wyślij im e-mail** i poproś o [założenie konta w Smaki Wsi](/smaki-wsi-docs/basic-features/subscriptions/subscriptions-the-customers-perspective.md#signing-up-to-ofn). Jeśli planujesz obciążać klientów przez Stripe, poproś ich także o wykonanie dodatkowych kroków [tutaj](/smaki-wsi-docs/basic-features/subscriptions/subscriptions-the-customers-perspective.md#saving-credit-cards-and-authorising-charges), aby dodać domyślną kartę i udzielić zgody na obciążenia.

{% hint style="info" %}
Możesz dodać klientów do listy przed lub po tym, jak założą konto Smaki Wsi. Jednak zanim subskrypcja zostanie poprawnie utworzona, klient musi potwierdzić adres e-mail powiązany z kontem.
{% endhint %}

{% hint style="warning" %}
Jeśli chcesz obciążać klienta Stripe, musi on zostać dodany do [listy Customers](/smaki-wsi-docs/basic-features/shopfront/customer-management-and-conditional-displays-prices/customers.md) ZANIM będzie mógł [udzielić zgody na płatności](/smaki-wsi-docs/basic-features/subscriptions/subscriptions-the-customers-perspective.md#saving-credit-cards-and-authorising-charges) z jego karty.\
Dlatego zalecamy następującą procedurę:

1. Skontaktuj się z klientem i zbierz wszystkie potrzebne informacje (zobacz [powyżej](#gather-information-from-your-customers)).
2. Dodaj go do [listy Customers](/smaki-wsi-docs/basic-features/shopfront/customer-management-and-conditional-displays-prices/customers.md).
3. Wyślij e-mail do klienta z prośbą o [rejestrację w Smaki Wsi](/smaki-wsi-docs/basic-features/subscriptions/subscriptions-the-customers-perspective.md#signing-up-to-ofn) oraz [dodanie danych karty](/smaki-wsi-docs/basic-features/subscriptions/subscriptions-the-customers-perspective.md#saving-credit-cards-and-authorising-charges).
4. [Utwórz subskrypcję](/smaki-wsi-docs/basic-features/subscriptions/subscriptions-creating-and-managing-orders.md).
   {% endhint %}

## Harmonogramy

{% hint style="info" %}
Jeśli dopiero zaczynasz ze Smaki Wsi, zachęcamy do zapoznania się z konfiguracją [cykli zamówień](/smaki-wsi-docs/basic-features/shopfront/order-cycle.md) przed ustawieniem harmonogramów i subskrypcji.
{% endhint %}

### O harmonogramach

Subskrypcje działają tak, że za każdym razem, gdy przedsiębiorstwo otwiera cykl zamówień, dla klientów z subskrypcją mogą zostać automatycznie wygenerowane zamówienia. Częstotliwość, z jaką zamówienie subskrypcyjne jest składane dla klienta (czyli które z aktywnych cykli uruchamiają subskrypcję), kontroluje funkcja **Schedules**.

Harmonogramy to grupy, do których można przypisywać cykle zamówień. Po utworzeniu harmonogramu subskrypcje klientów są do niego przypisywane, a zamówienia będą generowane tylko dla nowych cykli w tym harmonogramie.

{% hint style="info" %}
Możesz mieć klientów, którzy chcą zamówienia co tydzień — wtedy dodajesz ich subskrypcje do harmonogramu, który obejmuje wszystkie tygodniowe cykle. Dla klientów chcących zamówienia co dwa tygodnie lub co miesiąc możesz utworzyć dodatkowe harmonogramy obejmujące tylko co drugi lub co czwarty cykl.
{% endhint %}

{% hint style="success" %}
To rozwiązanie daje dużo elastyczności, więc warto eksperymentować, aby znaleźć kombinację cykli i harmonogramów najlepiej pasującą do Twojego przedsiębiorstwa. Przykłady: „odd week” i „even week”, „wholesale”, „monthly meat” itd.
{% endhint %}

### Tworzenie harmonogramu

Po wykonaniu powyższych kroków, przycisk **+New Schedule** pojawi się u góry menu Order Cycles:

{% hint style="warning" %}
Musisz mieć co najmniej jeden otwarty cykl lub cykl, który ma się otworzyć, aby móc utworzyć nowy harmonogram.
{% endhint %}

**Name:** Nadaj harmonogramowi logiczną nazwę opisującą grupę cykli zamówień, np. „weekly”, „monthly”, „Tuesday Deliveries”, „wholesale” lub „retail”. Ta nazwa nie jest widoczna dla klientów.

{% hint style="info" %}
Jeśli zarządzasz kilkoma przedsiębiorstwami Smaki Wsi z włączonymi subskrypcjami, jasne nazewnictwo harmonogramów jest kluczowe, np. weekly\_hubA, weekly\_hubB, fortnightly\_hubA, fortnightly\_hubB.\
Każde przedsiębiorstwo potrzebuje osobnego harmonogramu, ale podczas tworzenia subskrypcji dla klienta będą widoczne harmonogramy wszystkich Twoich przedsiębiorstw. Opisowa nazwa pomoże utworzyć subskrypcję dla właściwego przedsiębiorstwa.
{% endhint %}

Możesz dodawać cykle zamówień do harmonogramu lub je usuwać, klikając przyciski < i >.

Kliknij **create**, gdy skończysz.

### Edycja lub usuwanie harmonogramu

Aby edytować lub usunąć harmonogram, kliknij jego nazwę obok odpowiedniego cyklu zamówień w kolumnie „schedules”. (Kolumna „Schedules” może wymagać włączenia w menu kolumn u góry po prawej.)

Możesz zmienić nazwę harmonogramu, dodać/usunąć cykle lub usunąć harmonogram.

{% hint style="danger" %}
Nie możesz usunąć harmonogramu, jeśli są do niego przypisane subskrypcje.
{% endhint %}

### Dodawanie lub usuwanie cykli z harmonogramów

Możesz dodawać lub usuwać cykle z harmonogramów, edytując harmonogram ([powyżej](#edit-or-delete-a-schedule)) albo edytując cykl zamówień i dodając/usuwając harmonogram w polu „schedules”:

{% hint style="success" %}
Cykle zamówień mogą należeć do więcej niż jednego harmonogramu. Na przykład jeśli Twoje cykle są tygodniowe, ale masz trzy harmonogramy (weekly, fortnightly-odd weeks i fortnightly-even weeks), jeden cykl może należeć zarówno do „weekly”, jak i „fortnightly-odd”.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://smaki-wsi.gitbook.io/smaki-wsi-docs/basic-features/subscriptions/subscriptions-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
