Pengaturan akun

Buat Akun Terverifikasi Anda, tambahkan metode pembayaran, dan hubungkan integrasi Anda.

Langkah 1 — Buat Akun Terverifikasi Anda

Daftar untuk Akun Terverifikasi Zonos menggunakan tautan pendaftaran Česká pošta. Lengkapi alamat bisnis dan pengaturan penagihan Anda.

Langkah 2 — Tambahkan metode pembayaran

Tambahkan metode pembayaran ke akun Zonos Anda untuk mendanai pembayaran bea cukai untuk pengiriman yang ditujukan ke AS.

Langkah 3 — Dapatkan kunci API Anda

Masuk ke Zonos Dashboard dan navigasi ke Account → Integrations. Tabel menampilkan dua kunci:

Nama di Dashboard↕	Tujuan↕	Gunakan untuk API?↕
Account key	Pengenal untuk menghubungkan dengan operator pos	❌ TIDAK
API key	Kunci autentikasi untuk memanggil API Zonos	✅ YA — gunakan ini

Salin token di baris API key. Dimulai dengan credential_live_. Anda akan memerlukan kunci ini untuk kedua metode integrasi.

Jaga keamanan kunci API Anda. Jangan commit kunci ini ke sistem kontrol versi atau bagikan secara publik. Jika Anda merasa kunci ini telah disusupi, buat ulang dari halaman Account → Integrations yang sama.

Langkah 4 (opsional) — Perkirakan biaya bea cukai dengan Item Quoter

Alat Item Quoter di Zonos Dashboard Anda memungkinkan Anda mencari biaya bea cukai yang diperkirakan untuk produk Anda sebelum pengiriman — berguna untuk memeriksa tarif dan merencanakan ke depan tanpa membuat Declaration ID.

Metode integrasi

Pilih metode yang sesuai dengan pengaturan teknis Anda. Kedua metode menghasilkan Declaration ID yang kemudian Anda upload ke sistem pengiriman Česká pošta.

Untuk pelanggan teknis dan pengembang yang memanggil Zonos secara langsung dari sistem mereka sendiri.

Endpoint

URL: https://api.zonos.com/graphql
Method: POST
Content-Type: application/json

Autentikasi

Sertakan kunci API Anda di header credentialToken: credentialToken: credential_live_xxxxxxxxxxxxxxxxxx

Contoh API

Masuk ke akun Česká pošta Anda untuk contoh API lengkap, termasuk permintaan dan respons lengkap.

Setelah membuat Declaration ID

Kirimkan Declaration ID ke Česká pošta bersama dengan detail pengiriman Anda. Česká pošta menghubungkan Declaration ID ke pengiriman dan mengembalikan nomor pelacakan. Zonos tidak mengeluarkan nomor pelacakan.

Penanganan kesalahan

Kesalahan / Gejala↕	Penyebab yang mungkin dan perbaikan↕
Security requirement failed	Kunci API Anda tidak valid atau diteruskan di header yang salah. Pastikan Anda menggunakan API Key (bukan Account Key) dan nama header tepat `credentialToken`.
HTTP 401 Unauthorized	Kunci API hilang dari header permintaan. Konfirmasi `credentialToken` disertakan.
Array `errors` pada respons	Mutasi mengembalikan kesalahan GraphQL. Periksa bidang `message` dalam array errors untuk detail.
Bentuk respons tidak terduga	Respons tidak menyertakan `data.declarationCreate.id`. Catat badan respons lengkap dan verifikasi teks mutasi cocok dengan contoh persis.

Pesan demo