Wymagania wstępne
Przed rozpoczęciem upewnij się, że masz następujące elementy:
- Aktywną subskrypcję Inclusive Pricing w Zonos.
- Klucz Secret GraphQL API z Twojego Zonos Dashboard. Przejdź do Settings -> Integrations, aby znaleźć swoje klucze API. Klucz musi mieć przedrostek
credential_livei nie może być wygasły.
Pierwsza konfiguracja
Wykonaj poniższe kroki, aby skonfigurować szablon raportu Inclusive Pricing po raz pierwszy.
Skopiuj szablon Google Sheet
Otwórz szablon raportu Inclusive Pricing i utwórz własną kopię, przechodząc do File -> Make a copy. Nie proś o dostęp do edycji oryginalnego arkusza.
Połącz swój klucz API
W skopiowanym arkuszu kliknij Zonos -> Update GraphQL API Key na pasku menu (obok Help). Ta opcja menu może zająć chwilę, zanim pojawi się po otwarciu arkusza.
Autoryzuj skrypt
Dla nowych użytkowników pojawi się okno dialogowe autoryzacji. Kliknij OK, a następnie postępuj zgodnie z instrukcjami, aby autoryzować skrypt za pomocą swojego konta Google:
- Kliknij Select all, aby udzielić wymaganych uprawnień.
- Kliknij Continue, aby zakończyć autoryzację.
Wpisz swój klucz Secret API
Po autoryzacji pojawi się okno dialogowe z prośbą o wpisanie klucza Secret GraphQL API Zonos. Możesz go znaleźć w swoim Zonos Dashboard w sekcji Settings -> Integrations.
Upewnij się, że kopiujesz prawidłowy klucz Secret z przedrostkiem credential_live. Wygasłe klucze lub klucze Public spowodują błędy.
Pobierz zamówienia
Kliknij Zonos -> Fetch Orders na pasku menu.
Wybierz zakres dat
Wpisz datę początkową i końcową w oknie dialogowym lub użyj jednej z predefiniowanych opcji (Last 30 days, This month, Last month, This year), a następnie kliknij Fetch Orders.
Po zakończeniu Twoje zamówienia zostaną wypełnione w zakładce Orders arkusza.
Uwaga: Aby zachować raport do wykorzystania w przyszłości, kliknij prawym przyciskiem myszy zakładkę Orders i wybierz Duplicate, a następnie zmień jej nazwę według potrzeb. Możesz również wyeksportować lub skopiować cały arkusz kalkulacyjny.
Codzienne użycie
Po ukończeniu pierwszej konfiguracji generowanie nowych raportów jest proste:
- Pomiń kroki 1-3 - Są to czynności jednorazowe.
- Pomiń krok 4, chyba że Twój klucz API wygasł lub musisz pobrać dane z innego sklepu Zonos.
- Powtórz kroki 5 i 6, aby pobrać zamówienia dla nowego zakresu dat.
Błąd 401 Unauthorized
Może zostać wyświetlony błąd zawierający HTTP fetch failed from 'order': 401: Unauthorized.
Rozwiązanie: Upewnij się, że używasz prawidłowego klucza Secret GraphQL API z Twojego Zonos Dashboard. Ten błąd występuje, gdy klucz jest brakujący, nieprawidłowy lub nie jest typu Secret.
Błąd Security requirement failed
Może zostać wyświetlony błąd zawierający Security requirement failed.
Rozwiązanie: Upewnij się, że używasz klucza Secret GraphQL API (a nie klucza Public) i że nie ma on statusu Expired. Przejdź do Settings -> Integrations w Twoim Zonos Dashboard, aby zweryfikować stan klucza.
Nie pojawiają się żadne zamówienia
Żadne zamówienia nie są wypełniane, mimo podania prawidłowego klucza Secret GraphQL API.
Rozwiązanie: Ten raport generuje dane tylko dla zamówień z atrybutami Inclusive Pricing. Jeśli Twoje pozycje nie zawierają pól reverseAmountDetail, nie zostaną uwzględnione. Sprawdź, czy w wybranym zakresie dat przetworzono zamówienia Inclusive Pricing.
Eksportuj raport Inclusive Pricing
Wygeneruj podział Inclusive Pricing na poziomie pozycji za pomocą Google Sheet.
Szablon raportu Inclusive Pricing to Google Sheet z wbudowanym skryptem, który wysyła zapytania do API GraphQL Zonos w celu pobrania Twoich zamówień i generuje raport przedstawiający podział na poziomie pozycji kwot podstawowych i łącznych. Jest to przydatne dla każdego sprzedawcy, który chce mieć wgląd w to, jak cła, podatki i opłaty są rozdzielane między pozycje w jego zamówieniach Inclusive Pricing.