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 devolve | Cota | |
|---|---|---|
GET /properties/{paId} | o último estado que já tínhamos, em published.{portal}.remote | grátis |
GET …/publication/{portal} (esta página) | pergunta ao portal agora | 1 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 portal | remoteStatus fica em |
|---|---|
publicationState: ONLINE | published |
publicationState: OFFLINE | unpublished |
um PLANO (HOME_ZONA_DEMAND, SIMPLE…) com onlineAt e sem offlineAt | published |
um PLANO com offlineAt | unpublished |
| um estado da OPERAÇÃO (reservado, vendido, alugado) | published — ver abaixo |
| o anúncio não existe no portal | unpublished |
| algo que não reconhecemos e sem datas | nã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?
inSync | O que significa | O que fazer |
|---|---|---|
true | o portal coincide com o que você esperava | nada |
false | mudou sem que você tenha pedido — caiu, ou o plano venceu | publique novamente se você quiser que fique no ar |
null | o portal não nos deu com o que decidir: um estado que não interpretamos e sem onlineAt | olhe 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.
| Zonaprop | Argenprop | |
|---|---|---|
| O estado | publicationState + 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étricas | visits | points, os do anúncio |
| Processamento | processingState | não informa |
| Imagens e avisos | imagesStatus · errors · warnings | nã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:
| Campo | O que é |
|---|---|
portalItemId | o id que o portal deu ao anúncio. É o que forma a URL. Está nos dois portais |
publicationState | ONLINE / OFFLINE, ou o nome do plano enquanto está online. Veja a nota acima |
processingState | em 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 · offlineAt | quando saiu e quando foi retirado |
createdAt · modifiedAt | do lado do portal, não do seu |
visits | visitas que o portal registrou. null se não as informa |
errors · warnings | tal como o portal envia, sem traduzir |
imagesStatus | o que o portal fez com cada imagem |
exists | false se o anúncio não está no portal |
checkedAt | quando 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 pergunta | O 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ódigo | O que aconteceu | O que fazer |
|---|---|---|
200 | o estado do anúncio | — |
403 | seu token não tem o escopo {portal}:publish | nos escreva para habilitá-lo |
404 | essa propriedade não está no seu inventário | revise o paId e o x-client-ref |
409 | a conta não está conectada ao portal | peça um link de conexão |
501 | ainda não podemos consultar o estado nesse portal | o portal vem em portal |
403 | esse 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 é |
409 | o portal já não reconhece a conta do seu cliente (portal_account_unlinked) | conecte-a de novo: peça um link |
409 | o 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 |
502 | não conseguimos perguntar ao portal | tente 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
- Publicação em portais — os três métodos do mesmo endpoint
PUTpublicar ·DELETEdespublicarGET /properties/{paId}— a leitura que não gasta cota