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
coloresize; - 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": "SBS",
"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
}
Configurazioni flusso
Oltre alle configurazioni base del flusso dati aggiungere le seguenti impostazioni sui Settings Override:
| Campo | Valore | Note |
|---|---|---|
Base Url | https://adapt.flowlyze.com | url degli adapter |
Resource Path | /api/adp/channel-engine/egress/sync-product-to-ce | path dell'adapter per i prodotti |
Headers :: x-api-key | ********** | api key di verifica interazione endpoint |
Headers :: x-ce-url | https://CEURL.channelengine.net/api | url del Channel Engine con cui connettersi |
Headers :: x-ce-token | CODICEALFANUMERICO | token per l'integrazione |
Headers :: x-ignore-price | false | indica se ChannelEngine deve ignorare i prezzi inviati nella richiesta (default false) |