Importowanie i eksportowanie pliku CSV umowy

Możesz użyć pliku CSV (comma-separated values) do importu kontraktów z aplikacji subskrypcji firm zewnętrznych do aplikacji Shopify Subscriptions lub eksportu kontraktów z aplikacji Shopify Subscriptions.

Aby dowiedzieć się więcej na temat korzystania z plików CSV, zapoznaj się z sekcją Otwórz i edytuj plik CSV.

Pobierz przykładowy plik CSV

Możesz pobrać i wyświetlić przykładowy plik CSV kontraktu, aby go użyć jako szablonu.

Informacje dotyczące pliku CSV kontraktów

Przed użyciem pliku CSV umowy do importu umów zapoznaj się z poniższymi zagadnieniami.

Formatowanie pliku CSV

Aby plik CSV umowy został zaimportowany poprawnie, musi spełniać następujące kryteria:

  • Pierwszą linią pliku CSV kontraktów muszą być nagłówki kolumn zgodnie z informacjami podanymi w tabeli opisów plików CSV kontraktów.
  • Każda kolumna musi być oddzielona przecinkami.
  • Plik CSV może mieć maksymalny rozmiar 10 MB.

Opis kolumny Uchwyt

Uchwyt umożliwia jednoznaczną identyfikację każdej umowy. Uchwyty służą do zarządzania danymi w następujący sposób:

  • Grupowanie umów z wieloma pozycjami: Umowy z wieloma pozycjami są pogrupowane według udostępnionego uchwytu.
  • Zapobieganie duplikowaniu umów: Zduplikowane umowy są zignorowane przy imporcie. Jeśli wiersz z tym samym uchwytem został wcześniej pomyślnie zaimportowany, zostanie pominięty w nowym procesie importu. Ten mechanizm pomaga uniknąć duplikowania danych.

Umowy z wieloma pozycjami

Umowy, które zawierają wiele pozycji, wymagają oddzielnego wiersza dla każdej pozycji i są pogrupowane razem z pomocą kolumny Uchwyt.

Na przykład, jeśli umowa zawiera trzy pozycje, każda z nich musi zostać dodana jako osobny wiersz. Pierwszy wiersz zawiera wszystkie informacje o umowie, a następne dwa 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

Uchwyt musi być taki sam dla wszystkich trzech kolumn. Wszystkie inne kolumny w wierszach dwa i trzy muszą być puste.

Opis pliku CSV

Informacje używane w pliku CSV umowy należą do następujących kategorii: * Nazwa umowy * Informacje o kliencie i rozliczeniu * Metoda dostawy i informacje * Pozycje zawarte w subskrypcji

Wszystkie kolumny muszą zostać dodane do pliku CSV, aby można go było poprawnie zaimportować, a wszystkie pola są obowiązkowe, o ile nie określono inaczej.

Opis kolumn w pliku CSV kontraktów.
Kolumna Opis
Handle Uchwyty są unikalnymi identyfikatorami dla każdej umowy. Uchwyty mogą zawierać litery i cyfry i zazwyczaj są połączonym ciągiem liter i cyfr. Każda umowa musi mieć unikalny uchwyt.
upcoming_billing_date Zbliżająca się data rozliczenia umowy. Czas jest podany w formacie UTC (uniwersalny czas koordynowany) i musi być sformatowany w następujący sposób RRRR-MM-DDTHH:MM:SSZ. Na przykład, godzina 15:50 7 września 2019 r. w strefie czasowej UTC (uniwersalny czas koordynowany) ma format 2019-09-07T15:50:00Z.
customer_id ID klienta. ID musi być zgodne z ID istniejącego klienta w panelu administracyjnym Shopify.
currency_code Kod waluty umowy. Kod waluty musi być zgodny z walutą, która jest aktywna w Twoim sklepie.
status Status kontraktu. Kontrakty mogą mieć jeden z następujących statusów:
  • Aktywny
  • Wstrzymano
cadence_interval Częstotliwość dostawy subskrypcji. Możliwe są następujące częstotliwości dla umowy:
  • Tydzień
  • Miesiąc
  • Rok
cadence_interval_count Częstotliwość dostawy subskrypcji w ogólnym przedziale czasu. Na przykład, liczba przedziałów dla częstotliwości raz w miesiącu to 1, a liczba przedziałów dla częstotliwości co dwa tygodnie to 2.
customer_payment_method_id ID metody płatności użytej przez klienta dla umowy.
delivery_price Cena dostawy w prawidłowym formacie waluty.
delivery_method_type Metoda dostawy subskrypcji. Metoda dostawy musi należeć do jednego z następujących typów:
  • Wysyłka
  • Dostawa lokalna
  • Odbiór
  • Brak
