Mapaprop

Mapaprop

Além de ser o sistema que você está integrando, a Mapaprop é um dos destinos onde a sua propriedade pode terminar. E é o único que você não precisa pedir.

Se você é cliente da Mapaprop e gerou o seu token pelo app (Mapaprop > App e Token), cada propriedade que você carregar por esta API é cadastrada sozinha na sua conta. Não há um passo a pedir nem um endpoint a chamar.

Se o seu token não saiu de uma conta Mapaprop —o caso de um integrador que publica em portais para clientes que não são clientes nossos— nada desta página se aplica a você: as suas propriedades vivem só no PropertyAPI e são publicadas nos portais que você conectar.

As duas coisas, que não são a mesma

É a distinção que convém ter clara antes de seguir:

O que éQuem dispara
O cadastroa propriedade existe na sua conta Mapaprop, como se você a tivesse carregado pelo appsozinho, sem que você peça
A publicaçãoessa propriedade fica publicada no seu site e nos portaisvocê, com PUT …/publication/{portal}

Estar cadastrada não significa estar publicada. Ela fica na sua conta como qualquer propriedade carregada à mão, e publicá-la é uma decisão sua — a mesma que você tomaria pelo app.

Quando acontece

O cadastro não é instantâneo, e há um motivo: as fotos.

1 · POST /properties        guardamos a propriedade e devolvemos o paId
2 · baixamos as imagens     baixamos de onde você as tiver e hospedamos nós mesmos
3 · cadastro na sua conta   ← dispara sozinho quando o passo 2 termina

Uma propriedade chega à sua conta com as fotos já carregadas, que é a única forma em que serve. Por isso ela espera a ingestão terminar em vez de ser criada vazia e completada depois.

Como você sabe que deu certo

No bloco mapaprop, que viaja tanto na resposta do POST quanto no GET da propriedade:

{
  "mapaprop": {
    "state": "synced",
    "propertyId": 2619527,
    "branchId": 1,
    "message": "La propiedad existe en tu cuenta de Mapaprop con el id 2619527 (sucursal 1)…"
  }
}

O propertyId é o id da Mapaprop, diferente do paId desta API. É o que serve para encontrá-la no app.

stateo que aconteceu
pendingainda não rodou: a ingestão de imagens não terminou
synceda propriedade existe na sua conta
rejectedalgo do objeto não pôde ser guardado. O bloco nomeia o campo
blockeda conta não está em condições. Nós resolvemos
exhaustedas tentativas automáticas se esgotaram

Os estados, o que fazer com cada um e como tentar de novo estão em Tentar o cadastro de novo.

Verifique antes de postar. POST /properties/verify é gratuito e revisa o objeto contra o mesmo contrato, então um valor que o cadastro não conseguiria guardar nós dizemos na hora, em vez de você descobrir minutos depois no bloco.

O que entra com a propriedade

Tudo o que você mandou no objeto, na mesma chamada:

As fotoscom a sua rotação e a sua miniatura, como uma foto carregada pelo app. A que você marcar main fica como principal
A plantauma por propriedade. Tem que ser uma imagem, nunca um PDF
Os vídeoso link da plataforma, não o arquivo
As expensas e os impostoscom a sua moeda e o período de pagamento
Os preços alternativos"por semana", "por temporada" e os que você declarar

Se algo disso falhar e a propriedade tiver sido criada, o bloco mapaprop diz, e a nova tentativa manda só o que falta — não cria a propriedade de novo.

Em qual filial entra

Na que você declarar em branchId. Se você não mandar nenhuma, entra na filial principal da conta — e a resposta diz em qual ficou, então você não precisa adivinhar.

As filiais da sua conta, com os seus ids, saem de GET /branches.

Publicar na Mapaprop

Uma vez cadastrada, publica-se como qualquer outro destino, passando mapaprop onde a rota pede {portal}:

PUT    /property-v1/properties/{paId}/publication/mapaprop
GET    /property-v1/properties/{paId}/publication/mapaprop
DELETE /property-v1/properties/{paId}/publication/mapaprop

Relacionado