© navision.pl | Opracowano na podstawie: Microsoft Learn (CC BY 4.0)

Rozwiązywanie problemów z synchronizacją Shopify i Business Central

Możesz napotkać sytuacje, w których musisz rozwiązać problemy podczas synchronizacji danych między Shopify a Business Central. Ta strona definiuje kroki rozwiązywania problemów dla niektórych typowych scenariuszy.

Uruchamianie zadań na pierwszym planie

Wybierz ikonę , wprowadź Sklep Shopify i wybierz powiązane łącze.
Wybierz sklep, dla którego chcesz rozwiązać problemy, aby otworzyć stronę Karta sklepu Shopify.
Wyłącz przełącznik Uruchamiaj synchronizacje w tle.

Teraz, gdy zostanie wyzwolona akcja synchronizacji, zadanie działa na pierwszym planie. Jeśli wystąpi błąd, pojawi się okno dialogowe błędu z łączem Kopiuj szczegóły. Użyj łącza, aby skopiować informacje do edytora tekstu w celu dalszej analizy.

Dzienniki

Funkcje rejestrowania mogą ułatwić identyfikację przyczyny wystąpienia błędu. Na stronie Karta sklepu Shopify, w polu Tryb rejestrowania, można określić poziom szczegółowości, który ma być rejestrowany dla błędów. Pole udostępnia następujące opcje:

Wyłączone - Nie rejestruj informacji o błędach.
Tylko błędy - Rejestruj tylko komunikat o błędzie, bez par żądanie/odpowiedź. To ustawienie jest domyślne dla nowych sklepów.
Wszystkie - Rejestruj pary żądanie/odpowiedź dla wszystkich transakcji, w tym pary zakończone sukcesem. Ciągłe rejestrowanie wszystkich błędów może spowolnić działanie Business Central. Użyj tego trybu, gdy wymiana danych nie powoduje błędu, ale chcesz uzyskać informacje o wysłanych i odebranych danych. Niektóre dane są zawsze rejestrowane, niezależnie od tego, czy rejestrowanie jest włączone. Aby uzyskać więcej informacji, zobacz Przechwytywanie danych.

Aby przejrzeć dzienniki

Wybierz ikonę , wprowadź Zapisy dziennika Shopify i wybierz powiązane łącze.
Wybierz powiązany zapis dziennika, a następnie otwórz stronę Zapis dziennika Shopify.
Przejrzyj żądanie, kod stanu i opis oraz wartości odpowiedzi.

Porada

Jeśli musisz skontaktować się z pomocą techniczną Shopify w celu uzyskania pomocy w rozwiązywaniu problemów, zanotuj informacje w polu Identyfikator żądania. Te informacje mogą pomóc wsparciu technicznemu szybciej rozwiązać problem.

Możesz pobrać wartości żądania i odpowiedzi jako pliki w formacie tekstowym.

Zarządzanie danymi zapisów dziennika

Aby pomóc w kontrolowaniu rozmiaru bazy danych, zapisy dziennika są uwzględnione w zasadach przechowywania danych o nazwie Zapis dziennika Shpfy. Zasady przechowywania pozwalają określić, jak długo mają być przechowywane różne typy danych. Domyślnie zapisy dziennika Shopify są przechowywane przez jeden miesiąc. Aby dowiedzieć się więcej o zasadach przechowywania, przejdź do Czyszczenie danych za pomocą zasad przechowywania.

Ponadto na stronie Zapisy dziennika Shopify można usunąć wszystkie zapisy dziennika lub tylko zapisy starsze niż siedem dni.

Rozwiązywanie problemów z eksportem

Podczas eksportowania danych do Shopify, Łącznik Shopify pomija rekordy, które Shopify odrzuci lub które z innych powodów nie są prawidłowe do eksportu. Chociaż takie zachowanie jest oczekiwane, możesz być zdezorientowany, jeśli niektóre informacje nie zostały przetworzone zgodnie z oczekiwaniami. Możesz znaleźć te wpisy na stronie Pominięte rekordy Shopify, która pokazuje wszystkie pominięte rekordy i podaje przyczyny oraz datę i godzinę pominięcia rekordów.

Pole Tryb rejestrowania steruje zawartością strony Pominięte rekordy Shopify.

Uwaga

Opcja Wszystkie działa tak samo jak Tylko błędy i rejestruje tylko pominięte zapisy. Nie rejestruje zapisów, które zostały wcześniej pominięte.

Liczba rekordów na stronie Pominięte rekordy Shopify zwiększa się z czasem. Aby kontrolować rozmiar bazy danych, możesz użyć zasad przechowywania. Aby dowiedzieć się więcej o zasadach przechowywania, przejdź do Czyszczenie danych za pomocą zasad przechowywania.

