Per chiamata in batch
200
Prodotti per chiamata
Una richiesta in batch classifica e calcola il prezzo di fino a 200 prodotti in parallelo, terminando in 3-5 minuti.
Prodotto
L'API di classificazione e landed cost per gli importatori ad alto volume
Spedizionieri internazionali, piattaforme di e-commerce transfrontaliero, operatori postali e di corriere e importatori all'ingrosso fanno passare migliaia di prodotti in dogana ogni giorno. L'API di GingerControl trasforma una semplice descrizione di prodotto e un paese di origine in un codice HTS e nell'intero stack di dazi, così i tuoi sistemi possono quotare il landed cost e preparare le dichiarazioni doganali senza che una persona classifichi ogni riga.
Costruito per interi cataloghi, non per singoli casi
Livello production
200K+
Classificazioni al giorno
Capacità standard di produzione. I livelli enterprise personalizzati scalano fino a 100K classificazioni all'ora.
Sviluppatori
L'intero contratto di richiesta, risposta ed errore risiede nel riferimento API.
Riferimento APIOppure scrivi a chen@gingercontrol.com per una chiave di test.
Le cifre di throughput descrivono le chiavi API standard di livello production misurate su traffico reale. La capacità effettiva è dimensionata sul pattern di chiamata e sul picco di QPS di ciascun cliente. L'output di classificazione è materiale di ricerca da rivedere da parte di uno spedizioniere doganale abilitato prima della dichiarazione doganale.
Dalla linea di prodotti al landed cost in una sola chiamata
POST/v1/tariff
descriptionCotton T-shirt
countryVN
Invia il prodotto e l'origine
Fai la POST di una descrizione di prodotto e un paese di origine, un singolo elemento o un batch di fino a 200. Nessuna consultazione della tariffa doganale, nessuna coda dallo spedizioniere.
6109.10.0012
MFN
301
232
Ginger classifica e calcola
Il motore determina il codice HTS, poi assembla l'intero stack di dazi: aliquota base MFN più Section 301, 232, 122 e ogni voce Chapter 99 applicabile.
200 OK
hts_code
general_rate
Section 301
Section 232
Ricevi dati pronti per il landed cost
Un'unica risposta JSON restituisce il codice HTS e ogni livello di dazio, pronto per essere inserito nel tuo preventivo di landed cost, nella preparazione della dichiarazione doganale o nel tuo pricing engine.
Una richiesta in ingresso, l'intero quadro tariffario in uscita
Invia una descrizione e un'origine. Ricevi il codice HTS e il dettaglio completo dei dazi in un'unica chiamata. Questa è un'istantanea di marketing; il riferimento API documenta ogni campo, codice di errore e comportamento in batch.
Richiesta
curl -X POST 'https://api.gingercontrol.com/openapi/v1/tariff' \
-H 'Content-Type: application/json' \
-H 'X-Api-Key: YOUR_API_KEY' \
-d {
"description": "Cotton knit short sleeve T-shirt",
"country_of_origin": "VN"
}Risposta
{
"hts_code": "6109.10.0012",
"tariffs": {
"general_rate": "16.5%",
"special_rate": "Free",
"Section 301": [],
"Section 232 - Metals": [],
"Section 122": [
{ "code": "9903.03.01", "rate": "10%" }
]
}
}Consulta il riferimento API completo per richieste in batch, componenti split-code, semantica degli errori e limiti di frequenza.
Cosa dà l'API ai tuoi sistemi
Classifica
Classificazione HTS che regge alla scala di un catalogo, inclusi i beni compositi che la maggior parte delle API salta in silenzio.
6109.10
6109.10
6109.10
6109.10
6109.10
Classificazione HTS alla scala del catalogo
Invia descrizioni di prodotto disordinate del mondo reale e ricevi un codice HTS a 10 cifre. Nel nostro benchmark interno su oltre 1.000 prodotti il motore ha raggiunto il 99,86% di accuratezza, e ogni risultato è output di ricerca da rivedere da parte di uno spedizioniere doganale abilitato prima della dichiarazione doganale.
Calcola
Non solo l'aliquota base. L'intero stack che finisce davvero sulla dichiarazione doganale.
MFN
301
232
122
Ch 99
Total
L'intero stack di dazi del landed cost
Ogni risposta porta con sé le aliquote General (MFN) e Special più Section 301, Section 232, Section 122 e tutte le voci Chapter 99 applicabili, così il tuo landed cost riflette ciò che la dogana accerterà davvero.
Integra
Contratti prevedibili e modalità di errore chiare, le cose su cui un team ops può pianificare.
POST/tariff1 item
POST/tariff/batch200
Endpoint singolo e in batch
Classifica un singolo prodotto per un preventivo live al checkout, oppure invia fino a 200 elementi in un'unica chiamata batch per un'esecuzione notturna del catalogo. Entrambi gli endpoint condividono un'unica forma di risposta e un'unica quota.
Chi ci costruisce sopra
L'API è costruita per le operazioni che fanno passare in dogana ogni giorno grandi volumi di beni retail, generi alimentari e pacchi, dove classificare riga per riga a mano semplicemente non scala.
Spedizionieri internazionali
Classificare e calcolare il prezzo dell'intero manifesto di spedizione di un cliente prima che il camion parta, invece di aspettare uno spedizioniere per ogni riga.
E-commerce transfrontaliero
Mostrare al checkout un landed cost accurato comprensivo di dazi, così gli acquirenti non vengono sorpresi dagli oneri doganali alla consegna.
Operatori postali e di corriere
Elaborare codici HTS e dazi su flussi di pacchi in entrata ad alto volume per alimentare dichiarazioni doganali e prepagamento.
Marketplace e piattaforme retail
Fornire a migliaia di venditori terzi codici HTS corretti e stime dei dazi senza dover assumere un team di classificazione.
3PL e fulfillment
Integrare classificazione e landed cost nell'onboarding così ogni nuovo catalogo cliente è pronto per la dichiarazione doganale dal primo giorno.
ERP, TMS e pricing engine
Incorporare dati sui dazi in tempo reale nella piattaforma che i tuoi stessi clienti già usano, senza alcuna tariffa doganale da mantenere.
Il lavoro che svolge
"Spostiamo migliaia di SKU a settimana. Non possiamo mettere una persona su ogni riga, ma una stima dei dazi sbagliata in fase di preventivo ci costa il deal o il margine."
Cosa significa in pratica
| Calcolare il landed cost prima che la merce si muova | Una sola chiamata restituisce il codice HTS e l'intero stack di dazi, abbastanza rapida per un preventivo al checkout o per un manifesto di spedizione. |
|---|---|
| Gestire interi cataloghi, non singole consultazioni | L'endpoint in batch elabora fino a 200 prodotti per chiamata e scala fino a oltre 200K classificazioni al giorno. |
| Fidarsi del numero che finisce nel preventivo | Stack di dazi completo con Section 301, 232 e 122, più i dazi per componente split-code, pensato per la revisione dello spedizioniere prima della dichiarazione doganale. |
FAQ sull'API
Devo essere uno spedizioniere doganale abilitato per usare l'API?
+
No. L'API restituisce output di ricerca: un codice HTS e l'intero stack di dazi da usare nei tuoi sistemi per il preventivo e la preparazione. Il risultato è pensato per essere rivisto da uno spedizioniere doganale abilitato prima di essere usato in una dichiarazione doganale. Accelera il lavoro, non sostituisce il via libera dello spedizioniere.
Quanto è veloce una classificazione?
+
La classificazione di un singolo prodotto in genere ritorna in ben meno di un minuto. Un batch di fino a 200 prodotti gira in parallelo e si completa in circa 3-5 minuti, ed è ciò che permette alle chiavi standard di produzione di gestire oltre 200K classificazioni al giorno.
L'API può darmi un landed cost comprensivo di dazi?
+
Restituisce ogni livello di dazio che finisce sulla dichiarazione doganale: le aliquote General (MFN) e Special più Section 301, 232, 122 e le voci Chapter 99 applicabili. Combina quello stack di dazi con il tuo trasporto e i tuoi diritti per produrre una cifra di landed cost per un preventivo o un checkout.
Come ottengo una chiave API?
+
Richiedi una chiave di test e te la consegniamo tramite un canale offline come l'email. Le chiavi di test hanno una piccola quota e scadono in 7-30 giorni, solo per lo sviluppo. Quando sei pronto a partire, emettiamo una chiave di produzione dimensionata sul tuo pattern di chiamata, sull'allowlist di IP e sul picco di QPS.
Quali sono i limiti del batch?
+
L'endpoint in batch accetta fino a 200 prodotti per chiamata. Ogni elemento riporta il proprio stato, così un prodotto non classificabile non fa fallire l'intero batch, ed entrambi gli endpoint, singolo e batch, attingono alla stessa quota di elementi sotto la tua chiave.
Dove si trova la documentazione tecnica completa?
+
Il riferimento API documenta ogni endpoint, campo di richiesta e risposta, codice di errore, header e regola sui limiti di frequenza, con esempi curl copia-incolla. È la pagina su cui costruire una volta che hai una chiave.
Metti un classificatore dietro la tua operatività
Richiedi una chiave di test per iniziare a integrare, oppure leggi l'intero riferimento API per costruire sul contratto.
Solo a scopo di riferimento generale. Consulta il disclaimer di compliance.
Promemoria di compliance
Questo è un HTS classification researcher. I risultati sono destinati esclusivamente a scopi di riferimento generale, formativi e di pianificazione, pensati per favorire una migliore comunicazione tra team di compliance doganale, importatori e spedizionieri doganali abilitati. Secondo il CBP Ruling HQ H290535, fornire classificazioni HTS oltre le 6 cifre per importazioni specifiche costituisce "customs business" ai sensi del 19 U.S.C. § 1641. Non usare questi risultati direttamente nei documenti di dichiarazione doganale senza una revisione indipendente da parte di uno spedizioniere doganale abilitato.
Leggi il disclaimer di compliance completo →