Specifiche di importazione
http://www.openbazar.it
OPENBAZAR.IT SPECIFICHE DEL FILE DI IMPORTAZIONE DATI (1.02) Il file di importazione dati per prodotti su openbazar è un file CSV compresso in formato ZIP CARATTERI DI SUDDIVISIONE: Divisore di colonna: Inizio stringa: Fine stringa: Fine riga:
, (virgola) “ (virgolette) “ (virgolette) A Capo
CAMPI: CODICE
DESCRIZIONE
products_id
ID UNIVOCO del prodotto
language_id
Lingua della descrizione
Valori: (it/en)
products_master
ID del prodotto Principale (Master)
Stringa
128 caratteri
products_name
Nome del prodotto
Testo
256 caratteri
SI
products_description
Descrizione del prodotto
Testo
Illimitato
SI
products_description_2
Descrizione Corta
Testo
300 caratteri
products_quantity
Quantità disponibile
products_price
Prezzo
Decimale
9999999.99
special_price
Prezzo in offerta
Decimale
9999999.98
products_weight_gr
Peso in gr
products_weight
Peso in kg
products_image
Indirizzo dell'immagine
Url
256 char
products_image_extra1
Indirizzo dell'immagine
Url
256 char
products_image_extra2
Indirizzo dell'immagine
Url
256 char
products_image_extra3
Indirizzo dell'immagine
Url
256 char
products_image_extra4
Indirizzo dell'immagine
Url
256 char
products_model
Modello
Stringa
32 char
products_notes
Note aggiuntive
Testo
300 caratteri
categories_name
Nome della categoria
Testo
128 caratteri
SI
manufacturers_name
Nome del produttore (Brand)
Testo
Illimitato
SI
currency
Valuta
products_options
Opzioni e costi aggiuntivi (Vedi specifiche)
TIPO DATO Stringa
Max 128 caratteri
SI
2 caratteri
SI
Numero intero 9999
intero
Obblig.
SI SI
9999999
Decimale (Kg) 9999999.99
(1) SI
Valore (EUR) 3char Stringa
Illimitato
(1) il peso dei prodotti viene utilizzato per il calcolo dei costi di spedizione. E' vivamente consigliato riportarlo per avere dei costi di spedizione proporzionali alle spese di spedizione sostenute.
Versione 1.02
Specifiche di importazione
http://www.openbazar.it
Per una corretta importazione le stringhe non devono contenere i seguenti caratteri: ' (virgola) e “ (virgolette) eventualmente possono essere sostituiti con i codici hrml corrispondenti. La prima riga del file CSV deve contenere il nome delle colonne (products_id, language_id, products_name, ...). Ogni prodotto deve avere 1 riga per lingua contenente le informazioni sul prodotto il valore del “product_id” dovrà essere lo stesso per ogni lingua (vedasi esempio allegato prodottinegozio.csv) una volta creato il file CSV dovrà essere compresso in formato ZIP con lo stesso nome del file : esempio: - prodottinegozio.csv deve essere compresso nel file: - prodottinegozio.zip Vedere esempio in allegato (prodottinegozio.zip) DATI NON AMMESSI Nei CSV di inserimento non sono ammessi: • • • • • • • •
Prodotti non effettivamente in vendita Riferimenti a siti esterni Descrizioni non riferite al prodotto in vendita URL esterni/Collegamenti a siti esterni Prodotti duplicati prezzi non corrispondenti a quelli di effettiva vendita Javascripts/ Oggetti Flash e altro Gli archivi inviati non devono contenere più di un file
Eventuali problematiche non volute verranno segnalate L'eventuale tentativo di utilizzo e integrazione di javascript o codici di programmazione esterni con fini terzi alla vendita porta all'immediato blocco del negozio. Queste specifiche possono subire variazioni, eventuali variazioni verranno comunicate tramite apposito aggiornamento delle stesse e comunicato. Per ulteriori chiarimenti potete contattarci al seguente indirizzo: info@openbazar.it o visitare il sito http://www.openbazar.it OPZIONI E COSTI AGGIUNTIVI L'importazione delle opzioni e del costo di opzione di un prodotto segue un formato a se stante. Il campo prevede un numero illimitato di opzioni e per ogni tipologia di negozio sono previste differenti tipologie di opzione. Il formato dei dati inseriti tramite la colonna opzionale “products_options” è il seguente: Versione 1.02
Specifiche di importazione
http://www.openbazar.it
codice_selettore:
Il codice selettore in base alla denominazione fornita nella tabella seguente- utilizzare il carattere “:” come separatore dai valori selezionabili. (es. “print_type:”)
Nome opzione|
Nome dell'opzione come descritta nel selettore per suddividere le varie opzioni è necessario utilizzare la barra verticale “|”. (es. “Poster 40x60|”)
{Costo opzione}
Il costo aggiuntivo dell'opzione da applicare al costo del prodotto deve essere indicato tra parentesi graffe {costo opzione}, può essere aggiunto o sottratto utilizzando il segno +/- e per indicare i decimali si deve utilizzare il “.” (es. Poster 40x60{+1.00}| Foto 10x10{-0.70};
Fine selettore
Per indicare la fine dei valori disponibili per un determinato selettore utilizzare il carattere “;” - punto e virgola
Il formato indicativo è il seguente codice_selettore1:Nome opzione1{Prezzo1.00}|Nome opzione2{Prezzo2.00}|Nome opzione3{Prezzo3.00};codice_selettore2:Nome opzione1{Prezzo1.00}|Nome opzione2{Prezzo2.00}; ecc... esempio: print_type:Poster 40x60{+1.00}|Poster 50x75{+12.00};photo_frame:Nessuna{0}| Semplice{+10.50}|Classica{10.40}|Barocca{20.70}|Moderna{-5.20};
Versione 1.02
Specifiche di importazione
http://www.openbazar.it
Configurazione Woocommerce/Wordpress È possibile esportare facilmente il file contenente i dati dei prodotti utilizzando e configurando correttamente i seguenti plugin: Brands for woocommerce
Products Feed Pro
https://wordpress.org/plugins/brands-forwoocommerce/ by BeRocket
https://it.wordpress.org/plugins/woo-product-feed-pro/ By AdTribes.io
Brands for woocommerce La configurazione e l’installazione di Brands for woocommerce è semplice e immediata per e segue gli standard di woocommerce/wordpress Products Feed Pro Per configurare Products Feed Pro attenersi alla seguente procedura: - Installare il modulo e attivarlo come un normale modulo wordpress/woocommerce - Andare sul Menu Products Feed Pro e cliccare su Create Feed Sulla pagina di impostazione “File name, format and channel” del modulo impostare come di seguito riportato: Project name: *
Openbazar.it
Country:
Italy
Channel:
Custom Feed
Include product variations:
NO (Grigio)
File format:
CSV
Delimiter:
, comma
Refresh Interval
Daily
Cliccare sul tasto “Save & continue” Nella pagina sucecssiva bisognerà impostare i campi come di seguito indicato: Custom Feed attributes prefix value id
Product ID
title
Product Name
description
Product Description
Link
Link
image_link
Main Image
price
Price
Categories
categories
brand
Brand (Dynamic att.)
suffix
Versione 1.02
Specifiche di importazione
http://www.openbazar.it
language
Static Value → IT
special_price
Sale Price
quantity
Quantity
weight_gr
weight
products_image_extra1
Additional Image 1
products_image_extra2
Additional Image 2
products_image_extra3
Additional Image 3
currency
Static Value → EUR
SKU
SKU
Premendo sul tasto “Save” si ottiene la generazione del feed correttamente configurato con tutti i dati necessari e il link che permette l’importazione e l’aggiornamento
Versione 1.02
Specifiche di importazione
http://www.openbazar.it
CODICI SELETTORE E VALORI Di seguito sono riportati i codici selettore e i valori disponibili. Ogni tipologia di negozio ha ha disposizione dei cofici selettori specifici corrispondenti alle proprie opzioni TIPO NEGOZIO: “DEFAULT” print_type : Tipo di Stampa Nome Opzione (IT)
Nome Opzione (EN)
NOTE
Versione 1.02
Specifiche di importazione
http://www.openbazar.it
TIPO NEGOZIO: “INFORMATICA” print_type : Tipo di Stampa Nome Opzione (IT)
Nome Opzione (EN)
NOTE
Versione 1.02
Specifiche di importazione
http://www.openbazar.it
TIPO NEGOZIO: “FOTO E IMMAGINI” print_type : Tipo di Stampa Nome Opzione (IT)
Nome Opzione (EN)
NOTE
Versione 1.02
Specifiche di importazione
http://www.openbazar.it
TIPO NEGOZIO: “SCARPE” print_type : Tipo di Stampa Nome Opzione (IT)
Nome Opzione (EN)
NOTE
Versione 1.02
Specifiche di importazione
http://www.openbazar.it
TIPO NEGOZIO: “ABBIGLIAMENTO” print_type : Tipo di Stampa Nome Opzione (IT)
Nome Opzione (EN)
NOTE
Versione 1.02
Specifiche di importazione
http://www.openbazar.it
TIPO NEGOZIO: “AUDIO E MP3” print_type : Tipo di Stampa Nome Opzione (IT)
Nome Opzione (EN)
NOTE
Versione 1.02
Specifiche di importazione
http://www.openbazar.it
TIPO NEGOZIO: “LIBRI ED EBOOK” print_type : Tipo di Stampa Nome Opzione (IT)
Nome Opzione (EN)
NOTE
Versione 1.02
Specifiche di importazione
http://www.openbazar.it
TIPO NEGOZIO: “VIAGGI ED EVENTI” print_type : Tipo di Stampa Nome Opzione (IT)
Nome Opzione (EN)
NOTE
Versione 1.02