Landed Cost•

BerandaReferensi API API REST Landed Cost Permintaan landed cost

Permintaan landed cost

Cari pasangan kunci/nilai dalam permintaan landed cost.

Meskipun Zonos Landed Cost dapat memberikan landed cost yang akurat hanya berdasarkan deskripsi suatu barang, semakin banyak informasi yang diberikan, semakin akurat kutipan landed cost tersebut. Di bawah ini adalah input yang DIWAJIBKAN dan OPSIONAL, tetapi disarankan untuk mengisi sebanyak mungkin bidang OPSIONAL.

Kode HS sangat dianjurkan. Berbeda dengan landed cost dasar, landed cost lengkap akan mencakup detail tingkat item dari tarif bea per kode HS.

Atribut

Pasangan kunci/nilai JSON dalam badan permintaan

POST | https://api.zonos.com/v1/landed_cost

HEADER zonos-version: 2019-11-21

Header di atas adalah input yang diperlukan agar permintaan landed cost ini berhasil diselesaikan.

Field	Notes
`currency` REQUIRED	String mata uang dasar, yang diwakili oleh kode ISO tiga huruf.
`discounts` OPTIONAL	Informasi terkait dengan diskon, termasuk id, jumlah, dan detail lainnya.
`discounts.id` OPTIONAL	Pengidentifikasi diskon unik untuk pedagang atau eksportir.
`discounts.amount` OPTIONAL	Desimal dengan jumlah diskon, dalam dolar dan sen.
`discounts.detail` OPTIONAL	Fitur tambahan, atribut, atau deskripsi diskon.
`items` REQUIRED	Daftar barang yang diekspor. `hash`
`items.id` REQUIRED	Pengidentifikasi barang unik untuk pedagang atau eksportir.
`items.amount` REQUIRED	Desimal dengan total satu barang, dalam dolar dan sen.
`items.amount_discount` OPTIONAL	Jumlah diskon yang berlaku untuk barang tersebut.
`items.brand` OPTIONAL	Merek barang, misalnya "Leatherman.”
`items.category` OPTIONAL	Deskripsi kategori barang, misalnya "Pakaian."
`items.color` OPTIONAL	Warna barang.
`items.country_of_origin` OPTIONAL	Negara tempat barang diproduksi atau dibuat, diwakili oleh kode ISO dua huruf. Ini disarankan untuk mendapatkan kutipan yang paling akurat. Jika tidak ada negara asal yang diterima, Most Favored Nation (MFN) rate akan digunakan.
`items.description_customs` OPTIONAL	Deskripsi yang disarankan untuk barang dalam faktur komersial. Deskripsi ini biasanya berbeda dari deskripsi ritel dan biasanya mencakup deskripsi umum tentang apa itu, terbuat dari apa, dan untuk apa digunakan.
`items.description_retail` OPTIONAL	Deskripsi ritel barang.
`items.detail` OPTIONAL	Fitur tambahan, atribut, atau deskripsi barang.
`items.dimensions` OPTIONAL	Ukuran pengiriman. Ini disarankan untuk mendapatkan kutipan yang paling akurat ke negara-negara di mana tarif dipengaruhi oleh dimensi barang. `hash`
`items.dimensions.height` OPTIONAL	Desimal untuk tinggi barang.
`items.dimensions.length` OPTIONAL	Desimal untuk panjang barang.
`items.dimensions.unit` OPTIONAL	Satuan pengukuran untuk dimensi barang. Nilai yang mungkin adalah `inch`, `centimeter`, `millimeter`, dan `null`. Ketika `null`, `inch` akan digunakan.
`items.dimensions.width` OPTIONAL	Desimal untuk lebar barang.
`items.duty_tax_fee_free` OPTIONAL	String untuk menentukan apakah barang tersebut tidak boleh dimasukkan dalam perhitungan landed cost. Ketika `exclude` dikirim dalam permintaan, barang tersebut akan muncul dalam `removed_items` dalam respons API.
`items.hs_code` OPTIONAL	Kode HS barang, 2 hingga 10 digit.
`items.image_url` OPTIONAL	URL gambar.
`items.quantity` REQUIRED	Bilangan bulat dengan jumlah barang.
`items.upc_code` OPTIONAL	String kode UPC untuk barang.
`items.weight` OPTIONAL	Desimal untuk berat barang.
`items.weight_unit` OPTIONAL	String satuan pengukuran untuk berat. Nilai yang mungkin adalah `pound`, `ounce`, `kilogram`, dan `null`. Ketika `null`, `pound` akan digunakan.
`landed_cost` OPTIONAL	Jenis permintaan untuk landed cost. Nilai yang mungkin termasuk `delivery_duty_paid` dan `delivery_duty_unpaid`. Biaya untuk landed cost dapat berbeda, apakah dikirim DDP atau DDU. Jika `null`, permintaan DDP akan dianggap. Jika permintaan DDP dibuat dan DDP tidak tersedia, kesalahan 400 akan dikembalikan dengan pesan yang menyatakan bahwa DDP tidak tersedia untuk tingkat layanan yang diberikan. DDP dan DDU biasanya keduanya tersedia dalam setiap tingkat layanan, jadi harap pastikan bahwa ini dapat dikonfigurasi berdasarkan tingkat layanan dan bukan tingkat akun.
`sale_type` OPTIONAL	Indikator jenis penjualan. Nilai yang mungkin termasuk `not_for_resale` `for_resale`. Jika `null`, permintaan `not_for_resale` akan dianggap.
`ship_from_country` REQUIRED	String negara pengiriman, yang diwakili oleh kode ISO dua huruf.
`ship_to` REQUIRED	Alamat tujuan. `hash`
`ship_to.city` OPTIONAL*	String untuk kota alamat, kota, distrik, pinggiran kota, atau desa pelanggan. Tergantung pada negara impor, bidang ini mungkin DIHARUSKAN.
`ship_to.country` REQUIRED	String untuk negara tujuan di mana rekening bank berada, yang diwakili oleh kode ISO dua huruf.
`ship_to.postal_code` OPTIONAL*	String untuk kode pos tujuan. Bidang ini mungkin diperlukan ketika pengiriman dilakukan antara Irlandia Utara dan Uni Eropa.
`ship_to.state` OPTIONAL*	String untuk kode negara bagian tujuan jika tersedia. Jika negara impor adalah Brasil atau Kanada, bidang ini diperlukan.
`shipping` REQUIRED	Detail pengiriman seperti jumlah, jumlah diskon, dan tingkat layanan dengan pengangkut. `hash`
`shipping.amount` REQUIRED	Desimal untuk total biaya pengiriman, dalam dolar dan sen.
`shipping.amount_discount` OPTIONAL	Desimal untuk jumlah diskon yang berlaku untuk pengiriman.
`shipping.service_level` REQUIRED	Tingkat layanan dengan pengangkut. Lihat dokumentasi pengangkut untuk daftar lengkap tingkat layanan yang tersedia berdasarkan pengangkut.

