Optymalizacja konwersji
Zmienia dane w sklepie — wymagany dry_run
Wydawanie kart podarunkowych
Wygeneruj i wyślij karty podarunkowe do wybranych klientów w skali.
ŚredniozaawansowanyAPI 2025-01
Komenda
bash
shopify-admin-skills:gift-card-issuance store=your-store.myshopify.com### name
Wystawienie karty podarunkowej — środki na koncie klienta zamiast zwrotu gotówki
### oneLiner
Programowo wystawia kartę podarunkową Shopify dla konkretnego klienta — jako gest dobrej woli, kredyt sklepowy po zwrocie lub nagrodę lojalnościową.
### whenToUse
- Gdy opóźniłeś zamówienie i chcesz zaoferować klientowi rekompensatę bez wystawiania faktury korygującej.
- Zamiast zwrotu gotówki po reklamacji — karta podarunkowa zatrzymuje przychód w sklepie.
- Przy kampanii lojalnościowej, żeby automatycznie nagrodzić segment klientów za przekroczenie progu zakupów.
### howToRun
```
Run skill: shopify-admin-gift-card-issuance
Store: twojsklep.myshopify.com
customer_email: jan.kowalski@example.com
amount: 50
reason: "Dobra wola: opóźnienie zamówienia #1042"
dry_run: true
```
### whatYouGet
Brak pliku CSV — wynik pojawia się inline w sesji: kod karty podarunkowej, kwota, data wygaśnięcia i notatka wewnętrzna. Agent support kopiuje kod i przekazuje go klientowi. Przy `dry_run: true` komenda weryfikuje tylko czy klient istnieje w bazie i pokazuje planowaną operację — bez wystawienia karty.
### polishContext
W polskim prawie VAT karta podarunkowa Shopify kwalifikuje się jako „bon jednego przeznaczenia" (SVT — single-purpose voucher) jeśli obejmuje wyłącznie towary z jedną stawką VAT. W takim przypadku obowiązek podatkowy powstaje w momencie sprzedaży bonu, a nie jego realizacji. Przy mieszanym asortymencie (różne stawki VAT) karta staje się „bonem różnego przeznaczenia" (MPV) — podatek rozlicza się przy realizacji. Skonsultuj klasyfikację z księgowym przed masowym wystawianiem kart.
### safetyNote
Komenda wykonuje mutację `giftCardCreate` — karta jest wystawiana natychmiast i nie można jej usunąć (tylko dezaktywować). Zawsze uruchamiaj najpierw z `dry_run: true`, żeby potwierdzić e-mail klienta i kwotę. Wystawiona wartość jest od razu dostępna do realizacji przy kasie.
---
Bazuje na open-source 40RTY-ai/shopify-admin-skills (MIT), rozszerzone o kontekst polskiego rynku przez Dawida Gaca.