Dogana

Cerca i codici TARIC per descrizione o per codice. Usa il risultato come codice HS di un articolo nei dati doganali di una spedizione internazionale.

GET/tariff-codes

Search TARIC codes by description

In arrivo Il contratto è pubblicato prima dell'implementazione. Questa operazione non è ancora disponibile e la sua forma può ancora cambiare.

Assisted lookup of TARIC / HS codes from a natural-language product description (Italian or English). Only codes present in the customs catalogue are returned. Use the code as customs.items[].hs_code in POST /shipments. This search does not provide quantity, value, weight or export reason. If nothing matches, try a more specific description or English.

Autenticazione: la tua chiave API nell'header X-API-Key.

Parametri

  • Name
    q
    Type
    string
    obbligatorio
    Description

    Product description.

  • Name
    lang
    Type
    string
    Description

    Search language.

    Valori ammessi: it, en. Predefinito: it.

  • Name
    limit
    Type
    integer
    Description

    Maximum results, 1 to 10.

    Predefinito: 5. ≥ 1, ≤ 10.

Risposte

  • 200Matches, best first.TariffCodeList
  • 400Malformed or invalid request. Codes: VALIDATION_ERROR (with details.errors), INVALID_JSON, IDEMPOTENCY_KEY_REQUIRED, UNSUPPORTED_VERSION.Error
  • 401Missing, invalid or expired API key. Codes: API_KEY_MISSING, API_KEY_INVALID, API_KEY_EXPIRED.Error
  • 403Authenticated but not allowed. Codes: FEATURE_NOT_ENABLED (reserved feature not enabled for the customer), IP_NOT_ALLOWED (the key is restricted to other addresses), ACCOUNT_INACTIVE, CUSTOMER_OUT_OF_SCOPE.Error
  • 410Version retired. Code VERSION_RETIRED.Error
  • 429Daily or burst limit exceeded. Code DAILY_LIMIT_EXCEEDED or RATE_LIMIT_EXCEEDED. Wait Retry-After seconds.Error
  • 500Unexpected error. Code SERVER_ERROR; details.correlation_id repeats the correlation id.Error
  • 502The carrier or an internal dependency failed. Code UPSTREAM_ERROR. Safe to retry reads; retry writes with the same Idempotency-Key.Error

Richiesta

GET
/tariff-codes
Caricamento...

Risposta 200

{
  "data": [
    {
      "tariff_code": "1905310000",
      "descriptions": {
        "it": "Biscotti dolci",
        "en": "Sweet biscuits"
      },
      "confidence": 0.92
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 5
  }
}

Modelli

Oggetti usati dalle richieste e dalle risposte di questa pagina.

ParceLabsVersion

CorrelationId

KeyLocale

TariffCodeList

  • Name
    data
    Type
    array of TariffCode
    obbligatorio
    Description
  • Name
    meta
    Type
    PageMeta
    obbligatorio
    Description

TariffCode

  • Name
    tariff_code
    Type
    string
    obbligatorio
    Alias italiano: taric_code
    Description

    10-digit TARIC code. Use it as customs.items[].hs_code.

  • Name
    descriptions
    Type
    object
    obbligatorio
    Alias italiano: descrizioni
    Description

    Official descriptions.

  • Name
    confidence
    Type
    number
    Alias italiano: confidence
    Description

    Estimated match score, results sorted descending.

    ≥ 0, ≤ 1.

PageMeta

Pagination metadata.

  • Name
    total
    Type
    integer
    obbligatorio
    Description

    Total number of items matching the filters.

  • Name
    page
    Type
    integer
    obbligatorio
    Description

    Current page, starting at 1.

  • Name
    per_page
    Type
    integer
    obbligatorio
    Description

    Items per page.

BadRequest

Unauthorized

Forbidden

Gone

TooManyRequests

ServerError

BadGateway

Was this page helpful?