Fehlerbehebung bei der Synchronisierung zwischen Shopify und Business Central

2025-04-09

Eventuell müssen Sie bei der Synchronisierung von Daten zwischen Shopify und Business Central Probleme beheben. Auf dieser Seite werden Schritte zur Fehlerbehebung bei einigen häufig auftretenden Szenarien definiert.

Aufgaben im Vordergrund ausführen

Wählen Sie das Symbol aus, geben Sie Shopify-Shop ein und wählen Sie dann den entsprechenden Link aus.
Wählen Sie den Shop aus, für den Sie Probleme lösen möchten, um die Seite Shopify-Shop-Karte zu öffnen.
Schalten Sie den Schalter Hintergrundsynchronisationen zulassen aus.

Wenn nun die Synchronisierungsaktion ausgelöst wird, wird die Aufgabe im Vordergrund ausgeführt. Wenn ein Fehler auftritt, erhalten Sie einen Fehlerdialog mit einem Details kopieren-Link. Verwenden Sie den Link, um Informationen zur weiteren Analyse in einen Texteditor zu kopieren.

Protokolle

Die Protokollierungsfunktionen können es einfacher machen, herauszufinden, warum ein Fehler aufgetreten ist. Auf der Seite Shopify Shop-Karte im Feld Protokollierungsmodus können Sie den Detaillierungsgrad angeben, den Sie über Fehler erfassen möchten. Das Feld bietet die folgenden Optionen:

Deaktiviert – Protokollieren Sie keine Informationen über Fehler.
Nur Fehler – Protokollieren Sie nur die Fehlermeldung, ohne die Anforderungs-/Antwortpaare. Diese Einstellung ist die Standardeinstellung für neue Shops.
Alle: Protokollieren Sie die Anforderungs-/Antwortpaare für alle Transaktionen, einschliesslich für erfolgreiche Paare. Die kontinuierliche Protokollierung aller Fehler kann Business Central verlangsamen. Verwenden Sie diesen Modus, wenn der Datenaustausch nicht zu Fehlern führt, Sie aber Erkenntnisse über die Daten erhalten möchten, die gesendet und empfangen wurden. Manche Daten werden immer protokolliert, ungeachtet dessen, ob die Protokollierung aktiviert ist oder nicht. Weitere Informationen finden Sie unter Datenerfassung.

Um die Protokolle zu überprfen

Wählen Sie das Symbol aus, geben Sie Shopify-Protokolleinträge ein und wählen Sie dann den entsprechenden Link aus.
Wählen Sie den zugehörigen Protokolleintrag aus und öffnen Sie dann die Seite Shopify-Protokolleintrag.
Überprüfen Sie die Anfrage, den Statuscode und die Beschreibung sowie die Antwortwerte.

Trinkgeld

Wenn Sie Kontakt mit dem Shopify-Support aufnehmen müssen, da Sie bei der Fehlerbehebung Hilfe benötigen, beachten Sie die Informationen im Feld Anfrage ID. Mithilfe dieser Informationen kann der Support das Problem schneller lösen.

Sie können die Anfrage- und Antwortwerte als Dateien im Textformat herunterladen.

Verwalten von Protokolleinträgen

Um die Grösse Ihrer Datenbank unter Kontrolle zu halten, sind Protokolleinträge in einer Datenaufbewahrungsrichtlinie mit dem Namen Shopify Protokolleintrag. Mit Aufbewahrungsrichtlinien können Sie festlegen, wie lange Sie verschiedene Datentypen speichern möchten. Standardmässig werden Shopify Protokolleinträge einen Monat lang aufbewahrt. Weitere Informationen zu Aufbewahrungsrichtlinien finden Sie unter Aufbewahrungsrichtlinien definieren.

Auf der Seite Shopify Protokolleinträge können Sie ausserdem alle Protokolleinträge oder die Einträge löschen, die älter als sieben Tage sind.

Beheben von Exportproblemen

Wenn Sie Daten zu Shopify exportieren, überspringt der Shopify-Connector Datensätze, die Shopify ablehnen würde oder aus anderen Gründen nicht für den Export geeignet sind. Obwohl das Verhalten erwartet wird, können Sie verwirrt sein, wenn einige Informationen nicht wie erwartet verarbeitet wurden. Sie finden diese Einträge auf der Seite Übersprungene Shopify-Datensätze, auf der alle übersprungenen Datensätze sowie die Gründe angezeigt werden.

