Uç nokta

Menşeleri karşılaştır

Aynı HS + varış + değer + navlun için 1 ila 6 menşe ülkesinde landed-cost motorunu paralel çalıştırır. Menşe bazlı arızalar toplu işlemi başarısız kılmaz: doğrulanmış kapsamı olmayan satırlar, arayüzün dürüstçe göstermesi için bir mesajla birlikte coverage=false döner.

POST/v1/compare

İstek gövdesi

hs_code

string (6+ digits)Zorunlu

HS veya HTS kodu (noktalar izinli). Aynı kod her menşeye uygulanır.

destination

string (ISO-2)Zorunlu

Varış ülkesi.

value

numberZorunlu

Sevkiyat para biriminde toplam mal değeri.

currency

string (ISO-4217)

Varsayılan USD.

freight

number

Sevkiyat düzeyinde navlun. Farkların yalnızca gümrüğü yansıtması için her menşeye aynı şekilde uygulanır.

insurance

number

Sevkiyat düzeyinde sigorta.

incoterm

enum

Varsayılan FOB.

transport_mode

enum

Varsayılan ocean.

origins

string[] (ISO-2)Zorunlu

1 ila 6 menşe ülkesi. Yinelenenler sessizce birleştirilir.

eu_member_state

string (ISO-2)

Varış EU olduğunda zorunlu.

br_state

string

Brezilya eyaleti.

ca_province

string

Kanada eyaleti.

calculation_date

date

Karşılaştırmanın etkin olduğu ISO tarih.

Yanıt 200

hs_code

string

İstekten döndürülür.

destination

string

Döndürülür.

value

number

Döndürülür.

results

OriginResult[]

Menşe başına bir satır. Kapsanan satırlar önce (en ucuzdan en pahalıya sıralı), kapsanmayanlar ekli.

results[].origin

string

ISO-2 menşe.

results[].coverage

boolean

LandedFees doğrulanmış bir yığın döndürdüğünde true. Aksi halde false (coverage_message'a bakın).

results[].total_landed_cost

number

Gümrük, vergi, ücret, navlun ve sigorta dahil toplam landed maliyet.

results[].breakdown_summary

object

Kod başına toplamlar: MFN, SEC_122, SEC_301, SEC_301_FL, SEC_338_CA, SEC_232, SEC_232_PHARMA, AD_CVD, MPF, HMF, VAT, GST, GST_HST, IGST, BCD, II, IPI, ICMS.

results[].flags

object

denied_party, pga, restriction, ad_cvd, fta_opportunity boolean değerleri.

results[].delta_vs_cheapest

number

En ucuz kapsanan satıra göre fark.

results[].delta_pct

number

En ucuz kapsanan satıra göre yüzde fark.

calculated_at

date-time

Karşılaştırmanın hesaplandığı ISO zaman damgası.

Örnek istek

curl https://www.landedfees.com/api/v1/compare \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
  "hs_code": "8518.30.20",
  "destination": "US",
  "value": 64250,
  "currency": "USD",
  "freight": 3200,
  "insurance": 480,
  "incoterm": "FOB",
  "transport_mode": "ocean",
  "origins": ["CN", "VN", "MX", "IN"]
}'

Yukleniyor

Menşeleri karşılaştır