DOCS

Hitung landed cost - GraphQL

Landed Cost•
BerandaUntuk penyedia logistik Landed Cost Hitung landed cost - GraphQL

Hitung landed cost

Hitung bea, pajak, dan biaya dengan GraphQL.

GraphQL

Zonos menghitung total landed cost untuk pengiriman internasional—termasuk bea, pajak, dan biaya tambahan yang dikenakan oleh bea cukai, broker, atau pengangkut. Dalam banyak kasus, kami menjamin perhitungan ini dengan membayar tagihan akhir sendiri dan membebankan kepada Anda persis apa yang kami hitung. Dalam beberapa kasus, Anda dapat menggunakan landed cost kami tanpa jaminan, yang berarti Anda bertanggung jawab atas perbedaan antara perhitungan kami dan biaya sebenarnya.

Siapkan permintaan 

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

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

Perhatikan bahwa beberapa bidang bersifat kondisional diperlukan jika Anda ingin perhitungan Anda dijamin.

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

Input yang diperlukan untuk perhitungan yang dijamin

partyCreateWorkflowInput

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

  • location
    • administrativeAreaCode: Kode negara bagian atau provinsi, dalam dua huruf. Hanya diperlukan untuk CA dan BR.
    • countryCode: Kode ISO dua huruf negara.
    • line1: Baris pertama alamat.
    • postalCode: Kode pos atau kode zip 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. person yang terkait dengan asal pengiriman tidak diperlukan.