*Bidang ini opsional tergantung pada persyaratan bidang alamat untuk negara impor.

Contoh permintaan

{
  "currency": "USD",
  "discounts": [
    {
      "id": "sale124",
      "amount": 43.0,
      "detail": null
    }
  ],
  "items": [
    {
      "id": "294395",
      "amount": 75,
      "amount_discount": 0,
      "brand": null,
      "category": "Women's Clothing",
      "color": null,
      "country_of_origin": "FR",
      "description_customs": null,
      "description_retail": "Hoka One Running Shoe - Women's",
      "detail": null,
      "dimensions": {
        "height": 4,
        "length": 6,
        "unit": "inch",
        "width": 11
      },
      "duty_tax_fee_free": null,
      "hs_code": "6116.10.00",
      "image_url": "https://zonos.com/images/handbag.png",
      "quantity": 1,
      "upc_code": null,
      "weight": 10,
      "weight_unit": "pound"
    },
    {
      "id": "294396",
      "amount": 15,
      "country_of_origin": "CN",
      "country_of_origin_source": "account_default",
      "description_customs": "Men's t-shirt 100% polyester",
      "description_retail": "Galaxy Quest Men's Tee Blue",
      "detail": null,
      "dimensions": {
        "height": 4,
        "lenght": 6,
        "unit": "inch",
        "width": 11
      },
      "duty_tax_fee_free": "exclude",
      "hs_code": "6217.10",
      "image_url": null,
      "note": null,
      "quantity": 1,
      "upc_code": null,
      "weight": 1,
      "weight_unit": "pound"
    }
  ],
  "landed_cost": "delivery_duty_paid",
  "sale_type": "not_for_resale",
  "ship_from_country": "US",
  "ship_to": {
    "city": "Campinas",
    "country": "BR",
    "postal_code": "75828-000",
    "state": "SP"
  },
  "shipping": {
    "amount": 14.23,
    "amount_discount": 0,
    "service_level": "ups_express_saver"
  },
  "tariff_rate": "zonos_preferred"
}

