Endpunkt

Bulk-Landed-Cost

Bis zu 500 Positionszeilen pro Aufruf. Zeilen teilen sich die Sendungsfelder (Bestimmung, Währung, Incoterm, Transport, Fracht, Versicherung). Fracht und Versicherung werden nach Positionswert auf die Zeilen verteilt. Zeilenbezogene Validierungsfehler lassen den Batch nicht fehlschlagen.

POST/v1/calc/bulk

Anforderungstext

destination_country

string (ISO-2)Erforderlich

Bestimmung auf Sendungsebene.

currency

string (ISO-4217)Erforderlich

Rechnungswährung auf Sendungsebene.

incoterm

enumErforderlich

Incoterm auf Sendungsebene.

transport_mode

enumErforderlich

ocean, air, truck, rail oder express.

freight

number

Gesamtfracht auf Sendungsebene. Auf die Zeilen nach (quantity * unit_value) verteilt.

insurance

number

Gesamtversicherung auf Sendungsebene. Nach Wert auf die Zeilen verteilt.

eu_member_state

string (ISO-2)

Erforderlich, wenn destination_country EU ist.

br_state

string

Brasilianischer Bundesstaat für ICMS.

ca_province

string

Kanadische Provinz für PST/HST.

usmca_qualifying

boolean

USMCA-Anspruch (US, CA, MX).

fta_id

string

Nicht-USMCA-FTA-Anspruch.

calculation_date

date

ISO-Datum, an dem der Batch wirksam ist.

rows

BulkRow[]Erforderlich

1 bis 500 Positionen. Siehe BulkRow-Schema unten.

BulkRow-Schema

description

stringErforderlich

Freitext-Produktbeschreibung.

hs_code

stringErforderlich

HS- oder HTS-Code, 4 bis 13 Ziffern (Punkte erlaubt).

Beispiel: 8517.62 or 851762 or 8517.62.00

quantity

numberErforderlich

Positive Anzahl Einheiten.

unit_value

numberErforderlich

Rechnungswert pro Einheit in der Sendungswährung.

origin_country

string (ISO-2)Erforderlich

Ursprung pro Zeile.

weight_kg

number

Gewicht pro Einheit in kg.

Antwort 200

id

uuid

Aggregierte Berechnungs-Zeilen-ID.

results

RowResult[]

Zeilenergebnis mit line_index, hs_code, origin, duty, taxes, fees, landed_cost, de_minimis_applied, warnings.

errors

RowError[]

Zeilenbezogene Validierungs- oder Engine-Fehler mit line_index, reason, field.

aggregate

object

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

Beispielanfrage

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

Wird geladen

Endpunkt

Bulk-Landed-Cost

POST/v1/calc/bulk

Anforderungstext

destination_country

string (ISO-2)Erforderlich

Bestimmung auf Sendungsebene.

currency

string (ISO-4217)Erforderlich

Rechnungswährung auf Sendungsebene.

incoterm

enumErforderlich

Incoterm auf Sendungsebene.

transport_mode

enumErforderlich

ocean, air, truck, rail oder express.

freight

number

Gesamtfracht auf Sendungsebene. Auf die Zeilen nach (quantity * unit_value) verteilt.

insurance

number

Gesamtversicherung auf Sendungsebene. Nach Wert auf die Zeilen verteilt.

eu_member_state

string (ISO-2)

Erforderlich, wenn destination_country EU ist.

br_state

string

Brasilianischer Bundesstaat für ICMS.

ca_province

string

Kanadische Provinz für PST/HST.

usmca_qualifying

boolean

USMCA-Anspruch (US, CA, MX).

fta_id

string

Nicht-USMCA-FTA-Anspruch.

calculation_date

date

ISO-Datum, an dem der Batch wirksam ist.

rows

BulkRow[]Erforderlich

1 bis 500 Positionen. Siehe BulkRow-Schema unten.

BulkRow-Schema

description

stringErforderlich

Freitext-Produktbeschreibung.

hs_code

stringErforderlich

HS- oder HTS-Code, 4 bis 13 Ziffern (Punkte erlaubt).

Beispiel: 8517.62 or 851762 or 8517.62.00

quantity

numberErforderlich

Positive Anzahl Einheiten.

unit_value

numberErforderlich

Rechnungswert pro Einheit in der Sendungswährung.

origin_country

string (ISO-2)Erforderlich

Ursprung pro Zeile.

weight_kg

number

Gewicht pro Einheit in kg.

Antwort 200

id

uuid

Aggregierte Berechnungs-Zeilen-ID.

results

RowResult[]

Zeilenergebnis mit line_index, hs_code, origin, duty, taxes, fees, landed_cost, de_minimis_applied, warnings.

errors

RowError[]

Zeilenbezogene Validierungs- oder Engine-Fehler mit line_index, reason, field.

aggregate

object

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

Beispielanfrage

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