Endpunkt

Ursprünge vergleichen

Führt die Landed-Cost-Engine parallel für 1 bis 6 Ursprungsländer mit demselben HS + Bestimmung + Wert + Fracht aus. Ausfälle einzelner Ursprünge lassen den Batch nicht fehlschlagen: Zeilen ohne verifizierte Abdeckung liefern coverage=false mit einer Nachricht zurück, damit die Oberfläche sie ehrlich darstellen kann.

POST/v1/compare

Anforderungstext

hs_code

string (6+ digits)Erforderlich

HS- oder HTS-Code (Punkte erlaubt). Derselbe Code wird auf jeden Ursprung angewendet.

destination

string (ISO-2)Erforderlich

Bestimmungsland.

value

numberErforderlich

Gesamtwarenwert in der Sendungswährung.

currency

string (ISO-4217)

Standard USD.

freight

number

Fracht auf Sendungsebene. Auf jeden Ursprung identisch angewendet, damit die Deltas nur den Zoll widerspiegeln.

insurance

number

Versicherung auf Sendungsebene.

incoterm

enum

Standard FOB.

transport_mode

enum

Standard ocean.

origins

string[] (ISO-2)Erforderlich

1 bis 6 Ursprungsländer. Duplikate werden stillschweigend zusammengefasst.

eu_member_state

string (ISO-2)

Erforderlich, wenn die Bestimmung EU ist.

br_state

string

Brasilianischer Bundesstaat.

ca_province

string

Kanadische Provinz.

calculation_date

date

ISO-Datum, an dem der Vergleich wirksam ist.

Antwort 200

hs_code

string

Aus der Anfrage zurückgegeben.

destination

string

Zurückgegeben.

value

number

Zurückgegeben.

results

OriginResult[]

Eine Zeile pro Ursprung. Abgedeckte Zeilen zuerst (sortiert von günstig nach teuer), nicht abgedeckte Zeilen angefügt.

results[].origin

string

ISO-2-Ursprung.

results[].coverage

boolean

True, wenn LandedFees einen verifizierten Stack zurückgegeben hat. Andernfalls false (siehe coverage_message).

results[].total_landed_cost

number

Gesamte Landed Cost inklusive Zoll, Steuern, Gebühren, Fracht, Versicherung.

results[].breakdown_summary

object

Summen pro Code: 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 als boolesche Werte.

results[].delta_vs_cheapest

number

Differenz zur günstigsten abgedeckten Zeile.

results[].delta_pct

number

Prozentuales Delta zur günstigsten abgedeckten Zeile.

calculated_at

date-time

ISO-Zeitstempel der Berechnung des Vergleichs.

Beispielanfrage

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"]
}'

Wird geladen

Ursprünge vergleichen