Passa al contenuto principale

Anagrafica Prodotti

Il flusso di anagrafica prodotti su Channel Engine consente di creare, aggiornare e sincronizzare in modo centralizzato tutte le informazioni di un prodotto, comprese varianti, immagini e attributi personalizzati, garantendo che i dati siano sempre coerenti su tutti i marketplace collegati.

Il sistema consente di elaborare i prodotti in bulk, controllando e verificando che ogni prodotto sia coerente e valido. Durante l'elaborazione, se un campo del prodotto padre o dei una variante è null, viene recuperato il valore già presente su ChannelEngine. Se invece il campo è fornito come vuoto (es. "description": ""), il valore viene svuotato. Il recupero dei valori da ChannelEngine avviene solo se il prodotto è già presente sulla piattaforma.

Ogni prodotto fornito viene strutturato in almeno tre livelli:

  • GranParent, che rappresenta il contenitore principale
  • Parent, che raggruppa le varianti in base all'opzione con meno valori, dando priorità alle opzioni color e size;
  • Child, che rappresentano le singole varianti.

Le opzioni principali color e size determinano il comportamento del prodotto, mentre le altre opzioni vengono memorizzate nei campi extra. Se color e size non sono presenti, le prime opzioni disponibili vengono assegnate a questi due campi principali e le restanti diventano campi extra.

La gestione delle immagini è strutturata nel seguente modo: la prima immagine fornita nell'elenco dei media viene selezionata come immagine principale. Fino a dieci immagini vengono assegnate ai campi principali dei vari prodotti, mentre le successive immagini vengono aggiunte negli extra data con chiavi numerate progressivamente (ExtraImageUrl{indice}). Questo comportamento rispetta il limite imposto da ChannelEngine, che consente di caricare un massimo di 10 immagini per prodotto.

Nel caso in cui uno dei livelli di un prodotto in fase di creazione generi un errore, l’intero gruppo di prodotti correlati viene eliminato per mantenere la coerenza dei dati. Al contrario, se il prodotto è già presente e si tratta di un aggiornamento, eventuali errori non comportano la cancellazione degli altri livelli.

Tracciato​

Tracciato per inserimento prodotti con esempio di metafield tipizzati.