Przypadki rejestrowane przez łącznik Shopify

Nabywca:

Nabywca ma pusty adres e-mail.
Nabywca o tym samym adresie e-mail lub numerze telefonu już istnieje.

Firma: - Firma o tym samym identyfikatorze zewnętrznym już istnieje w Shopify.

Zaksięgowana faktura sprzedaży:

Nabywca nie istnieje w Shopify.
Brak mapowania warunków płatności.
Numer nabywcy jest domyślnym numerem nabywcy dla sklepu Shopify.
Numer nabywcy jest używany w szablonie nabywcy Shopify.
Faktura sprzedaży nie zawiera wierszy.
Nieprawidłowa (ujemna lub ułamkowa) ilość.
Pusta wartość liczbowa.

Produkt:

Zapas jest zablokowany/sprzedaż zablokowana (wariant zapasu).
Zapas jest zablokowany.
Opis zapasu jest pusty.

Katalog:

Synchronizacja cen, jeśli katalog nie został znaleziony w Shopify.

Wydania:

Powiązane zamówienie Shopify nie istnieje.
Żadne wiersze w zaksięgowanym wydaniu sprzedaży nie kwalifikują się do realizacji.
Nie znaleziono odpowiedniej realizacji w Shopify.

Jeśli uruchomisz synchronizację na pierwszym planie, otrzymasz powiadomienie, gdy rekordy zostały pominięte. Wybierz Wyświetl pominięte rekordy, aby otworzyć stronę Pominięte rekordy Shopify.

Przechwytywanie danych

Niezależnie od tego, czy rejestrowanie jest włączone, niektóre odpowiedzi Shopify są zawsze rejestrowane. Dzienniki można przeglądać lub pobierać na stronie Lista przechwytywania danych.

Wybierz akcję Pobrane dane Shopify na jednej z następujących stron:

Zamówienie Shopify
Wiersz zamówienia Shopify
Zakończona realizacja Shopify
Koszty wysyłki zamówienia Shopify
Transakcje zamówienia Shopify
Zwrot Shopify
Wiersz zwrotu Shopify
Refundacja Shopify
Wiersz refundacji Shopify
Wypłaty Shopify
Transakcje płatności Shopify
Transakcje Shopify

Resetowanie synchronizacji

Dla uzyskania optymalnej wydajności łącznik importuje tylko nabywców, produkty i zamówienia, które zostały utworzone lub zmienione od ostatniej synchronizacji. Na stronie Karta sklepu Shopify dostępne są funkcje, które zmieniają datę/godzinę ostatniej synchronizacji lub całkowicie ją resetują. Ta funkcja zapewnia synchronizację wszystkich danych, a nie tylko zmian od ostatniej synchronizacji.

Ta funkcja dotyczy tylko synchronizacji z Shopify do Business Central. Może być przydatna, gdy trzeba przywrócić usunięte dane, takie jak produkty, nabywcy lub usunięte zamówienia.

Żądanie tokenu dostępu

Jeśli Business Central nie łączy się z Twoim kontem Shopify, zażądaj tokenu dostępu od Shopify. Może być konieczne zażądanie nowego tokenu, jeśli nastąpiły zmiany w kluczach zabezpieczeń lub wymaganych uprawnieniach (zakresach aplikacji).

Wybierz ikonę , wprowadź Sklepy Shopify, a następnie wybierz powiązane łącze.
Wybierz sklep, dla którego chcesz uzyskać token dostępu, aby otworzyć stronę Karta sklepu Shopify.
Wybierz akcję Zażądaj dostępu.
Jeśli zostanie wyświetlony monit, zaloguj się na swoje konto Shopify.

Przełącznik Ma klucz dostępu jest włączony.

Weryfikacja i włączanie uprawnień do wykonywania żądań HTTP w środowisku nieprodukcyjnym

Aby działać prawidłowo, rozszerzenie Shopify Connector wymaga uprawnień do wykonywania żądań HTTP. Żądania HTTP są zabronione dla wszystkich rozszerzeń podczas uruchamiania testów w środowiskach piaskownicy.

Wybierz ikonę , wprowadź Zarządzanie rozszerzeniami, a następnie wybierz powiązane łącze.
Wybierz rozszerzenie Shopify Connector.
Wybierz akcję Konfiguruj, aby otworzyć stronę Ustawienia rozszerzenia.
Upewnij się, że przełącznik Zezwalaj na żądania HTTPClient jest włączony.

Rotacja tokenu dostępu Shopify

