BETA

A chave publication

O objeto do imóvel descreve o imóvel. publication descreve como você o publica: qual conta você usa em cada portal e o que escolheu para esse anúncio.

São duas coisas diferentes e por isso estão separadas. Os metros quadrados de um apartamento são os mesmos onde quer que você publique; o plano que você contratou no Zonaprop, não.

Está em beta. É por esta chave que as capacidades de publicação são habilitadas, portanto ela vai crescer: portais novos, campos novos, canais novos. O que já está documentado aqui não muda de significado sem aviso.

Onde vai

Dentro do objeto do imóvel, como mais uma chave:

{
  "code": "DEV-V3-909181",
  "title": "…",
  "attributes": [ … ],
  "publication": { "api": { … } }
}

Viaja da mesma forma no cadastro e na verificação — é o mesmo objeto nos dois casos.

A forma

{
  "publication": {
    "api": {
      "argenprop": {
        "visible": true,
        "token": "<tu-token-de-argenprop>"
      },
      "zonaprop": {
        "plan": {
          "plan": "SUPERDESTACADO"
        },
        "token": "<tu-token-de-zonaprop>"
      },
      "cabaprop": {
        "token": "<tu-token-de-cabaprop>"
      },
      "mercadolibre": {
        "listingTypeId": "gold_special",
        "condition": "used",
        "token": "<tu-token-de-mercadolibre>"
      }
    }
  }
}

A amostra não traz advertiserId nem branchOfficeId, e isso não é um esquecimento: são o id que o portal atribuiu ao seu cliente, portanto qualquer valor de exemplo seria o de outra conta. Se você os omitir, nós os resolvemos a partir da conexão do seu cliente — que é o valor correto, a menos que você administre várias contas com um mesmo integrador. Continuam aceitos: veja a tabela abaixo.

Os dois níveis

publication
└── api            ← publicação pela API do portal
    └── <portal>

O nível api não é decorativo: um portal pode ser publicado por mais de um canal. O Zonaprop, por exemplo, aceita publicação por API e por feed XML, e cada canal tem o seu próprio contrato. Separá-lo desde o início permite somar o outro canal sem mudar a forma do que já funciona.

Hoje apenas api está habilitado. Qualquer outra chave nesse nível é rejeitada: não é "ainda não suportado", é desconhecido.

O que cada portal aceita

PortalCampoTipoO que é
argenpropadvertiserIdnumberO id de anunciante do seu cliente no Argenprop👤
visiblebooleanSe o anúncio é publicado visível
zonapropplanobjectO plano de publicação, por exemplo {"plan": "SUPERDESTACADO"}
branchobjectOs dados de contato da filial: {custId, email, name, phone1}. Já não é necessário — veja abaixo👤
cabapropbranchOfficeIdnumberA filial (corretor registrado) do seu cliente no Cabaprop👤
mercadolibrelistingTypeIdstringO tipo de publicação
conditionstringA condição do imóvel
sellerContactobjectOs dados de contato do vendedor. Já não é necessário — veja abaixo👤
manualAttributesobjectAtributos do MercadoLibre que você envia pelo id, por exemplo {"LAND_ACCESS": "245046"}. Eles substituem o que derivamos do imóvel

👤 = dado da conta do seu cliente no portal. Os demais são escolhas de publicação: o valor sai de um catálogo e é o mesmo para todas as contas. A diferença aparece em dois lugares — na amostra acima (os de 👤 não aparecem) e nos erros (eles não lhe dão um valor de exemplo).

Todos aceitam também um token (string), que é o da sua conta nesse portal.

Cinco categorias do MercadoLibre pedem um atributo que não sai do imóvel. As quatro de aluguel por temporada (MLA50278, MLA50279, MLA105180, MLA52745) pedem GUESTS, que tomamos de occupancy quando o imóvel o traz. E MLA401687 (Terrenos e Lotes à venda) pede LAND_ACCESS, que não tem equivalente no objeto: esse você envia.

{
  "mercadolibre": { "manualAttributes": { "LAND_ACCESS": "245046" } }
}

Os cinco valores de LAND_ACCESS são 245049 Tierra, 245045 Arena, 245046 Asfalto, 245048 Ripio e 245047 Otro.

Se um atributo é obrigatório na categoria e não chega nem do imóvel nem de manualAttributes, o /verify o devolve como blocker com seu id — assim você sabe qual completar antes de publicar.

