Dar baixa

São três operações distintas e se confundem com frequência. A diferença importa porque uma delas afeta o que o público vê e as outras duas não.

🔴 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.

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.

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 das três: 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

Relacionado

• Despublicar de um portal — o endpoint e o contrato dele
• Consultar e desconectar · Dar baixa num cliente
• Cadastrar um cliente — o caminho inverso