Prasyarat
Sebelum Anda mulai, pastikan Anda memiliki yang berikut:
- Langganan penetapan harga inklusif aktif dengan Zonos.
- Kunci API GraphQL Secret dari Zonos Dashboard Anda. Navigasikan ke Pengaturan -> Integrasi untuk menemukan kunci API Anda. Kunci harus memiliki awalan
credential_livedan tidak boleh kedaluwarsa.
Penyetelan pertama kali
Ikuti langkah-langkah ini untuk menyiapkan template laporan penetapan harga inklusif untuk pertama kalinya.
Salin template Google Sheet
Buka template laporan penetapan harga inklusif dan buat salinan Anda sendiri dengan membuka File -> Buat salinan. Jangan minta akses editor ke lembar asli.
Hubungkan kunci API Anda
Di lembar yang Anda salin, klik Zonos -> Perbarui Kunci API GraphQL dari bilah menu (di sebelah Bantuan). Opsi menu ini dapat memakan waktu satu menit untuk muncul setelah membuka lembar.
Otorisasi skrip
Untuk pengguna pertama kali, dialog otorisasi akan muncul. Klik OK, kemudian ikuti petunjuk untuk mengotorisasi skrip dengan akun Google Anda:
- Klik Pilih semua untuk memberikan izin yang diperlukan.
- Klik Lanjutkan untuk menyelesaikan otorisasi.
Masukkan kunci API Secret Anda
Setelah otorisasi, dialog akan meminta Anda memasukkan kunci API GraphQL Secret Zonos Anda. Anda dapat menemukannya di Zonos Dashboard Anda di bawah Pengaturan -> Integrasi.
Pastikan untuk menyalin kunci Secret yang valid dengan awalan credential_live. Kunci yang kedaluwarsa atau kunci Publik akan menyebabkan kesalahan.
Ambil pesanan
Klik Zonos -> Ambil Pesanan dari bilah menu.
Pilih rentang tanggal
Masukkan tanggal mulai dan akhir dalam dialog, atau gunakan salah satu opsi preset (30 hari terakhir, Bulan ini, Bulan terakhir, Tahun ini), kemudian klik Ambil Pesanan.
Setelah selesai, pesanan Anda akan diisi di tab Pesanan lembar.
Catatan: Untuk menyimpan laporan untuk referensi di masa mendatang, klik kanan tab Pesanan dan pilih Duplikat, kemudian ganti nama sesuai kebutuhan. Anda juga dapat mengekspor atau membuat salinan seluruh spreadsheet.
Penggunaan sehari-hari
Setelah menyelesaikan penyetelan pertama kali, menghasilkan laporan baru sangat mudah:
- Lewatkan langkah 1-3 - Ini adalah proses sekali.
- Lewatkan langkah 4 kecuali kunci API Anda telah kedaluwarsa atau Anda perlu menarik data dari toko Zonos yang berbeda.
- Ulangi langkah 5 dan 6 untuk mengambil pesanan untuk rentang tanggal baru.
Kesalahan 401 Unauthorized
Anda mungkin melihat kesalahan yang berisi HTTP fetch failed from 'order': 401: Unauthorized.
Perbaiki: Pastikan Anda menggunakan kunci API GraphQL Secret yang valid dari Zonos Dashboard Anda. Kesalahan ini terjadi ketika kunci hilang, tidak valid, atau bukan tipe kunci Secret.
Kesalahan persyaratan keamanan gagal
Anda mungkin melihat kesalahan yang berisi Security requirement failed.
Perbaiki: Pastikan Anda menggunakan kunci API GraphQL Secret (bukan kunci Publik) dan tidak memiliki status Kedaluwarsa. Navigasikan ke Pengaturan -> Integrasi di Zonos Dashboard Anda untuk memverifikasi status kunci Anda.
Tidak ada pesanan yang muncul
Tidak ada pesanan yang diisi meskipun memberikan kunci API Secret yang valid.
Perbaiki: Laporan ini hanya menghasilkan data untuk pesanan dengan atribut penetapan harga inklusif. Jika item Anda tidak berisi bidang reverseAmountDetail, mereka tidak akan disertakan. Verifikasi bahwa Anda telah memproses pesanan penetapan harga inklusif dalam rentang tanggal yang Anda pilih.
Laporan ekspor penetapan harga inklusif
Hasilkan rincian penetapan harga inklusif tingkat item menggunakan Google Sheet.
Template laporan penetapan harga inklusif adalah Google Sheet dengan skrip bawaan yang mengkueri API GraphQL Zonos untuk pesanan Anda dan menghasilkan laporan yang menunjukkan rincian tingkat item dari jumlah dasar dan inklusif. Ini berguna bagi pedagang mana pun yang menginginkan visibilitas ke dalam bagaimana bea, pajak, dan biaya didistribusikan di seluruh item dalam pesanan penetapan harga inklusif mereka.