Universal Web Platform · Categorie merceologiche

CategoriaMerceologica: le categorie che ordinano il catalogo, con le categorie dei marketplace

Categorie merceologiche: le categorie che ordinano il catalogo, con le categorie dei marketplace. Nel web service è il tipo CATEGORIEMERCEOLOGICHE (valore 2 di DataType); gli oggetti sono della classe CategoriaMerceologica e viaggiano nella lista ObjectListCategoriaMerceologica della richiesta e della risposta.

Scheda tecnica

VoceValore
Tipo di datoCATEGORIEMERCEOLOGICHE = 2
ClasseCategoriaMerceologica
Lista nella richiesta e nella rispostaObjectListCategoriaMerceologica
Tabella letta da QUERYCategorieMerceologiche — è il nome da usare davanti alle colonne in SQLFilter
Operazioni ammesseQUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2)
Campi chiaveCodice — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea
Chiave per cancellare con DeletingClassCodice
Chiave per le conferme di ricezioneCodice — come si usa
Controlli prima del salvataggioCodice: «Codice non specificato»
Descrizione: «Descrizione non specificato»

I campi di CategoriaMerceologica

La colonna Obbligatorio riporta i campi chiave e quelli controllati dal server prima di salvare; Predefinito è il valore che il campo assume se non lo invii; Colonna è il nome del campo nel database, da usare nei filtri di lettura.

CampoTipoObbligatorioPredefinitoColonnaA cosa serve
CodiceTestoChiave, sìvuotocodiceCodice univoco del record. È la chiave con cui il record viene creato o aggiornato. Se manca il server risponde «Codice non specificato».
DescrizioneTestoSìvuotodescrizioneDescrizione del record, mostrata nel gestionale e sul sito. Se manca il server risponde «Descrizione non specificato».
LogoImageTrasmission—oggetto vuoto—Logo, come file in Base64.
LogoMiniaturaImageTrasmission—oggetto vuoto—Logo in miniatura, come file in Base64.
CaricaVenditaBancoVero/falso—falsecaricavendbancoCarica vendita banco.
CaricaSuMenuEcommerceVero/falso—falsecaricaecommerceCarica su menu e-commerce.
CategoriaEbayTesto—vuotocatebayCategoria eBay.
CategoriaGoogleMarketTesto—vuotogooglecodCategoria corrispondente nella tassonomia di Google Merchant.
CategoriaGoogleMarketDescrizioneTesto—vuotogoogledesDescrizione di CategoriaGoogleMarket, riportata per comodità di chi legge.
CategoriaFacebookMarketTesto—vuotofacebookcodCategoria corrispondente nel catalogo di Meta.
CategoriaFacebookMarketDescrizioneTesto—vuotofacebookdesDescrizione di CategoriaFacebookMarket, riportata per comodità di chi legge.
CategoriaAmazonTesto—vuotocatamazonCategoria Amazon.
OrdinamentoIntero—0ordinamentoPosizione nell'ordinamento: i valori più bassi vengono prima.
DescrizioneDettagliataTesto—vuotodescrizionedettDescrizione estesa, anche in HTML.
AttivoVero/falso—falseattivoVero se il record è attivo.
SottocategoriaDefaultTesto—vuotosottocategoriadefSottocategoria predefinito.
RistoPlusPrioritaIntero—0rpprioritaRisto plus priorità.

Esempi

Inserimento o aggiornamento di un record (valori di esempio). Ricorda che INSERTORMODIFY riscrive tutti i campi: quelli che non invii tornano al valore predefinito, quindi per modificare un record esistente invia il record completo.

JSON · INSERTORMODIFY
{
  "DataOperation": 0,
  "TypeObject": 2,
  "GuidPC": "gestionale-01",
  "AllInsert": false,
  "ObjectListCategoriaMerceologica": [
    {
      "Codice": "COD001",
      "Descrizione": "Descrizione di esempio",
      "CaricaVenditaBanco": false,
      "CaricaSuMenuEcommerce": false,
      "CategoriaEbay": "ESEMPIO",
      "CategoriaGoogleMarket": "ESEMPIO"
    }
  ]
}

Lettura con filtro: fino a 100 record, ignorando le conferme di ricezione.

JSON · QUERY
{
  "DataOperation": 3,
  "TypeObject": 2,
  "GuidPC": "gestionale-01",
  "SQLFilter": "CategorieMerceologiche.codice = 'COD001'",
  "QueryParameter": {
    "IgnoreImportRecord": true,
    "StartingRecord": 1,
    "LimitRecord": 100
  }
}

Cancellazione: bastano i campi chiave.

JSON · DELETE
{
  "DataOperation": 1,
  "TypeObject": 2,
  "GuidPC": "gestionale-01",
  "ObjectListCategoriaMerceologica": [
    {
      "Codice": "COD001"
    }
  ]
}

Le regole su formati, date, numeri e compressione sono in formato e trasporto; esempi completi in esempi di codice.

PrecedenteListiniSuccessivaSottocategorie merceologiche