Prerequisiti
Prima di iniziare, si assicuri di disporre di quanto segue:
- Un abbonamento attivo a inclusive pricing con Zonos.
- Una chiave API GraphQL Secret dal Suo Zonos Dashboard. Vada su Settings -> Integrations per trovare le Sue chiavi API. La chiave deve avere il prefisso
credential_livee non deve essere scaduta.
Configurazione iniziale
Segua questi passaggi per configurare il modello di report di inclusive pricing per la prima volta.
Copi il modello Google Sheet
Apra il modello di report di inclusive pricing e crei una copia personale andando su File -> Make a copy. Non richieda l'accesso come editor al foglio originale.
Colleghi la Sua chiave API
Nel foglio copiato, faccia clic su Zonos -> Update GraphQL API Key dalla barra dei menu (accanto a Help). Questa opzione di menu può richiedere un minuto per comparire dopo l'apertura del foglio.
Autorizzi lo script
Per i nuovi utenti, comparirà una finestra di dialogo di autorizzazione. Faccia clic su OK, quindi segua le istruzioni per autorizzare lo script con il Suo account Google:
- Faccia clic su Select all per concedere le autorizzazioni richieste.
- Faccia clic su Continue per completare l'autorizzazione.
Inserisca la Sua chiave API Secret
Dopo l'autorizzazione, una finestra di dialogo Le chiederà di inserire la Sua chiave API GraphQL Secret Zonos. La trova nel Suo Zonos Dashboard in Settings -> Integrations.
Si assicuri di copiare una chiave Secret valida con prefisso credential_live. Chiavi scadute o chiavi Public causeranno errori.
Recuperi gli ordini
Faccia clic su Zonos -> Fetch Orders dalla barra dei menu.
Selezioni un intervallo di date
Inserisca una data di inizio e fine nella finestra di dialogo oppure usi una delle opzioni predefinite (Last 30 days, This month, Last month, This year), quindi faccia clic su Fetch Orders.
Al termine, i Suoi ordini verranno popolati nella scheda Orders del foglio.
Nota: Per salvare un report per riferimento futuro, faccia clic con il tasto destro sulla scheda Orders e selezioni Duplicate, quindi la rinomini come necessario. Può anche esportare o creare una copia dell'intero foglio di calcolo.
Uso quotidiano
Dopo aver completato la configurazione iniziale, generare nuovi report è semplice:
- Salti i passaggi 1-3 — Sono un processo una tantum.
- Salti il passaggio 4 a meno che la Sua chiave API non sia scaduta o debba recuperare dati da un negozio Zonos diverso.
- Ripeta i passaggi 5 e 6 per recuperare ordini per un nuovo intervallo di date.
Errore 401 Unauthorized
Può comparire un errore contenente HTTP fetch failed from 'order': 401: Unauthorized.
Soluzione: Si assicuri di usare una chiave API GraphQL Secret valida dal Suo Zonos Dashboard. Questo errore si verifica quando la chiave manca, non è valida o non è di tipo Secret.
Errore Security requirement failed
Può comparire un errore contenente Security requirement failed.
Soluzione: Si assicuri di usare la chiave API GraphQL Secret (non una chiave Public) e che non abbia lo stato Expired. Vada su Settings -> Integrations nel Suo Zonos Dashboard per verificare lo stato della chiave.
Nessun ordine compare
Nessun ordine viene popolato nonostante una chiave API GraphQL Secret valida.
Soluzione: Questo report genera dati solo per ordini con attributi di inclusive pricing. Se i Suoi articoli non contengono campi reverseAmountDetail, non saranno inclusi. Verifichi di aver elaborato ordini con inclusive pricing nell'intervallo di date selezionato.
Esporta report di inclusive pricing
Generi una ripartizione di inclusive pricing a livello di articolo usando un Google Sheet.
Il modello di report di inclusive pricing è un Google Sheet con uno script integrato che interroga l'API GraphQL Zonos per i Suoi ordini e genera un report con ripartizioni a livello di articolo degli importi base e inclusivi. È utile per qualsiasi merchant che desideri visibilità su come dazi, imposte e commissioni sono distribuiti tra gli articoli nei Suoi ordini con inclusive pricing.