Rozwiązywanie problemów w aplikacji Transporter
Podczas przetwarzania Twoich rekordów oraz importowania ich jako obiekty aplikacja Transporter może napotkać na błędy.
Jak przebiega proces importu
Podczas rozwiązywania problemów z aplikacją Transporter, przydatne może być zrozumienie, w jaki sposób aplikacja przesyła i importuje dane, a także poznanie typowych błędów, które mogą wystąpić w trakcie tych procesów i przyczyn wystąpienia niektórych z nich. Status importów można znaleźć w panelu administracyjnym Shopify w opcji Aplikacje > Transporter.
Podczas importowania obiektów do sklepu Shopify aplikacja Transporter wykonuje następujące czynności:
Przesyła plik do bezpiecznej lokalizacji pośredniej hostowanej przez Shopify. Aby dowiedzieć się, w jaki sposób Shopify chroni przesyłane informacje, zapoznaj się z polityką prywatności Shopify.
Sprawdza plik pod kątem błędów strukturalnych i formatu zawartości. Jeśli aplikacja Transporter wykryje błędy, import nie powiedzie się, a jego status zmieni się na Nie powiodło się.
Importuje obiekty. Czas potrzebny na wykonanie importu zależy od liczby przetwarzanych obiektów (średnia szybkość przetwarzania wynosi 40 obiektów na sekundę). Po zakończeniu importu jego status zmienia się na Zakończono. Jeśli zdarzyły się rekordy, których aplikacja Transporter nie mogła zaimportować, w tabeli pojawi się link Eksportuj błędy.
W dowolnym momencie możesz zatrzymać import dalszych obiektów, klikając Zatrzymaj import. Obiekty, które zostały zaimportowane przed zatrzymaniem importu, pozostaną w Twoim sklepie Shopify. Po zatrzymaniu importu jego status zmienia się na Zatrzymany.
Eksportowanie i korygowanie błędów
Jeśli są problemy z importem, możesz kliknąć przycisk Eksportuj błędy, aby dowiedzieć się, jak je rozwiązać. Aby uzyskać więcej informacji na temat kodów tych błędów, zapoznaj się z poniższą listą kodów typowych błędów.
Proces poprawiania błędów różni się nieco w zależności od tego, czy import ma status Nie powiodło się czy*Zakończono*.
Nie powiodło się
Gdy import ma status Nie powiodło się, oznacza to, że występuje problem z samym plikiem CSV, a nie z zawartością pliku. Po przejrzeniu pliku tekstowego błędów napraw błędy w początkowym przesłanym pliku, a następnie spróbuj ponownie przesłać plik.
Zakończono
Jeśli zakończony import zawiera błędy, to występują one raczej w poszczególnych rekordach, a nie w strukturze pliku CSV. W tym przypadku w Shopify tworzone są tylko rekordy bez błędów. Rekordy zawierające błędy nie są tworzone, są natomiast dodawane do pliku CSV z błędami eksportu. Plik CSV z błędami eksportu będzie widoczny dopiero po zakończeniu importu i ustawieniu statusu na Zakończono. Po zakończeniu importu w tabeli pojawia się link Eksportuj błędy.
Ostatnia kolumna w każdym wierszu pliku CSV z błędami zawiera opis błędu dla rekordu. Po pobraniu pliku napraw w nim błędy, a następnie go prześlij. Przed przesłaniem tego pliku nie musisz usuwać kolumny błędów.
W poniższym przykładzie nie można było zaimportować trzech klientów, ponieważ istnieli już w sklepie.
First Name,Last Name,Email,Error(s)
Jane,Doe,jane.doe01520022060@example.com,...,Email has already been taken
Jane,Doe,jane.doe11520022060@example.com,...,Email has already been taken
Jane,Doe,jane.doe21520022060@example.com,...,Email has already been taken
Klienci Shopify są identyfikowani poprzez ich unikalne adresy e-mail, zatem import tych klientów nie był możliwy, ponieważ dla ich adresów e-mail istniały już rekordy w Shopify.
Kody typowych błędów
Typowe błędy plików są następujące:
-
Wystąpił błąd w API Shopify, nie można zapisać danych
Ten błąd może pojawić się z kilku różnych powodów. Najczęstszą przyczyną tego błędu jest pojedyncze meta pole pojawiające się więcej niż raz dla danego rekordu. Aplikacja Transporter nie obsługuje rekordów ze zduplikowanymi metapolami. Jeśli usunięcie zduplikowanych metapól nie rozwiąże problemu, skontaktuj się z pomocą techniczną Shopify.
-
Wykonanie nie powiodło się. Kod odpowiedzi = 400. Wiadomość z odpowiedzią = Nieprawidłowe żądanie
Aplikacja Transporter nie może utworzyć obiektu w Shopify, ponieważ w danych występują błędy. Częstą przyczyną jest nieprawidłowe sformatowanie danych. Upewnij się, że Twoje dane spełniają te wymagania:
- Wartości walut muszą być określone zgodnie z normą ISO 4217 (na przykład USD).
- Kod kraju, prowincji/stanu oraz kod pocztowy muszą być prawidłowe.
- Numery telefonów muszą mieć prawidłowy format, kody krajów i kody obszarów.
- Adresy e-mail muszą mieć prawidłowe domeny.
-
Status finansowy
musi być jedną z dozwolonych wartości. -
Status realizacji
musi być jedną z dozwolonych wartości. - Wartości logiczne muszą być zdefiniowane jako
Prawda
lubFałsz
. - Wszystkie kolumny wymagające liczby całkowitej (np.
Ilość zapasów wariantu
w pliku CSV produktu lubIlość pozycji pojedynczych
w pliku CSV zamówień) nie będą importowane, jeśli wprowadzisz wartość dziesiętną. Przykładowo wprowadź5
zamiast5,0
. Niektóre programy arkusza kalkulacyjnego (np. liczby) mogą wyświetlać wartości dziesiętne lub zmiennoprzecinkowe jako liczby całkowite. Sprawdź swoje wartości w edytorze tekstowym. - Żadna kolumna, która wymaga liczby całkowitej (np.
całkowita waga
lubID lokalizacji transakcji
w CSV zamówień), nie zostanie zaimportowana, jeśli wprowadzisz wartości nienumeryczne (takie jak litery).
-
Typ wartości nie jest uwzględniony na liście
Sprawdź wartości w kolumnach metapola. Aby zaimportować metapole, musisz uwzględnić wartości we wszystkich następujących kolumnach:
Przestrzeń nazw metapola
,Klucz metapola
,Wartość metapola
iTyp wartości metapola
. Ten błąd często występuje, ponieważ w jednej lub kilku kolumnach znajduje się nieprawidłowa wartość lub puste pola. -
Nazwa kolumny
jest nieprawidłowaTen błąd może pojawić się z kilku różnych powodów. Na przykład z powodu rozróżniania w kolumnie wielkich i małych liter. W przypadku kolumn, które akceptują listę wartości, należy postąpić jak w przypadku stosowanym w opisach kolumn. Na przykład w pliku CSV zamówień w kolumnie
Status finansowy
rozróżniane są wielkie i małe litery. Oznacza to, że jeśli wprowadzisz wartośćZapłacono
zamiastzapłacono
, to wstatusie finansowym
wystąpi błąd. Sprawdź pozostałe kolumny, aby upewnić się, że wprowadzone wartości mają prawidłowy format. -
Nieprawidłowy status zamówienia - nie może być jednocześnie zrealizowane i anulowane
Shopify nie może tworzyć zamówień, które są jednocześnie zrealizowane i anulowane. Ten błąd wystąpi wtedy, jeśli obydwa poniższe warunki będą prawdziwe:
- Zamówienie ma ustawioną sygnaturę czasową
cancelled_at
. - Zamówienie ma
fulfillment_status
ustawiony na Zrealizowane lub Częściowe.
Zamówienie, które ma ustawioną sygnaturę czasową
cancelled_at
ifulfillment_status
ustawiony na Zrealizowane lub Częściowe, może zostać utworzone, jeślifinancial_status
zostanie ustawiony na Zwrócono koszty. - Zamówienie ma ustawioną sygnaturę czasową
Jeśli trafisz na kod błędu, który nie został tutaj wymieniony, skontaktuj się z pomocą techniczną Shopify.