Os stands podem publicar o seu stock no RooCar automaticamente, a partir do programa de gestão de stock ou do próprio site. O RooCar lê o feed todos os dias e cria os anúncios novos, atualiza preços, quilómetros e fotografias, e retira as viaturas que deixaram de constar no feed (vendidas).
Como ligar
- Crie uma conta de anunciante (stand) no RooCar.
- Peça à empresa do seu programa de gestão de stock (ou do seu site) um endereço de exportação no formato abaixo.
- Em Minha conta → Importar stock, cole o endereço, clique em Testar feed e depois em Guardar e sincronizar agora.
Formatos aceites
- XML (recomendado), em UTF-8, com um elemento
<veiculo>(ou<vehicle>) por viatura. - CSV, em UTF-8, com cabeçalho na primeira linha e separador
;ou,. Fotografias separadas por|.
Ficheiros de exemplo: feed-exemplo.xml · feed-exemplo.csv
Campos
| Campo | Obrigatório | Descrição / exemplo |
|---|---|---|
ref |
Sim | Referência única e permanente da viatura no seu stock (ex.: RC-0001). É usada para atualizar o anúncio certo. |
marca, modelo |
Sim | Ex.: Peugeot, 3008 |
versao |
Não | Ex.: 1.5 BlueHDi Allure EAT8 |
preco |
Sim | Preço final em euros, só números (ex.: 24900) |
ano, mes |
Ano sim | Ano e mês da primeira matrícula |
quilometros |
Sim | Ex.: 58000 |
combustivel |
Sim | Diesel, Gasolina, Híbrido, Híbrido Plug-in, Elétrico, GPL |
caixa |
Sim | Manual, Automática, Semi-automática |
carrocaria |
Não | Hatchback, Sedan, Carrinha, SUV, Monovolume, Coupé, Cabrio, Pick-up, Comercial |
condicao |
Não | Novo, Seminovo ou Usado (por omissão: Usado) |
tracao |
Não | Dianteira, Traseira, Integral / 4×4 |
potencia_cv, cilindrada, portas, lugares, cor |
Não | Números / texto |
distrito, concelho |
Distrito sim* | Ex.: Lisboa, Oeiras. *Pode definir um distrito por omissão na sua conta. |
descricao |
Não | Texto do anúncio (pode usar CDATA) |
equipamento |
Não | Lista separada por ; (ex.: GPS; Câmara traseira; Apple CarPlay) |
fotos |
Sim | Endereços https das fotografias, a primeira é a capa. XML: <fotos><foto>https://…</foto></fotos> |
video |
Não | Endereço YouTube ou Vimeo |
garantia_meses |
Não | Ex.: 18 |
iva_dedutivel, negociavel, financiamento, aceita_retoma |
Não | 1/0 ou Sim/Não |
matricula, vin |
Não | Não são mostrados no anúncio; servem para evitar duplicados |
telefone, email |
Não | Contacto específico da viatura (por omissão, os do seu perfil) |
Também reconhecemos os nomes em inglês mais comuns (brand, make, model, price, year, mileage, fuel, gearbox, images…).
Regras
- Até 300 viaturas por feed e 20 fotografias por viatura (JPG, PNG ou WebP, máx. 10 MB cada).
- Sincronização automática uma vez por dia; manual no máximo de 30 em 30 minutos.
- Viaturas que deixem de constar no feed são retiradas do site. Se o feed trouxer de repente menos de metade das viaturas habituais, por segurança nada é retirado.
- Os primeiros anúncios importados são revistos pela equipa RooCar antes de ficarem visíveis.
- Ao ligar um feed, o anunciante declara que é titular dos anúncios, textos e fotografias ou que tem autorização para os publicar.
Outras formas de importar e exportar
- Ficheiro Excel ou CSV — em Minha conta → Importar / exportar, descarregue o modelo, preencha uma linha por viatura (mesmos campos desta página) e carregue o ficheiro. Viaturas sem fotografias ficam como rascunho.
- Página de stock do seu site — cole o endereço da página onde o seu site lista as viaturas. Funciona com sites que publicam os dados das viaturas em formato schema.org (Car/Vehicle), como a maioria dos sites de stands modernos. Não é possível importar de portais (Standvirtual, OLX, CustoJusto…).
- Exportar — descarregue os seus anúncios do RooCar em Excel (CSV) ou XML, ou use o seu link de feed pessoal (formato desta página) para os enviar para o seu site ou outro programa.
Empresas de software
Se desenvolve um programa de gestão de stock ou de multipublicação e quer integrar o RooCar, use este formato e contacte-nos através da página de contactos.