Anuntul Online - Aplicatie transfer

Feed XML

1. Introducere

online.anuntul.ro ofera posibilitatea importului de anunturi folosind un feed XML.

2. Accesul online.anuntul WS

Accesul autorizat se poate obtine prin completarea acestui formular specificandu-se urmatoarele informatii: adresa de email a contului de pe online.anuntul.ro; numele firmei sau a persoanei pentru care s-a creat contul respectiv; numar de telefon si persoana de contact

3. Cerinte

Este necesar ca accest feed XML sa poata fi accesibil public.

4. Exemplu de implementare in limbaj PHP

Recomandam varianta Feed XML pentru adaugarea unui numar nelimitat de produse. Acest feed, care va fi apelat de catre serverele noastre, trebuie salvat pe serverul dumneavoastra si modificat corespunzator astfel incat sa returneze toate produsele, ce se doresc a fi adaugat pe online.anuntul.ro, in formatul stabilit.

Vezi exemplu complet in feed.php

Lista completa a categoriilor conform Anuntul Online poate fi gasita aici.
Lista completa a judetelor conform Anuntul Online poate fi gasita aici.

anunt.class.php prezinta structura clasei anunt. Nu este necesara includerea acestei clase in codul dumneavoastra. Campurile marcate cu @obligatoriu, vor fi obligatoriu necesar completate.

O situatie aparte o reprezinta utilizarea campurilor aditionale. O parte din categoriile Anuntul Online necesita completarea unor campuri aditionale. de ex: Pentru categoria Electronice, electro. > Computere, laptopuri > Laptopuri este necesara completarea a doua campuri aditionale: marca si starea laptop-ului.
Acest lucru se poate realiza in urmatorul mod:

$campuri_aditionale[262] = "Acer";
$campuri_aditionale[224] = "nou";

unde 262 si 224 reprezinta ID Camp Marca respectiv ID Camp Stare.

Campurile cu [type] => select_multiple sau [type] => checkbox permit valori multiple. Acestea lucru se realizeaza folosind un array de valori in locul unei singure valori:

$campuri_aditionale[237] = array("XS (34)","M (38-40)","XXL (50-54)");

Lista completa a campurilor specifice fiecarei categorii poate fi gasita aici.

Imaginiile anunturilor se vor trimite sub forma de link complet cu acces public.

Dupa completarea cel putin a campurilor obligatorii, se poate adauga anuntul pentru Anuntul Online.

5. Restrictii

Toate campurile marcate cu @obligatoriu in anunt.class.php sunt obligatorii oricarui anunt indiferent de categoria aleasa.

Toate campurile aditionale (unde este cazul) apartinand categoriei alese sunt optionale.

Un anunt poate avea maxim 8 imagini.

feed.php

<?php



//nu este necesar sa modificati aici


set_time_limit(0);

class XML {

 
  public function encodeObj($obj, $root_node = 'root') {
    $xml = '<?xml version="1.0" encoding="utf-8"?>' . PHP_EOL;
	
	
	
    $xml .= self::encode($obj, $root_node, $depth = 0);
    return $xml;
  }
	 
  private function encode($data, $node, $depth) {
	  
	if( $depth == 1 ) $node = "anunturi"; 
	elseif( $depth == 2 ) $node = "anunt"; 
	  
    $xml = str_repeat("\t", $depth);
    $xml .= "<{$node}>" . PHP_EOL;
		
	
    foreach($data as $key => $val) {
      if(is_array($val) || is_object($val)) {
		 
		if( is_numeric($key) ) {
				$key = $node;
		}
			
        $xml .= self::encode($val, $key, ($depth + 1));
      } else {
		  
		  
        $xml .= str_repeat("\t", ($depth + 1));
		
		
		 
		 if( is_numeric($key) ) {
			 	
			 
				$xml .= "<camp id=\"".$key."\" value=\"".htmlspecialchars($val)."\" />" . PHP_EOL;
		}
		 else	   {
			 
        		$xml .= "<{$key}><![CDATA[" . htmlspecialchars($val) . "]]></{$key}>" . PHP_EOL;
		 }
      }
    }
    $xml .= str_repeat("\t", $depth);
    $xml .= "</{$node}>" . PHP_EOL;
    return $xml;
  }
}