Contoh respons

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

{
  "id": "ldct_eab3008d-a8ca-4bd7-bf6d-cd178fe3cd77",
  "amount_subtotal": {
    "duties": 27.74,
    "fees": 15.33,
    "taxes": 16.23
  },
  "currency": {
    "id": "curr_8fb20952-d",
    "base": "USD",
    "date": "2019-11-04T20:42:40.999+0000",
    "rates": [
      {
        "currency": "BRL",
        "rate": 0.2274
      }
    ]
  },
  "customs": {
    "delivery_duty_paid": "available",
    "items": [
      {
        "id": "294395",
        "amount": 32.0,
        "country_of_origin": "FR",
        "country_of_origin_source": null,
        "description_customs": "Women's Tennis Shoe",
        "description_retail": "Hoka One Running Shoe - Women's",
        "detail": null,
        "dimensions": {
          "height": 4.0,
          "length": 6.0,
          "unit": "inch",
          "width": 11.0
        },
        "hs_code": "6116.10.00",
        "hs_code_source": "account_default",
        "image_url": "https://zonos.com/images/handbag.png",
        "note": null,
        "quantity": 1,
        "upc_code": null,
        "weight": 10.0,
        "weight_unit": "pound"
      }
    ],
    "ship_to_country": "BR",
    "shipping_amount": 14.23
  },
  "de_minimis": [
    {
      "formula": "Less than 0 BRL",
      "method": "FOB",
      "note": null,
      "threshold": "above",
      "type": "duty"
    },
    {
      "formula": "Less than 0 BRL",
      "method": "FOB",
      "note": null,
      "threshold": "above",
      "type": "tax"
    }
  ],
  "duties": [
    {
      "amount": 19.2,
      "description": "duty",
      "formula": "60%",
      "item_id": "294395",
      "note": "Duty is 60% of the items total.",
      "type": "item"
    },
    {
      "amount": 8.54,
      "description": "Duty",
      "formula": "60%",
      "item_id": null,
      "note": null,
      "type": "shipping"
    }
  ],
  "fees": [
    {
      "amount": 22.0,
      "description": "UPS United States Duty and Tax Forwarding Charge",
      "formula": "15 USD",
      "item_id": null,
      "note": null,
      "type": "ddp_service_fee"
    },
    {
      "amount": 0.33,
      "description": "UPS Currency Conversion Fee",
      "formula": ".75% of the amount converted",
      "item_id": null,
      "note": null,
      "type": "currency_conversion_fee"
    }
  ],
  "removed_items": [
    {
      "id": "294396",
      "amount": 15,
      "country_of_origin": "CN",
      "country_of_origin_source": "account_default",
      "description_customs": "Men's t-shirt 100% polyester",
      "description_retail": "Galaxy Quest Men's Tee Blue",
      "hs_code": "6217.10",
      "hs_code_source": "account_default",
      "note": null,
      "quantity": 1
    }
  ],
  "remittance": [],
  "taxes": [
    {
      "amount": 7.02,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": "294395",
      "note": null,
      "type": "item"
    },
    {
      "amount": 3.12,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": null,
      "note": null,
      "type": "shipping"
    },
    {
      "amount": 6.09,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": null,
      "note": null,
      "type": "duty"
    }
  ]
}

Apakah halaman ini membantu?

Pertanyaan?

Hubungi kami.

Lihat Zonos

kebijakan dan perjanjian