Voraussetzungen
Stellen Sie vor Beginn Folgendes sicher:
- Ein aktives Inclusive Pricing-Abonnement bei Zonos.
- Einen Secret GraphQL-API-Schlüssel aus Ihrem Zonos Dashboard. Navigieren Sie zu Settings -> Integrations, um Ihre API-Schlüssel zu finden. Der Schlüssel muss das Präfix
credential_livehaben und darf nicht abgelaufen sein.
Ersteinrichtung
Folgen Sie diesen Schritten, um die Inclusive-Pricing-Berichtsvorlage zum ersten Mal einzurichten.
Google-Sheet-Vorlage kopieren
Öffnen Sie die Inclusive-Pricing-Berichtsvorlage und erstellen Sie Ihre eigene Kopie unter File -> Make a copy. Fordern Sie keinen Bearbeitungszugriff auf das Original-Sheet an.
API-Schlüssel verbinden
Klicken Sie in Ihrer Kopie auf Zonos -> Update GraphQL API Key in der Menüleiste (neben Help). Diese Menüoption kann nach dem Öffnen des Sheets eine Minute dauern, bis sie erscheint.
Skript autorisieren
Für Erstbenutzer erscheint ein Autorisierungsdialog. Klicken Sie auf OK und folgen Sie den Anweisungen, um das Skript mit Ihrem Google-Konto zu autorisieren:
- Klicken Sie auf Select all, um die erforderlichen Berechtigungen zu erteilen.
- Klicken Sie auf Continue, um die Autorisierung abzuschließen.
Secret-API-Schlüssel eingeben
Nach der Autorisierung werden Sie aufgefordert, Ihren Zonos Secret GraphQL-API-Schlüssel einzugeben. Sie finden diesen in Ihrem Zonos Dashboard unter Settings -> Integrations.
Kopieren Sie einen gültigen Secret-Schlüssel mit dem Präfix credential_live. Abgelaufene Schlüssel oder Public Keys führen zu Fehlern.
Bestellungen abrufen
Klicken Sie in der Menüleiste auf Zonos -> Fetch Orders.
Datumsbereich auswählen
Geben Sie im Dialog ein Start- und Enddatum ein oder verwenden Sie eine der Voreinstellungen (Last 30 days, This month, Last month, This year) und klicken Sie dann auf Fetch Orders.
Nach Abschluss werden Ihre Bestellungen im Tab Orders des Sheets angezeigt.
Hinweis: Um einen Bericht zur späteren Verwendung zu speichern, klicken Sie mit der rechten Maustaste auf den Tab Orders und wählen Sie Duplicate, benennen Sie ihn dann nach Bedarf um. Sie können auch das gesamte Spreadsheet exportieren oder kopieren.
Tägliche Nutzung
Nach Abschluss der Ersteinrichtung ist die Erstellung neuer Berichte unkompliziert:
- Schritte 1–3 überspringen – Dies ist ein einmaliger Prozess.
- Schritt 4 überspringen, es sei denn, Ihr API-Schlüssel ist abgelaufen oder Sie müssen Daten aus einem anderen Zonos-Shop abrufen.
- Schritte 5 und 6 wiederholen, um Bestellungen für einen neuen Datumsbereich abzurufen.
401 Unauthorized-Fehler
Sie sehen möglicherweise einen Fehler mit HTTP fetch failed from 'order': 401: Unauthorized.
Lösung: Stellen Sie sicher, dass Sie einen gültigen Secret GraphQL-API-Schlüssel aus Ihrem Zonos Dashboard verwenden. Dieser Fehler tritt auf, wenn der Schlüssel fehlt, ungültig ist oder kein Secret-Schlüsseltyp ist.
Security requirement failed-Fehler
Sie sehen möglicherweise einen Fehler mit Security requirement failed.
Lösung: Stellen Sie sicher, dass Sie den Secret GraphQL-API-Schlüssel (keinen Public Key) verwenden und dass er nicht den Status Expired hat. Navigieren Sie zu Settings -> Integrations in Ihrem Zonos Dashboard, um den Status Ihres Schlüssels zu überprüfen.
Keine Bestellungen erscheinen
Es werden keine Bestellungen angezeigt, obwohl ein gültiger Secret GraphQL-API-Schlüssel angegeben wurde.
Lösung: Dieser Bericht generiert nur Daten für Bestellungen mit Inclusive-Pricing-Attributen. Wenn Ihre Artikel keine reverseAmountDetail-Felder enthalten, werden sie nicht einbezogen. Überprüfen Sie, ob Sie Inclusive-Pricing-Bestellungen innerhalb des ausgewählten Datumsbereichs verarbeitet haben.
Inclusive-Pricing-Bericht exportieren
Erstellen Sie eine Inclusive-Pricing-Aufschlüsselung auf Artikelebene mit einem Google Sheet.
Die Inclusive-Pricing-Berichtsvorlage ist ein Google Sheet mit einem integrierten Skript, das die Zonos GraphQL-API für Ihre Bestellungen abfragt und einen Bericht mit Artikelaufschlüsselungen von Basis- und Inclusive-Beträgen erstellt. Dies ist nützlich für Händler, die Einblick in die Verteilung von Zöllen, Steuern und Gebühren auf Artikel in ihren Inclusive-Pricing-Bestellungen wünschen.