Interface para transferência de anúncios

Barra de menu
País                     
Língua

Interface para transferência de anúncios

Versão 2.3


1) Princípio da transferência

Green-acres.com propõe uma interface XML que permite a softwares ou sites Internet nos quais as agências introduzem os seus anúncios, exportar esse anúncios para os publicar directamente em Green-acres.com

a) Configuração Green-acres.com

Cada agência dispõe na sua interface de administração de um separador 'Transferência' para pedir a activação do sistema de transferência.

b) Envio dos anúncios

Os anúncios são transferidos com fotos respeitando o formato mais abaixo. Todos os anúncios enviados serão publicados e a agência será facturada em consequência.

Excepto pedido contrário, a publicação dos anúncios faz-se em módulo cancela e substitui: Todos os anúncios não apresentados no fluxo serão automaticamente retirados da publicação.

Em conformidade com as condições gerais de venda de Green-acres.com, a agência responsabiliza-se para verificar que o resultado da transferência lhe convém.

2) Testar um ficheiro xml

Em primeiro lugar, abra o ficheiro num navegador (Internet Explorer ou Firefox que dá mais detalhes) e verifique que o ficheiro não contém erros e que todos os caracteres aparecem correctamente. Em seguida, utilize o formulário de validação mais adiante.

Identificação da agência para esse ficheiro
Ficheiro xml

3) Formato dos ficheiros

a) Número dos ficheiros

Os anúncios serão fornecidos num ficheiro XML respeitando o formato mais abaixo (ver parte 3). 2 opções são possíveis para fornecer o ficheiro:
  • Envio FTP: O ficheiro é directamente fornecido por FTP (exemplo '212a.xml' ou '212a-644.xml') utilizando os códigos fornecidos por Green-acres.com.

  • Recuperação HTTP: Recuperamos todos os dias um ficheiro XML correctamente formatado através um URL que nos fornecerá.

b) Fotos:

  • Envio FTP: As fotos do anúncio serão enviadas por FTP tendo como nome a referência Green-acres.com do anúncio seguido do carácter '_' e depois o número da foto começando por 1. Exemplo: '212a-644_1.jpg', '212a-644_2.jpg' etc. Green-acres.com aceita até 25 fotos por anúncios.

    Cuidado! O número de referência estando em minúscula conforme a especificação mais abaixo, os nomes das fotos também devem aparecer em minúscula.

  • Recuperação HTTP: As fotos também podem ser fornecidos através de um URL no ficheiro XML com os tags <pic_1>,...<pic_25>, o URL deve começar com 'http://' e acabar com '.jpg' em minúsculo.
    Exemplo: <pic_1>http://www.o-meu-site-Internet.com/photo/vrw6789.jpg</pic_1>

Para limitar o consumo de CPU nos nossos servidores, se algumas fotos já estão inseridas no anúncio, o envio de novas fotos não implicará a actualização das fotos, excepto se a agência preencheu o campo 'Forçar a actualização das fotos (separador 'Transferência'), antes da transferência.

b) Conteúdo do ficheiro XML

O ficheiro texto descrevendo um anúncio terá todos os campos obrigatórios, indicados mais abaixo, preenchidos e eventualmente os campos opcionais. O ficheiro deve ter o formato xml como segue:
Cabeçalho do ficheiro:

<?xml version="1.0" encoding="ISO-8859-1"?>
<Envelope>
<Body>
<add_adverts>

Para cada anúncio:

<advert>
(...)
</advert>

Para cada campo de elemento 'advert':

<nome_campo>texto_do_campo</nome_campo>

No final do ficheiro:
</add_adverts>
</Body>
</Envelope>

c) Exemplo de ficheiro

Para ver um exemplo de ficheiro: Clique aqui

d) Zip

Os ficheiros textos e fotos poderão ser reunidos num só ficheiro zip, o qual terá então o nome da agência. Ex: '212a.zip'.

e) Codificação

A codificação Ocidental 'ISO-8859-1' é utilizada automaticamente. A codificação internacional 'utf-8' também é aceite. Nesse caso, é necessário colocar 'utf-8' no cabeçalho XML e realmente codificar o ficheiro em utf-8, e em seguida contactar-nos para tratarmos do ficheiro em 'utf-8' na recepção.

4) Campos obrigatórios

