DOCS

Artikelen classificeren

Artikelen classificeren

Leer hoe je een classificatie aanvraagt in Dashboard en via API.

Hieronder vind je voorbeelden die illustreren hoe je universele en land-specifieke classificaties kunt aanvragen via Dashboard of via API. Voor degenen die op zoek zijn naar meer uitgebreide technische details en uitgebreide documentatie, bezoek onze Zonos GraphQL API-referentie ontwikkelaarswebsite. Deze uitgebreide bron biedt gedetailleerde inzichten in API-eindpunten, GraphQL-mutaties en uitgebreide technische informatie.

Invoervelden 

Hoewel alleen een beschrijving vereist is om een classificatie te genereren, hoe meer productdetails je verstrekt, hoe nauwkeuriger je classificatie zal zijn. Hieronder vind je een uitgebreide uitleg van elk invoerveld dat wordt geaccepteerd door Classify. Door deze invoervelden te begrijpen, kun je hun gebruik maximaliseren en zeer nauwkeurige classificaties genereren.

Beschrijvingen van invoervelden

VeldBeschrijving
Naam (vereist)De naam van het product
Beschrijving (optioneel)Een diepgaande, lange beschrijving van het product
Afbeeldings-URL (optioneel)Link naar een afbeelding van het product. Opmerking: Zorg ervoor dat je een link naar de daadwerkelijke afbeeldings-URL gebruikt en niet de URL van de productpagina
Categorieën (optioneel)Algemene subproductcategorieën, bijv. Kleding & Accessoires, Huisdierbenodigdheden, Kantoorproducten of Baby Kleding, Huisdierbedden, Lijmen & Tape
Materiaal (optioneel)Waar het product van gemaakt is, bijv. plastic, hout, staal
Land van herkomst (optioneel)De tweeletterige afkorting (ISO-code) voor het land van vervaardiging of productie van het product
Gegeven HS-code (optioneel)Voeg een bestaande HS-code toe aan je classificatieverzoek om je verzoek te begeleiden. Afhankelijk van je voorkeur en de oorsprong van je gegeven HS-code, kan Classify de HS-code valideren en de coherentie ervan controleren met de beschrijvingsdetails van het artikel. Leer meer.
Bestemmingsland (optioneel)Identificeert naar welk land het product zal worden geclassificeerd. Het bestemmingsland moet worden weergegeven met de tweeletterige afkorting (ISO-code) van elk land en niet de daadwerkelijke landnaam, bijv. AU, niet Australië. Het opnemen van dit veld zal Classify in staat stellen om een 8+ cijferige land-specifieke HS-code terug te geven in plaats van de universele 6-cijferige code. Leer meer over de verschillen tussen universele en land-specifieke HS-codes.
Product-ID (optioneel)Je product-ID of elk nummer dat kan worden gebruikt om elk product uniek te identificeren. Als er geen product-ID wordt verstrekt, zal Classify product-ID's toewijzen die beginnen met 1

Opmerking: Als je je bulkverzoek CSV in Dashboard uploadt, zal het bestemmingsland geen onderdeel zijn van de sjabloon, maar selecteer je je bestemmingslanden nadat je je bulkverzoek CSV hebt geüpload.

Vraag een classificatie aan 

Om een classificatie aan te vragen in Dashboard of via API, volg de onderstaande stappen en mutatie.

Het onderstaande voorbeeld toont een universeel (6-cijferig) verzoek. Om classificaties voor specifieke landen aan te vragen, voeg je de 'ISO-codes' van de landen toe in het Classify verzoek zoals te zien in het onderstaande voorbeeld. Om een universele HS-code aan te vragen, laat je het verzendland null in het Classify verzoek.

De invoer accepteert een lijst, zodat je meerdere of een enkele classificatie tegelijk kunt aanvragen.

MUTATIE

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
mutation {
  classificationsCalculate(
    input: [
      {
        categories: "women's clothing"
        imageUrl: "https://zonos.com/images/cozygloves.webp"
        name: "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
        configuration: { shipToCountries: KR }
      }
    ]
  ) {
    id
    name
    categories
    imageUrl
    hsCode {
      code
      description {
        full
      }
    }
  }
}

ANTWOORD

JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "data": {
    "classificationsCalculate": [
      {
        "id": "classification_313d8d9d-e330-4d79-9922-cb7a1ff317e2",
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
        "categories": ["women's clothing"],
        "imageUrl": null,
        "hsCode": {
          "code": "6116.99.0000",
          "description": {
            "full": "Articles of apparel and clothing accessories, knitted or crocheted: Gloves, mittens and mitts, knitted or crocheted: Other : Of other textile materials"
          }
        }
      }
    ]
  }
}

Mogelijke API-antwoorden

Wanneer Classify een classificatieverzoek ontvangt, probeert het de gegevens van het invoeritem die in het verzoek zijn opgenomen, te matchen met een overeenkomst in de database van Classify's op basis van de hoogste vertrouwensscore. Afhankelijk van wat er wordt gevonden, zal Classify een van de volgende antwoorden retourneren:

  1. Wanneer hsCode wordt geretourneerd met een 6 tot 8+ cijferige HS-code, afhankelijk van of er een verzendland in het verzoek is opgenomen, was uw classificatieverzoek succesvol.
  2. Wanneer {"errors": [ { "message": "Geen adequate reactie"}]} wordt geretourneerd, betekent dit dat Classify geen classificatie kon vinden vanwege onvoldoende invoerinformatie.

Was deze pagina nuttig?