Despublicar de um portal
Quando você quer que o anúncio deixe de estar publicado no portal, isto o retira.
Não apaga o imóvel: ele continua no seu inventário e você pode publicá-lo de novo quando quiser.
DELETE /property-v1/properties/{paId}/publication/{portal}
Mesmo escopo que publicar ({portal}:publish), mesmo paId, sem body.
curl -X DELETE "https://property-api.mapaprop.com/property-v1/properties/01M3Z4MF6S817S9V8QADXFFXN3/publication/zonapropapi" \
-H "Authorization: Bearer $TOKEN" \
-H "x-client-ref: $CLIENT_REF"
{ "status": "unpublished",
"portal": "zonapropapi",
"paId": "01M3Z4MF6S817S9V8QADXFFXN3",
"quota": { "remaining": 1479, "limit": 1500 } }
Uma baixa pode voltar incompleta, e isso é um 200
{ "status": "partially_unpublished", "portal": "argenpropapi", "paId": "01M…",
"detail": "La baja quedó incompleta por el presupuesto de la llamada…" }
Acontece quando o empreendimento tem muitas unidades: dar baixa exige desconectar cada uma, e isso não
cabe sempre numa chamada. Não é um erro —o portal não rejeitou nada— então vem como 200.
| O anúncio | continua publicado, de propósito |
| O que fazer | repetir a baixa. Cada vez ela retoma de onde parou |
| Quando terminou | quando o status volta como unpublished |
| Quantas voltas | poucas: um empreendimento de 50 unidades baixa em ~5, não em dezenas |
🔴 O anúncio fica publicado porque baixá-lo ali seria pior. Se o baixássemos com unidades ainda conectadas, o portal apagaria essas unidades. Preferimos deixá-lo no ar e que você repita.
Se você dá baixa num empreendimento, a resposta pode trazer a conta anúncio por anúncio
Um empreendimento é uma chamada mas vários anúncios (o pai e suas unidades). Quando o portal os
reporta um por um, nós repassamos essa conta num bloco development, e os três números somam o
total: unpublished + withError + processing.
processing não é uma falha: o portal aceitou a baixa e ainda está trabalhando. Está separado de
withError justamente para que você não leia como um erro.
O detalhamento completo, com o exemplo e as listas de códigos, está em publicar um empreendimento.
É idempotente: chame quantas vezes quiser
Se o anúncio já não estava publicado, você recebe 200 do mesmo jeito. Não é um erro: o resultado que você queria já estava cumprido.
A resposta não diz se a baixa foi feita por esta chamada ou se o anúncio já estava fora, e isso é de propósito: o portal não distingue os dois casos — responde o mesmo nas duas situações. Um campo que prometesse essa diferença seria uma constante disfarçada de informação.
O que você pode olhar é quota: se diminuiu, a chamada chegou ao portal.
Isso faz com que tentar de novo seja sempre seguro, inclusive depois de um 502 em que você não sabe se a baixa chegou.
Os erros
| Código | O que aconteceu | O que fazer |
|---|---|---|
404 | essa propriedade não está no seu inventário | confira o paId |
409 | a conta não está conectada ao portal | sem conexão não podemos nomear o anúncio do lado de lá |
409 | o portal já não reconhece a conta do seu cliente como parte da sua integração (portal_account_unlinked) | conecte-a de novo: peça um link. Tentar a baixa de novo não a recupera |
409 | o portal tem a conta desabilitada ou bloqueada (portal_account_blocked) | escreva para nós com o reference; tentar de novo não a habilita, e o vínculo com o portal é gerenciado por nós |
502 | o portal recusou a baixa, ou não respondeu | se não respondeu, pode ter sido retirado mesmo assim: tente de novo |
Os dois 409 são sobre o estado da CONTA, não do anúncio, então não mudamos nada do seu lado: o
anúncio fica como estava no nosso registro. Quando a conta for desbloqueada, repita a baixa.
Três coisas que convém ter em mente
- Consome cota. Uma baixa usa uma das chamadas do seu cliente no portal, igual a publicar.
- Despublicar não apaga a propriedade. Ela continua no seu inventário e você pode publicá-la de novo quando quiser com o mesmo
paId— o anúncio é recriado, não duplicado. - 🔴 Uma baixa enquanto o portal processa a publicação anterior NÃO a cancela. O
200diz que o portal aceitou a baixa, não que o anúncio ficou fora do ar: se ainda tinha a publicação pendente —típico em empreendimentos com muitas unidades, que vão em modo diferido—, ele a termina depois e o anúncio volta a ficar online. É a mesma janela que produz o409 portal_processingdo publish. Medido em 2026-10-08 contra a Zonaprop: baixa 3 s depois de um publish diferido → online de novo ~2,5 min mais tarde. ⇒ Espere atéprocessingStateparar de dizer que está processando (vem em a consulta de status) e só então dê baixa.
Relacionado
- Publicar em um portal — o
PUT, e o que acontece ao chamá-lo de novo - A chave
publication— o que configurar dentro do objeto