DOCS

Manage products

/

Beheer Catalogus

Maak en wijzig producten.

Leer hoe u uw Zonos Catalogus product(en) kunt toevoegen, wijzigen en verwijderen in Dashboard of via API. Gebruik Catalogus in Dashboard om code te vermijden of als u kleine wijzigingen aanbrengt. Als u direct met Catalogus wilt integreren voor productie-implementaties, gebruik dan de API.

Maak een product

Dashboard
API

Maak een product in Catalogus:

  1. Ga naar Catalogus en klik op Product toevoegen in de rechterbovenhoek.
  2. Voeg uw productdetails toe. Het enige vereiste veld om een product te maken is het SKU en/of product ID veld(en). Deze velden worden gebruikt om uw catalogusproducten te refereren. Leer meer over Catalogus’ identificatoren.
  3. Optioneel—Voeg uw HS-code(s) toe.
  4. Optioneel—Voeg uw verzendinformatie toe (gewicht, afmetingen, eenheden van maat, enz.).
  5. Optioneel—Voeg beperkte landen toe.
  6. Klik op product opslaan.

Maak meerdere producten in Catalogus:

Upload meerdere producten of uw gehele productcatalogus in één keer.

Belangrijk: Als je probeert een product te creëren dat al bestaat, zal Catalog het product herkennen op basis van de SKU en/of product ID en de details van het originele product overschrijven met de nieuwe details.

Bewerk een product

Het bewerken van producten stelt je in staat om je bestaande producten efficiënt bij te werken met aanvullende of bijgewerkte informatie. In plaats van het product te verwijderen en opnieuw te uploaden, kun je de bijgewerkte informatie uploaden, en Catalog zal deze matchen met het bestaande product op basis van je SKU of product ID, afhankelijk van je voorkeur voor item sleutels. Op deze manier kun je je catalogus up-to-date houden met minimale inspanning, of je nu het Dashboard of de API gebruikt om nieuwe producten te creëren of bestaande producten te bewerken.

Als je een catalogusproduct creëert/bewerkt dat al bestaat in Catalog, verwacht dan het volgende:

Catalog zal lege velden op bestaande items overschrijven.

  • Bijvoorbeeld, als een bestaand product, SKU 321, geen waarde voor gewicht had, en hetzelfde product, SKU 321, een gewicht van 1.3 lbs had in de nieuwe upload, zou het gewicht van 1.3 lbs het eerder lege veld overschrijven.

Catalog zal bestaande velden overschrijven met nieuwe veldwaarden.

  • Bijvoorbeeld, als een bestaand product, SKU 123, een prijs van 18.99 USD had en hetzelfde product, SKU 123, een bijgewerkte prijs van 22.99 USD had, zou de nieuwe prijs van 22.99 USD de vorige prijs overschrijven.

Catalog zal bestaande waarden niet overschrijven met lege velden.

  • Bijvoorbeeld, als een bestaand product, SKU 456, een HS-code van 6109.10 had, maar de HS-code van het bijgewerkte product, SKU 456, leeg is, blijft de bestaande HS-code behouden.
Dashboard
API

Om een product te bewerken:

  1. Klik op het Producten tabblad.
  2. Selecteer het product dat je wilt bewerken.
  3. Maak je wijzigingen.
  4. Klik op product opslaan.

Om meerdere of alle producten tegelijk te bewerken, upload je gewoon een bijgewerkt CSV-bestand naar de Catalogus, inclusief je SKU/Product ID-combinaties. Dit zal automatische updates van je bestaande items activeren.

Verwijder een product

Dashboard
API

Om een product te verwijderen:

  1. Klik op het tabblad Producten in het Dashboard.
  2. Selecteer de product(en) die je wilt verwijderen. Zodra je product(en) zijn geselecteerd, verschijnt er een verwijderknop.
  3. Klik op Verwijderen en vervolgens op Verwijder alles om je verwijdering te bevestigen.

Om alle producten te verwijderen:

  1. Selecteer het tabblad Producten in het Dashboard.
  2. Klik op Beheer Catalogus in de rechterbovenhoek en klik vervolgens op Verwijder alles.
  3. Klik nogmaals op Verwijder alles om je verwijdering te bevestigen.

Houd er rekening mee dat als je een groot aantal artikelen verwijdert (meer dan 20.000 producten of zo), er een melding verschijnt die aangeeft dat je verwijdering in uitvoering is. Gedurende deze tijd kun je niet interactie hebben met de Catalogus totdat de verwijdering is voltooid. Je kunt echter de melding negeren en weg navigeren zonder het verwijderingsproces te onderbreken.

Restrict een product

Als je verzendingen naar een bepaald land (of landen) wilt voorkomen, kun je beperkingen toevoegen bij het aanmaken of bijwerken van een product.

Dashboard
API

