Vereisten
Zorg vóór u begint dat u het volgende hebt:
- Een actief inclusive pricing-abonnement bij Zonos.
- Een Secret GraphQL API-sleutel uit uw Zonos Dashboard. Ga naar Settings -> Integrations om uw API-sleutels te vinden. De sleutel moet een
credential_live-prefix hebben en mag niet zijn verlopen.
Eerste installatie
Volg deze stappen om het sjabloon voor het inclusive pricing-rapport voor het eerst in te stellen.
Kopieer het Google Sheet-sjabloon
Open het sjabloon voor het inclusive pricing-rapport en maak uw eigen kopie via File -> Make a copy. Vraag geen editor-toegang aan tot het originele blad.
Koppel uw API-sleutel
Klik in uw gekopieerde blad op Zonos -> Update GraphQL API Key in de menubalk (naast Help). Deze menuoptie kan een minuut duren voordat deze verschijnt na het openen van het blad.
Autoriseer het script
Voor nieuwe gebruikers verschijnt een autorisatiedialoog. Klik op OK en volg de prompts om het script te autoriseren met uw Google-account:
- Klik op Select all om de vereiste machtigingen te verlenen.
- Klik op Continue om de autorisatie te voltooien.
Voer uw Secret API-sleutel in
Na autorisatie vraagt een dialoog u om uw Zonos Secret GraphQL API-sleutel in te voeren. U vindt deze in uw Zonos Dashboard onder Settings -> Integrations.
Kopieer een geldige Secret-sleutel met een credential_live-prefix. Verlopen sleutels of Public-sleutels veroorzaken fouten.
Bestellingen ophalen
Klik op Zonos -> Fetch Orders in de menubalk.
Selecteer een datumbereik
Voer een begin- en einddatum in de dialoog in, of gebruik een van de voorinstellingen (Last 30 days, This month, Last month, This year), en klik vervolgens op Fetch Orders.
Wanneer het proces is voltooid, worden uw bestellingen ingevuld op het tabblad Orders van het blad.
Opmerking: Om een rapport voor later te bewaren, klikt u met de rechtermuisknop op het tabblad Orders en selecteert u Duplicate, en hernoemt u het indien nodig. U kunt het hele spreadsheet ook exporteren of kopiëren.
Dagelijks gebruik
Na het voltooien van de eerste installatie is het genereren van nieuwe rapporten eenvoudig:
- Sla stappen 1-3 over — Dit is een eenmalig proces.
- Sla stap 4 over tenzij uw API-sleutel is verlopen of u gegevens uit een andere Zonos-winkel wilt ophalen.
- Herhaal stappen 5 en 6 om bestellingen op te halen voor een nieuw datumbereik.
401 Unauthorized-fout
U kunt een fout zien met HTTP fetch failed from 'order': 401: Unauthorized.
Oplossing: Zorg dat u een geldige Secret GraphQL API-sleutel uit uw Zonos Dashboard gebruikt. Deze fout treedt op wanneer de sleutel ontbreekt, ongeldig is of geen Secret-sleuteltype is.
Security requirement failed-fout
U kunt een fout zien met Security requirement failed.
Oplossing: Zorg dat u de Secret GraphQL API-sleutel gebruikt (geen Public-sleutel) en dat deze niet de status Expired heeft. Ga naar Settings -> Integrations in uw Zonos Dashboard om de status van uw sleutel te controleren.
Geen bestellingen verschijnen
Er worden geen bestellingen ingevuld ondanks een geldige Secret GraphQL API-sleutel.
Oplossing: Dit rapport genereert alleen gegevens voor bestellingen met inclusive pricing-attributen. Als uw artikelen geen reverseAmountDetail-velden bevatten, worden ze niet opgenomen. Controleer of u inclusive pricing-bestellingen hebt verwerkt binnen het datumbereik dat u hebt geselecteerd.
Inclusive pricing-rapport exporteren
Genereer een uitsplitsing van inclusive pricing op artikelniveau met een Google Sheet.Het sjabloon voor het inclusive pricing-rapport is een Google Sheet met een ingebouwd script dat de Zonos GraphQL API bevraagt voor uw bestellingen en een rapport genereert met uitsplitsingen op artikelniveau van basis- en inclusive bedragen. Dit is nuttig voor elke merchant die inzicht wil in hoe invoerrechten, belastingen en kosten over artikelen zijn verdeeld in inclusive pricing-bestellingen.