BETA

Consultar o estado no portal

GET /property-v1/properties/{paId}/publication/{portal}

É a forma de saber como está o anúncio do outro lado: se continua online, qual é sua URL pública, quantas visitas teve e se o portal registrou algum erro.

Esta chamada gasta uma chamada da cota mensal do cliente no portal, da mesma forma que publicar. Se você só precisa do último estado conhecido, GET /properties/{paId} te dá isso sem gastar nada.

curl https://property-api.mapaprop.com/property-v1/properties/01M41AQNXYG4W4SEEEEPHEDNX4/publication/zonapropapi \
  -H "Authorization: Bearer $TOKEN" \
  -H "x-client-ref: cliente-42"
{
  "paId": "01M41AQNXYG4W4SEEEEPHEDNX4",
  "portal": "zonapropapi",
  "remoteStatus": "unpublished",
  "inSync": false,
  "remote": {
    "portalItemId": 60321762,
    "url": "https://www.zonaprop.com.ar/propiedades/clasificado/-60321762.html",
    "publicationState": "OFFLINE",
    "processingState": "PROCESADO",
    "onlineAt": "2026-10-03T17:14:06.000Z",
    "offlineAt": "2026-10-03T04:00:00.000Z",
    "createdAt": "2026-10-03T17:14:05.000Z",
    "modifiedAt": "2026-10-03T17:14:28.000Z",
    "visits": 0,
    "errors": [],
    "warnings": [],
    "imagesStatus": [],
    "exists": true,
    "checkedAt": "2026-10-03T18:42:57.716Z"
  },
  "quota": { "remaining": 1443, "limit": 1500 }
}

A URL do anúncio

remote.url é onde se vê o anúncio publicado. Não pode ser construída do seu lado: leva o id interno do portal (remote.portalItemId), que é diferente do código com o qual você publica.

remote.url vem em null se ainda não temos o id do portal, ou se não podemos montar a URL com certeza para o país do imóvel. Não montamos uma aproximada: um link que leva a outro lugar é peor do que não ter link.

As duas leituras: uma grátis e uma fresca

O que te devolveCota
GET /properties/{paId}o último estado que já tínhamos, em published.{portal}.remotegrátis
GET …/publication/{portal} (esta página)pergunta ao portal agora1 chamada

Para decidir entre as duas está remote.checkedAt: diz de quando é o dado salvo. Se te é suficiente, não é preciso perguntar de novo.

Se você percorrer todo o seu inventário consultando propriedade por propriedade, gasta uma chamada por cada uma. Com 400 propriedades são 400 chamadas da cota mensal do seu cliente. Leia primeiro o estado salvo e consulte somente o que você precisar fresco.

remoteStatus e inSync

remoteStatus é o estado do anúncio, e esta chamada o atualiza com o que o portal disser.

O que diz o portalremoteStatus fica em
publicationState: ONLINEpublished
publicationState: OFFLINEunpublished
um PLANO (HOME_ZONA_DEMAND, SIMPLE…) com onlineAt e sem offlineAtpublished
um PLANO com offlineAtunpublished
um estado da OPERAÇÃO (reservado, vendido, alugado)published — ver abaixo
o anúncio não existe no portalunpublished
algo que não reconhecemos e sem datasnão se altera

Um anúncio com um estado da operação continua sendo published. Se você marcou o imóvel como vendido, o portal o oculta —isso está correto— mas o anúncio existe: é nosso e o deixamos assim de propósito.

"remoteStatus": "published",
"remote": { "publicationState": "VENDIDO", "visible": false }

Dizemos assim porque o contrário te empurraria a republicar: se você lesse unpublished sobre um anúncio que está perfeito, cada nova tentativa sua tentaria publicá-lo de novo. O publicationState te diz por que não se vê, com o nome do portal.

publicationState nem sempre é um estado: enquanto o anúncio está online em um plano nomeado, o portal coloca ali o PLANO. Ao dá-lo de baixa volta a dizer OFFLINE.

Quando isso acontece, o estado nós resolvemos pelas datas (onlineAt / offlineAt), que é o registro que o portal mantém de quando entrou e quando saiu.

inSync responde à pergunta que importa: o anúncio está como você o deixou?

inSyncO que significaO que fazer
trueo portal coincide com o que você esperavanada
falsemudou sem que você tenha pedido — caiu, ou o plano venceupublique novamente se você quiser que fique no ar
nullo portal não nos deu com o que decidir: um estado que não interpretamos e sem onlineAtolhe o remote completo e nos escreva com a reference

Nós não republicamos por nossa conta. Se o anúncio caiu, te avisamos com inSync: false e a decisão é sua: pode ser que você já não o queira no ar.

Os outros campos de remote

remote é o que o portal responde, então seu conteúdo muda conforme o portal. O único que está nos dois é portalItemId, url, exists e checkedAt; o resto depende do que cada um informa. Não assuma um campo porque você o viu no outro portal.

ZonapropArgenprop
O estadopublicationState + as datas (onlineAt / offlineAt)publicationState também, com seu próprio dicionário: VIGENTE · SUSPENDIDO · HISTORICO · RESERVADO · VENDIDO
Se está visível—visible — ⚠️ em um empreendimento isso não significa isso, veja abaixo
Métricasvisitspoints, os do anúncio
ProcessamentoprocessingStatenão informa
Imagens e avisosimagesStatus · errors · warningsnão informa

