DOCS

Hitung landed cost - GraphQL

Hitung landed cost

Hitung bea cukai, pajak, dan biaya dengan GraphQL.

GraphQL

Zonos menghitung total landed cost untuk pengiriman internasional—termasuk bea cukai, pajak, dan biaya tambahan apa pun yang dikenakan oleh bea cukai, pialang, atau perusahaan kurir. Dalam sebagian besar kasus, kami menjamin perhitungan ini dengan membayar tagihan akhir sendiri dan mengenakan biaya kepada Anda persis sesuai dengan yang kami hitung. Dalam beberapa kasus, Anda dapat menggunakan landed cost kami tanpa jaminan, artinya Anda bertanggung jawab atas perbedaan antara perhitungan kami dan biaya sebenarnya.

Siapkan permintaan 

Menghitung API landed cost memerlukan beberapa input, yang telah kami atur ke dalam alur kerja. Setelah selesai, Anda akan dapat membuat satu permintaan untuk mengembalikan landed cost berdasarkan tujuan pengiriman, item dalam keranjang, dan detail pengiriman.

Setiap alur kerja memiliki input yang diperlukan sendiri. GraphQL memungkinkan Anda melewatkan lebih banyak data daripada yang diperlukan, tetapi hanya bidang tertentu yang diperlukan untuk mengembalikan landed cost. Ini jelas ditandai dalam referensi API kami untuk melihat semua bidang yang mungkin.

Perhatikan bahwa beberapa bidang bersyarat diperlukan jika Anda ingin perhitungan Anda dijamin.

Di bawah, kami telah menguraikan semua bidang yang diperlukan untuk menghitung landed cost yang dijamin. Pastikan informasi ini disertakan sebelum membuat permintaan Anda.

partyCreateWorkflowInput

partyCreateWorkflowInput mengidentifikasi pihak-pihak yang terlibat dan lokasi mereka. Lihat skema lengkap dalam referensi GraphQL API kami reference. Bidang yang diperlukan adalah:

  • location
    • administrativeAreaCode: Kode negara bagian atau provinsi, dua huruf. Hanya diperlukan untuk CA dan BR.
    • countryCode: Kode ISO dua huruf dari negara.
    • line1: Baris pertama alamat.
    • postalCode: Kode pos atau zip code alamat.
  • person
    • email: Alamat email orang tersebut.
    • firstName: Nama depan orang tersebut.
    • lastName: Nama belakang orang tersebut.
    • phone: Nomor telepon orang tersebut.
  • type
    • DESTINATION: Informasi location & person untuk tujuan pengiriman.
    • ORIGIN: Informasi location untuk asal pengiriman. Orang yang terkait dengan asal pengiriman tidak diperlukan.
itemCreateWorkflowInput

itemCreateWorkflowInput mencantumkan item dalam keranjang. Ada banyak bidang opsional (lihat semua kemungkinan dalam referensi API kami), tetapi bidang di bawah ini diperlukan.

  • amount: Nilai satu unit produk yang dikirimkan, sebelum dikalikan dengan kuantitas. Perhatikan bahwa ini berbeda dari definisi pos item pos. Jika quantity item adalah 1, ini adalah biaya total item. Jika quantity item adalah >1, API akan mengalikan item amount dengan item quantity untuk mendapatkan total untuk item baris. Jangan masukkan harga total dari semua unit item dalam amount.
  • currencyCode: Kode mata uang untuk jumlah item.
  • quantity: Kuantitas item. API akan mengalikan item amount dengan item quantity untuk mendapatkan total untuk item baris.
  • countryOfOrigin: Negara tempat item diproduksi.
  • Salah satu dari berikut ini (mana pun yang ditetapkan sebagai preferensi item key Anda. Item key Anda menghubungkan informasi yang disimpan di Catalog dengan item dalam keranjang dan digunakan selama pembuatan label.)
    • productId: ID produk item.
    • sku: SKU item.

measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) hanya diperlukan jika Anda ingin cartonize item Anda saat mendapatkan rating pengiriman.

cartonsCreateWorkflowInput

cartonsCreateWorkflowInput hanya memerlukan input itu sendiri. Lihat skema lengkap dalam referensi GraphQL API kami reference untuk melihat semua nilai yang dapat dilewatkan. Penting untuk melewatkan dimensi dan berat karton jika Zonos menghitung biaya pengiriman.

shipmentRatingCreateWorkflowInput

Alur kerja ini digunakan ketika Anda sudah mengetahui layanan pengiriman dan biayanya; jika Anda ingin Zonos menghitung biaya ini untuk layanan yang telah Anda aktifkan, tukarkan alur kerja ini dan gunakan shipmentRatingCalculateWorkflow sebagai gantinya.

shipmentRatingCreateWorkflowInput mengkomunikasikan biaya pengiriman. Lihat skema lengkap dalam referensi GraphQL API kami reference. Bidang yang diperlukan adalah:

  • amount: Biaya pengiriman.
  • currencyCode: Kode mata uang biaya pengiriman.
  • serviceLevelCode: Kode yang menunjukkan tingkat layanan pengiriman yang digunakan dalam rating pengiriman.
landedCostWorkFlowInput

landedCostWorkFlowInput menentukan preferensi untuk perhitungan landed cost. Lihat skema lengkap dalam referensi GraphQL API kami reference. Bidang yang diperlukan adalah:

  • calculationMethod: Menunjukkan preferensi Anda untuk cara Anda berencana mengirim: DDP (bea cukai dan pajak prabayar) atau DAP (baik bea cukai dan pajak dibayar saat pengiriman, atau jika skema pengiriman ulang berlaku, mereka dikirim kembali melalui ID pajak).
    • Jika Anda menggunakan jaminan landed cost kami, nilai ini harus selalu DDP_PREFERRED, yang akan memberikan kutipan DDP jika memungkinkan dan kutipan DAP adalah DDP tidak diizinkan. Menggunakan DAP sebagai gantinya dapat mengakibatkan landed cost tidak lagi dijamin, karena ini biasanya menghasilkan bea cukai dan pajak yang dibayar saat pengiriman.
  • endUse: Menunjukkan apakah barang dijual ke bisnis lain (FOR_RESALE) atau untuk penggunaan akhir dengan konsumen (NOT_FOR_RESALE).
  • tariffRate: Menunjukkan metode yang harus digunakan Zonos untuk menghitung tarif untuk kutipan ini, jika ada kisaran tarif yang dapat diterapkan. *Saat menggunakan jaminan landed cost kami, ini harus selalu ZONOS_PREFERRED.

Tambahkan pengiriman yang dihitung: Jika Anda ingin Zonos menghitung biaya pengiriman untuk Anda, ganti shipmentRatingCreateWorkflow dengan shipmentRatingCalculateWorkflow. Tambahkan cartonizeWorkflow jika Anda ingin Zonos mengurutkan item Anda ke dalam karton sebelum menemukan biaya pengiriman (digunakan untuk berat dimensi).

GraphQL memberi Anda fleksibilitas untuk menyesuaikan permintaan dengan preferensi Anda. Ada beberapa opsi untuk cara Anda menyertakan kode HS dan biaya pengiriman dalam permintaan.

Kode HS 

Kode HS mempengaruhi tarif bea cukai dan karenanya diperlukan. Anda dapat melewatkan kode HS untuk setiap item atau membiarkan Classify menghasilkannya.

Lewatkan kode HS untuk setiap item

Zonos sangat merekomendasikan menggunakan kode HS spesifik produk karena menghasilkan kutipan landed cost yang lebih akurat. Jika Anda mengetahui kode HS Anda, lewatkan hsCode untuk setiap item selama itemCreateWorkflow.

