Gestisci il Catalogo

Importante: Se tenti di creare un prodotto che esiste già, il Catalog riconoscerà il prodotto in base al SKU e/o ID prodotto e sovrascriverà i dettagli del prodotto originale con i nuovi dettagli.

Modificare i prodotti ti consente di aggiornare i tuoi prodotti esistenti con informazioni aggiuntive o aggiornate in modo efficiente. Invece di dover eliminare e ricaricare il prodotto, puoi caricare le informazioni aggiornate, e il Catalog le abbinerà al prodotto esistente utilizzando il tuo SKU o ID prodotto, a seconda della tua preferenza per la chiave dell'elemento. In questo modo, puoi mantenere il tuo catalogo aggiornato con il minimo sforzo, sia che tu utilizzi il Dashboard o lAPI per creare nuovi prodotti o modificare prodotti esistenti.

Se crei/modifichi un prodotto del catalogo che esiste già nel Catalog, aspettati quanto segue:

Il Catalog sovrascriverà i campi vuoti sugli elementi esistenti.

• Ad esempio, se un prodotto esistente, SKU 321, non aveva un valore per il peso, e lo stesso prodotto, SKU 321, aveva un peso di 1.3 lbs nel nuovo upload, il peso di 1.3 lbs sovrascriverebbe il campo precedentemente vuoto.

Il Catalog sovrascriverà i campi esistenti con nuovi valori di campo.

• Ad esempio, se un prodotto esistente, SKU 123, aveva un prezzo di 18.99 USD e lo stesso prodotto, SKU 123, aveva un prezzo aggiornato di 22.99 USD, il nuovo prezzo di 22.99 USD sovrascriverebbe il prezzo precedente.

Il Catalog non sovrascriverà i valori esistenti con campi vuoti.

• Ad esempio, se un prodotto esistente, SKU 456, aveva un codice HS di 6109.10, ma il codice HS del prodotto aggiornato, SKU 456, è vuoto, il codice HS esistente rimane.

Se desideri impedire le spedizioni verso un determinato paese (o paesi), puoi aggiungere restrizioni durante la creazione o l'aggiornamento di un prodotto.

Se stai utilizzando Checkout, un messaggio di restrizione verrà visualizzato nel tuo checkout quando un prodotto è limitato al paese del cliente. Per impostazione predefinita, il messaggio dirà "Questo articolo è vietato all'importazione nel tuo paese", ma puoi personalizzare il tuo messaggio di restrizione fornendolo nel campo restrictedCountriesMessage quando aggiungi le restrizioni per il tuo paese.

Puoi cercare prodotti nel Catalogo tramite Dashboard o tramite API utilizzando sia il SKU che l'ID prodotto. Tieni presente che solo le corrispondenze esatte restituiranno risultati; le corrispondenze parziali non verranno riconosciute.

Dashboard

API

Per filtrare per SKU o ID prodotto:

1. Clicca sulla scheda Prodotti.
2. Seleziona SKU o ID Prodotto nell'angolo in alto a sinistra del tuo Catalogo.
3. Inserisci il tuo SKU o ID prodotto.
4. Clicca su Applica per visualizzare il/i prodotto/i filtrato/i.

Se scegli 50 o meno articoli dalla tabella Catalogo, il tuo catalogo verrà scaricato direttamente dal Dashboard. Tuttavia, se selezioni Esporta tutto o più di 50 articoli, il tuo CSV verrà esportato via email.

Per esportare 50 articoli o meno, segui questi passaggi:

1. Seleziona 50 o meno articoli direttamente dalla tabella Catalogo.
2. Fai clic su Esporta nell'angolo in alto a destra.
3. Trova il tuo file CSV nella tua casella di posta elettronica.

Per esportare tutti i prodotti:

Problemi nel download dalla tua email?

Se hai problemi a scaricare il CSV dal link nell'email, potrebbe essere dovuto al fatto che il tuo browser sta bloccando il download. In tal caso, segui questi passaggi:

1. Fai clic con il tasto destro sul pulsante "Download" nella tua email.
2. Seleziona "Copia indirizzo link" per copiare l'URL di download.
3. Incolla l'URL copiato nel tuo browser e premi invio.
4. Il tuo catalogo verrà quindi scaricato direttamente dal tuo browser.

Puoi classify un prodotto dal tuo catalogo utilizzando l'API con il catalogItemId nella mutazione ClassificationsCreateFromCatalog.

Nota che è richiesto un name per classify un prodotto dal tuo catalogo. Consulta il riferimento API GraphQL per un elenco completo dei campi catalogo e classificazione.

Per creare e classify un prodotto del catalogo simultaneamente, aggiungi la mutazione ClassificationsCreateFromCatalog qui sotto alla tua mutazione CatalogItemsCreate.

Classify un prodotto del catalogo con codice HS specifico per il paese di 8+ cifre

Quando il campo shipToCountries è popolato, la classificazione sarà un codice HS di 8+ cifre (specifico per il paese). Se non vengono forniti shipToCountries, la classificazione predefinita sarà un codice HS di 6 cifre (universale). Scopri di più sulle differenze tra i codici HS universali e specifici per il paese.

Nell'esempio qui sotto, il campo shipToCountries è fornito per generare un codice specifico per il paese per il Canada.

mutation ClassificationsCreateFromCatalog(
  $catalogItemToClassify: [ClassificationFromCatalogInput!]!
) {
  classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
    id
    configuration {
      shipToCountries
    }
    hsCode {
      code
    }
    name
  }
}

Ecco un esempio di una richiesta. Mentre Zonos Classify genererà una classificazione con solo un nome, raccomandiamo vivamente di aggiungere quanti più dettagli possibile per i migliori risultati di classificazione.

{
  "catalogItemToClassify": [
    {
      "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
      "configuration": {
        "shipToCountries": ["CA"]
      }
    }
  ]
}

{
  "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"
      }
    ]
  }
}

Errori API e risoluzioni

* Errore API solo