Versioni del tracciato
Le specifiche tecniche di interfacciamento tra Easyfatt ed il sito di e-commerce possono variare nel tempo per consentire l'aggiunta di nuove funzionalità. Versioni differenti delle specifiche vengono denominate "protocolli":
- Protocollo 1 (identificato dall'attributo AppVersion="DaneaEasyfatt.2006.17.00")
Questo è il primo protocollo realizzato (Giugno 2007).
Viene usato negli applicativi Easyfatt 2006 (a partire dalla rev. 17), fino a Easyfatt 2009 rev. 07 (compreso).
- Protocollo 2 (identificato dall'attributo AppVersion="2")
Questo è il secondo protocollo realizzato (Giugno 2009).
Viene usato a partire da Easyfatt 2009 rev. 08
Differenze
Il protocollo 2 introduce la possibilità di trasmettere il catalogo prodotti in modo incrementale e con la possibilità di inviare in upload le relative immagini. Se l'utente Easyfatt non sceglie l'opzione di invio incrementale, il tracciato Xml trasmesso sarà analogo a quello del protocollo 1 (con la sola differenza dell'attributo AppVersion="2").
Rispetto al protocollo 1, nel protocollo 2 la trasmissione di prodotti o clienti invierà esclusivamente record il cui campo <code> (codice) è valorizzato.
Nell'invio dell'elenco clienti e nella ricezione degli ordini non vi sono differenze (ad esclusione dell'attributo AppVersion="2").
Retrocompatibilità
Consigliamo di verificare che le procedure del sito siano in grado di gestire entrambi i protocolli, in questo modo sarà garantita la compatibilità anche con gli utilizzatori del precedente Easyfatt 2006. Sono pochi gli aspetti da controllare:
- Accertarsi che non esistano blocchi che impediscono di processare le richieste con AppVersion="2" o con AppVersion="DaneaEasyfatt.2006.17.00".
- La procedura che riceve l'invio prodotti con AppVersion="DaneaEasyfatt.2006.17.00" dovrà rispondere sempre e solo con "OK" (nel caso in cui non ci siano problemi), senza aggiungere i parametri per l'invio delle immagini.