O que não muda é remoteStatus, o campo acima: esse nós normalizamos para published / unpublished / null justamente para que você não precise ler a forma de cada portal para saber se o anúncio está no ar.

Em um empreendimento da Argenprop, visible: false é o normal

Um empreendimento publicado e visível no site devolve igual:

"remote": { "publicationState": "VIGENTE", "visible": false }

Medido contra o portal: para a Argenprop visible e publicationState são dois eixos distintos, e em um empreendimento —e em suas unidades— Visible vem em false ainda que o anúncio esteja visível. Nós transportamos esse valor tal como é, sem interpretá-lo.

⇒ Para saber se está no ar, olhe remoteStatus (ou publicationState), não visible. Em um empreendimento, visible: false não indica nenhum problema e não há nada para corrigir.

A tabela que vem agora é a da Zonaprop, que é o portal que mais informa:

CampoO que é
portalItemIdo id que o portal deu ao anúncio. É o que forma a URL. Está nos dois portais
publicationStateONLINE / OFFLINE, ou o nome do plano enquanto está online. Veja a nota acima
processingStateem que etapa do processamento está este anúncio: ESPERANDO_PROCESAR (na fila), EN_PROCESO (processando) ou PROCESADO (concluído). É o que o portal diz, sem interpretar — e o enum é dele, então pode crescer
onlineAt · offlineAtquando saiu e quando foi retirado
createdAt · modifiedAtdo lado do portal, não do seu
visitsvisitas que o portal registrou. null se não as informa
errors · warningstal como o portal envia, sem traduzir
imagesStatuso que o portal fez com cada imagem
existsfalse se o anúncio não está no portal
checkedAtquando perguntamos a ele

errors pode trazer coisas ainda que a publicação tenha saído bem: são anotações que o portal deixa por conta própria. Vêm sem interpretar porque o texto do portal é mais preciso do que qualquer tradução nossa.

O que processingState responde, e o que não

São três perguntas distintas e o campo responde uma:

A perguntaO campo
o anúncio está no ar?remoteStatus (e publicationState com as datas, de onde sai)
em que etapa está este anúncio?processingState
já posso voltar a escrever?🔴 nenhum campo responde isso. Se responde tentando de novo

processingState não entra no veredito de publicação, e é de propósito. Em um empreendimento o portal deixa PROCESADO antes e depois de dá-lo de baixa, então um estado deduzido daí diria "publicado" para sempre sem falhar nunca. O veredito sai das datas.

E PROCESADO também não significa "já pode escrever" em um empreendimento.

Em um empreendimento grande a publicação é processada de forma diferida: o anúncio pai chega a PROCESADO enquanto as unidades continuam na fila, e o cadeado de escrita do portal vive no empreendimento completo, não no anúncio.

Com 20 unidades, PROCESADO chega em 3 minutos e o portal continua rejeitando escritas com 409 portal_processing por quase 6 minutos mais.

⇒ Se você vem de um 409, o caminho continua sendo esperar e tentar de novo. Consultar o estado te diz em que etapa está o anúncio que você perguntou; não te diz quando o portal vai aceitar a próxima escrita, e não temos esse dado: o portal não o envia.

É o mesmo campo e o mesmo nome em um anúncio e em um empreendimento, então a leitura que você escrever serve para os dois — Publicar e despublicar um empreendimento.

E antes de usá-lo, olhe o custo: perguntar gasta uma chamada da cota do seu cliente; esperar é grátis. Para a janela de processamento, o backoff do 409 continua sendo o recomendado — isto é a alternativa para quem preferir saber em vez de esperar.

Códigos de resposta

CódigoO que aconteceuO que fazer
200o estado do anúncio—
403seu token não tem o escopo {portal}:publishnos escreva para habilitá-lo
404essa propriedade não está no seu inventáriorevise o paId e o x-client-ref
409a conta não está conectada ao portalpeça um link de conexão
501ainda não podemos consultar o estado nesse portalo portal vem em portal
403esse anúncio não consta na conta do seu cliente no portal (listing_not_found_or_not_yours)pode ser que não tenha sido publicado, que tenha sido retirado, ou que esteja sob outra conta. O portal responde o mesmo nos três casos, então não afirmamos qual é
409o portal já não reconhece a conta do seu cliente (portal_account_unlinked)conecte-a de novo: peça um link
409o portal tem a conta desabilitada ou bloqueada (portal_account_blocked)escreva para nós com o reference: o vínculo com o portal é gerenciado por nós
502não conseguimos perguntar ao portaltente novamente; não mudamos nada do seu lado

Nenhum dos três muda o estado que temos guardado. Uma recusa sobre o estado da conta — ou sobre um anúncio que não consta — não diz nada sobre se o anúncio está publicado, então o deixamos como estava. É a mesma regra do 502: não afirmamos o que não conseguimos medir.

O 501 não significa que o portal não existe: pode ser que você publique nele perfeitamente e que o que falte seja esta consulta. Hoje está disponível em Zonaprop.

Relacionado