La lista di seguito si riferisce a tutte le chiamate API per gestire i prodotti:
Attraverso la API P41 sarà possibile inviare il file relativo alla creazione di nuove schede anagrafiche prodotto in formato CSV codifica UTF8 SENZA BOM (Byte Order Mark) oppure in formato XLSX per le versione più aggiornate di Excel.
Se il file verrà caricato correttamente la P41 restituirà un messaggio contenente un ID con cui tracciare l’avanzamento dell’importazione attraverso l’API P22.
Nella tabella sono riportati tutti i possibili stati dell’importazione.
Altrimenti, ricordate che la piattaforma Mirakl permette di controllare lo stato dell’importazione e tutti gli eventuali errori.
Nel caso voleste importare i file utilizzando il formato XML, i campi prodotto sono utilizzati come nome delle etichette. I campi prodotto devono essere un livello al di sotto dell’etichetta dei prodotti. Esempio di file prodotti valido:
Formato XML valido <?xml version="1.0" encoding="UTF-8"?> <catalog> <product> <ean>1234567890</ean> <product_name>Product's Name</product_name> <category>Product's Category</category> <brand>Product's Brand</brand> <long_description>Product's Long Description</long_description> <image_url_1> You'r product's image url #1</image_url> <image_url_2> You'r product's image url #2</image_url> <image_url_3> You'r product's image url #3</image_url> </product> </catalog>
In questa sezione sono riportate alcune chiamate API che richiama l’alberatura commerciale e gli attributi di ciascuna categoria.
Categorie
L’API H11 restituisce la lista delle categorie (parent e children). Questa API può essere utilizzata per esportare tutto l’albero o anche solo una sua parte.
Attributi
L’API PM11 può essere utilizzata per esportare gli attributi predefiniti dei prodotti presenti nel catalogo del Marketplace. Considerato che gli attributi sono associati alle categorie, va da sé che si andrà ad operare con gli stessi principi sopra descritti per l’API H11 e che ritornerà quindi un albero di attributi dalle medesime caratteristiche. Ogni nodo infatti corrisponde ad una categoria ed alla relativa lista di attributi.