Das Feld Protokollierungsmodus steuert den Inhalt der Seite Übersprungene Shopify-Datensätze.

Notiz

Die Option Alle funktioniert genauso wie Nur Fehler und protokolliert nur übersprungene Einträge. Posten, die zuvor übersprungen wurden, werden nicht protokolliert.

Im Laufe der Zeit kann die Anzahl der Datensätze auf der Seite „Übersprungene Shopify-Datensätze“ sehr gross werden. Um die Grösse Ihrer Datenbank unter Kontrolle zu halten, können Sie eine Aufbewahrungsrichtlinie verwenden. Weitere Informationen zu Aufbewahrungsrichtlinien finden Sie unter Aufbewahrungsrichtlinien definieren.

Fälle, die der Shopify-Connector protokolliert

Debitor:

Ein Kunde hat eine leere E-Mail-Adresse.
Es gibt bereits einen Debitor mit derselben E-Mail-Adresse oder Telefonnummer.

Gebuchte Verkaufsrechnung:

Debitor ist in Shopify nicht vorhanden.
Die Zuordnung der Zahlungsbedingungen fehlt.
Debitorennummer ist die Standarddebitorennummer für den Shopify-Shop.
Die Debitorennummer wird in der Shopify-Debitorenvorlage verwendet.
In der Verkaufsrechnung sind keine Zeilen vorhanden.
Ungültige (negative oder bruchstückhafte) Menge.
Leerer Zahlenwert.

Produkt:

Der Artikel bzw. Verkauf ist gesperrt (Artikelvariante).
Artikel ist gesperrt.
Die Artikelbeschreibung ist leer.

Katalog:

Preissynchronisierung, wenn der Katalog nicht in Shopify gefunden wird.

Lieferungen:

Es ist kein entsprechender Shopify-Auftrag vorhanden.
Keine Zeilen in der gebuchten Verkaufslieferung sind für das Fulfillment geeignet.
In Shopify wurde keine entsprechende Auftragserfüllung gefunden.

Wenn Sie die Synchronisierung im Vordergrund ausführen, erhalten Sie eine Benachrichtigung, wenn Datensätze übersprungen wurden. Wählen Sie Übersprungene Datensätze anzeigen aus, um die Seite Übersprungene Shopify-Datensätze zu öffnen.

Datenerfassung

Unabhängig davon, ob die Protokollierung eingeschaltet ist, werden einige Shopify-Antworten immer protokolliert. Sie können die Protokolle auf der Seite Datenerfassungsliste einsehen oder herunterladen.

Wählen Sie auf einer der folgenden Seiten die Aktion Abgerufene Shopify Daten:

Shopify-Auftrag
Shopify-Auftragsposition
Shopify-Auftragserfüllungen
Shopify-Auftragslieferkosten
Shopify-Auftragstransaktionen
Shopify-Rückgabe
Shopify-Rückgabeposition
Shopify-Erstattung
Shopify-Erstattungsposition
Shopify-Auszahlungen
Shopify-Zahlungstransaktionen
Shopify-Transaktionen

Synchronisierung zurücksetzen

Für eine optimale Leistung importiert der Connector nur Debitoren, Produkte und Aufträge, die nach der letzten Synchronisierung erstellt oder geändert wurden. Auf der Seite Shopify Shop-Karte stehen Ihnen Funktionen zur Verfügung, mit denen Sie das Datum/die Uhrzeit der letzten Synchronisierung ändern oder komplett zurücksetzen können. Diese Funktion stellt sicher, dass alle Daten synchronisiert werden, nicht nur die Änderungen seit der letzten Synchronisierung.

Diese Funktion gilt nur für Synchronisierungen von Shopify nach Business Central. Sie kann nützlich sein, wenn Sie gelöschte Daten wie Produkte, Kunden oder gelöschte Bestellungen wiederherstellen müssen.

Fordern Sie das Access-Token an