{
    "sku": "BGSM001C210",
    "title": "Product Test 1 Con Varianti",
    "barcode": "14785985742",
    "handle": "product-product-1",
    "not-found-handle": "/collections/all",
    "description": "Description of product",
    "type": "product-type",
    "price": 15.99,
    "compareAtPrice": 19.99,
    "vendor": "Flowlyze",
    "category": "category",
    "tags": [
        "tagprimo",
        "tag2"
    ],
    "media": [
        {
            "alternativeText": "image test",
            "url": "https://demo.sintra-soh.com/csv-import-images/BGSM001C005/BGSM001C005.jpg"
        },
        {
            "alternativeText": "image test 1",
            "url": "https://demo.sintra-soh.com/csv-import-images/BGSM001C005/BGSM001C005_1.jpg"
        }
    ],
    "files": {
        "namespace.certification_file": "http://demo.sintra-soh.com/LdV/samplepdf.pdf",
        "documents_file": "http://demo.sintra-soh.com/LdV/samplepdf_1.pdf",
        "gallery_images_file": "http://demo.sintra-soh.com/ShippingLabels/1002-816-0.pdf",
        "manual": "http://demo.sintra-soh.com/ShippingLabels/1006-867-0.pdf"
    },
    "metafields": {
        "namespace.accessories_included": "value",
        "addition_features": "value",
        "attachment": "value",
        "attachment_system": "value",
        "audio_output": "value",
        "audio_power": "value",
        "audio_power_unit": "value",
        "logistic_depth": 1,
        "type_product": "[\"tipo1\",\"tipo2\"]",
        "video": "https://www.youtube.com/watch?v=WqDiH5bnZ4s",
        "volume_control_position": "value",
        "warrentyupgrade": false
    },
    "variants": [
        {
            "sortingNumber": 1,
            "sku": "BGSM001C210-1",
            "barcode": "1478598574258",
            "price": 12.99,
            "compareAtPrice": 15.99,
            "optionValues": {
                "color": "Blue"
            },
            "media": [
                {
                    "alternativeText": "image test 1 facoltativo",
                    "url": "http://demo.sintra-soh.com/csv-import-images/BGSM003C014/BGSM003C014.jpg"
                },
                {
                    "alternativeText": "image test 2 facoltativo",
                    "url": "http://demo.sintra-soh.com/csv-import-images/BGSM003C014/BGSM003C014_1.jpg"
                }
            ],
            "metafields": {
                "subtitle": "value"
            },
            "files": {
                "gallery_images_file": "http://demo.sintra-soh.com/ShippingLabels/1006-867-0.pdf"
            },
            "harmonizedSystemCode": "147856923",
            "countryCodeOfOrigin": "IT",
            "provinceCodeOfOrigin": "IT-52",
            "costPerItem": 14.95,
            "isDigitalItem": true
        },
        {
            "sortingNumber": 2,
            "sku": "BGSM001C210-2",
            "barcode": "1478598574259",
            "optionValues": {
                "color": "Lilac"
            },
            "media": [
                {
                    "alternativeText": "lilla davanti",
                    "url": "http://demo.sintra-soh.com/csv-import-images/BGSM003C015/BGSM003C015.jpg"
                },
                {
                    "alternativeText": "lilla sopra",
                    "url": "http://demo.sintra-soh.com/csv-import-images/BGSM003C015/BGSM003C015_1.jpg"
                }
            ],
            "metafields": {
                "subtitle": "value"
            },
            "files": {
                "gallery_images_file": "http://demo.sintra-soh.com/ShippingLabels/1006-867-0.pdf"
            },
            "weight": "1.09",
            "weightUnit": "kg",
            "harmonizedSystemCode": "123456789",
            "countryCodeOfOrigin": "IT",
            "provinceCodeOfOrigin": "IT-52",
            "costPerItem": 14.95,
            "isDigitalItem": true
        }
    ],
    "weight": "1090",
    "weightUnit": "g",
    "metaTitle": "SEO Product metaTile",
    "metaDescription": "SEO Product metaDescription",
    "harmonizedSystemCode": "987456321",
    "countryCodeOfOrigin": "IT",
    "provinceCodeOfOrigin": "IT-52",
    "costPerItem": 14.95,
    "isDigitalItem": true
}

Configurazione destinazione​

Configurare una destinazione Channel Engine e associarla al flusso, oltre alla configurazione base del flusso dati.

CampoValoreNote
Destination TypeChannel Engine
OperationProduct syncPOST /egress/sync-product-to-ce
Channel Engine URLhttps://CEURL.channelengine.net/apiURL base delle API Channel Engine
Channel Engine tokenCODICEALFANUMERICOToken API Channel Engine
Ignore pricetrue / falseSe true, ignora i prezzi durante la sincronizzazione prodotti (default: false)

Deprecato — configurazione precedente (HTTP Adapter)​

Deprecato

La configurazione tramite HTTP Adapter con Base Url, Resource Path e header x-api-key nei Settings Override è deprecata. Utilizzare la destinazione Channel Engine descritta sopra.

Oltre alle configurazioni base del flusso dati era necessario impostare nei Settings Override:

CampoValoreNote
Base Urlhttps://adapter.flowlyze.iourl degli adapter
Resource Path/api/adp/channel-engine/egress/sync-product-to-cepath dell'adapter per i prodotti
Headers :: x-api-key**********api key di verifica interazione endpoint
Headers :: x-ce-urlhttps://CEURL.channelengine.net/apiurl del Channel Engine con cui connettersi
Headers :: x-ce-tokenCODICEALFANUMERICOtoken per l'integrazione
Headers :: x-ignore-pricefalseignora i prezzi inviati nella richiesta (default false)