Uç nokta

Toplu landed cost

Çağrı başına en fazla 500 kalem satırı. Satırlar sevkiyat düzeyindeki alanları (varış, para birimi, incoterm, taşıma, navlun, sigorta) paylaşır. Navlun ve sigorta, satır değerine göre satırlara oransal dağıtılır. Satır düzeyindeki doğrulama hataları toplu işlemi başarısız kılmaz.

POST/v1/calc/bulk

İstek gövdesi

destination_country

string (ISO-2)Zorunlu

Sevkiyat düzeyinde varış.

currency

string (ISO-4217)Zorunlu

Sevkiyat düzeyinde fatura para birimi.

incoterm

enumZorunlu

Sevkiyat düzeyinde incoterm.

transport_mode

enumZorunlu

ocean, air, truck, rail veya express.

freight

number

Sevkiyat düzeyinde toplam navlun. (quantity * unit_value) ile satırlara dağıtılır.

insurance

number

Sevkiyat düzeyinde toplam sigorta. Değere göre satırlara dağıtılır.

eu_member_state

string (ISO-2)

destination_country EU olduğunda zorunlu.

br_state

string

ICMS için Brezilya eyaleti.

ca_province

string

PST/HST için Kanada eyaleti.

usmca_qualifying

boolean

USMCA talebi (US, CA, MX).

fta_id

string

USMCA dışı FTA talebi.

calculation_date

date

Toplu işlemin etkin olduğu ISO tarih.

rows

BulkRow[]Zorunlu

1 ila 500 kalem. Aşağıdaki BulkRow şemasına bakın.

BulkRow şeması

description

stringZorunlu

Serbest metin ürün açıklaması.

hs_code

stringZorunlu

HS veya HTS kodu, 4 ila 13 rakam (noktalar izinli).

Örnek: 8517.62 or 851762 or 8517.62.00

quantity

numberZorunlu

Pozitif birim sayısı.

unit_value

numberZorunlu

Sevkiyat düzeyi para biriminde birim başına fatura değeri.

origin_country

string (ISO-2)Zorunlu

Satır başına menşe.

weight_kg

number

Birim başına ağırlık (kg).

Yanıt 200

id

uuid

Toplu hesaplama satır ID.

results

RowResult[]

line_index, hs_code, origin, duty, taxes, fees, landed_cost, de_minimis_applied, warnings ile satır başına sonuç.

errors

RowError[]

line_index, reason, field ile satır başına doğrulama veya motor hataları.

aggregate

object

total_rows, ok_rows, error_rows, total_value, total_duty, total_taxes, total_fees, total_landed, currency.

Örnek istek

curl https://www.landedfees.com/api/v1/calc/bulk \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
  "destination_country": "US",
  "currency": "USD",
  "incoterm": "FOB",
  "transport_mode": "ocean",
  "freight": 1200,
  "insurance": 180,
  "rows": [
    {
      "description": "Bluetooth earbuds",
      "hs_code": "8517.62",
      "quantity": 500,
      "unit_value": 12.50,
      "origin_country": "CN"
    },
    {
      "description": "USB-C charging cable",
      "hs_code": "8544.42",
      "quantity": 1000,
      "unit_value": 1.20,
      "origin_country": "CN"
    }
  ]
}'

Yukleniyor

Toplu landed cost