Importowanie i eksportowanie pliku CSV z kontraktami
Możesz użyć pliku CSV (wartości rozdzielane przecinkami), aby importować kontrakty z zewnętrznej aplikacji do obsługi subskrypcji do aplikacji Shopify Subscriptions lub eksportować kontrakty z aplikacji Shopify Subscriptions.
Aby dowiedzieć się więcej o korzystaniu z plików CSV, zapoznaj się z sekcją otwieranie i edycja pliku CSV.
Na tej stronie
Pobierz przykładowy plik CSV
Możesz pobrać i wyświetlić przykładowy plik CSV z kontraktami, aby użyć go jako szablonu.
Kwestie do rozważenia dotyczące pliku CSV z kontraktami
Zanim użyjesz pliku CSV z kontraktami do ich importu, zapoznaj się z poniższymi kwestiami.
Formatowanie pliku CSV
Aby plik CSV z kontraktami został poprawnie zaimportowany, sprawdź, czy spełnia następujące kryteria:
- Pierwszy wiersz pliku CSV z kontraktami musi zawierać nagłówki kolumn określone w tabeli z opisem pliku CSV z kontraktami.
- Każda kolumna musi być oddzielona przecinkiem.
- Maksymalny rozmiar pliku CSV to 10 MB.
Informacje o kolumnie „handle”
Identyfikator (handle) służy do jednoznacznej identyfikacji każdego kontraktu. Identyfikatory są używane do zarządzania danymi w następujący sposób:
- Grupowanie kontraktów z wieloma pozycjami pojedynczymi: Kontrakty z wieloma pozycjami pojedynczymi są grupowane według wspólnego identyfikatora.
- Zapobieganie powielaniu kontraktów: Zduplikowane kontrakty są ignorowane podczas importu. Jeśli wiersz z tym samym identyfikatorem został wcześniej pomyślnie zaimportowany, jest on pomijany w nowym procesie importu. Ten mechanizm pomaga uniknąć powielania danych.
Kontrakty z wieloma pozycjami pojedynczymi
Kontrakty, które zawierają wiele pozycji pojedynczych, wymagają osobnego wiersza dla każdej pozycji i są grupowane za pomocą kolumny handle.
Na przykład, jeśli kontrakt ma trzy pozycje pojedyncze, każda z nich musi zostać dodana jako osobny wiersz. Pierwszy wiersz zawiera wszystkie informacje o kontrakcie, a dwa następne wiersze zawierają wartości tylko w następujących kolumnach:
- handle
- line_variant_id
- line_quantity
- line_current_price
- Opcjonalnie: line_selling_plan_id
- Opcjonalnie: line_selling_plan_name
Identyfikator handle musi być identyczny dla wszystkich trzech wierszy. Wszystkie inne kolumny w wierszach drugim i trzecim muszą być puste. Możesz pobrać przykładowy szablon CSV, aby zapoznać się z przykładem kontraktu z wieloma pozycjami pojedynczymi.
Opis pliku CSV
Informacje używane w pliku CSV z kontraktami dzielą się na następujące kategorie:
- Nazwa kontraktu
- Informacje o kliencie i informacje rozliczeniowe
- Metoda dostawy i informacje o dostawie
- Pozycje zawarte w subskrypcji
Aby import przebiegł pomyślnie, wszystkie kolumny muszą być dodane do pliku CSV, a wszystkie pola są wymagane, chyba że zaznaczono inaczej.
| Kolumna | Opis |
|---|---|
| Handle | Identyfikatory (handle) to unikalne oznaczenia dla każdego kontraktu. Na przykład red-shirt. Identyfikatory mogą zawierać litery i cyfry i zazwyczaj są połączonym ciągiem znaków składającym się z liter, cyfr lub jednych i drugich. Każdy kontrakt musi mieć unikalny identyfikator. |
| upcoming_billing_date | Nadchodząca data rozliczenia dla kontraktu.
Czas jest podany w standardzie UTC (uniwersalny czas koordynowany) i musi mieć format YYYY-MM-DDTHH:MM:SSZ. Na przykład godzina 15:50 7 września 2019 r. w strefie czasowej UTC (uniwersalny czas koordynowany) jest przedstawiona jako 2019-09-07T15:50:00Z. Wartość nadchodzącej daty rozliczenia musi być ustawiona na datę i godzinę występującą co najmniej 24 godziny po dacie i godzinie zaimportowania pliku CSV. |
| customer_id | ID klienta. ID musi pasować do ID istniejącego klienta w panelu administracyjnym Shopify i powinno być ciągiem cyfr. Na przykład 6320530986896. |
| currency_code | Kod waluty kontraktu. Kod waluty musi odpowiadać walucie aktywnej w Twoim sklepie. |
| status | Status kontraktu. Kontrakty mogą mieć jeden z następujących statusów:
|
| cadence_interval | Częstotliwość dostaw subskrypcji. Kontrakt może mieć jeden z następujących przedziałów częstotliwości:
|
| cadence_interval_count | Określa częstotliwość dostaw subskrypcji w ramach danego przedziału czasowego. Na przykład dla dostawy co miesiąc wartość ta wynosi 1, a dla dostawy co dwa tygodnie — 2. |
| customer_payment_method_id | ID metody płatności używanej przez klienta dla kontraktu. Jest to unikalny kod alfanumeryczny. Na przykład 24e8c839c47ef47d30ad28346d130e74. |
| delivery_price | Cena dostawy we właściwym formacie waluty. |
| delivery_method_type | Metoda dostawy subskrypcji. Metoda dostawy musi być jednym z następujących typów:
|
| delivery_address_first_name | Imię odbiorcy podane w adresie dostawy. To pole jest wymagane tylko dla metod dostawy Wysyłka i Dostawa lokalna. |
| delivery_address_last_name | Nazwisko odbiorcy podane w adresie dostawy.
To pole jest wymagane tylko w przypadku metod Wysyłka i Dostawa lokalna. |
| delivery_address_address1 | Pierwszy wiersz adresu dostawy.
To pole jest wymagane tylko w przypadku metod Wysyłka i Dostawa lokalna. |
| delivery_address_address2 | Drugi wiersz adresu dostawy.
To pole jest wymagane tylko wtedy, gdy w adresie występuje drugie pole, a wybraną metodą dostawy jest Wysyłka lub Dostawa lokalna. |
| delivery_address_city | Miasto z adresu dostawy.
To pole jest wymagane tylko w przypadku metod Wysyłka i Dostawa lokalna. |
| delivery_address_province_code | Kod ISO prowincji lub stanu z adresu dostawy.
To pole jest wymagane tylko w przypadku metod Wysyłka i Dostawa lokalna. |
| delivery_address_country_code | Kod ISO kraju z adresu dostawy.
To pole jest wymagane tylko w przypadku metod Wysyłka i Dostawa lokalna. |
| delivery_address_company | Nazwa firmy z adresu dostawy.
To pole jest wymagane tylko wtedy, gdy zamówienie jest składane przez firmę, a wybraną metodą dostawy jest Wysyłka lub Dostawa lokalna. |
| delivery_address_zip | Kod pocztowy z adresu dostawy.
To pole jest wymagane tylko w przypadku metod Wysyłka i Dostawa lokalna. |
| delivery_address_phone | Numer telefonu z adresu dostawy — na przykład +1 (613) 555-5555.
To pole jest wymagane tylko w przypadku metod Wysyłka i Dostawa lokalna. |
| delivery_local_delivery_phone | Numer telefonu z adresu dostawy.
To pole jest wymagane w przypadku subskrypcji z metodą Dostawa lokalna. |
| delivery_local_delivery_instructions | Instrukcje dotyczące dostawy lokalnej.
To pole musi zostać uwzględnione tylko wtedy, gdy podano instrukcje dla subskrypcji z metodą Dostawa lokalna. |
| delivery_pickup_method_location_id | ID lokalizacji dla metody odbioru.
To pole jest wymagane tylko w przypadku subskrypcji z metodą Odbiór lokalny. |
| line_variant_id | ID każdej pozycji pojedynczej uwzględnionej w subskrypcji — na przykład 53154087005812.
Jeśli w subskrypcji znajduje się wiele pozycji pojedynczych, każdą z nich należy dodać w nowym wierszu z unikalnym ID wariantu. |
| line_quantity | Ilość dla każdej pozycji pojedynczej uwzględnionej w subskrypcji.
Jeśli w subskrypcji uwzględniono wiele pozycji pojedynczych, dodana ilość powinna dotyczyć tej konkretnej pozycji, a nie całkowitej ilości wszystkich uwzględnionych pozycji. |
| line_current_price | Cena pozycji pojedynczej subskrypcji we właściwym formacie waluty. |
| line_selling_plan_id | ID planu subskrypcji — na przykład 3607724288.
To pole jest opcjonalne. |
| line_selling_plan_name | Nazwa planu subskrypcji.
To pole jest opcjonalne. |
Importowanie kontraktów za pomocą pliku CSV
Możesz użyć pliku CSV, aby zaimportować istniejące kontrakty z kwalifikującej się aplikacji subskrypcyjnej firmy zewnętrznej z Shopify App Store lub z aplikacji Shopify Subscriptions w innym sklepie.
Pliku CSV nie można używać do edytowania ani nadpisywania istniejących kontraktów. Duplikaty istniejących kontraktów są ignorowane podczas importu.
Importowanie kontraktów z aplikacji subskrypcyjnej firmy zewnętrznej
Może istnieć możliwość importu kontraktów z aplikacji subskrypcyjnej firmy zewnętrznej. Przy importowaniu z aplikacji firmy zewnętrznej należy wziąć pod uwagę następujące kwestie:
- Jeśli Twoja aplikacja subskrypcyjna firmy zewnętrznej nie jest zintegrowana z Shopify Checkout, nie możesz zaimportować kontraktów.
- Nie możesz importować danych bezpośrednio z aplikacji firmy zewnętrznej. Aby je zaimportować, musisz dodać dane kontraktu z aplikacji firmy zewnętrznej do pliku CSV zgodnego z aplikacją Shopify Subscriptions we właściwym formacie.
- Jeśli Twoja aplikacja subskrypcyjna firmy zewnętrznej nie ma funkcji eksportu lub jeśli wyeksportowane dane nie zawierają wszystkich wymaganych danych, skontaktuj się z deweloperem aplikacji, aby uzyskać pomoc.
Kroki:
Z panelu administracyjnego Shopify przejdź do opcji Aplikacje > Subscriptions.
Kliknij opcję Kontrakty.
Kliknij opcję Importuj.
Kliknij opcję Dodaj plik, a następnie wybierz plik CSV, który chcesz zaimportować.
Kliknij opcję Prześlij plik.
Po przesłaniu pliku CSV otrzymasz od Shopify e-mail z potwierdzeniem na konto e-mail użyte do skonfigurowania Twojego sklepu Shopify. Zapoznaj się z rozwiązaniami często występujących błędów importu, aby rozwiązać wszelkie problemy z importem.
Eksportowanie kontraktów za pomocą pliku CSV
Możesz wyeksportować kontrakty, aby zachować je w swojej dokumentacji lub zaimportować do innego sklepu Shopify, w którym masz zainstalowaną aplikację Shopify Subscriptions.
Kroki:
Z panelu administracyjnego Shopify przejdź do opcji Aplikacje > Subscriptions.
Kliknij opcję Kontrakty.
Kliknij opcję Eksportuj.