Om een restrict enkel product in de Catalogus:

  1. Klik op het tabblad Producten.
  2. Selecteer het product waaraan je een beperking wilt toevoegen, dit opent de bewerkingspagina.
  3. Zoek de sectie Beperkte landen onderaan de bewerkingspagina.
  4. Voeg de landen toe waaraan je je product wilt restrict door de naam van het land of de landen te selecteren of in te typen.
  5. Klik op product opslaan.

Om meerdere producten in de Catalogus te restrict:

  1. Klik op het tabblad Importeren/exporteren.
  2. Download de Catalogus sjabloon CSV.
  3. Vul het sjabloon in met je productdetails, inclusief je SKU/Product ID en beperkte landen. Voer de 2-cijferige ISO-code in, gescheiden door verticale streepjes (bijv. AU|KR|MY|SG). Om alle landen te restrict voer je eenvoudig ALL in als waarde. Als je alle landen wilt restrict behalve één of een paar, voer dan ALL- in, gevolgd door de landen die je wilt vrijgeven, gescheiden door verticale streepjes (bijv. ALL-CA|FR|US). Leer meer over CSV-indeling. Als je alle bestaande beperkte landen wilt verwijderen, voer dan NONE in als waarde.
  4. Sla je bestand op als een CSV en upload het naar de Catalogus door het te slepen of je bestand te selecteren door op bladeren te klikken op dezelfde pagina waar je de CSV hebt gedownload.
  5. Bekijk je geüploade producten in het voorbeeld screen en klik op uploaden.

Beperkte producten filteren:

Je kunt beperkte producten rechtstreeks in de catalogus filteren door je volledige catalogus in CSV-indeling te downloaden vanuit het Dashboard en deze te openen in Excel of Google Sheets. Van daaruit kun je de filterfunctie gebruiken om alleen de beperkte producten te bekijken. Dit stelt je in staat om de beperkte producten in je catalogus eenvoudig te lokaliseren en te beheren.

Als je je catalogus moet bijwerken na het aanbrengen van wijzigingen in je CSV, upload dan het bestand opnieuw en alle overeenkomende producten worden vervangen door de bijgewerkte versie. Dit gebeurt door de SKU en/of product-ID te identificeren en te matchen.

Als je Checkout gebruikt, wordt er een beperkt bericht weergegeven in je checkout wanneer een product beperkt is voor het land van de klant. Standaard zal het bericht zeggen "Dit item is beperkt voor import naar jouw land," maar je kunt je eigen beperkte bericht aanpassen door het te verstrekken in het restrictedCountriesMessage veld wanneer je je landbeperkingen toevoegt.

Filter een product

Je kunt producten in de Catalogus doorzoeken via het Dashboard of via de API met behulp van de SKU of product-ID. Let op dat alleen exacte overeenkomsten resultaten opleveren; gedeeltelijke overeenkomsten worden niet herkend.

Dashboard
API

Om te filteren op SKU of product-ID:

  1. Klik op het tabblad Producten.
  2. Selecteer SKU of Product-ID in de linkerbovenhoek van je Catalogus.
  3. Voer je SKU of product-ID in.
  4. Klik op Toepassen om je gefilterde product(en) te bekijken.

Exporteer uw producten

Als u 50 of minder artikelen uit de Catalogustabel kiest, wordt uw catalogus rechtstreeks van het Dashboard gedownload. Als u echter Alles exporteren of meer dan 50 artikelen selecteert, wordt uw CSV via e-mail geëxporteerd.

Volg deze stappen om 50 artikelen of minder te exporteren:

  1. Selecteer 50 of minder artikelen rechtstreeks uit de Catalogustabel.
  2. Klik op Exporteren in de rechterbovenhoek.
  3. Zoek uw CSV-bestand in uw e-mailinbox.

Om alle producten te exporteren:

Dashboard
API
  1. Ga naar Dashboard -> Producten -> Catalogus.
  2. Klik op de Beheer catalogus dropdown naast Product toevoegen en klik op Alles exporteren.
  3. Zoek uw catalogusbestand in uw downloads.

Problemen met downloaden vanuit uw e-mail?

Als u problemen ondervindt bij het downloaden van de CSV via de link in uw e-mail, kan dit komen doordat uw browser de download blokkeert. Volg in dat geval deze stappen:

  1. Klik met de rechtermuisknop op de knop "Downloaden" in uw e-mail.
  2. Selecteer "Kopieer linkadres" om de download-URL te kopiëren.
  3. Plak de gekopieerde URL in uw browser en druk op enter.
  4. Uw catalogus wordt dan rechtstreeks vanuit uw browser gedownload.

Classify een product

U kunt classify een product uit uw catalogus met de API door de catalogItemId te gebruiken in de ClassificationsCreateFromCatalog mutatie.

Houd er rekening mee dat een name vereist is om classify een product uit uw catalogus. Raadpleeg de GraphQL API-referentie voor een complete lijst van catalogus- en classificatievelden.

