Hai un sito web che pubblica con regolarità Offerte di Lavoro, Annunci Immobiliari o Annunci Auto & Moto?
Vuoi promuovere in modo rapido e gratuito i tuoi annunci e la tua attività?
Realizza un Feed XML con la lista dei tuoi annunci ed in breve tempo saranno caricati su Mercatino Annunci.
Ci rivolgiamo principalmente ad Agenzie per il Lavoro, Agenzie Immobiliari e Concessionarie Auto-Moto che desiderano pubblicare in modo massivo le proprie inserzioni sul nostro circuito.
|
Cos'è un Feed XML? |
|
Un Feed XML è uno specifico file di testo che al suo interno contiene una struttura (xml) tale da poter contenere informazioni strutturate
sui tuoi annunci secondo determinate regole.
Maggiori informazioni sul formato XML sono disponibili su Wikipedia.
|
Formato del Feed XML |
Il feed XML dovrà includere tutte le offerte valide che si desidera pubblicare su MercatinoAnnunci,
sarà nostra cura gestire le offerte preesistenti e gli eventuali aggiornamenti da effettuare sugli annunci.
Una volta realizzato il feed dovrà essere disponibile via HTTP o HTTPS (es. https://www.tuosito.it/mercatinoannunci_feed.xml).
Il formato del Feed XML da destinare a MercatinoAnnunci è definito all'interno del seguente
XML Schema Definition (XSD).
Per gli utenti meno esperti niente paura. Andremmo di seguito a spiegare passo passo i singoli elementi (nodi) che
costituiscono l'xml destinato al nostro portale.
La codifica dell'xml deve essere di tipo UTF-8. Tutto il contenuto testuale delle offerte deve
essere racchiuso entro sezioni CDATA per evitare problemi durante l'importazione del feed XML.
Entriamo nel merito dell'xml. Il nodo di root <items> contiene uno o più sottonodi <item>
ognuno dei quali contiene a sua volta i seguenti sottonodi:
|
 |
<id> è il nodo più importante, contiene infatti l'identificativo univoco dell'annuncio.
MercatinoAnnunci utilizzerà questo identificativo per riferirsi al tuo annuncio, è dunque
importante che un singolo identificativo non sia ripetuto per più annunci. Può essere numerico o alfanumerico.
Max 100 caratteri.
Obbligatorio;
|
| |
<category> contiene il codice sintetico della categoria in cui pubblicare il singolo annuncio,
i valori ammessi J1, J2 | P1, P2, P3, P4 | C1, C2, C3, C4, C5, C6 | N1, N2
sono sintetizzati nella tabella che segue. Non sono ammessi annunci di Telelavoro o Offerte di Lavoro troppo vecchie. Formato 2 caratteri.
Obbligatorio.
| Job |
J1 |
Offerte di Lavoro |
| J2 |
Cerco Lavoro |
| Property |
P1 |
Immobili in Affitto |
| P2 |
Immobili in Vendita |
| P3 |
Terreni |
| P4 |
Cessione Attività |
| Car |
C1 |
Auto Italiane |
| C2 |
Auto Straniere |
| C3 |
Auto d'Epoca |
| C4 |
Veicoli Commerciali |
| C5 |
Moto |
| C6 |
Scooter e Motorini |
Camping
& boating |
N1 |
Camping |
| N2 |
Nautica |
|
| |
<adType> contiene la tipologia di annuncio, i valori ammessi sono offer (annunci di offerta/vendita),
request (annunci di richiesta) o exchange (annunci di scambio).
Obbligatorio.
|
| |
<title> contiene il titolo dell'annuncio. Specificare un titolo rappresentativo evitando
termini generici come vendo, cerco, auto, lavoro ecc. Non sono ammessi tag <html>. Max 100 caratteri.
Obbligatorio.
|
| |
<description> contiene la descrizione dell'annuncio. Non sono ammessi tag <html>.
Obbligatorio.
|
| |
<price> contiene il prezzo in EURO dell'annuncio o il salario in caso di Offerte di Lavoro. Sono ammessi solo numeri interi
con valori tra 1 e 9999999. Non inserire nessun simbolo di valuta (es. € o $). Eventuali separatori
delle migliaia (es. punto o virgola) verranno ignorati. Formato 1-7 cifre.
Opzionale.
|
| |
<paymentDelivery> contiene eventuali informazioni sulla consegna ed il pagamento del bene
(es. consegna a mano, visibile a Roma, pagamento in contanti, ecc).
Nel caso di Offerte di Lavoro è assimilabile al tipo di contratto (es. part-time, tempo indeterminato, ecc).
Max 150 caratteri.
Opzionale.
|
| |
<company> contiene il nome o la ragione sociale dell'azienda titolare dell'annuncio.
(es. Informatica S.p.A., Agenzia Immobiliare s.r.l., Autosalone Multimarche Bianchi, ecc). Max 100 caratteri.
Opzionale.
|
| |
<companySite> contiene l'indirizzo web dell'azienda titolare dell'annuncio.
(es. https://www.informaticaspa.it/, https://www.agenziaimmobiliare-srl.com/, ecc). Max 250 caratteri.
Opzionale.
|
| |
<city> contiene la città (provincia) di riferimento per l'annuncio.
(es. Roma, Milano, ecc).
Obbligatorio.
|
| |
<locality> contiene la località (comune) di riferimento per l'annuncio.
(es. Civitavecchia, Monza, ecc).
Se presente ci aiuterà a localizzare meglio il tuo annuncio.
Opzionale.
|
| |
<postalCode> contiene il CAP (Codice di Avviamento Postale) di riferimento per l'annuncio.
(es. 00100, 20100, ecc). Se presente ci aiuterà a localizzare meglio il tuo annuncio,
vengono riconosciuti CAP a livello comunale. Formato 5 cifre.
Opzionale.
|
| |
<email> contiene l'indirizzo e-mail per contattare il titolare dell'annuncio.
Max 100 caratteri.
Opzionale per le Offerte di Lavoro (category J1), per tutti gli altri annunci Obbligatorio.
|
| |
<phoneNumber> contiene il numero di telefono per contattare il titolare dell'annuncio.
Max 100 caratteri.
Opzionale.
|
| |
<url> contiene l'indirizzo web dell'annuncio nel tuo sito web.
Max 250 caratteri.
Obbligatorio per le Offerte di Lavoro (category J1), per tutti gli altri annunci Opzionale.
|
| |
<date> contiene la data originaria di pubblicazione dell'annuncio nel formato GG/MM/AAAA
(es. 05/08/2010).
Questo campo è molto importante in quanto utilizzato da MercatinoAnnunci per
individuare eventuali aggiornamenti da apportare sull'annuncio: qualora tra un caricamento ed il
successivo si trova una data più recente si procede all'aggiornamento del record presente in archivio.
Formato 10 caratteri.
Obbligatorio.
|
| |
<time> contiene l'orario di pubblicazione dell'annuncio nel formato hh24:mm:ss
(es. 13:56:07).
Insieme alla data di pubblicazione concorre nella gestione degli aggiornamenti sugli annunci.
Formato 8 caratteri.
Opzionale.
|
| |
<pictures>/<pictureUrl> uno o più nodi pictureUrl possono essere contenuti all'interno del
macronodo pictures.
Ogni nodo pictureUrl contiene l'indirizzo http di eventuali immagini e/o foto da allegare all'annuncio.
Se presente il macronodo pictures va specificato almeno un nodo pictureUrl, se non si desidera allegare immagini
è sufficiente omettere il blocco pictures.
pictureUrl Max 250 caratteri.
Opzionale.
|
Il feed XML risulterà così:
|
| |
<?xml version="1.0" encoding="UTF-8"?>
<items>
<item>
<id><![CDATA[...]]></id>
<category><![CDATA[...]]></category>
<adType><![CDATA[...]]></adType>
<title><![CDATA[...]]></title>
<description><![CDATA[...]]></description>
<price><![CDATA[...]]></price>
<paymentDelivery><![CDATA[...]]></paymentDelivery>
<company><![CDATA[...]]></company>
<companySite><![CDATA[...]]></companySite>
<city><![CDATA[...]]></city>
<locality><![CDATA[...]]></locality>
<postalCode><![CDATA[...]]></postalCode>
<email><![CDATA[...]]></email>
<phoneNumber><![CDATA[...]]></phoneNumber>
<url><![CDATA[...]]></url>
<date><![CDATA[...]]></date>
<time><![CDATA[...]]></time>
<pictures>
<pictureUrl><![CDATA[...]]></pictureUrl>
<pictureUrl><![CDATA[...]]></pictureUrl>
<pictureUrl><![CDATA[...]]></pictureUrl>
</pictures>
</item>
</items>
|
|
Esempio di Feed XML |
| |
<?xml version="1.0" encoding="UTF-8"?>
<items>
<item>
<id><![CDATA[63976]]></id>
<category><![CDATA[C1]]></category>
<adType><![CDATA[offer]]></adType>
<title><![CDATA[Fiat Bravo 1.9 Multijet Dynamic 120 cv]]></title>
<description><![CDATA[Anno 2008, grigio scuro metallizzato, stereo cd mp3, cerchi 16", clima, fendinebbia, v.e., computer di bordo, bracciolo. Unico proprietario, qualsiasi prova.]]></description>
<price><![CDATA[10500]]></price>
<paymentDelivery><![CDATA[visibile a Fiumicino, prezzo trattabile]]></paymentDelivery>
<company><![CDATA[Autosalone Multimarche Bianchi]]></company>
<companySite><![CDATA[https://www.autosalonebianchi.it/]]></companySite>
<city><![CDATA[Roma]]></city>
<locality><![CDATA[Fiumicino]]></locality>
<postalCode><![CDATA[00054]]></postalCode>
<email><![CDATA[mario.rossi@email.it]]></email>
<phoneNumber><![CDATA[06/1234567]]></phoneNumber>
<url><![CDATA[https://www.tuosito.it/car/121/fiat/bravo_multijet.htm]]></url>
<date><![CDATA[09/07/2010]]></date>
<time><![CDATA[14:22:10]]></time>
<pictures>
<pictureUrl><![CDATA[https://www.tuosito.it/car/121/fiat/photo/bravo_multijet_esterno.jpg]]></pictureUrl>
<pictureUrl><![CDATA[https://www.tuosito.it/car/121/fiat/photo/bravo_multijet_interno.jpg]]></pictureUrl>
<pictureUrl><![CDATA[https://www.tuosito.it/car/121/fiat/photo/bravo_multijet_dettaglio.jpg]]></pictureUrl>
</pictures>
</item>
<item>
<id><![CDATA[RIF049]]></id>
<category><![CDATA[P2]]></category>
<adType><![CDATA[offer]]></adType>
<title><![CDATA[Monolocale zona San Donato Milanese]]></title>
<description><![CDATA[Monolocale con angolo cottura, ampio bagno, balconato. 35 mq in zona San Donato Milanese, ottime rifiniture, ben collegato, zona tranquilla.]]></description>
<price><![CDATA[140000]]></price>
<paymentDelivery><![CDATA[chiamare per appuntamento, pagamento al rogito]]></paymentDelivery>
<company><![CDATA[Agenzia Immobiliare s.r.l.]]></company>
<companySite><![CDATA[https://www.agenziaimmobiliare-srl.com/]]></companySite>
<city><![CDATA[Milano]]></city>
<locality><![CDATA[San Donato Milanese]]></locality>
<postalCode><![CDATA[20097]]></postalCode>
<email><![CDATA[ag.milano3@email.it]]></email>
<phoneNumber><![CDATA[339-1234567]]></phoneNumber>
<date><![CDATA[14/06/2010]]></date>
<time><![CDATA[23:04:57]]></time>
<pictures>
<pictureUrl><![CDATA[https://www.tuosito.it/immobili/picture/rif049_monolocale_1.jpg]]></pictureUrl>
<pictureUrl><![CDATA[https://www.tuosito.it/immobili/picture/rif049_monolocale_2.jpg]]></pictureUrl>
</pictures>
</item>
<item>
<id><![CDATA[54360]]></id>
<category><![CDATA[J1]]></category>
<adType><![CDATA[offer]]></adType>
<title><![CDATA[Analista/Programmatore Java]]></title>
<description><![CDATA[Il candidato ideale ha documentata esperienza di analisi e programmazione in ambito web/j2ee. Costituiranno titolo preferenziale la conoscenza di Spring, Hibernate e JBoss. Contratto in base all'esperienza maturata.]]></description>
<price><![CDATA[1800]]></price>
<paymentDelivery><![CDATA[tempo indeterminato]]></paymentDelivery>
<company><![CDATA[Informatica S.p.A.]]></company>
<companySite><![CDATA[https://www.informaticaspa.it/]]></companySite>
<city><![CDATA[Roma]]></city>
<email><![CDATA[informatica@email.it]]></email>
<phoneNumber><![CDATA[061234567]]></phoneNumber>
<url><![CDATA[https://www.tuosito.it/5436_java.html]]></url>
<date><![CDATA[01/09/2010]]></date>
<time><![CDATA[16:00:00]]></time>
</item>
</items>
|
|
Una volta generato il feed XML secondo le specifiche sopra indicate è sufficiente fornirci il suo indirizzo HTTP/HTTPS
utilizzando il seguente modulo di segnalazione.
|
|
JobList |
home |
inserisci gratis un annuncio |
ricerca |
