> ## Documentation Index
> Fetch the complete documentation index at: https://andcze.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Dostawa treści cyfrowych

> Sprzedawaj klucze licencyjne, pliki i wiadomości — bez pluginu. Kupujący dostaje treść po płatności na stronie zamówienia i w e-mailu.

Produkt nie musi wykonywać komend na serwerze gry. W każdym sklepie — także typu **ogólnego** (`general`, np. licencje, boty Discord, zasoby FiveM, kursy) — możesz sprzedawać treść cyfrową, którą ItemShop wydaje sam, zaraz po opłaceniu zamówienia. Plugin nie jest do tego potrzebny, a zamówienia z treścią cyfrową nie trafiają do jego kolejki.

## Cztery rodzaje dostawy

W formularzu produktu wybierasz **rodzaj dostawy**:

| Rodzaj | Co dostaje kupujący | Co ustawiasz |
| - | - | - |
| **Komendy** (domyślny) | Zakup realizuje plugin na serwerze gry. | Komendy realizacji — [Produkty](https://andcze.mintlify.site/pl/shop/products.md). |
| **Klucze licencyjne** | Jeden klucz z puli na każdą kupioną sztukę. | Pulę kluczy (import), opcjonalnie notatkę, próg niskiego stanu (domyślnie 5). |
| **Plik** | Link do pobrania prywatnego pliku. | Plik (do 25 MB), czas ważności linku (1–720 h, domyślnie 72) i limit pobrań (1–50, domyślnie 5). |
| **Wiadomość** | Tekst, który wpisałeś (np. instrukcja, link zaproszenia, kod). | Treść wiadomości. |

Notatka do kluczy lub pliku jest dołączana do wydanej treści — dobre miejsce na instrukcję aktywacji. Treść wiadomości i notatki jest zapisywana zaszyfrowana.

> [!NOTE]
>
> Klucze, plik i wiadomość dodajesz po pierwszym zapisaniu produktu. Komendy realizacji są dla rodzajów cyfrowych opcjonalne.

## Klucze licencyjne

Pula kluczy należy do produktu — albo do **wariantu**, jeśli sprzedajesz warianty (wariant bez własnej puli korzysta ze wspólnej). Klucze dodajesz:

* wklejając listę — **jedna linia = jeden klucz**,
* ładując plik CSV — kolumna `key`, `klucz` lub `code` (a gdy jej nie ma, pierwsza kolumna).

Duplikaty są pomijane. Lista kluczy w panelu jest zamaskowana i pokazuje liczniki puli: dostępne, wydane. Klucze, które jeszcze nie zostały wydane, możesz usunąć pojedynczo albo zbiorczo; wydanych nie da się usunąć. Pełną pulę wyeksportujesz do CSV (wymaga uprawnienia do zarządzania produktami, eksport jest zapisywany w dzienniku).

Jedno zamówienie może zawierać do **100 kluczy**.

### Gdy klucze się skończą

Jeśli kupujący zapłaci, a pula jest pusta, zamówienie dostaje stan **oczekuje na dostawę** (`awaiting_stock`). Ty dostajesz jedno powiadomienie. Gdy dodasz klucze, brakujące sztuki są dosyłane automatycznie w kolejności zamówień (FIFO), a kupujący dostaje je na stronie zamówienia i e-mailem. Próg niskiego stanu ostrzega Cię, zanim pula się wyczerpie.

## Plik do pobrania

Plik trafia do **prywatnego magazynu** — nigdy do publicznego CDN. Kupujący dostaje podpisany link, który:

* wygasa po ustawionym czasie,
* ma limit pobrań — każde otwarcie linku zużywa jedno pobranie,
* odpowiada z kodem `410`, gdy wygasł lub limit został wyczerpany.

Plik wgrywasz z panelu (do 25 MB). Przy dłuższych materiałach wystaw w pliku odnośnik do własnego hostingu i użyj rodzaju **Wiadomość**.

## Co widzi kupujący

1. W kasie podaje **e-mail** — dla produktów cyfrowych jest wymagany (także w sklepie typu `game`).
2. Po opłaceniu zamówienie od razu przechodzi w **zrealizowane**, a strona zamówienia pokazuje klucze, link do pobrania albo wiadomość. Odbiór wymaga numeru zamówienia i klucza statusu z adresu strony zamówienia — nie wystarczy sam numer.
3. Osobny e-mail z treścią (niezależny od potwierdzenia zamówienia) trafia na podany adres. Treść jest renderowana dopiero przy wysyłce.

Zamówienie z kilku pozycji (cyfrowych i zwykłych) zachowuje się jak zawsze: każda pozycja jest realizowana osobno — zobacz [Zamówienia](https://andcze.mintlify.site/pl/shop/orders.md).

## Zwroty, spory i anulowanie

Zwrot, spór (chargeback) albo anulowanie **unieważniają** wydane klucze (nie wracają do puli) i link do pobrania. Kupujący przy próbie odbioru dostaje informację, że dostawa została cofnięta.

## Akcje na zamówieniu

W szczegółach zamówienia z treścią cyfrową (uprawnienie do zarządzania zamówieniami) widzisz **wydaną treść** oraz stan e-maila i pobrań — każde takie wyświetlenie jest zapisywane w dzienniku. Możesz też:

* **wysłać treść ponownie** (do 5 razy na godzinę dla zamówienia),
* wysłać ją z **nowym linkiem do pobrania** — poprzedni link przestaje działać.

## Dla deweloperów

Strona sklepu pobiera dane o dostawie ze [Storefront API](https://andcze.mintlify.site/pl/developers/storefront-api.md): produkt ma pole `deliveryKind`, status zamówienia zawiera `delivery`, a treść odbiera się z endpointu dostawy. Treść „wiadomości” renderuj jako zwykły tekst, nie HTML. Panel i integracje serwerowe zarządzają pulą kluczy i plikiem przez API sklepu (sekcja Digital delivery w [referencji](https://andcze.mintlify.site/pl/api-reference/overview.md)).

> **[Produkty](https://andcze.mintlify.site/pl/shop/products.md)**
>
> Ceny, warianty i komendy realizacji.

> **[Zamówienia](https://andcze.mintlify.site/pl/shop/orders.md)**
>
> Statusy, grupy płatności i ręczne akcje.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.