Jika Anda melewatkan kode HS, Zonos akan memvalidasinya dengan cepat saat mendapatkan kutipan landed cost. Jika kode HS yang Anda berikan tidak valid (artinya tidak ada), Zonos akan mengklasifikasikan ulang item Anda dengan cepat dan menggunakan kode HS yang baru dan valid sebagai gantinya dari yang Anda berikan.

Jika Anda memerlukan bantuan dalam menghasilkan kode HS untuk produk Anda, pelajari tentang Zonos Classify dan cara meminta klasifikasi.

Hasilkan kode HS dengan Classify

Jika Anda tidak melewatkan hsCode ke Zonos, kami akan terlebih dahulu memeriksa Zonos Catalog untuk melihat apakah Anda memiliki kode HS yang disimpan untuk item Anda. Jika Anda tidak memilikinya, kami akan memanggil Classify untuk menghasilkan klasifikasi untuk mendukung perhitungan landed cost Anda berdasarkan bidang detail produk itemCreateWorkflow berikut: description, category, dan material. Jika bidang detail produk Anda tidak cukup detail untuk menghasilkan klasifikasi berdasarkan skor kepercayaan diri Classify, kode HS default yang ditetapkan ke toko Anda akan digunakan.

Biaya pengiriman 

Baik tingkat layanan pengiriman maupun biayanya mempengaruhi bea cukai, pajak, dan biaya dan oleh karena itu diperlukan. Zonos dapat menghitung pengiriman atau Anda dapat meneruskannya kepada kami.

Hitung pengiriman

Untuk membuat Zonos menghitung biaya pengiriman, gunakan shipmentRatingCalculateWorkflow. Opsi pengiriman yang dikembalikan dalam respons pengiriman yang dihitung akan berkorelasi dengan serviceLevels yang telah Anda tetapkan ke profil pengiriman di Dashboard.

Pemecahan Masalah: Jika Anda mengharapkan serviceLevel dalam respons tetapi tidak muncul, harap pastikan bahwa serviceLevel diaktifkan dan didukung oleh method yang Anda pilih.