Nome do campo Tipo Comentário Exemplo
owner varchar(15) Referência da conta em Green-acres.com 212a
reference varchar(20) Referência conta e referência do produto para a agência. Contém apenas números, letras, '_' e '_'. Deve ser em minúscula. Por defeito, recomenda-se utilizar o número do mandato da agência como referência produto, se o número de mandato determinar o produto de forma única. 212a-644 para o bem 644 da agência 212a
type enum ('properties', 'rentals', 'holidays') Tipo de anúncio (venda, arrendamento, arrendamento-férias)  
price int(10) unsigned Preço de agência incluídos - Renda com encargos no caso de arrendamento 215000
currency char(3) Código moeda internacional (3 letras) EUR
postal_code varchar(5) Código postal do bem 47300
commune varchar(75) Deve apenas conter um nome de concelho sem comentário (sem 'perto' ou 'a 5mn de')
Este campo não precisa de ser a cidade exacta onde se encontra o bem, pode ser uma cidade próxima (Ver campo 'precise_location) 		Villeneuve sur lot
country_code char(2) Código país do bem imobiliário fr
habitat enum ('old', 'recent', 'luxury', 'land', 'appartement', 'business', 'new', 'mobile_home', 'parking', 'bed_breakfast', 'gite' ) Tipo de bem. A denominação exacta depende do país (em França: 'old' dá 'casa antiga' - em Marrocos: 'old' dá 'Riade') old

Se um dos elementos obrigatórios vier a faltar, o anúncio é criado e automaticamente colocado em espera. A agência pode aceder aos anúncios em espera e completar rapidamente os elementos em falta. Se faltar apenas o ambiente e/ou habitat, esses elementos são adivinhados a partir do resumo textual (cuidado a taxa de erro é elevada) e o campo opcional 'status' pode ser forçado a 'ok' (ver mais abaixo).

5) Campos facultativos

Nome do campo Tipo Comentário Exemplo
mandate_number varchar 16 Número de mandato. Se o número em referência é um número informático, pode utilizar aqui o número de mandato ou qualquer número útil para a agência para encontrar rapidamente um bem . Wd-5913
title_XX varchar 60 Título do anúncio na língua XX onde é preciso substituir XX pelo código língua (title_fr). É preciso inserir um elemento title_XX por cada língua activa para o site. Limitado a 60 caracteres.
As traduções automáticas são proibidas nesta secção. 		Charmante propriété sur 5 ha de terrain
summary_XX blob Texto de apresentação geral do bem na língua XX onde é preciso substituir XX pelo código língua (summary_fr). É preciso inserir um elemento summary_XX por cada língua activa para o site.
As traduções automáticas são proibidas nesta secção. 		Située dans le village de Laz, avec bar et commerce à une courte distance à pied, cette maison qui nécessite de travaux de rénovation bénéficie d'une vue étonnante sur la vallée de l'Aulne et au-delà.
h_surface int Superfície habitável em m2 250
l_surface int Superfície terreno em m2 20000
n_rooms int Número de divisões 6
n_beds int Número de quartos 3
n_baths int Número de casas de banho 2
environment enum ('country', 'village', 'town', 'city', 'beach', 'mountain') Ambiente onde se encontra a propriedade country
precise_location int Localização em relação ao código postal indicado:
0 = perto de (valor predefinido)
1 = Localização exacta 		0
street_number varchar(12) Número de rua 17 bis
street_name varchar(64) Nome da rua Avenue Aristide Briand
metro varchar(32) Nome do metro mais perto Porte d'Orléan
distance_metro int Distância expressa em minuto do metro mais perto 5
airport varchar(32) Nome do aeroporto mais perto Bergerac
distance_airport int Distância expressa em minuto do aeroporto mais perto 5
train varchar(32) Nome da estação mais perto Bergerac
distance_train int Distância expressa em minuto da estação mais perto 5
charges int Encargos para a renda 150
furnished enum(0,1) Não mobilado / Mobilado para arrendamento (Defeito: 0 não mobilado) 0


6) Mostrar o ficheiro de especificações xsd

Clique aqui

7) Menções legais

Green-acres.com não se responsabiliza pelos problemas e eventuais perdas de dados ligados ao uso do software ou do site Internet do editor propondo um gateway para os seus sites.

A agência responsabiliza-se para verificar que o resultado da transferência corresponde ao seu pedido e para efectuar eventuais modificações necessárias directamente em Green-acres.com