Modelo XML para integrar os seus imóveis

Como integrar

1. Descarregue o modelo XML e consulte os campos necessários.
2. Adapte o seu XML ao nosso modelo, com o apoio do fornecedor do CRM. Use UTF-8 e inclua a lista completa dos imóveis que pretende publicar.
3. Partilhe uma ligação HTTPS estável para o ficheiro através do formulário de contacto e indique o CRM que utiliza e os eventuais requisitos de acesso.
4. A nossa equipa valida o ficheiro e combina consigo a ativação da integração e a frequência das atualizações.

A adaptação do XML deve ser feita pelo anunciante ou pelo fornecedor do CRM, seguindo este modelo. A CréditoCasa.pt lê o ficheiro a partir da ligação fornecida, após validação pela nossa equipa. Esta página não disponibiliza uma API para enviar imóveis.

Um imóvel, com agência e fotografias

Repita o elemento property dentro de feed para cada imóvel. Em feeds com várias agências, inclua a agência responsável em cada imóvel. Todos os dados e endereços deste exemplo são fictícios; substitua-os pelos seus, incluindo as URLs das fotografias e o email do anunciante.

<?xml version="1.0" encoding="UTF-8"?>
<!-- Exemplo fictício. Substitua os dados e URLs antes de integrar. -->
<feed>
  <property>
    <external_id>demo-0001</external_id>
    <reference>DEMO-T2-001</reference>
    <transaction_type>sale</transaction_type>
    <price>285000</price>
    <property_type>apartment</property_type>
    <country>Portugal</country>
    <district>Lisboa</district>
    <municipality>Lisboa</municipality>
    <parish>Arroios</parish>
    <latitude>38.7223</latitude>
    <longitude>-9.1393</longitude>
    <typology>T2</typology>
    <bedrooms>2</bedrooms>
    <bathrooms>2</bathrooms>
    <area_useful>85.5</area_useful>
    <area_gross>100</area_gross>
    <area_land>0</area_land>
    <energy_certificate>B</energy_certificate>
    <condition>Usado</condition>
    <description><![CDATA[Apartamento T2 com varanda & garagem. Exemplo fictício para integração.]]></description>
    <source_url>https://example.com/imoveis/demo-0001?origem=crm&amp;idioma=pt</source_url>
    <agency>
      <external_id>agencia-demo</external_id>
      <name>Agência de Exemplo</name>
      <email>agencia@example.com</email>
      <ami_license>00000</ami_license>
      <address>Rua de Exemplo, 1</address>
      <postal_code>1000-000</postal_code>
      <city>Lisboa</city>
      <phone>+351 210 000 000</phone>
      <mobile_phone>+351 910 000 000</mobile_phone>
      <website>https://example.com</website>
      <logo_url>https://example.com/imagens/logotipo.png</logo_url>
    </agency>
    <images>
      <image>
        <url>https://example.com/imagens/demo-0001-1.jpg</url>
      </image>
      <image>
        <url>https://example.com/imagens/demo-0001-2.jpg</url>
      </image>
    </images>
  </property>
</feed>

Use elementos sem prefixos de namespace e mantenha a estrutura consistente. Para campos opcionais desconhecidos, omita o elemento; não envie os textos null, undefined ou N/A. Escape caracteres XML ou use CDATA para descrições.

Campos do imóvel

Os caminhos seguintes são relativos a feed/property. Os campos obrigatórios são o mínimo para importar. Para publicar o anúncio na CréditoCasa.pt, inclua pelo menos uma fotografia. Tipologia e certificado energético são opcionais, mas, quando enviados, têm de usar um dos valores aceites.

Dados da agência ou anunciante

Inclua estes campos dentro de property/agency. O email é necessário para o anunciante receber pedidos de contacto através da CréditoCasa.pt, mesmo que o ficheiro possa ser importado sem esse campo.

Valores aceites

Adapte os valores do seu CRM aos códigos apresentados abaixo, respeitando maiúsculas e acentos.

Tipologia · typology

T0 · T1 · T2 · T3 · T4 · T5 · T6 · T6+

Certificado energético · energy_certificate

A+ · A · B · B- · C · D · E · F · G · Isento · Não aplicável · Em trâmite

Atualizações e remoções

• Envie sempre a lista completa. Este fluxo não é incremental. Não envie apenas os imóveis alterados desde a última sincronização.
• Mantenha os identificadores. Uma alteração de preço, descrição ou fotografias deve conservar o mesmo external_id. Numa fonte com várias agências, os IDs dos imóveis devem ser únicos em toda a fonte.
• Retire do XML os imóveis indisponíveis. Após uma sincronização sem falhas e com imóveis válidos, os anúncios ausentes são desativados. Se voltarem a aparecer, podem ser reativados com o mesmo ID.
• Um feed vazio ou com erros exige revisão. Não é usado para desativar automaticamente todos os anúncios. Para retirar toda a carteira, contacte a equipa.
• Mantenha as fotografias acessíveis. Envie sempre a lista completa e ordenada de imagens de cada imóvel, com URLs estáveis. Um imóvel sem fotografias não aparece na pesquisa pública.