itemCreateWorkflowInput

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

  • amount: Harga barang.
  • currencyCode: Kode mata uang untuk jumlah barang.
  • quantity: Jumlah barang.
  • Salah satu dari berikut ini (mana yang ditetapkan sebagai preferensi kunci item Anda. Kunci item Anda menghubungkan informasi yang disimpan di Katalog 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 kartonisasi barang Anda saat mendapatkan penilaian pengiriman.

cartonsCreateWorkflowInput

cartonsCreateWorkflowInput hanya memerlukan input itu sendiri. Lihat skema lengkap di referensi API GraphQL kami untuk melihat semua nilai yang dapat dikirimkan. Penting untuk mengirimkan 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, ganti alur kerja ini dengan menggunakan shipmentRatingCalculateWorkflow sebagai gantinya.

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

  • amount: Biaya pengiriman.
  • currencyCode: Kode mata uang dari biaya pengiriman.
  • serviceLevelCode: Kode yang menunjukkan tingkat layanan pengiriman yang digunakan dalam penilaian pengiriman.
landedCostWorkflowInput

landedCostWorkflowInput menentukan preferensi untuk perhitungan landed cost. Lihat skema lengkap di referensi API GraphQL kami. Bidang yang diperlukan adalah:

  • calculationMethod: Menunjukkan preferensi Anda untuk cara Anda berencana mengirim: DDP (bea dan pajak yang dibayar di muka) atau DAP (baik bea dan pajak dibayar saat pengiriman, atau jika skema remittance berlaku, mereka dibayarkan 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 jika kutipan DDP tidak diizinkan. Menggunakan DAP sebagai gantinya dapat mengakibatkan biaya landed tidak lagi dijamin, karena ini biasanya mengakibatkan bea dan pajak dibayar saat pengiriman.
  • endUse: Menunjukkan apakah barang dijual kepada bisnis lain (FOR_RESALE) atau untuk digunakan akhir dengan konsumen (NOT_FOR_RESALE).
  • tariffRate: Menunjukkan metode yang harus digunakan Zonos untuk menghitung tarif bea untuk kutipan ini, jika ada rentang tarif bea yang dapat diterapkan. *Saat menggunakan jaminan landed cost kami, ini harus selalu ZONOS_PREFERRED.

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

Opsi kode HS dan pengiriman

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

Kode HS

Kode HS mempengaruhi tarif bea sehingga diperlukan. Anda dapat mengirimkan kode HS untuk setiap item atau biarkan Classify yang menghasilkannya.

Kirim kode HS untuk setiap item

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

Jika Anda mengirimkan kode HS, Zonos akan memvalidasinya secara langsung saat mendapatkan kutipan landed cost. Jika kode HS yang Anda berikan tidak valid (berarti tidak ada), Zonos akan mengulang-classify item Anda secara langsung dan menggunakan kode HS baru yang valid sebagai pengganti yang Anda berikan.

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

Hasilkan kode HS dengan Classify

Jika Anda tidak mengirimkan hsCode ke Zonos, kami akan terlebih dahulu memeriksa Zonos Catalog untuk melihat apakah Anda memiliki kode HS yang disimpan untuk item Anda. Jika tidak, 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 rinci untuk menghasilkan klasifikasi berdasarkan penilaian kepercayaan Classify's, kode HS default yang ditetapkan ke toko Anda akan digunakan.

Biaya pengiriman

Baik tingkat layanan pengiriman maupun biayanya mempengaruhi bea, pajak, dan biaya sehingga diperlukan. Zonos dapat menghitung pengiriman atau Anda dapat mengirimkannya kepada kami.

Hitung pengiriman

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

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

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

Kirim biaya pengiriman

Jika Anda mengetahui serviceLevel dan amount untuk pengiriman, Anda dapat mengirimkannya dalam bagian shipmentRatingCreateWorkflow dari permintaan. Kami akan menggunakan nilai-nilai tersebut untuk menghitung biaya pengangkut terkait dan mengembalikannya dalam respons.

Meminta landed cost melalui API 

Setelah Anda memiliki data input yang diperlukan, kirimkan mutasi GraphQL ke endpoint API menggunakan pustaka klien atau alat yang Anda pilih. Berikut adalah beberapa contoh bagaimana Anda dapat menyusun mutasi.

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

Mutasi

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

  itemCreateWorkflow(input: $items) {
    id
    amount
  }

  cartonizeWorkflow {
    id
    type
    items {
      item {
        id
      }
    }
  }

  shipmentRatingCalculateWorkflow {
    id
    amount
  }

  landedCostCalculateWorkflow(input: $landedCostConfig) {
    id
    duties {
      amount
      currency
    }
    taxes {
      amount
      currency
    }
    fees {
      amount
      currency
    }
  }
}

Variabel

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
{
  "parties": [
    {
      "location": {
        "administrativeArea": "Utah",
        "administrativeAreaCode": "UT",
        "countryCode": "US",
        "line1": "345 N 2450 E",
        "line2": "#151",
        "locality": "St George",
        "postalCode": "84790"
      },
      "type": "ORIGIN"
    },
    {
      "location": {
        "administrativeArea": "BC",
        "administrativeAreaCode": "BC",
        "countryCode": "CA",
        "line1": "27 Sussex Dr.",
        "locality": "Victoria",
        "postalCode": "V8T 2V9"
      },
      "person": {
        "email": "test@gmail.com",
        "firstName": "firstName",
        "lastName": "lastName",
        "phone": "5022303021",
        "companyName": "goProTest",
        "metadata": { "key": "key", "value": "value" }
      },
      "type": "DESTINATION"
    },
    {
      "type": "PAYOR",
      "location": {
        "administrativeArea": "ON",
        "administrativeAreaCode": "ON",
        "countryCode": "CA",
        "latitude": 1.2,
        "line1": "asdf",
        "line2": "asdf",
        "locality": "locality",
        "longitude": 3423.2,
        "postalCode": "M4C 1A1"
      },
      "person": {
        "email": "test@gmail.com",
        "firstName": "firstName",
        "lastName": "lastName",
        "phone": "5022303021",
        "companyName": "goProTest",
        "metadata": { "key": "key", "value": "value" }
      }
    }
  ],
  "items": [
    {
      "amount": 69,
      "currencyCode": "USD",
      "countryOfOrigin": "US",
      "quantity": 1,
      "productId": "productId",
      "hsCode": "1006.30",
      "description": "description",
      "measurements": [
        { "type": "WIDTH", "value": 2, "unitOfMeasure": "CENTIMETER" },
        { "type": "WEIGHT", "value": 2, "unitOfMeasure": "POUND" }
      ]
    },
    {
      "amount": 62,
      "currencyCode": "CAD",
      "countryOfOrigin": "US",
      "hsCode": "1006.30",
      "quantity": 1,
      "productId": "productId2",
      "description": "description2",
      "measurements": [
        { "type": "WIDTH", "value": 2, "unitOfMeasure": "CENTIMETER" },
        { "type": "WEIGHT", "value": 2, "unitOfMeasure": "POUND" }
      ]
    }
  ],
  "landedCostConfig": {
    "endUse": "FOR_RESALE",
    "method": "DAP",
    "tariffRate": "ZONOS_PREFERRED"
  }
}

Respon

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
{
  "data": {
    "partyCreateWorkflow": [
      {
        "type": "ORIGIN",
        "id": "party_749959ae-b9ff-4de4-b4ac-59cc990c53ba",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      },
      {
        "type": "DESTINATION",
        "id": "party_cd7ff245-76b6-464f-a7bf-151ebe1f8833",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      },
      {
        "type": "PAYOR",
        "id": "party_00e63a9e-9735-44d9-b129-3b3e76c5df25",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      }
    ],
    "itemCreateWorkflow": [
      {
        "id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e",
        "amount": 69
      },
      {
        "id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115",
        "amount": 62
      }
    ],
    "cartonizeWorkflow": [
      {
        "id": "carton_b34b29c1-ce27-464b-b91b-df8e4a696312",
        "type": "PACKAGE",
        "items": [
          {
            "item": {
              "id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e"
            }
          },
          {
            "item": {
              "id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115"
            }
          }
        ]
      }
    ],
    "shipmentRatingCalculateWorkflow": [
      {
        "id": "shipment_rating_96787309-9510-43cc-b4fa-c341ff80f4cc",
        "amount": 173.2
      },
      {
        "id": "shipment_rating_b0ccb109-7794-4c7c-b5cc-e2cfbbc5c8ac",
        "amount": 190.1
      }
    ],
    "landedCostCalculateWorkflow": [
      {
        "id": "landed_cost_74d3ce11-bff2-4326-9e6f-368e03ac88b4",
        "duties": [
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "taxes": [
          {
            "amount": 3.45,
            "currency": "USD"
          },
          {
            "amount": 3.1,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "fees": [
          {
            "amount": 0.13,
            "currency": "USD"
          },
          {
            "amount": 1.44,
            "currency": "USD"
          }
        ]
      },
      {
        "id": "landed_cost_7bbfd354-028c-457f-8c8e-c81bb8fa09a0",
        "duties": [
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "taxes": [
          {
            "amount": 3.45,
            "currency": "USD"
          },
          {
            "amount": 3.1,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "fees": [
          {
            "amount": 0.13,
            "currency": "USD"
          },
          {
            "amount": 1.44,
            "currency": "USD"
          }
        ]
      }
    ]
  }
}

Minta landed cost di Dashboard 

Anda juga dapat menghitung biaya landed secara langsung di Zonos Dashboard tanpa menggunakan API. Ini berguna 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 yang Anda dapatkan dari panggilan API langsung. Ini menjadikannya cara yang bagus untuk memvalidasi integrasi API Anda atau menjelajahi bagaimana berbagai input 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. Pergi ke Dashboard → Orders → Quotes
  2. Klik Kutipan baru
  3. Opsional — Ubah lokasi alamat pengiriman Anda
  4. Pilih Negara tujuan dari dropdown
  5. Masukkan jumlah pengiriman
    • Tingkat layanan bersifat opsional; menambahkannya memungkinkan kami untuk menghitung biaya pengangkut yang berlaku
  6. Tambahkan detail item untuk pengiriman
    • Ketika Anda memasukkan deskripsi, kami secara otomatis classify produk dan menghasilkan kode HS
    • Anda dapat menimpa kode HS yang dihasilkan jika diperlukan
    • Untuk beberapa item, klik Simpan dan tambahkan lainnya. Jika tidak, klik Simpan
  7. Opsional — Klik Opsi lebih lanjut untuk mengubah:
    • Jenis penjualan menjadi Untuk dijual kembali
    • Mode pengiriman menjadi Pengiriman tanpa biaya yang dibayar
  8. Klik Dapatkan kutipan
    • Untuk melakukan perubahan, klik Edit formulir dan ubah detail apa pun
    • Klik Dapatkan kutipan lagi untuk memperbarui

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

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

Manfaat menggunakan Dashboard

  • Tanpa kode yang diperlukan — Hasilkan kutipan melalui antarmuka yang ramah pengguna
  • Pelatihan tim — Membantu anggota tim non-teknis memahami komponen landed cost
  • Validasi API — Verifikasi integrasi API Anda menghasilkan hasil yang diharapkan
  • Dukungan pelanggan — Cepat menghasilkan kutipan untuk pertanyaan pelanggan
  • Pemrosesan massal — Menangani beberapa perhitungan dengan efisien (segera hadir)

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

Apakah halaman ini membantu?

Pesan demo
© 2025 Zonoszonos.com
Di halaman ini:
  • Hitung landed cost
  • Siapkan permintaan
  • Meminta landed cost melalui API
  • Minta landed cost di Dashboard