Interfaccia XML

GestionaleAuto.com permette le operazioni di esportazione e importazione dati tramite tracciato XML Standard.

Estrazione dei dati

GestionaleAuto.com mette a disposizione del cliente che ne faccia richiesta un URL ad un feed XML che esegue l'estrazione aggiornata degli annunci, ogni volta invocato tramite codice di programmazione o tramite browser..

Di seguito un esempio di XML ottenuto con l'esportazione XML

<?xml version="1.0"  encoding="utf-8"  ?>
<export_gestionaleauto userid="dealername">
<car id="3015243">
    <model>
        <infocar_code>066342200809</infocar_code>
        <make>BMW</make>
        <model>320</model>
        <version>D 177 CV TOURING RESTYLING 2008</version>
        <body>Station Wagon</body>
        <fuel>Diesel</fuel>
        <traction>posteriore</traction>
        <kwatt>130</kwatt>
        <cc>1995</cc>
        <cylinders>4</cylinders>
        <cvfiscali>20</cvfiscali>
        <doors>5</doors>
        <seats>5</seats>
        <weight>1505</weight>
        <emission_class>E5</emission_class>
        <emission_co2>130.0</emission_co2>
        <consumption>
            <urban>6.1</urban>
            <outer>4.2</outer>
            <combined>4.9</combined>
        </consumption>
    </model>
    <exterior>
        <color>Nero</color>
        <paint>metallizzato</paint>
    </exterior>
    <interior>
        <color>Grigio scuro</color>
        <make>Pelle</make>
    </interior>
    <start_date>2012-10-22</start_date>
    <usage>usato</usage>
    <origin>nazionale</origin>
    <registration_date>10/2008</registration_date>
    <km>73800</km>
    <gearbox>Automatico</gearbox>
    <gears_number>6</gears_number>
    <damaged>false</damaged>
    <claimable_vat>true</claimable_vat>
    <negotiable>false</negotiable>
    <business_vehicle>false</business_vehicle>
    <occasion>true</occasion>
    <previous_owners>1</previous_owners>
    <prompt_delivery>true</prompt_delivery>
    <financing_available>true</financing_available>
    <warrenty>true</warrenty>
    <warrenty_months>12</warrenty_months>
    <warrenty_type>concessionario</warrenty_type>
    <plate>DT804KP</plate>
    <price_type>lordo</price_type>
    <customers_price>17800</customers_price>
    <subtitle>Cambio automatico - Navigatore - Pelle - Garanzia 12 Mesi</subtitle>
    <options>
        <standard_option>Sistema di navigazione</standard_option>
        <standard_option>Servosterzo</standard_option>
        <standard_option>Lettore CD</standard_option>
        <standard_option>Filtro antiparticolato</standard_option>
        <standard_option>Fendinebbia</standard_option>
        <extra>Volante multifunzione</extra>
        <extra>Retrovisori elettrici</extra>
        <extra>Bracciolo</extra>
    </options>
    <additional_informations>
        Auto perfetta
    </additional_informations>
    <images>
        <image>
            <small>http://graphics.gestionaleauto.com/3015243_T_508fe34e34742.jpg</small>
            <medium>http://graphics.gestionaleauto.com/3015243_N_508fe34e2bd38.jpg</medium>
            <large>http://graphics.gestionaleauto.com/3015243_E_508fe34e24311.jpg</large>
        </image>
        <image>
            <small>http://graphics.gestionaleauto.com/3015243_T_508fe32caffe6.jpg</small>
            <medium>http://graphics.gestionaleauto.com/3015243_N_508fe32ca8013.jpg</medium>
            <large>http://graphics.gestionaleauto.com/3015243_E_508fe32ca153a.jpg</large>
        </image>
        <image>
            <small>http://graphics.gestionaleauto.com/3015243_T_508fe32ff32ca.jpg</small>
            <medium>http://graphics.gestionaleauto.com/3015243_N_508fe32feb226.jpg</medium>
            <large>http://graphics.gestionaleauto.com/3015243_E_508fe32fe4882.jpg</large>
        </image>
    </images>
    <last_modified>2012-12-16 08:39:40.955621</last_modified>
</car>

Scarica il file xml di esempio completo

Per importare gli annunci all'interno di un proprio sito il programmatore deve implementare una procedura che scarica il file XML (ad esempio tramite CURL) ed importa i dati ricevuti nel database del sito.

Per non creare un carico eccessivo, suggeriamo di schedulare l'attività di download automatico ogni “n” ore

Di seguito un esempio del codice PHP che lo sviluppatore dovrà implementare per scaricare i dati automaticamente

<?php
// create a new cURL resource
$ch = curl_init();

// set URL and other appropriate options
curl_setopt($ch, CURLOPT_URL, "http://developer.gestionaleauto.com/export_gestionaleauto.php");
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

// grab URL and save the content into $result
$result = curl_exec ($ch);

// close cURL resource, and free up system resources
curl_close($ch);

// parse $result 

[...]

?>

 

Importazione dei dati via FTP

Il programmatore può implementare una procedura di importazione massiva dei dati tramite tracciato standard XML.

Il formato dell'XML di importazione è equivalente all'XML di esportazione precedentemente illustrato.

L'XML creato dal programmatore deve rispettare le specifiche e deve pertanto essere validato tramite XSD prima dell'invio.

Lo scambio dati avviene tramite FTP.

Il file generato dovrà essere nominativo username_archive.zip e l'XML contenuto username.xml

Ogni annuncio deve avere un "idannuncio" corrispondente ad un numero intero univoco. Le immagini all'interno del file ZIP sono nominate:

  • idannuncio_0.jpg
  • idannuncio_1.jpg
  • ...
  • idannuncio_n.jpg

Per una corretta interpretazione degli annunci marca e modello deve essere conforme al database allestimenti fornito da GestionaleAuto.com