Om een catalogusproduct tegelijkertijd te creëren en classify te classificeren, voegt u de ClassificationsCreateFromCatalog mutatie hieronder toe aan uw CatalogItemsCreate mutatie.

Classify een catalogusproduct naar de 8+ cijfers (land-specifiek)

Wanneer het veld shipToCountries is ingevuld, zal de classificatie een 8+ cijfers (land-specifiek) HS-code zijn. Als er geen shipToCountries worden opgegeven, zal de classificatie standaard een 6-cijferige (universale) HS-code zijn. Leer meer over de verschillen tussen universale en land-specifieke HS-codes.

In het onderstaande voorbeeld is het veld shipToCountries ingevuld om een land-specifieke code voor Canada te genereren.

Mutatie

1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation ClassificationsCreateFromCatalog(
  $catalogItemToClassify: [ClassificationFromCatalogInput!]!
) {
  classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
    id
    configuration {
      shipToCountries
    }
    hsCode {
      code
    }
    name
  }
}

Hier is een voorbeeld van een verzoek. Terwijl Zonos Classify een classificatie zal genereren met alleen een naam, raden we ten zeerste aan om zoveel mogelijk details toe te voegen voor de beste classificatieresultaten.

Variabelen

1
2
3
4
5
6
7
8
9
10
{
  "catalogItemToClassify": [
    {
      "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
      "configuration": {
        "shipToCountries": ["CA"]
      }
    }
  ]
}

Antwoord

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "data": {
    "classificationsCreateFromCatalog": [
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "configuration": {
          "shipToCountries": ["CA"]
        },
        "countryOfOrigin": "US",
        "hsCode": {
          "code": "6116.10.0020"
        },
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
      }
    ]
  }
}

API-fouten en oplossingen

FoutOplossing
Een SKU of product-ID is vereist om een product te creërenEen identificatie (SKU/product-ID) is vereist om een catalogusitem te creëren, bewerken of te verwijderen. Om dit op te lossen, voeg een SKU en/of product-ID toe.
Het product dat u probeert te bewerken bestaat niet*U kunt een product dat niet bestaat niet bewerken. Om dit op te lossen, creëert u een nieuw product met uw gewenste SKU en/of product-ID.
Douanebeschrijving overschrijdt het tekenlimiet van 30 tekens.Standaard zijn douanebeschrijvingen beperkt tot 30 tekens, wat overeenkomt met de meest voorkomende tekenlimiet voor commerciële facturen.
Producttype ongeldig. Catalogus ondersteunt de volgende producttypes: digital_good. Voor fysieke goederen, laat het leeg.Catalogus ondersteunt alleen de volgende producttypes: digital_good en physical_good. Als uw product een fysiek goed is (meest voorkomend), laat dit veld dan leeg.
Verpakkingsvoorkeur ongeldig. Catalogus ondersteunt de volgende verpakkingsvoorkeuren: ships_alone en consolidated. Als uw product kan worden samengevoegd met andere producten, laat het leeg.Verpakkingsvoorkeur ongeldig. Catalogus ondersteunt de volgende verpakkingsvoorkeuren: ships_alone en consolidated. Als uw product kan worden samengevoegd met andere producten, kunt u het leeg laten, aangezien consolidated de standaard is.
Land moet worden gespecificeerd bij het verstrekken van een HS-codeAls u een land-specifieke HS-code verstrekt bij het creëren van een item, is een verzendland vereist. Om dit op te lossen, voeg een verzendland toe.
Prijs moet groter zijn dan 0Catalogus ondersteunt geen negatieve prijswaarden. Om dit op te lossen, voeg een prijs groter dan nul toe.
Valutacode moet worden verstrekt wanneer een prijswaarde wordt opgegevenAls u een prijs opgeeft, is een valutacode vereist. Om dit op te lossen, voeg een valutacode toe.
Prijs moet worden opgegeven wanneer een valutacode wordt verstrektAls u een valutacode opgeeft, is een prijs vereist. Om dit op te lossen, voeg een prijs toe.
Het bijbehorende dimensionale veld kan niet leeg worden gelatenAls één dimensionaal veld wordt opgegeven, zijn de andere twee vereist. Bijv. als u een breedte van “8 inch” opgeeft, zijn de hoogte en lengte vereist.
Meetwaarde moet groter zijn dan 0Catalogus ondersteunt geen negatieve of nul meetwaarden. Om dit op te lossen, voeg een waarde groter dan nul toe.
Bij het verstrekken van een dimensionale waarde, kunnen dimensionale eenheden niet leeg worden gelatenAls u een dimensionale waarde opgeeft, is een dimensionale eenheid vereist. Om dit op te lossen, voeg een dimensionale eenheid toe.
Bij het verstrekken van een gewichtwaarde, kan de gewichtseenheid niet leeg worden gelatenAls u een gewichtwaarde opgeeft, is een gewichtseenheid vereist. Om dit op te lossen, voeg een gewichtseenheid toe.

* API-fout alleen

Was deze pagina nuttig?