Tambahkan cartonizeWorkflow (yang tidak memiliki input) jika Anda ingin Zonos mengurutkan item Anda ke dalam karton sebelum menemukan biaya pengiriman (digunakan untuk berat dimensi.

Lewatkan biaya pengiriman

Jika Anda mengetahui serviceLevel dan amount untuk pengiriman, Anda dapat meneruskannya dalam bagian shipmentRatingCreateWorkflow dari permintaan. Kami akan menggunakan nilai-nilai tersebut untuk menghitung biaya pembawa apa pun yang terkait dan mengembalikannya dalam respons.

Minta landed cost melalui API 

Setelah Anda memiliki data input yang diperlukan, kirimkan mutasi GraphQL ke endpoint API menggunakan perpustakaan atau alat klien pilihan Anda. Berikut adalah beberapa contoh cara Anda dapat menstruktur mutasi.

Gunakan permintaan ini ketika Anda membuat Zonos menghitung biaya pengiriman sebagai bagian dari permintaan Landed Cost. Kami kemudian akan menghitung bea cukai dan pajak pada pengiriman jika dinilai oleh negara tujuan.

1mutation CalculateLandedCost(
2$parties: [PartyCreateWorkflowInput!]!
3$items: [ItemCreateWorkflowInput!]!
4$landedCostConfig: LandedCostWorkFlowInput!
5) {
6 partyCreateWorkflow(input: $parties) {
7 type
8 id
9 organization
10 }
11 itemCreateWorkflow(input: $items) {
12 id
13 amount
14 productId
15 }
16 cartonizeWorkflow {
17 id
18 type
19 items {
20 item {
21 id
22 }
23 }
24 }
25 shipmentRatingCalculateWorkflow {
26 id
27 amount
28 }
29 landedCostCalculateWorkflow(input: $landedCostConfig) {
30 id
31 duties {
32 amount
33 currency
34 note
35 }
36 taxes {
37 amount
38 currency
39 note
40 }
41 fees {
42 amount
43 currency
44 note
45 }
46 }
47}

Langkah berikutnya: Buat pesanan

Setelah Anda menghitung landed cost dan menerima landedCostId dari respons API, Anda harus membuat pesanan untuk menyelesaikan transaksi dalam sistem Zonos. Gunakan mutasi orderCreate dan lewatkan landedCostId dari kutipan Anda. Pelajari lebih lanjut tentang membuat pesanan.


Minta landed cost di Dashboard 

Anda juga dapat menghitung landed cost langsung di Zonos Dashboard tanpa menggunakan API. Ini membantu untuk menguji perhitungan, melatih tim Anda, atau mendapatkan kutipan cepat untuk pertanyaan pelanggan.

Dashboard menggunakan endpoint API yang sama seperti yang dijelaskan di atas, sehingga hasilnya akan sesuai dengan apa yang Anda dapatkan dari panggilan API langsung. Ini membuatnya menjadi cara yang bagus untuk memvalidasi integrasi API Anda atau menjelajahi bagaimana input yang berbeda mempengaruhi perhitungan.

Menggunakan kalkulator Dashboard

Dengan kalkulator landed cost di Dashboard, Anda dapat mendapatkan kutipan dengan tarif pengiriman yang dihitung, membuat kutipan dengan biaya pengiriman yang diketahui, atau memproses beberapa kutipan secara massal.

Gunakan alur ini ketika Anda mengetahui tingkat layanan pengiriman dan biaya untuk pengiriman Anda.

  1. Buka DashboardOrdersQuotes
  2. Klik New quote
  3. Opsional — Ubah lokasi alamat pengiriman Anda
  4. Pilih Destination country dari dropdown
  5. Masukkan jumlah pengiriman
    • Tingkat layanan bersifat opsional; menambahkannya memungkinkan kami untuk menghitung biaya pembawa yang berlaku
  6. Tambahkan detail item untuk pengiriman
    • Ketika Anda memasukkan deskripsi, kami secara otomatis mengklasifikasikan produk dan menghasilkan kode HS
    • Anda dapat menimpa kode HS yang dihasilkan jika diperlukan
    • Untuk beberapa item, klik Save and add another. Jika tidak, klik Save
  7. Opsional — Klik More options untuk mengubah:
    • Jenis penjualan ke For resale
    • Mode pengiriman ke Delivery duties unpaid
  8. Klik Get quote
    • Untuk membuat perubahan, klik Edit form dan ubah detail apa pun
    • Klik Get quote lagi untuk memperbarui

Kutipan landed cost akan muncul di sebelah kanan, termasuk biaya produk, pengiriman, dan impor. Perluas kutipan untuk melihat rincian terperinci item, pengiriman, bea cukai, pajak, dan biaya. Semua kutipan disimpan di halaman kutipan untuk referensi di masa mendatang.

Edit kutipan yang ada: Klik Quote again di kanan atas untuk mengubah kutipan yang ada daripada memulai dari awal.

Manfaat menggunakan Dashboard

  • Tidak diperlukan pengkodean — Hasilkan kutipan melalui antarmuka yang ramah pengguna
  • Pelatihan tim — Bantu anggota tim non-teknis memahami komponen landed cost
  • Validasi API — Verifikasi bahwa integrasi API Anda menghasilkan hasil yang diharapkan
  • Dukungan pelanggan — Dengan cepat hasilkan kutipan untuk pertanyaan pelanggan
  • Pemrosesan massal — Menangani beberapa perhitungan secara efisien (segera hadir)

Kutipan Dashboard menyertakan rincian terperinci yang sama seperti yang tersedia melalui API, menjadikannya pelengkap yang sangat baik untuk integrasi otomatis Anda.

Pesan demo

Apakah halaman ini bermanfaat?