//nu este necesar sa modificati aici

	



	//Exempul 1. Adaugare anunt in categoria Computere, sectiunea Laptop-uri 
	
	$content = new StdClass();
	$content->anunturi = array();
	
	$anunt = new StdClass();
	
	//ID anunt (sau ID produs) in sistemul dumneavoastra
	$anunt -> id_anunt_intern = 14;
		 
	$anunt -> categorie = 'Accesorii Tablete > Acumulatori Tablete';
	
	
	
	$anunt -> tip_vanzator = 1; 
	$anunt -> titlu = 'laptop DELL performant';  
	$anunt -> text_anunt = 'Vand cel mai performant laptop DELL al momentului, INSPIRON 17000, la un pret incredibil de mic.';
	$anunt -> descriere = 'Detalii la telefon';
	$anunt -> pret = 2000.55;
	$anunt -> pret_nou = 1900.55;
	$anunt -> pana_cand = strtotime('+1 day');  
	$anunt -> um = 'buc';  
	$anunt -> moneda = 1;  
	
	$anunt -> idjud = 2; //ID Judet Arat; 
	if( $anunt -> idjud != 10 ) {
		$anunt -> localitate = "Arad";
		
	}
	
	$anunt -> strada = 'Blvd. Elisabete';  
	$anunt -> nr_strada = '21A';  
	$anunt -> lat = 44.434798;  
	$anunt -> lng = 26.095669;  
	$anunt -> subzona = '';
	$anunt -> email = 'email@email.ro';  
	$anunt -> not_display_email = 0;  
	$anunt -> site = 'www.exemplu.ro';  
	$anunt -> telefon1 = '0720000000';  
	$anunt -> telefon2 = '0720000001'; 
	$anunt -> youtube_url = 'http://www.youtube.com/watch?v=bbAO4ICmwYk';  
	
	$anunt -> link_produs = 'http://www.siteulmeu.ro/pagina-detalii-produs';  
	$anunt -> imagini = array( 'http://www.downloadprograme.ro/wp-content/uploads/2010/07/3-D-66.jpg'
				  ,'http://www.downloadprograme.ro/wp-content/uploads/2010/07/12340.jpg'
				  ); 
	
	$campuri_aditionale[262] = "Acer";
	$campuri_aditionale[224] = "nou";
	
	
	$anunt -> campuri_aditionale = $campuri_aditionale;
	
	
	$content->anunturi[] = $anunt;
	
	$xml = new XML();
	
	header('Content-Type: text/xml; charset=utf-8');
	echo $xml->encodeObj($content);
		
	
	exit();

?>

executia feed.php

