Documentazione Partner

1. Condivisione dei Cataloghi Prodotti

Offriamo due formati principali per la condivisione dei cataloghi prodotti:

CSV - formato preferito per la sua semplicità e compatibilità
XML - supportato per partner con sistemi esistenti

Nota importante: È possibile fornire più file separati per gestire diverse tipologie di dati (categorie, varianti, fornitori, etc.). In questo caso, è necessario specificare chiaramente la logica di collegamento tra i file.

Esempi di strutture multi-file:

File "colori.csv" con mappatura colori (es. tabella codici colori: 1-rosso, 2-verde...) e file prodotti con colonna "id_colore" collegata
File "fornitori.csv" con ID e informazioni dettagliate, e file prodotti con colonna "id_fornitore"
File "categorie.csv" con mappatura nomi delle categorie e file prodotti con colonna "id_categorie"

Esempio formato CSV:

sku,nome_prodotto,prezzo,peso,url_immagine,descrizione
ABC123,Prodotto Example,99.99,0.5,immagine1.jpg;immagine2.jpg,Descrizione prodotto
XYZ789,Altro Prodotto,149.99,1.2,principale.jpg;dettaglio.jpg,Altra descrizione

Esempio formato XML:

<?xml version="1.0" encoding="UTF-8"?>
<prodotti>
    <prodotto>
        <sku>ABC123</sku>
        <nome>Prodotto Example</nome>
        <prezzo>99.99</prezzo>
        <peso>0.5</peso>
        <immagini>
            <immagine>immagine1.jpg</immagine>
            <immagine>immagine2.jpg</immagine>
        </immagini>
        <descrizione>Descrizione prodotto</descrizione>
    </prodotto>
</prodotti>

2. Metodi di Condivisione

Offriamo diverse opzioni per la condivisione dei file:

URL proprio - Potete fornirci un URL pubblico dove accedere ai vostri file
FTP proprio - Accesso al vostro server FTP
Nostro spazio FTP - Vi forniremo credenziali per uno spazio dedicato sui nostri server

3. Definizione delle Colonne

Importante: La seguente tabella è un esempio indicativo. È necessario che il partner fornisca la propria definizione dettagliata delle colonne e dei campi utilizzati, specificando:

Nome e descrizione di ogni campo
Tipo di dato e formato atteso
Eventuali vincoli o regole specifiche
Relazioni tra campi in caso di file multipli

Esempio di struttura base:

Campo	Descrizione	Obbligatorio
sku	Identificativo univoco del prodotto	Sì
nome_prodotto	Nome completo del prodotto	Sì
prezzo	Prezzo al rivenditore in € (IVA esclusa)	Sì
IVA	IVA in percentuale	Sì
Prezzo consigliato	Prezzo consigliato al cliente finale	No
peso	Peso in kg	Sì
categorie	Elenco ID di categorie (separati da punto e virgola)	Sì
url_immagine	URL o nomi file delle immagini (separati da punto e virgola)	Sì
descrizione	Descrizione dettagliata del prodotto	Sì

4. Gestione delle Immagini

Le immagini possono essere fornite in due modi:

URL assoluti - Se le immagini sono già ospitate su un vostro server, fornite l'URL completo nel campo url_immagine
Caricamento FTP - Caricate le immagini via FTP e indicate i nomi dei file nel campo url_immagine

Specifiche delle immagini:

Formato: JPG o PNG
Dimensione minima: 800x800 pixel
Peso massimo: 2MB per immagine

È possibile associare più immagini a un singolo prodotto. In questo caso, i nomi o gli URL delle immagini devono essere separati (es. da punto e virgola) nel campo url_immagine.

5. Frequenza di Aggiornamento

È necessario che il partner specifichi:

La frequenza prevista degli aggiornamenti
Eventuali vincoli temporali dal proprio lato
Procedure di gestione degli aggiornamenti