BETA

Dar baixa

São cinco operações distintas e se confundem com frequência. A diferença importa porque só uma retira o anúncio do portal: as outras quatro não o tocam.

Você quer…Você chamaO anúncio sai do portal?
baixar um anúncio de um portalDELETE …/publication/{portal}sim
baixá-lo da conta da Mapaprop do seu clienteDELETE …/publication/mapapropapinão — sai do site dele e das redes dele
desconectar a conta do seu clientedesconectarnão
apagar a ficha do seu clienteDELETE /customersnão
apagar um imóvel do seu inventárioDELETE /properties/{paId}não

⚠️ Apagar um imóvel do seu inventário também não baixa os anúncios dele: é a mesma regra das outras. Se quiser baixá-los, baixe-os antes de apagá-lo.

📌 A segunda linha se aplica somente se o seu token veio de uma conta da Mapaprop — Mapaprop.

🔴 A regra, e é uma decisão nossa, não uma limitação

Nunca damos baixa num anúncio do seu cliente por iniciativa própria. Nem ao desconectar a conta dele, nem ao apagar a ficha dele, nem se ele deixar de usar o serviço.

Esse anúncio está publicado com a conta do seu cliente no portal, e a decisão de baixá-lo é dele. Nós desconectamos o que é nosso; o anúncio dele continua sendo o anúncio dele.

O que fazemos ao desconectar é cortar o nosso próprio acesso: deixamos de poder publicar ou atualizar em nome dele.

⚠️ Isto importa para o seu desenho. Se o seu aplicativo oferece "desvincular do Mapaprop" e você supõe que isso limpa os portais, o anúncio do seu cliente vai continuar no ar — com os dados congelados do último dia em que você o atualizou. Se quiser baixá-lo, baixe-o explicitamente antes.

A ordem, se você quiser deixar tudo limpo

1 · baixar os anúncios     DELETE …/publication/{portal}   ← um por imóvel e portal
2 · desconectar a conta
3 · apagar a ficha          (se for o caso)

Pular o passo 1 não falha: desconecta do mesmo jeito e os anúncios ficam publicados. Por isso a ordem é uma recomendação, não um requisito que o sistema imponha.

🔴 Dar baixa num empreendimento grande também pode pedir mais de uma volta

Nos portais onde cada unidade é um anúncio próprio, dar baixa no empreendimento exige desconectar cada uma antes de tocá-lo — e isso não cabe sempre numa chamada. Quando não cabe, avisamos e o anúncio continua publicado: repita a baixa e cada volta retoma de onde parou.

E continua publicado de propósito, não por uma falha: se o baixássemos com unidades ainda conectadas, o portal apagaria essas unidades. Preferimos deixá-lo no ar e que você repita.

Repetir é seguroas já desconectadas não são tocadas de novo
Nunca se perde nadaenquanto a baixa está incompleta, tudo continua como estava
Quando terminouquando a resposta deixa de dizer que ficou incompleta

Baixar um anúncio

DELETE …/publication/{portal} baixa aquele anúncio daquele portal.

  • É idempotente: se já não estava, responde bem do mesmo jeito. Você não precisa levar a conta.
  • É por portal: se você publicou em três, são três chamadas. Baixar de um não mexe nos outros.
  • Gasta uma chamada da cota do seu cliente, como publicar.
  • O imóvel continua existindo do nosso lado: despublicar não é apagar. Você pode publicá-lo de novo quando quiser, com o mesmo identificador.

Não despublique um anúncio enquanto o portal ainda está processando a publicação dele. Se você publicou e despublicou em seguida, a baixa vai responder normalmente e o anúncio pode voltar a ficar online: o portal continua o trabalho pendente e o termina depois da baixa.

Acontece principalmente com empreendimentos grandes, onde o portal trabalha em modo diferido e a janela é de minutos. O sintoma é desconcertante: você dá baixa, vê o anúncio fora do ar por um tempo, e ele volta sozinho.

Espere até o status parar de dizer que está processando e só então dê baixa. Se você tentar publicar de novo nesse meio-tempo, vamos recusar como algo temporário — é a mesma janela.

Desconectar a conta

Desconectar corta o nosso acesso à conta do portal. Depois disso não é possível publicar nem atualizar até que o seu cliente a conecte de novo.

O que conservamos de propósito, e é o que faz com que reconectar seja barato:

  • Quais imóveis estavam publicados em qual portal. Ao reconectar, o estado é recuperado e corrigido contra o que o portal diz de verdade.
  • O mapeamento das zonas. Esse dado é do sistema, não da conta: não é apagado nunca.

Apagar a ficha do cliente

DELETE /customers apaga o que temos daquele cliente. Os anúncios dele nos portais continuam publicados — mesma regra de cima.

É a operação menos reversível de todas: depois de apagar, cadastrar esse cliente outra vez é começar do zero, conexão do portal incluída.

Como cada uma responde se você se antecipar

Se você…
baixa um anúncio que já estava baixado200, sem drama. É idempotente
baixa um anúncio de um portal onde nunca publicoudizemos isso, e não há nada quebrado
desconecta uma conta que não estava conectadadizemos isso nomeando o portal
publica depois de desconectaro erro diz que falta conectar essa conta, não "você não tem permissão"

Relacionado