BETA

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únciocontinua publicado, de propósito
O que fazerrepetir a baixa. Cada vez ela retoma de onde parou
Quando terminouquando o status volta como unpublished
Quantas voltaspoucas: 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ódigoO que aconteceuO que fazer
404essa propriedade não está no seu inventárioconfira o paId
409a conta não está conectada ao portalsem conexão não podemos nomear o anúncio do lado de lá
409o 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
409o 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
502o portal recusou a baixa, ou não respondeuse 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 200 diz 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 o 409 portal_processing do 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é processingState parar de dizer que está processando (vem em a consulta de status) e só então dê baixa.

Relacionado