Por llamada por lotes
200
Productos por llamada
Una sola solicitud por lotes clasifica y tarifica hasta 200 productos en paralelo, terminando en 3 a 5 minutos.
Producto
La API de clasificación y landed cost para importadores de alto volumen
Los agentes de carga, las plataformas de comercio electrónico transfronterizo, los operadores postales y de paquetería y los importadores a granel envían miles de productos a través de la aduana todos los días. La API de GingerControl convierte una descripción de producto simple y un país de origen en un código HTS y la pila arancelaria completa, para que sus sistemas puedan cotizar el landed cost y preparar declaraciones de importación sin que un humano clasifique cada línea.
Diseñada para catálogos enteros, no para casos aislados
Nivel de producción
200K+
Clasificaciones por día
Capacidad de producción estándar. Los niveles empresariales personalizados escalan hasta 100K clasificaciones por hora.
Desarrolladores
El contrato completo de solicitud, respuesta y error vive en la referencia de la API.
Referencia de la APIO escriba a chen@gingercontrol.com para obtener una clave de prueba.
Las cifras de rendimiento describen claves de API de nivel de producción estándar medidas en tráfico real. La capacidad real se dimensiona al patrón de llamada y al QPS máximo de cada cliente. La salida de clasificación es material de investigación para la revisión de un agente de aduanas con licencia antes de la presentación.
De la línea de producto al landed cost en una sola llamada
POST/v1/tariff
descriptionCotton T-shirt
countryVN
Envíe el producto y el origen
Haga POST de una descripción de producto y un país de origen, un solo elemento o un lote de hasta 200. Sin consultas al arancel, sin cola de agentes de aduanas.
6109.10.0012
MFN
301
232
Ginger clasifica y calcula
El motor determina el código HTS y luego ensambla la pila completa de derechos: la tasa base MFN más Section 301, 232, 122, y cada entrada aplicable de Chapter 99.
200 OK
hts_code
general_rate
Section 301
Section 232
Reciba datos listos para el landed cost
Una sola respuesta JSON devuelve el código HTS y cada capa de derechos, lista para incorporar a su cotización de landed cost, preparación de declaración de importación o motor de precios.
Una solicitud de entrada, el panorama arancelario completo de salida
Envíe una descripción y un origen. Reciba el código HTS y el desglose completo de derechos en una sola llamada. Esta es una instantánea de marketing; la referencia de la API documenta cada campo, código de error y comportamiento por lotes.
Solicitud
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"
}Respuesta
{
"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%" }
]
}
}Consulte la referencia completa de la API para solicitudes por lotes, componentes de código dividido, semántica de errores y límites de tasa.
Lo que la API le da a sus sistemas
Clasificar
Clasificación HTS que se sostiene a escala de catálogo, incluidos los bienes compuestos que la mayoría de las API omiten en silencio.
6109.10
6109.10
6109.10
6109.10
6109.10
Clasificación HTS a escala de catálogo
Envíe descripciones de producto desordenadas del mundo real y reciba un código HTS de 10 dígitos. En nuestra prueba comparativa interna con más de 1,000 productos, el motor alcanzó una precisión del 99.86 %, y cada resultado es salida de investigación para que un agente de aduanas con licencia la revise antes de la presentación.
Calcular
No solo la tasa base. Toda la pila que realmente aterriza en la declaración de importación.
MFN
301
232
122
Ch 99
Total
La pila completa de derechos hasta destino
Cada respuesta lleva las tasas General (MFN) y Especial más Section 301, Section 232, Section 122, y todas las entradas aplicables de Chapter 99, para que su cifra de landed cost refleje lo que la aduana realmente cobrará.
Integrar
Contratos predecibles y modos de falla claros, lo que un equipo de operaciones necesita para planificar.
POST/tariff1 item
POST/tariff/batch200
Endpoints único y por lotes
Clasifique un producto para una cotización de checkout en vivo, o envíe hasta 200 elementos en una sola llamada por lotes para una ejecución nocturna de catálogo. Ambos endpoints comparten una misma forma de respuesta y una misma cuota.
Quién construye sobre ella
La API está diseñada para operaciones que mueven grandes volúmenes de bienes minoristas, comestibles y paquetes a través de la aduana todos los días, donde clasificar línea por línea a mano simplemente no escala.
Agentes de carga
Clasificar y tarificar todo el manifiesto de embarque de un cliente antes de que salga el camión, en lugar de esperar a un agente de aduanas por cada línea.
Comercio electrónico transfronterizo
Mostrar un landed cost preciso con derechos incluidos en el checkout, para que los compradores no se sorprendan con cargos aduaneros en la entrega.
Operadores postales y de paquetería
Ejecutar códigos HTS y derechos en flujos de paquetes entrantes de alto volumen para alimentar las declaraciones aduaneras y el prepago.
Marketplaces y plataformas minoristas
Dar a miles de vendedores externos códigos HTS y estimaciones de derechos correctos sin dotar de personal a un equipo de clasificación.
3PL y fulfillment
Integrar la clasificación y el landed cost en el onboarding para que cada nuevo catálogo de cliente esté listo para declaración de importación desde el primer día.
ERP, TMS y motores de precios
Incorporar datos de derechos en vivo en la plataforma que sus propios clientes ya usan, sin ningún arancel que mantener.
El trabajo que hace
"Movemos miles de SKUs por semana. No podemos poner a un humano en cada línea, pero una estimación de derechos equivocada al momento de cotizar nos cuesta el negocio o el margen."
En qué se traduce eso
| Cotizar el landed cost antes de que la mercancía se mueva | Una sola llamada devuelve el código HTS y la pila completa de derechos, lo bastante rápido para una cotización de checkout o un manifiesto de embarque. |
|---|---|
| Manejar catálogos enteros, no consultas individuales | El endpoint por lotes procesa hasta 200 productos por llamada y escala a más de 200K clasificaciones al día. |
| Confiar en el número que va a la cotización | Pila arancelaria completa con Section 301, 232 y 122, más los derechos de componentes de código dividido, diseñada para la revisión del agente de aduanas antes de la presentación. |
Preguntas frecuentes sobre la API
¿Necesito ser un agente de aduanas con licencia para usar la API?
+
No. La API devuelve salida de investigación: un código HTS y la pila completa de derechos para que sus sistemas la usen en la cotización y la preparación. El resultado está diseñado para ser revisado por un agente de aduanas con licencia antes de usarse en una presentación aduanera. Acelera el trabajo, no reemplaza el visto bueno del agente de aduanas.
¿Qué tan rápida es una clasificación?
+
La clasificación de un solo producto suele devolverse en bastante menos de un minuto. Un lote de hasta 200 productos se ejecuta en paralelo y se completa en aproximadamente 3 a 5 minutos, que es lo que permite a las claves de producción estándar manejar más de 200K clasificaciones al día.
¿Puede la API darme un landed cost con derechos incluidos?
+
Devuelve cada capa de derechos que aterriza en la declaración de importación: las tasas General (MFN) y Especial más Section 301, 232, 122, y las entradas aplicables de Chapter 99. Combine esa pila de derechos con su propio flete y tarifas para producir una cifra de landed cost para una cotización o checkout.
¿Cómo obtengo una clave de API?
+
Solicite una clave de prueba y se la entregamos a través de un canal fuera de línea, como el correo electrónico. Las claves de prueba llevan una cuota reducida y expiran en 7 a 30 días, solo para desarrollo. Cuando esté listo para el lanzamiento, emitimos una clave de producción dimensionada a su patrón de llamada, lista de IP permitidas y QPS máximo.
¿Cuáles son los límites por lotes?
+
El endpoint por lotes acepta hasta 200 productos por llamada. Cada elemento reporta su propio estado, de modo que un producto no clasificable no hace fallar todo el lote, y tanto el endpoint único como el por lotes toman de la misma cuota de elementos bajo su clave.
¿Dónde está la documentación técnica completa?
+
La referencia de la API documenta cada endpoint, campo de solicitud y respuesta, código de error, encabezado y regla de límite de tasa, con ejemplos de curl para copiar y pegar. Es la página contra la cual construir una vez que tenga una clave.
Ponga un clasificador detrás de su operación
Solicite una clave de prueba para empezar a integrar, o lea la referencia completa de la API para construir contra el contrato.
Solo para referencia general. Ver el descargo de responsabilidad de cumplimiento.
Recordatorio de cumplimiento
Este es un HTS classification researcher. Los resultados son solo para fines de referencia general, educativos y de planificación, diseñados para permitir una mejor comunicación entre los equipos de cumplimiento comercial, los importadores y los agentes de aduanas con licencia. Según la CBP Ruling HQ H290535, proporcionar clasificaciones HTS más allá de 6 dígitos para importaciones específicas constituye "customs business" bajo 19 U.S.C. § 1641. No use estos resultados directamente en los documentos de la declaración de importación sin la revisión independiente de un agente de aduanas con licencia.
Leer el descargo de responsabilidad de cumplimiento completo →