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.

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.

Opis kolumn w pliku CSV z kontraktami.
KolumnaOpis
HandleIdentyfikatory (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_dateNadchodzą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_idID klienta. ID musi pasować do ID istniejącego klienta w panelu administracyjnym Shopify i powinno być ciągiem cyfr. Na przykład 6320530986896.
currency_codeKod waluty kontraktu. Kod waluty musi odpowiadać walucie aktywnej w Twoim sklepie.
statusStatus kontraktu. Kontrakty mogą mieć jeden z następujących statusów:
  • Aktywny
  • Wstrzymany
cadence_intervalCzęstotliwość dostaw subskrypcji. Kontrakt może mieć jeden z następujących przedziałów częstotliwości:
  • Tydzień
  • Miesiąc
  • Rok
cadence_interval_countOkreś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_idID metody płatności używanej przez klienta dla kontraktu. Jest to unikalny kod alfanumeryczny. Na przykład 24e8c839c47ef47d30ad28346d130e74.
delivery_priceCena dostawy we właściwym formacie waluty.
delivery_method_type Metoda dostawy subskrypcji. Metoda dostawy musi być jednym z następujących typów:
  • Wysyłka
  • Dostawa lokalna
  • Odbiór
  • Brak
delivery_address_first_nameImię odbiorcy podane w adresie dostawy. To pole jest wymagane tylko dla metod dostawy Wysyłka i Dostawa lokalna.
delivery_address_last_nameNazwisko odbiorcy podane w adresie dostawy.
To pole jest wymagane tylko w przypadku metod Wysyłka i Dostawa lokalna.
delivery_address_address1Pierwszy wiersz adresu dostawy.
To pole jest wymagane tylko w przypadku metod Wysyłka i Dostawa lokalna.
delivery_address_address2Drugi 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_cityMiasto z adresu dostawy.
To pole jest wymagane tylko w przypadku metod Wysyłka i Dostawa lokalna.
delivery_address_province_codeKod ISO prowincji lub stanu z adresu dostawy.
To pole jest wymagane tylko w przypadku metod Wysyłka i Dostawa lokalna.
delivery_address_country_codeKod ISO kraju z adresu dostawy.
To pole jest wymagane tylko w przypadku metod Wysyłka i Dostawa lokalna.
delivery_address_companyNazwa 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_zipKod pocztowy z adresu dostawy.
To pole jest wymagane tylko w przypadku metod Wysyłka i Dostawa lokalna.
delivery_address_phoneNumer 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_phoneNumer telefonu z adresu dostawy.
To pole jest wymagane w przypadku subskrypcji z metodą Dostawa lokalna.
delivery_local_delivery_instructionsInstrukcje 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_idID lokalizacji dla metody odbioru.
To pole jest wymagane tylko w przypadku subskrypcji z metodą Odbiór lokalny.
line_variant_idID 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_quantityIlość 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_priceCena pozycji pojedynczej subskrypcji we właściwym formacie waluty.
line_selling_plan_idID planu subskrypcji — na przykład 3607724288.
To pole jest opcjonalne.
line_selling_plan_nameNazwa 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:

Kroki:

  1. Z panelu administracyjnego Shopify przejdź do opcji Aplikacje > Subscriptions.

  2. Kliknij opcję Kontrakty.

  3. Kliknij opcję Importuj.

  4. Kliknij opcję Dodaj plik, a następnie wybierz plik CSV, który chcesz zaimportować.

  5. 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:

  1. Z panelu administracyjnego Shopify przejdź do opcji Aplikacje > Subscriptions.

  2. Kliknij opcję Kontrakty.

  3. Kliknij opcję Eksportuj.