Wenn Business Central keine Verbindung zu Ihrem Shopify-Konto herstellt, fordern Sie den Zugriffstoken von Shopify an. Möglicherweise müssen Sie ein neues Token beantragen, wenn Änderungen an den Sicherheitsschlüsseln oder erforderlichen Berechtigungen (Anwendungsbereichen) vorgenommen wurden.

Wählen Sie das Symbol aus, geben Sie Shopify-Shops ein und wählen Sie den entsprechenden Link aus.
Wählen Sie den Shop aus, für den Sie den Zugriffstoken abrufen möchten, um die Seite Shopify-Shop-Karte zu öffnen.
Wählen Sie die Aktion Zugriff anfordern aus.
Melden Sie sich bei Ihrem Shopify-Konto an, falls Sie dazu aufgefordert werden.

Der Schalter Hat AccessKey ist eingeschaltet.

Die Berechtigungen für HTTP-Anforderungen in einer Nichtproduktionsumgebung überprüfen und aktivieren

Damit die Shopify Connector-Erweiterung korrekt funktioniert, benötigt sie die Berechtigung, HTTP-Anfragen zu stellen. HTTP-Anfragen sind für alle Erweiterungen verboten, wenn Sie Tests in Sandbox-Umgebungen ausführen.

Wählen Sie das Symbol aus, geben Sie Erweiterungsverwaltung ein und wählen Sie dann den entsprechenden Link aus.
Wählen Sie die Erweiterung Shopify Konnektor.
Wählen Sie die Aktion Konfigurieren, um die Seite Erweiterungseinstellungen zu öffnen.
Stellen Sie sicher, dass der Schalter HTTPClient-Anfragen zulassen aktiviert ist.

Shopify-Zugriffstoken rotieren

Die folgenden Prozeduren beschreiben, wie Sie den Access Token, der vom Shopify- Konnektor für den Zugriff auf Ihren Shopify Onlineshop verwendet wird, rotieren können.

In Shopify

Gehen Sie in Ihrem Shopify Admin zu Apps.
Wählen Sie Löschen in der Zeile mit der Dynamics 365 Business Central-App aus.
In der angezeigten Nachricht wählen Sie Löschen.

In Business Central

Wählen Sie das Symbol aus, geben Sie Shopify-Shops ein und wählen Sie dann den entsprechenden Link aus.
Wählen Sie den Shop, für den Sie den Access-Token rotieren möchten, um die Seite Shopify Shop-Karte zu öffnen.
Wählen Sie die Aktion Zugriff anfordern aus.
Wenn Sie dazu aufgefordert werden, melden Sie sich bei Ihrem an Shopify-Konto an, überprüfen Sie den Datenschutz und die Berechtigungen, und wählen Sie dann die Schaltfläche App installieren aus.

Bekannte Probleme

Fehler: Der Verkaufskopf existiert nicht. Identifizierungsfelder und -werte: Dokumententyp='Quote',No.='YOUR SHOPIFY STORE'

Um die Preise zu berechnen, erstellt der Shopify-Connector ein temporäres Verkaufsdokument (Offerte) für einen temporären Debitor (Geschäftscode) und lässt die Standard-Preisberechnungslogik ihre Arbeit erledigen. Wenn eine Partnererweiterung Ereignisse in einem temporären Verkaufsbeleg abonniert, ist die Kopfzeile möglicherweise nicht verfügbar. Wir empfehlen Ihnen, sich an den Erweiterungsanbieter zu wenden. Bitten Sie ihn, seinen Code zu ändern, um nach temporären Datensätzen zu suchen. In einigen Fällen muss er nur die IsTemporary-Methode an der richtigen Stelle hinzufügen. Um mehr über IsTemporary zu erfahren, gehen Sie zu IsTemporary.

Um zu überprüfen, ob das Problem durch eine Partnererweiterung verursacht wird, verwenden Sie die Verknüpfung Informationen in die Zwischenablage kopieren in der Fehlermeldung und kopieren Sie den Inhalt in den Texteditor. Die Informationen enthalten eine AL-Aufrufliste, wobei die oberste Zeile die Zeile ist, in der der Fehler aufgetreten ist. Das Folgende ist ein Beispiel einer AL-Aufrufliste.

Al-Aufrufliste:

[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

Denken Sie daran, die AL-Aufruflisten-Informationen mit dem Anbieter der Nebenstelle zu teilen.

Fehler: Gen. Die Geschäftsbuchungsgruppe muss einen Wert in Debitor haben: „IHR SHOPIFY-GESCHÄFT“. Sie darf nicht leer sein

Wählen Sie im Feld Debitorenvorlagencode im Fenster Shopify Shop-Karte die Vorlage aus, in der Geschäftsbuchungsgruppe ausgefüllt ist. Die Debitorenvorlage wird zum Anlegen von Debitoren und zum Berechnen von Verkaufspreisen auf Verkaufsbelegen verwendet.

Fehler: Importieren von Daten in Ihren Shopify Shop ist nicht aktiviert. Gehen Sie zur Shop-Karte, um sie zu aktivieren

Aktivieren Sie die Seite Shopify Shop-KarteDatensynchronisierung mit Shopify zulassen. Diese Einstellung hilft, den Onlineshop davor zu schützen, dass er Demodaten aus Business Central abruft.

Fehler: OAuth-Fehler invalid_request: Shopify-API-Anwendung mit api_key wurde nicht gefunden

Die Einbettungs-App kann die Client-URL im folgenden Format verwenden: https://[application name].bc.dynamics.com. Der Konnektor Shopify funktioniert nicht für Embed Apps. Um mehr zu erfahren, gehen Sie zu Welche Microsoft-Produkte funktionieren mit dem Shopify Connector?

Fehler: Interner Fehler. Anscheinend ist auf Ihrer Seite ein Fehler aufgetreten. Anforderungs-ID: XXXXXXXX-XXXX-XXXX-XXXX-XXXX

Wenden Sie sich innerhalb von sieben Tagen nach Auftreten dieses Fehlers über Ihren Business Central-Partner an den Microsoft-Support und geben Sie die Anforderungs-ID an. Weitere Informationen finden Sie unter Support für den Shopify-Connector.

Fehler: OAuth-Fehler invalid_request: Ihr Konto verfügt nicht über die Berechtigung, den angeforderten Zugriff für diese App zu gewähren

Der Benutzende, der Zugriff anfordert, hat nicht die notwendige Berechtigung zum Verwalten von Apps (die Möglichkeit, Apps und Kanäle zu verwalten und zu installieren und möglicherweise App-Gebühren zu genehmigen). Möglicherweise können Sie dieses Problem beheben, indem Sie die App als Kontoinhaber installieren. Alternativ können Sie die App-Berechtigung für den Benutzenden in den Einstellungen Benutzer und Berechtigungen in Ihrer Shopify-Verwaltung überprüfen.

Sie benötigen Berechtigungen für die Aktualisierung von Dynamics 365 Business Central. Bitten Sie den Inhaber, diese App zu aktualisieren. Oder kontaktieren Sie ihn, um Zugriff zu erhalten: [BERECHTIGUNG]

Die aktualisierte Version des Connectors erfordert mehr Berechtigungen (Anwendungsbereiche), als der Benutzende hat, der den Zugriff angefordert hat. Möglicherweise können Sie dieses Problem beheben, indem Sie die App als Kontoinhaber installieren. Alternativ können Sie die App-Berechtigung für den Benutzenden in den Einstellungen für Benutzender und Berechtigungen in Ihrer Shopify-Verwaltung überprüfen. Wenn die erforderlichen Berechtigungen fehlen, was Sie in der Fehlermeldung sehen können, bitten Sie den Kontoinhaber, die erforderlichen Berechtigungen zu erteilen.

Fehler: Der Anwendungsbereich wurde geändert, fordern Sie ein neues Zugriffstoken für den Store „IHR SHOPIFY-STORE“ an

Fordern Sie ein neues Token an, da die aktualisierte Version des Connectors mehr Berechtigungen (Anwendungsbereiche) erfordert. Weitere Informationen finden Sie unter Anforderung des Zugriffstokens.

[{„message“:„Zugriff für FELD-Feld verweigert.“,„locations“:[{„line“:0,„column“:0}],„path“:[„path“],„extensions“:{„code“:„ACCESS_DENIED“,„documentation“:https://shopify.dev/api/usage/access-scopes}}]