delivery_address_first_name Imię odbiorcy w adresie dostawy. To pole jest wymagane tylko dla metod Wysyłka i Dostawa lokalna.
delivery_address_last_name Nazwisko odbiorcy w adresie dostawy. To pole jest wymagane tylko dla metod Wysyłka oraz Dostawa lokalna.
delivery_address_address1 Pierwsza linia adresu dostawy. To pole jest wymagane tylko dla metod Wysyłka oraz Dostawa lokalna.
delivery_address_address2 Druga linia adresu dostawy. To pole jest wymagane tylko wtedy, jeśli adres ma drugie pole, a metoda dostawy to Wysyłka lub Dostawa lokalna.
delivery_address_city Miasto adresu dostawy. To pole jest wymagane tylko dla metod Wysyłka oraz Dostawa lokalna.
delivery_address_province_code Prowincja lub stan adresu dostawy. To pole jest wymagane tylko dla metod Wysyłka oraz Dostawa lokalna.
delivery_address_country_code Kod kraju w adresie dostawy. To pole jest wymagane tylko dla metod Wysyłka oraz Dostawa lokalna.
delivery_address_company Nazwa firmy w adresie dostawy. To pole jest wymagane tylko wtedy, jeśli zamówienie złożyła firma, a metoda dostawy to Wysyłka lub Dostawa lokalna.
delivery_address_zip Kod pocztowy adresu dostawy. To pole jest wymagane tylko dla metod Wysyłka oraz Dostawa lokalna.
delivery_address_phone Numer telefonu adresu dostawy. To pole jest wymagane tylko dla metod Wysyłka oraz Dostawa lokalna.
delivery_local_delivery_phone Numer telefonu w adresie dostawy. To pole jest wymagane w przypadku subskrypcji z metodą Dostawa lokalna.
delivery_local_delivery_instructions Instrukcje dotyczące dostawy lokalnej. To pole należy dodać tylko wtedy, gdy dodano instrukcje dotyczące 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 dla każdej pozycji uwzględnionej w subskrypcji. Jeśli w subskrypcji uwzględniono wiele pozycji, każda pozycja musi zostać dodana jako nowa linia z unikalnym ID wariantu.
line_quantity Ilość dla każdej pozycji uwzględnionej w subskrypcji. Jeśli subskrypcja obejmuje wiele pozycji, dodana ilość powinna dotyczyć konkretnej pozycji, a nie całkowitej ilości wszystkich uwzględnionych pozycji.
line_current_price Cena pozycji subskrypcji w prawidłowym formacie waluty.
line_selling_plan_id ID planu subskrypcji. To pole jest opcjonalne.
line_selling_plan_name Nazwa planu subskrypcji. To pole jest opcjonalne.

Import umów za pomocą pliku CSV

Aby zaimportować umowy z aplikacji subskrypcyjnej firmy zewnętrznej ze sklepu Shopify App Store lub innego sklepu Shopify do aplikacji Shopify Subscription możesz użyć pliku CSV. Pliku CSV nie można używać do edytowania ani nadpisywania umów. Duplikaty umów są ignorowane przy imporcie.

Kroki:

  1. W panelu administracyjnym Shopify przejdź do sekcji Subskrypcje > Umowy.
  2. Kliknij Importuj.
  3. Kliknij opcję Dodaj plik, a następnie wybierz plik CSV, który chcesz zaimportować.
  4. Naciśnij Załaduj plik.

Po przesłaniu pliku CSV otrzymasz wiadomość e-mail z potwierdzeniem od Shopify na konto e-mail, które zostało użyte do skonfigurowania sklepu Shopify. Zapoznaj się z rozwiązaniami typowych błędów importu, aby rozwiązać wszelkie problemy z importem.

Eksport kontraktów z wykorzystaniem pliku CSV

Możesz eksportować umowy do swoich dokumentów lub importować je innego sklepu Shopify, w którym zainstalowano aplikację Shopify Subscriptions.

Kroki:

  1. W panelu administracyjnym Shopify przejdź do sekcji Subskrypcje > Umowy.
  2. Kliknij Eksportuj.

Gotowy(-a) do rozpoczęcia sprzedaży za pomocą Shopify?

Wypróbuj za darmo