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.
Na tej stronie
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. Możesz pobrać przykładowy szablon CSV, aby przejrzeć przykład umowy z wieloma pozycjami.
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.
| Kolumna | Opis |
|---|---|
| Handle | Uchwyty są unikalnymi identyfikatorami dla każdej umowy, np. czerwona koszula. 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 strefie czasowej 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 w dniu 7 września 2019 r. w strefie czasowej UTC (uniwersalny czas koordynowany) ma format 2019-09-07T15:50:00Z. Wartość zbliżającej się daty rozliczenia musi być ustawiona jako data i godzina przypadająca co najmniej 24 godziny po dacie i godzinie importu pliku CSV. |
| customer_id | ID klienta. ID musi być zgodny z ID istniejącego klienta w panelu administracyjnym Shopify i powinien być ciągiem cyfr, na przykład 6320530986896. |
| 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:
|
| cadence_interval | Częstotliwość dostawy subskrypcji. Możliwe są następujące częstotliwości dla umowy:
|
| 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 na potrzeby umowy. ID to unikalny kod alfanumeryczny, na przykład 24e8c839c47ef47d30ad28346d130e74. |
| 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:
|
| 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 |
Kod ISO prowincji lub stanu w adresie dostawy. To pole jest wymagane tylko dla metod Wysyłka oraz Dostawa lokalna. |
| delivery_address_country_code |
Kod ISO 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 w adresie 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 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. -- na przykład 53154087005812. 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 - na przykład 3607724288. To pole jest opcjonalne. |
| line_selling_plan_name | Nazwa planu subskrypcji. To pole jest opcjonalne. |
Importuj umowy za pomocą pliku CSV
Możesz użyć pliku CSV do zaimportowania istniejących umów z kwalifikującej się aplikacji do obsługi subskrypcji 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 umów. Duplikaty umów są ignorowane przy imporcie.
Importowanie umów z aplikacji do obsługi subskrypcji firmy zewnętrznej
Możesz importować umowy z aplikacji do obsługi subskrypcji firmy zewnętrznej. Podczas importu z aplikacji firmy zewnętrznej pamiętaj o następujących kwestiach:
- Jeśli aplikacja do obsługi subskrypcji firmy zewnętrznej nie jest zintegrowana z platformą Shopify Checkout, nie możesz zaimportować umów.
- Nie możesz importować danych bezpośrednio z aplikacji firmy zewnętrznej. Musisz dodać dane umów z aplikacji firmy zewnętrznej do pliku CSV kompatybilnego z aplikacją Shopify Subscriptions w odpowiednim formacie do zaimportowania.
- Jeśli aplikacja do obsługi subskrypcji firmy zewnętrznej nie ma funkcji eksportu lub jeśli wyeksportowane dane nie zawierają wszystkich wymaganych danych, skontaktuj się z twórcą aplikacji, aby uzyskać pomoc.
Kroki:
- W panelu administracyjnym Shopify przejdź do sekcji Subskrypcje > Umowy.
- Kliknij Importuj.
- Kliknij opcję Dodaj plik, a następnie wybierz plik CSV, który chcesz zaimportować.
- 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:
- W panelu administracyjnym Shopify przejdź do sekcji Subskrypcje > Umowy.
- Kliknij Eksportuj.