Já não é necessário enviar branch e sellerContact. São os dados de contato do seu cliente escritos no vocabulário de cada portal, e agora nós os preenchemos sozinhos a partir de a ficha do seu cliente, que você declara uma vez e não viaja em cada imóvel.

Se você os enviar de todo modo, os seus prevalecem: o preenchimento automático tem a precedência mais baixa de todas.

O formato deles, se você quiser enviá-los:

{
  "zonaprop": { "branch": { "custId": 1, "name": "…", "phone1": "…", "email": "…" } },
  "mercadolibre": { "sellerContact": { "phone": "…", "email": "…" } }
}

advertiserId e branchOfficeId continuam sendo necessários: não são dados do seu cliente, e sim ids dentro do portal — o seu anunciante no Argenprop, o seu corretor registrado no Cabaprop — e apenas a sua conta lá os conhece.

Não é preciso enviar todos os portais. Envie os que você vai usar; o que não estiver simplesmente não é configurado.

Sobre o token

O token é validado na forma e nunca na validade. Nós o aceitarmos não significa que ele esteja correto nem que a sua conta exista: apenas que é uma string não vazia. Este endpoint verifica imóveis, não contas.

E do outro lado: o valor do seu token não aparece em nenhuma resposta. Se houver um problema com ele, dizemos qual é a chave (publication.api.zonaprop.token) e nunca o que ela contém. Também não é armazenado junto com o objeto nem reenviado para nenhum lugar que não precise dele.

O que acontece se você enviar algo que não corresponde

A forma é validada, e o que não cumpre aparece de duas maneiras ao mesmo tempo na resposta do verify:

  1. Em object.contract, com o caminho completo, a regra e um exemplo de como resolver.
  2. Como blocker do portal afetado, que passa a missing_data.
CasoO que reportaO exemplo que te dá
Tipo errado, campo de escolhase espera boolean"publication": { "api": { "argenprop": { "visible": true } } }
Tipo errado, campo de conta (👤)se espera number + de onde sai o valor realnenhum, de propósito — qualquer número seria o de outra conta
Portal que não existeportal desconocido. Válidos: …um dos válidos
Campo que esse portal não aceitano es un dato de cuenta/publicación reconocido…a lista dos que ele aceita
Um nível diferente de apisólo admite api"publication": { "api": { … } }
token vaziose espera un string no vacío"token": "<tu-token-de-argenprop>"
{ "field": "publication.api.argenprop.advertiserId",
  "rule": "type",
  "value": "noventa",
  "detail": "se espera number. el valor de `advertiserId` es el que el portal le asignó a TU CLIENTE: no hay ejemplo que sirva. Si lo omitís lo resolvemos desde su conexión, que es lo correcto salvo que administres varias cuentas." }

E o mesmo erro em um campo de escolha, que sim traz o fix pronto para colar:

{ "field": "publication.api.argenprop.visible",
  "rule": "type",
  "value": "si",
  "detail": "se espera boolean",
  "fix": "\"publication\": { \"api\": { \"argenprop\": { \"visible\": true } } }" }

Um publication quebrado bloqueia a publicação nesse portal, mesmo que o objeto do imóvel esteja impecável. E bloqueia apenas o portal que ele nomeia: se o problema é de publication.api.argenprop, Zonaprop e Cabaprop seguem o seu curso. Os problemas de nível superior —o publication inteiro, ou um nível diferente de api— afetam todos.

É de propósito: um advertiserId com o tipo errado não é um imóvel incompleto, é uma instrução de publicação quebrada — e publicar com ela é o dano.

Nada é limpo em silêncio nem adivinhamos o que você quis dizer. Se não cumpre, nós dizemos, e dizemos como resolver.

Declarar um portal é pedir que ele seja reportado

A resposta do verify traz apenas os portais que você declarou aqui. Se você configurou o Argenprop e mais nada, o Zonaprop não aparece — nem com problemas, nem no summary.

Se você não enviar publication, vê todos: é o caso de quem está avaliando a integração.

publication não é um campo do imóvel

Não é armazenado junto com o imóvel e não viaja aos portais como um dado do anúncio. É consumido para configurar a publicação e depois descartado.

Por isso também você não vai vê-lo no imóvel que devolvemos: ele não faz parte dele.

Veja também


Precisa de ajuda? Entre em contato com o Suporte técnico da Mapaprop