Obsługa klienta
Zmienia dane w sklepie — wymagany dry_run
Inicjowanie zwrotu
Zainicjuj zwrot dla klienta z wybranym powodem i opcją zwrotu towaru.
PoczątkującyAPI 2025-01
Komenda
bash
shopify-admin-skills:return-initiation store=your-store.myshopify.com### name
Inicjowanie zwrotu — tworzenie formalnego rekordu zwrotu w Shopify
### oneLiner
Tworzy oficjalny rekord zwrotu dla dostarczonych produktów i opcjonalnie powiadamia klienta — pierwszy krok w natywnym procesie zwrotów Shopify.
### whenToUse
- Gdy klient kontaktuje się z prośbą o zwrot dostarczonego zamówienia i chcesz otworzyć rekord zwrotu w systemie.
- Gdy chcesz śledzić statusy zwrotów (OPEN → IN_PROGRESS → CLOSED) bez ręcznego klikania w panelu.
- Gdy klient chce wymienić produkt — tworzysz rekord zwrotu, a następnie użyjesz `refund-and-reorder` z opcją wymiany.
### howToRun
```
Run skill: shopify-admin-return-initiation
Store: twojsklep.myshopify.com
dry_run: true
order_id: "gid://shopify/Order/12345"
return_reason: "SIZE_TOO_LARGE"
notify_customer: true
```
### whatYouGet
Potwierdzenie ID zwrotu, status (`OPEN`), liczba pozycji zwrotu i informacja czy klient otrzymał email. Brak pliku CSV — wynik pojawia się bezpośrednio w oknie rozmowy. Rekord zwrotu nie wydaje jeszcze zwrotu pieniędzy — do przetworzenia zwrotu finansowego użyj komendy `refund-and-reorder` po przyjęciu towaru.
### polishContext
Polska ustawa o prawach konsumenta (art. 27 Ustawy z dnia 30 maja 2014 r.) przyznaje konsumentom prawo do odstąpienia od umowy bez podania przyczyny w ciągu 14 dni od otrzymania towaru. Komenda obsługuje powód `OTHER` jako domyślny — przy polskich zwrotach warto ustawić powód na `UNWANTED` (rezygnacja bez przyczyny) lub precyzyjny powód produktowy, aby statystyki zwrotów były użyteczne.
### safetyNote
Uruchom najpierw z `dry_run: true` — zobaczysz pozycje zamówienia i ID linii fulfillmentu przed stworzeniem rekordu. Krok 2 wykonuje mutację `returnCreate`, która tworzy formalny rekord zwrotu i — jeśli `notify_customer: true` — wysyła email do klienta. Tej operacji nie da się cofnąć przez API.
---
Bazuje na open-source 40RTY-ai/shopify-admin-skills (MIT), rozszerzone o kontekst polskiego rynku przez Dawida Gaca.