<?xml version="1.0" encoding="utf-8"?>
<root>
	<anunturi>
		<anunt>
			<id_anunt_intern><![CDATA[14]]></id_anunt_intern>
			<categorie><![CDATA[Accesorii Tablete > Acumulatori Tablete]]></categorie>
			<tip_vanzator><![CDATA[1]]></tip_vanzator>
			<titlu><![CDATA[laptop DELL performant]]></titlu>
			<text_anunt><![CDATA[Vand cel mai performant laptop DELL al momentului, INSPIRON 17000, la un pret incredibil de mic.]]></text_anunt>
			<descriere><![CDATA[Detalii la telefon]]></descriere>
			<pret><![CDATA[2000.55]]></pret>
			<pret_nou><![CDATA[1900.55]]></pret_nou>
			<pana_cand><![CDATA[1714092306]]></pana_cand>
			<um><![CDATA[buc]]></um>
			<moneda><![CDATA[1]]></moneda>
			<idjud><![CDATA[2]]></idjud>
			<localitate><![CDATA[Arad]]></localitate>
			<strada><![CDATA[Blvd. Elisabete]]></strada>
			<nr_strada><![CDATA[21A]]></nr_strada>
			<lat><![CDATA[44.434798]]></lat>
			<lng><![CDATA[26.095669]]></lng>
			<subzona><![CDATA[]]></subzona>
			<email><![CDATA[email@email.ro]]></email>
			<not_display_email><![CDATA[0]]></not_display_email>
			<site><![CDATA[www.exemplu.ro]]></site>
			<telefon1><![CDATA[0720000000]]></telefon1>
			<telefon2><![CDATA[0720000001]]></telefon2>
			<youtube_url><![CDATA[http://www.youtube.com/watch?v=bbAO4ICmwYk]]></youtube_url>
			<link_produs><![CDATA[http://www.siteulmeu.ro/pagina-detalii-produs]]></link_produs>
			<imagini>
				<camp id="0" value="http://www.downloadprograme.ro/wp-content/uploads/2010/07/3-D-66.jpg" />
				<camp id="1" value="http://www.downloadprograme.ro/wp-content/uploads/2010/07/12340.jpg" />
			</imagini>
			<campuri_aditionale>
				<camp id="262" value="Acer" />
				<camp id="224" value="nou" />
			</campuri_aditionale>
		</anunt>
	</anunturi>
</root>

anunt.class.php doar informativ, nu este necesara includerea clasei in client.php

<?php

class anunt
{


    /**
     * ID anunt in sistemul Anuntul Online
     * @var int
     *
     */
    public $id_anunt;

    /**
     * ID anunt (sau ID produs) in sistemul dumneavoastra
     * @var int
     *
     */
    public $id_anunt_intern;

    /**
     * ID user
     * @var int
     *
     */
    public $iduser;

    /**
     *
     * Numele complet al categoriei din care face parte anuntul, ex: Accesorii Tablete > Acumulatori Tablete
     * @obligatoriu
     * @var string
     *
     */
    public $categorie = "";

    /**
     *
     * nu trebuie completat
     * @var int
     *
     */
    public $id_categorie = 0;

    /**
     * nu trebuie completat
     * @var int
     *
     */
    public $id_sectiune;

    /**
     * Tip vanzator, valori posibile:
     * 1 = Particular
     * 2 = Firma
     * @obligatoriu
     * @var int
     *
     */
    public $tip_vanzator = '';


    /**
     * Titlu, permite maxim 30 de caractere
     * @obligatoriu
     * @var string
     *
     */
    public $titlu = '';

    /**
     * Text anunt, permite minim 40 de caractere, maxim 200 de caractere
     * @obligatoriu
     * @var string
     *
     */
    public $text_anunt = '';

    /**
     * Descriere, permite maxim 1000 de caractere
     * @var string
     *
     */
    public $descriere = '';

    /**
     * Pret, sub forma 1000 sau 1000.23
     * @var double
     *
     */
    public $pret;

    /**
     * In cazul in care aveti o promotie, completati si pretul nou.
     * $pret_nou trebuie sa fie mai mic decat $pret
     * @var double
     *
     */
    public $pret_nou;

    /**
     * Data pana la care este valabila promotia, in format timestamp
     * @var int
     *
     */
    public $pana_cand;

    /**
     * Unitatea de masuna, poate fi luna, an, km, buc
     * @var string
     *
     */
    public $um;

    /**
     * Moneda, valori posibile
     * 1 = EUR
     * 2 = USD
     * 3 = RON
     * @var int
     *
     */
    public $moneda;

    /**
     * ID judet, trebuie setat conform notatiei online.anuntul.ro, pentru mapare folosite $client->getJudete();
     * Daca judetul este nu Bucuresti ( ID judet = 10), este necesar completarea campului de localitate $anunt->localitate_id
     *      pentru mapare se va folosi $anunt->localitate_id = $client->getLocalitati($idJudet,$numeLocalitate);
     * @var int
     *
     */
    public $idjud = '';


    /**
     * Localitatea oblogatoriu de completat doar daca se alege judet altul decat Bucuresti
     * @var int
     *
     */
    public $localitate_id;


    /**
     * Strada
     * @var string
     *
     */
    public $strada;

    /**
     * Numarul strazii
     * @var string
     *
     */
    public $nr_strada;

    /**
     * Latitudine, ex: 44.4095832
     * @var double
     *
     */
    public $lat;

    /**
     * Longitutidne, ex: 26.139221200000065
     * @var double
     *
     */
    public $lng;

    /**
     * Adresa de e-mail, obligatorie in lista unui telefon
     * @obligatoriu email sau telefon
     * @var string
     *
     */
    public $email;

    /**
     * In cazul in care nu doriti ca adresa de e-mail sa fie afisata, setati 1
     * @var int
     *
     */
    public $not_display_email;

    /**
     * Adresa website-ului
     * @var string
     *
     */
    public $site;

    /**
     * Numarul de telefon, obligatoriu in lipsa unei adresa de e-mail
     * @obligatoriu telefon sau email
     * @var string
     *
     */
    public $telefon1;

    /**
     * Numarul de telefon
     * @var string
     *
     */
    public $telefon2;

    /**
     * Adresa de youtube
     * @var string
     *
     */
    public $youtube_url;

    /**
     * Vector de imagini, sunt permise maxim 8 imagini, ex: $anunt->imagini = array('http://sitemeu.ro/imaginea1.jpg',''http://sitemeu.ro/imaginea2.jpg');
     * @var array
     *
     */
    public $imagini;

    /**
     * Link catre pagina de detalii a produsului pe site-ul dumneavoastra
     * @var string
     *
     */
    public $link_produs;


    /**
     * Vector de campuri aditionale
     * @obligatoriu
     * @var string
     *
     */
    public $campuri_aditionale;

}

?>

Feed XML sau Web Service