Poniższe procedury opisują sposób rotacji tokenu dostępu używanego przez łącznik Shopify do uzyskiwania dostępu do sklepu internetowego Shopify.

W Shopify

W panelu Shopify Admin przejdź do Apps.
Wybierz Usuń w wierszu z aplikacją Dynamics 365 Business Central.
Wybierz Usuń w wyświetlonym komunikacie.

W Business Central

Wybierz ikonę , wprowadź Sklepy Shopify, a następnie wybierz powiązane łącze.
Wybierz sklep, dla którego chcesz wykonać rotację tokenu dostępu, aby otworzyć stronę Karta sklepu Shopify.
Wybierz akcję Zażądaj dostępu.
Jeśli zostanie wyświetlony monit, zaloguj się na swoje konto Shopify, przejrzyj ustawienia prywatności i uprawnień, a następnie wybierz przycisk Zainstaluj aplikację.

Kroki rozwiązywania problemów dla określonych synchronizacji:

Rozwiązywanie problemów ze zwrotami

Gdy podczas tworzenia faktury korygującej na podstawie zwrotu wystąpi błąd, oprócz pola Ma błąd dostępny jest również konkretny komunikat o błędzie oraz stos wywołań na stronie Informacje o ostatnim błędzie, które mogą pomóc w zdiagnozowaniu problemu. Na przykład może wskazywać, że brakuje wartości w polu Nr konta zwrotu na stronie Karta sklepu Shopify.

Rozwiązywanie problemów z tworzeniem produktów podczas importowania do Business Central

Podczas importowania produktów z Shopify do Business Central łącznik Shopify Connector próbuje przekonwertować każdy produkt Shopify na zapas w Business Central. Czasami łącznik napotyka problem, często spowodowany dostosowaniami, który uniemożliwia mu konwersję produktu Shopify na zapas, przez co import kończy się niepowodzeniem.

Aby ułatwić identyfikację i rozwiązanie tych problemów, przejdź do strony Produkty Shopify i znajdź wpisy, w których pole Ma błąd jest zaznaczone. Pole Komunikat o błędzie, podobnie jak w przypadku zamówień Shopify, wyświetla komunikat o błędzie wyjaśniający, dlaczego nie można było utworzyć zapasu. Te informacje mogą pomóc w zrozumieniu głównej przyczyny problemu, co umożliwi podjęcie działań naprawczych. Następnie można użyć akcji Utwórz zapas, aby ręcznie ponownie uruchomić proces tworzenia zapasu.

Pola Shopify w zarchiwizowanych zamówieniach sprzedaży mogą pokazywać ręczne korekty

Zarchiwizowane zamówienia sprzedaży zawierają następujące pola:

Identyfikator zamówienia Shpfy i Nr zamówienia Shpfy w tabeli Archiwum nagłówków sprzedaży.
Identyfikator wiersza zamówienia Shpfy i Nr zamówienia Shpfy w tabeli Archiwum wierszy sprzedaży.

Pola nie są wyświetlane na stronie, ale można użyć inspektora strony, aby je przejrzeć lub eksplorować tabelę w celu zdiagnozowania przypadków, gdy zaimportowane zamówienie zostało ręcznie skorygowane. Czasami ręczne korekty wpływają na synchronizację wysyłek do przepływów Shopify.

Znane problemy

Błąd: Nagłówek sprzedaży nie istnieje. Pola i wartości identyfikacyjne: Typ dokumentu='Oferta',Nr='TWÓJ SKLEP SHOPIFY'

Aby obliczyć ceny, łącznik Shopify Connector tworzy tymczasowy dokument sprzedaży (ofertę) dla tymczasowego nabywcy (kod sklepu) i używa standardowej logiki obliczania cen. Jeśli rozszerzenie partnera subskrybuje zdarzenia na tymczasowym dokumencie sprzedaży, nagłówek może nie być dostępny. Zalecamy skontaktowanie się z dostawcą rozszerzenia. Poproś go o modyfikację kodu w celu sprawdzania rekordów tymczasowych. W niektórych przypadkach wystarczy dodać metodę IsTemporary we właściwym miejscu. Aby dowiedzieć się więcej o IsTemporary, przejdź do IsTemporary.

Aby sprawdzić, czy problem jest spowodowany przez rozszerzenie partnera, użyj łącza Kopiuj informacje do schowka w komunikacie o błędzie i skopiuj zawartość do edytora tekstu. Informacje zawierają stos wywołań AL, gdzie górna linia to linia, w której wystąpił błąd. Poniższy przykład przedstawia stos wywołań AL.

Stos wywołań AL:

