Beruflich Dokumente
Kultur Dokumente
com
Descrio do arquivo xml a ser enviado por agncias para a publicao no portal www.vrum.com.br
Associados.com
1/18
Megaportal Associados.com
ndice
INTRODUO............................................................................................................ 3 SEO <AD />....................................................................................................... 5 SEO < ADVERTISERINFO />........................................................................................5 SEO <ADPUB />...................................................................................................6 SEO <ATTRIBUTES>................................................................................................ 7 SEO <VEA_OPCIONAIS>........................................................................................... 14 EXEMPLO.............................................................................................................. 16
Associados.com
2/18
Megaportal Associados.com
Introduo
Os testes de aprovao do movimento devero ser feitos atravs de e-mail enviado para mpilarurban.mg@diariosassociados.com.br com os arquivos xml e de fotos compactados. Aps a aprovao dos arquivos xml com os dados dos anncios e os arquivos das fotos de cada anncio, devero ser enviados via ftp para nosso servidor (ftp.vrum.com.br) com usurio e senha que sero criados para cada agncia. Ao receber a aprovao de seu movimento, favor solicitar via e-mail (atendimento@vrum.com.br) ao setor comercial do Associados.com a criao de um usurio e senha para cada agncia que usar o sistema de envio. No ser possvel que vrias agncias usem o mesmo login e senha pois em caso de m utilizao do servio ou cancelamento de contrato ocorrer a suspenso do acesso do usurio da agncia em questo. Sempre que se conectar ao servidor de ftp, o usurio j estar no diretrio onde deve colocar os arquivos e pegar o log. importante lembrar que os arquivos das fotos devem ser colocados no diretrio antes do xml dos anncios pois ao terminar a transferncia do arquivo xml, a rotina de processamento dele disparada e as fotos sero procuradas para que sejam enviadas ao servidor de publicao do site. O arquivo de log criado assim que termina o upload do arquivo xml, mas o log s est pronto para ser baixado quando o arquivo xml removido do diretrio. Regras bsicas: 1. O CNPJ enviado dentro do arquivo xml deve ser o mesmo que consta no cadastro da agncia no patio.com.br. 2. O nmero do anncio (Seo:AD Tag:ID) deve ser nico para o mesmo CNPJ. Caso haja repetio de nmeros de anncios, ocorrer sobreposio e um dos anncios ser perdido. 3. O nome do arquivo pode ser montado da forma que for mais conveniente para o sistema de origem mas para garantir que no haver sobreposio de arquivos enviados, uma boa prtica incluir no final do nome um timestamp. Desta forma o arquivo gerado ser nico e no corremos risco de haver sobreescrita. Exemplo: Se um arquivo seria gerado com o nome de ABCDEF.XML sugerimos que ele sena criado com o nome ABCDEF_AAAAMMDDHHMMSS.XML onde AAAAMMDDHHMMSS formado pelo ano, ms, dia, hora, minuto e segundo corrente. O arquivo de log gerado ser abcdef_AAAAMMDDHHMMSS.log e poder ser baixado pelo mesmo usurio que fez o upload do arquivo ABCDEF_AAAAMMDDHHMMSS.XML.
Associados.com
3/18
Megaportal Associados.com
Como trabalhamos com servidores linux todos os arquivos enviados via ftp so padronizados em minsculo, portanto, se enviado o arquivo TESTE_20110728172400.XML, o log disponibilizado ser teste_20110728172400.log. 4. O nome de cada arquivo de foto deve seguir o seguinte padro de nomenclatura: CNPJ_numerodoanuncio_N.extensao, onde N o nmero sequncial da foto (mximo 15 por anncio). Os tipos de arquivos aceitos so: jpg, png, gif. O tamanho mximo dde cada foto enviada deve ser de 5 Megabytes. 5. No pode haver nenhuma linha em branco antes da linha <?xml version="1.0" encoding="ISO-8859-1" ?>. 6. A primeira palavra entre os sinais <> define a origem, e por consequncia, a forma de tratamento do arquivo de entrada. 7. A segunda palavra define o tipo do anncio, sendo que para o portal www.vrum.com.br s ser enviado "Veiculo". 8. Se houver tags em branco elas no devem ser fechadas de forma abreviada. Ex: forma errada: <numero /> forma correta: <numero></numero> 9. Importante: Se uma tag no tem valor vlido, no deve ser enviada. 10. Importante: As tabelas de FABRICANTES, MODELOS e CIDADES/ESTADO so atualizadas mensalmente e dever ser fornecido um e-mail para onde sero enviadas as atualizaes no formato csv (excel). Favor informar este e-mail para Maria do Pilar Urban (mpilarurban.mg@diariosassociados.com.br). 11. Segue abaixo a lista de caractres que devem ser tratados para a utilizao no xml. O correto que todos os textos enviados via xml sejam tratados para substituir os caractres de acordo com a tabela abaixo. Caracter Proibido Sequncia Substituta < > " & < > " &
O arquivo deve ter a seguinte forma para todas as transaes enviadas pela agncia: <?xml version="1.0" encoding="utf-8" ?> <Megaportal> <Veiculo> ...Dados do anuncio
Associados.com
4/18
Megaportal Associados.com
NumeroFotos Status
3 ACTIVE
Numrico Texto
OPR
Caractr
Associados.com
5/18
Megaportal Associados.com
CNPJ_CPF EmailAnunciante
99999999999 email@mail.com. br
Texto Texto
Associados.com
Megaportal Associados.com
Texto Data no padro AAAA-MM-DD Numrico Data no padro AAAA-MM-DD Calendrio no padro M/D-D ou M/D-M/D (caso mude de ms) Texto
TextoAnuncio
nico dono
DP Dirio de Pernambuco FL Folha de Londrina GZ A Gazeta IM O Imparcial JT Jornal do Tocantins NO O Norte PO O Popular Indica que o anncio ser enviado para o Portal. Por enquanto valor fixo WEB. Data da primeira publicao do anncio Numero total de publicaes Data da ltima publicao do anncio Calendrio de publicaes do anncio citando todas as datas de publicao da primeira ltima. Obs: Pode ser descrito por intervalos. Texto descritivo do anncio. Usado para o campo observao / complemento no site.
Seo <Attributes>
Ser iniciada por <Attributes> e fechada por </Attributes>. Esta seo ser fechada aps a seo de opcionais.
Todos os atributos devem ter um valor entre as tags de inicio e fim. No sero enviados atributos que no existam na lista de atributos vlidos ou possuem valor 0 (zero) ou vazio. Exemplo: <vea_fabricante >BMW</ vea_fabricante > Lista dos atributos do anncio exemplo: Tag Valor Exemplo Tipo Valor cidade Belo Horizonte Texto Descrio Cidade em que o veculo est sendo annciado selecionada da tabela de Cidades do estado. Estado em que o veculo est sendo annciado selecionado da tabela de estados. Tipo do Veculo a ser anunciado
7/18
estado
MG
Texto
tipoveiculo
carro
Texto
Associados.com
Megaportal Associados.com
vea_fabricante vea_modelo vea_modelobase vea_anofabricacao vea_anomodelo vea_codigomodelo vea_cilindros vea_combustivel vea_motor vea_tracao vea_transmissao vea_cor vea_estado vea_kilometragem vea_placa vea_portas preco publicarpreco aceitotroca avista estudotroca melhoroferta aceitotrocamenor financio entrada foto1 (dependendo do nmero de fotos, tem-se foto2, foto3 at foto15)
BMW 120i 2.0 16V 150cv 5p 120I 2005 2005 009106-5 8 Gasolina 5.0 Traseira Manual PRETA Usado 50000 GGG6969 3 980000 publicar preo aceito troca vista estudo troca melhor oferta aceito troca menor financio 1000 99999999999_5 26785_1.jpg
Texto Texto Texto Numrico Numrico Texto Numrico Texto Texto Texto Texto Texto Texto Numrico Texto Numrico Numrico Texto Texto Texto Texto Texto Texto Texto Numrico Texto
Marca (tabela FABRICANTES) Modelo completo (tabela MODELOS) Modelo base (tabela MODELOS Ano vlido pela tabela MODELOS Ano vlido pela tabela MODELOS Cdigo da tabela MODELOS Cilindros do veculo. Combustvel do veculo. Motor do veculo. Trao do veculo. Transmisso do veculo. Cor do veculo. Estado do veculo. Kilometragem do veculo. Placa do veculo. Nmero de portas do veculo. Valor do veculo em reais. Valor fixo "publicar preo" para que o preo seja mostrado no site. Valor fixo aceito troca Valor fixo vista Valor fixo estudo troca Valor fixo melhor oferta Valor fixo aceito troca menor Valor fixo financio Valor da entrada As fotos enviadas para nosso servidor de ftp antes do arquivo xml do anncio. O nome do arquivo da foto deve seguir o seguinte padro de nomenclatura: CNPJ_numerodoanuncio_N.e xtensao, onde N o nmero sequncial da foto (mximo 15 por anncio) Legendas das fotos enviadas para nosso
8/18
legenda1 (dependendo do
Associados.com
Texto
Megaportal Associados.com
veculo
prestacoes contato tipo publicar email ddd1 tel1 tipotel1 ddd2 tel2 tipotel2
25 LSN JS Particular publicar email@mail.co m.br 31 34351121 Horrio Comercial 31 91267373 Horrio Comercial
Numrico Texto Texto Texto Texto Numrico Numrico Texto Numrico Numrico Texto
servidor. O nmero de identificao da legenda deve corresponder ao nmero da foto qual se refere. O tamanho mximo de cada legenda de 40 caracteres. Nmero de parcelas Nome do contato Tipo do contato. Valor fixo publicar e-mail do contato DDD (com 2 digitos) do telefone 1 Nmero do telefone 1 (s numeros, sem formatao) Horrio disponvel para atendimento no telefone 1. DDD (com 2 digitos) do telefone 1 Nmero do telefone 1 (s numeros, sem formatao) Horrio disponvel para atendimento no telefone2.
Os atributos que so obrigatrios para a publicao dos anncios de veculos so: tipoveiculo vea_fabricante vea_modelobase cidade estado Sem estes atributos no h como incluir os anncios no portal corretamente.
Lista completa dos atributos possveis: Tag Tipo Valor Descrio do Valor Cidade Texto Cidade em que o veculo est sendo annciado. Estado Texto Estado em que o veculo est sendo annciado. tipoveiculo Texto 'carro' 'moto' 'caminhao'
Associados.com 9/18
Megaportal Associados.com
vea_cilindros
Numrico
Marca (tabela FABRICANTES) Modelo completo (tabela MODELOS) Modelo base (tabela MODELOS) Ano vlido pela tabela MODELOS Ano vlido pela tabela MODELOS Cdigo da tabela MODELOS Obs: Com o hifen Cilindradas (em caso de motos): '50cc' '60cc' '80cc' '85cc' '100cc' '125cc' '135cc' '150cc' '180cc' '200cc' '220cc' '250cc' '300cc' '350cc' '400cc' '420cc' '450cc' '500cc' '520cc' '570cc' '600cc' '620cc' '650cc' '750cc' '800cc' '820cc' '850cc' '900cc' '950cc' '1000cc' '1100cc' '1200cc' '1300cc' '1500cc' '1800cc' Cilindros do veculo: '4'
Associados.com
10/18
Megaportal Associados.com
vea_combustivel
Texto
vea_eixos
Texto
vea_motor
Texto
'5' '6' '8' '10' '12' '16' '20' '24' Combustvel: 'Diesel' 'Etanol' 'Flex' 'Gasolina' 'GNV' 'Hbrido' 'Tetrafuel' Eixos (em caso de caminhes): 'Toco (4x2)' 'Traado (6x4)' 'Trucado (6x2)' Motor: 1.0 1.3 1.4 1.5 1.6 1.7 1.8 1.9 2.0 2.2 2.3 2.4 2.5 2.8 3.0 3.2 3.5 3.8 4.0 4.1 4.2 4.3 4.4
Associados.com
11/18
Megaportal Associados.com
vea_tracao
Texto
vea_transmissao
Texto
vea_cor
Texto
4.5 5.0 5.5 6.0 Trao: Dianteira Traseira 4X4 Transmisso: Manual Automtico Tiptronic Cor do veculo. Valores vlidos: "Amarelo Metlico" "Amarelo Perolizado" "Amarelo Slido" "Azul Metlico" "Azul Perolizado" "Azul Slido" "Bege Metlico" "Bege Perolizado" "Bege Slido" "Branco Metlico" "Branco Perolizado" "Branco Slido" "Cinza Metlico" "Cinza Perolizado" "Cinza Slido" "Cromado Slido" "Dourado Metlico" "Laranja Metlico" "Laranja Perolizado" "Laranja Slido" "Marrom Metlico" "Marrom Perolizado" "Marrom Slido" "Prata Metlico" "Preto Metlico" "Preto Perolizado" "Preto Slido" "Rosa Metlico" "Rosa Perolizado" "Rosa Slido" "Roxo Metlico"
12/18
Associados.com
Megaportal Associados.com
vea_estado
Texto
preco publicarpreco aceitotroca avista estudotroca melhoroferta aceitotrocamenor financio entrada prestacoes contato tipo
Numrico Texto Texto Texto Texto Texto Texto Texto Numrico Numrico Texto Texto
"Roxo Perolizado" "Roxo Slido" "Verde Metlico" "Verde Perolizado" "Verde Slido" "Vermelho Metlico" "Vermelho Perolizado" "Vermelho Slido" "Vinho Metlico" "Vinho Perolizado" "Vinho Slido" Estado do veculo: novo usado Kilometragem do veculo. Placa do veculo. Nmero de portas do veculo: '2' '3' '4' '5' '6' Valor do veculo em reais. Valor fixo publicar preo Valor fixo aceito troca Valor fixo vista Valor fixo estudo troca Valor fixo melhor oferta Valor fixo aceito troca menor Valor fixo financio Valor da entrada Nmero de parcelas Nome do contato Tipo do contato: Particular Agncia Valor fixo publicar e-mail do contato DDD (com 2 digitos) do telefone 1 Nmero do telefone 1 (s numeros, sem formatao) Horrio disponvel para atendimento no telefone1: Horrio Comercial Manh
13/18
Associados.com
Megaportal Associados.com
Tarde Noite DDD (com 2 digitos) do telefone 1 Nmero do telefone 1 (s numeros, sem formatao) Horrio disponvel para atendimento no telefone2: Horrio Comercial Manh Tarde Noite
Seo <vea_opcionais>
Para a tag vea_opcionais, so listados apenas os atributos que o anncio possui. A lista dos opcionais existentes no veculo deve ser separada por vrgula. Esta seo est contida dentro da seo Attributes e deve ser aberta por <vea_opcionais> e fechada por </vea_opcionais>. Exemplo: <vea_opcionais> vea_alarme,vea_faroldeneblina,vea_cdplayer</vea_opcionais> Para cada Pergunta feita cuja resposta for SIM, deve-se exportar a tag correspondente. Lista completa dos atributos possveis para carros: Tag Tipo Valor Pergunta vea_airbagmotorista Texto Tem air-bag s para o motorista vea_airbags Texto Tem air-bags vea_alarme Texto Tem alarme vea_alarmedistancia Texto Tem alarme a distncia vea_arcondicionado Texto Tem ar condicionado vea_arquente Texto Tem ar quente vea_bancosdecouro Texto Tem bancos de couro vea_blindagem Texto Tem blindagem vea_cdplayer Texto Tem CD player vea_cdplayermp3 Texto Tem CD player MP3 vea_computadordebordo Texto Tem computador de bordo vea_desembacadortraseiro Texto Tem desembacador traseiro vea_direcaohidraulica Texto Tem direo hidrulica vea_disqueteira Texto Tem disqueteira vea_dvd Texto Tem DVD vea_espelhoseletricos Texto Tem espelhos eltricos vea_faroldeneblina Texto Tem farol de neblina vea_freiosabs Texto Tem freios ABS vea_insulfilme Texto Tem insulfilme
Associados.com
14/18
Megaportal Associados.com
vea_insulfilmeblindado vea_limpadortraseiro vea_pilotoautomatico vea_pneureserva0km vea_protetordemotorecarter vea_radioamfm vea_rodasdeligaleve vea_tetosolar vea_tocafitas vea_travacentral vea_travaeletrica vea_travamentoportas vea_vidroeletrico vea_vidrosverdes
Texto Texto Texto Texto Texto Texto Texto Texto Texto Texto Texto Texto Texto Texto
Tem Tem Tem Tem Tem Tem Tem Tem Tem Tem Tem Tem Tem Tem
insulfilme blindado limpador traseiro piloto automtico pneu de reserva zero kilometros protetor de motor e crter radio AM/FM rodas de liga leve teto solar toca fitas trava central trava eltrica travamento de portas vidro eltrico vidros verdes
Lista completa dos atributos possveis para caminhes: Tag Tipo Valor Pergunta vec_alarme Texto Tem alarme vec_aquecimentodacabine Texto Tem aquecimento da cabine vec_arcondicionado Texto Tem ar condicionado vec_bancosdecouro Texto Tem bancos de couro vec_baudealuminio Texto Tem ba de alumnio vec_bauisotermico Texto Tem ba isotrmico vec_bitrem Texto Tem bi-trem vec_cabineblindada Texto Tem cabine blindada vec_cabineestendida Texto Tem cabine estendida vec_cacamba Texto Tem caamba vec_calotado Texto calotado vec_cama Texto Tem cama vec_carroceriademadeira Texto Tem carroceria de madeira vec_cavalomecanico Texto cavalo mecnico vec_cdplayer Texto Tem CD player vec_cdplayermp3 Texto Tem CD player MP3 vec_chassi Texto chassi vec_direcaohidraulica Texto Tem direo hidrulica vec_disqueteira Texto Tem disqueteira vec_dvd Texto Tem DVD vec_espelhoseletricos Texto Tem espelhos eltricos vec_faroldemilhaeneblina Texto Tem farol de milha e neblina vec_freioaar Texto Tem freio a ar vec_graneleira Texto Tem graneleira vec_guincho Texto Tem guincho vec_insulfilme Texto Tem insulfilme vec_radioamfm Texto Tem radio AM/FM
Associados.com 15/18
Megaportal Associados.com
Tem radio frequncia Tem rastreador refrigerado Tem Rodoar tanque Tem toca fitas Tem turbo Tem vidro eltrico
Lista completa dos atributos possveis para motos: Tag Tipo Valor Pergunta vem_alarme Texto Tem alarme vem_alforge Texto Tem alforge vem_amortecedordedirecao Texto Tem amortecedor de direo vem_bagageiro Texto Tem bagageiro vem_bau Texto Tem ba vem_bolha Texto Tem bolha vem_carenagem Texto Tem carenagem vem_escapamentoesportivo Texto Tem escapamento esportivo vem_faroldemilha Texto Tem farol de milha vem_guidaodealuminio Texto Tem guido de alumnio vem_injecaoeletronica Texto Tem injeo eletrnica vem_matacachorro Texto Tem mata-cachorro vem_partidaeletrica Texto Tem partida eltrica vem_pneuespecial Texto Tem pneu especial vem_rodasligaleve Texto Tem rodas de liga-leve vem_travas Texto Tem travas
Exemplo
A seguir temos uma transao xml de criao de um anncio:
<?xml version="1.0" encoding="iso8859-1" ?> <Megaportal> <Veiculo> <AD Id="526107" AdvertiserType="T" AdPubCount="2" NumeroFotos="1" Status="ACTIVE" OPR="R"/> <AdvertiserInfo Company="Nome da Agncia" Address="Av Getulio Vargas, 291" Address2="" City="Belo Horizonte"
Associados.com
16/18
Megaportal Associados.com
State="MG" Zip="30112020" BillingPhone="3132635157" DayPhone="3132635561" Contrato="1234567890" CNPJ_CPF="99999999999" EmailAnunciante="email@mail.com.br"/> <AdPub PubCode="AMG" Edition="WEB" StartDate="2006-12-27" Insertions="7" StopDate="2007-01-02" Schedule="12/27-1/2" TextoAnuncio="nico dono"/> <Attributes> <estado>MG</estado> <cidade>Belo Horizonte</cidade> <tipoveiculo>carro</tipoveiculo> <vea_fabricante>BMW</vea_fabricante> <vea_modelo>120i 2.0 16V 150cv 5p</vea_modelo> <vea_modelobase>120I</vea_modelobase> <vea_anofabricacao>2005</vea_anofabricacao> <vea_anomodelo>2005</vea_anomodelo> <vea_codigomodelo>009106-5</vea_codigomodelo> <vea_cilindros>8</vea_cilindros> <vea_combustivel>Gasolina</vea_combustivel> <vea_motor>5.0</vea_motor> <vea_tracao>Traseira</vea_tracao> <vea_transmissao>Manual</vea_transmissao> <vea_cor>PRETA</vea_cor> <vea_estado>usado</vea_estado> <vea_kilometragem>50000</vea_kilometragem> <vea_placa>GGG6969</vea_placa> <vea_portas>3</vea_portas> <vea_opcionais> vea_alarme,vea_alarmedistancia,vea_faroldeneblina, vea_insulfilmeblindado,vea_insulfilme,vea_blindagem, vea_airbagmotorista,vea_airbags,vea_travacentral, vea_freiosabs,vea_protetordemotorecarter,vea_arcondicionado, vea_arquente,vea_bancosdecouro,vea_direcaohidraulica, vea_espelhoseletricos,vea_travaeletrica,vea_vidroeletrico, vea_travamentoportas,vea_pilotoautomatico,vea_cdplayer, vea_cdplayermp3,vea_dvd,vea_tocafitas,vea_radioamfm, vea_disqueteira,vea_pneureserva0km,vea_computadordebordo, vea_tetosolar,vea_rodasdeligaleve,vea_vidrosverdes, vea_desembacadortraseiro,vea_limpadortraseiro </vea_opcionais> <preco>25555</preco> <publicarpreco>publicar preo/publicarpreco> <aceitotroca>aceito troca</aceitotroca> <avista> vista</avista> <estudotroca>estudo troca</estudotroca> <melhoroferta>melhor oferta</melhoroferta>
Associados.com 17/18
Megaportal Associados.com
<aceitotrocamenor>aceito troca menor</aceitotrocamenor> <financio>financio</financio> <entrada>1000</entrada> <prestacoes>25</prestacoes> <contato>LSN JS</contato> <tipo>Particular</tipo> <publicar>publicar</publicar> <email>email@mail.com.br</email> <ddd1>31</ddd1> <tel1>34351121</tel1> <tipotel1>Horrio Comercial</tipotel1> <ddd2>31</ddd2> <tel2>91267373</tel2> <tipotel2>Horrio Comercial</tipotel2> </Attributes> </Veiculo> </Megaportal>
Associados.com
18/18