Endpunkt

HS-Code klassifizieren

Akzeptiert eine einzelne Beschreibung oder einen Batch mit bis zu 50 Zeilen. Gibt den empfohlenen 6-stelligen HS-Code, sofern verfügbar einen 10-stelligen HTS-Vorschlag sowie einen Konfidenzwert und einen Begründungstext zurück. Übergeben Sie hs_code_printed, um Abweichungen zu dem zu markieren, was Ihr Lieferant auf der Handelsrechnung gedruckt hat.

POST/v1/classify

Anforderungstext (Einzeln)

description

string (3 to 2000 chars)Erforderlich

Produktbeschreibung. Mehr Details (Material, Funktion, Verpackung) führen zu höherer Konfidenz.

destination_country

string (ISO-2)Erforderlich

Bestimmungsland. Bestimmt die Tarifplan-Suche.

hs_code_printed

string

HS-Code, den Ihr Lieferant auf der Rechnung gedruckt hat. Setzen, damit der Klassifizierer vergleicht und Abweichungen markiert.

confidence_threshold

number (0 to 1)

Mindestkonfidenz, bevor needs_review false ist. Standard 0,85.

Anforderungstext (Batch)

lines

ClassifyLine[]Erforderlich

1 bis 50 Zeilenobjekte: { description, hs_code_printed? }.

destination_country

string (ISO-2)Erforderlich

Bestimmungsland, das von allen Zeilen geteilt wird.

confidence_threshold

number

Wird pro Zeile angewendet.

Antwort 200 (Einzeln)

hs_6_code

string

6-stellige HS-Position.

Beispiel: 851762

recommended_10_digit

string

10-stelliger HTS-Code, wenn das Bestimmungsland ein nationales Schema hat (US, CA).

Beispiel: 8517.62.00.90

confidence

number

0 bis 1. Mit confidence_threshold vergleichen, um needs_review zu entscheiden.

reason

string

Prosa-Erklärung, warum dieser Code gewählt wurde.

needs_review

boolean

True, wenn die Konfidenz unter dem Schwellenwert liegt oder hs_code_printed abweicht.

candidates

array

Top-N alternative Codes mit Bewertungen.

disagreement_with_printed

boolean

True, wenn hs_code_printed von der Empfehlung abweicht.

Antwort 200 (Batch)

results

ClassificationResult[]

Zeilenergebnis in der Eingabereihenfolge.

needs_review

int[]

Indizes der Ergebnisse, die eine menschliche Überprüfung benötigen.

consistency

object

common_chapter + outlier_indices für Sendungen, bei denen die meisten Zeilen ein Kapitel teilen und wenige Ausreißer nicht.

Beispielanfrage

curl https://www.landedfees.com/api/v1/classify \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "Wireless bluetooth earbuds with charging case",
  "destination_country": "US"
}'

Wird geladen

HS-Code klassifizieren