[Object Name]([Object type] [Object Id]).[Function Name] line [XX] - [Extension Name] by [Publisher] 
...
"Sales Line"(Table 37)."No. - OnValidate"(Trigger) line 98 - Base Application by Microsoft
"Shpfy Product Price Calc."(CodeUnit 30182).CalcPrice line 20 - Shopify Connector by Microsoft
"Shpfy Create Product"(CodeUnit 30174).CreateTempProduct line 137 - Shopify Connector by Microsoft
"Shpfy Create Product"(CodeUnit 30174).CreateProduct line 5 - Shopify Connector by Microsoft
"Shpfy Create Product"(CodeUnit 30174).OnRun(Trigger) line 12 - Shopify Connector by Microsoft
"Shpfy Add Item to Shopify"(Report 30106)."Item - OnAfterGetRecord"(Trigger) line 2 - Shopify Connector by Microsoft
"Shpfy Products"(Page 30126)."AddItems - OnAction"(Trigger) line 5 - Shopify Connector by Microsoft

Pamiętaj, aby udostępnić informacje o stosie wywołań AL dostawcy rozszerzenia.

Błąd: Ogólna gosp. grupa księgowa musi mieć wartość w nabywcy: 'TWÓJ SKLEP SHOPIFY'. Nie może być zerowa ani pusta

Na stronie Karta sklepu Shopify w polu Kod szablonu nabywcy wybierz szablon, który ma wypełnione pole Ogólna gosp. grupa księgowa. Szablon nabywcy jest używany do tworzenia nabywców i obliczania cen sprzedaży w dokumentach sprzedaży.

Błąd: Importowanie danych do sklepu Shopify nie jest włączone. Przejdź do karty sklepu, aby to włączyć

Na stronie Karta sklepu Shopify włącz przełącznik Zezwalaj na synchronizację danych do Shopify. To ustawienie pomaga chronić sklep internetowy przed otrzymaniem danych demonstracyjnych z Business Central.

Błąd: Błąd Oauth invalid_request: Nie można odnaleźć aplikacji Shopify API z api_key

Aplikacja Embed App może używać adresu URL klienta w formacie: https://[application name].bc.dynamics.com. Łącznik Shopify nie działa z aplikacjami Embed Apps. Aby dowiedzieć się więcej, przejdź do Często zadawane pytania dotyczące szczegółów technicznych.

Błąd: Błąd wewnętrzny. Wygląda na to, że coś poszło nie tak po naszej stronie. Identyfikator żądania: XXXXXXXX-XXXX-XXXX-XXXX-XXXX

Skontaktuj się z pomocą techniczną Microsoft za pośrednictwem partnera Business Central w ciągu siedmiu dni od wystąpienia tego błędu i podaj identyfikator żądania. Aby dowiedzieć się więcej, zobacz Wsparcie dla łącznika Shopify.

Błąd: Błąd Oauth invalid_request: Twoje konto nie ma uprawnień do udzielenia żądanego dostępu dla tej aplikacji

The user who requested access doesn’t have the rights to manage apps (the ability to manage and install apps and channels, as well as potentially approve app charges). You might be able to resolve issue by installing the app as the account owner. Alternatively, you can check the App permission for the user in the User and permissions settings in your Shopify admin.

Potrzebujesz uprawnień do aktualizacji Dynamics 365 Business Central. Poproś właściciela sklepu o aktualizację tej aplikacji. Lub skontaktuj się z nim w sprawie dostępu do: [PERMISSION]

Zaktualizowana wersja łącznika wymaga więcej uprawnień (zakresów aplikacji) niż posiada użytkownik, który zażądał dostępu. Problem można rozwiązać, instalując aplikację jako właściciel konta. Alternatywnie można sprawdzić Uprawnienia aplikacji dla użytkownika w ustawieniach Użytkownicy i uprawnienia w panelu Shopify admin. Jeśli brakuje wymaganych uprawnień, co można zobaczyć w komunikacie o błędzie, poproś właściciela konta o przyznanie wymaganych uprawnień.

Błąd: Zakres aplikacji został zmieniony, poproś o nowy token dostępu dla sklepu 'TWÓJ SKLEP SHOPIFY'

Zażądaj nowego tokenu, ponieważ zaktualizowana wersja łącznika wymaga więcej uprawnień (zakresów aplikacji). Aby dowiedzieć się więcej, przejdź do Żądanie tokenu dostępu.

[{"message":"Access denied for FIELD field.","locations":[{"line":0,"column":0}],"path":["path"],"extensions":{"code":"ACCESS_DENIED","documentation":https://shopify.dev/api/usage/access-scopes}}]