Publicar um empreendimento

Um empreendimento é um edifício ou um bairro com unidades dentro. Se você já leu publicar um anúncio, o fluxo é o mesmo com uma diferença que muda toda a ordem.

As unidades são cadastradas ANTES do empreendimento que as agrupa. Não é uma recomendação de estilo: o empreendimento as referencia, então se elas ainda não existem, não há nada para referenciar. É o erro número um deste fluxo e não se corrige para a frente — é preciso voltar atrás.

O caminho

1 · cada unidade, separadamente       POST /properties             ← PRIMEIRO. São imóveis normais
2 · o empreendimento que as agrupa    POST /properties             ← referencia as do passo 1
3 · verificar                         POST /properties/verify      gratuito
4 · publicar                          PUT  …/publication/{portal}  ← UMA chamada: pai + unidades
5 · estado e baixa                    igual a um anúncio

1 · As unidades primeiro

Cada unidade é um imóvel normal: é cadastrada com o mesmo POST /properties que qualquer outro.

⚠️ Uma unidade não é um empreendimento. Tem o seu próprio tipo de imóvel —apartamento, casa, lote— e só herda o do empreendimento se você errar ao montá-la. Se acontecer, a tentativa de publicar marca isso unidade por unidade, nomeando o tipo que o portal não reconhece.

Guarde o código ou o identificador de cada uma: é com isso que o empreendimento vai referenciá-las.

2 · O empreendimento

Outro POST /properties, com o objeto de empreendimento e a lista das unidades do passo 1.

Duas coisas que convém saber antes:

Uma unidade pertence a um só empreendimento. Se já faz parte de outro, dizemos isso nomeando qual — não a reatribuímos por conta própria.
Um empreendimento pode ser guardado sem unidades e recebê-las depois. O que não se pode é publicá-lo vazio.

3 · Verificar (gratuito, e aqui rende mais do que nunca)

O verificador revisa o empreendimento e cada unidade. Como publicá-lo é uma única chamada ao portal, um problema numa única unidade pode travar tudo — e verificar não custa nada.

O verificador trabalha sobre o objeto que você manda, não sobre o que já guardamos. Para conferir um empreendimento que já existe, mande-o com as unidades atuais: como elas já pertencem a esse mesmo empreendimento, ele vai marcá-las. É um limite conhecido e não é um erro seu.

4 · Publicar: uma chamada, o pai e as unidades

PUT …/publication/{portal} com o empreendimento. As unidades viajam dentro dele: você não as publica uma por uma.

Isso tem duas consequências que convém ter claras:


A cota	é uma chamada, não uma por unidade. Um empreendimento de 40 unidades custa o mesmo que um de 2
O plano	os empreendimentos consomem um plano próprio, diferente do de um anúncio solto. Qual é e quantos o seu cliente tem você vê com a consulta de planos

Dependendo de quantas unidades tiver, o portal pode responder de duas formas: confirmando cada anúncio, ou confirmando só o empreendimento e processando as unidades depois. O que devolvemos está explicado em a resposta do empreendimento; o modo não é você quem escolhe.

5 · Estado, atualizar e baixa

Igual a um anúncio: publicar de novo atualiza, a baixa é idempotente, e o estado se lê gratuitamente do nosso lado ou pagando uma chamada ao portal.

⚠️ O empreendimento e as unidades dele têm estados separados. Consulte o do empreendimento pelo empreendimento: perguntar por uma unidade como se fosse um anúncio solto não vai dizer o que você procura.

Os três erros de ordem, e como aparecem

Se você…	Dizemos assim
manda o empreendimento antes das unidades	não encontramos essas unidades, com o código que não existe
referencia uma unidade que já é de outro empreendimento	nomeamos o empreendimento que a tem
deixa as unidades herdarem o tipo do empreendimento	a tentativa marca cada unidade com o tipo que o portal não aceita

Os três aparecem antes de chegar ao portal se você verificou. Se não verificou, aparecem depois de gastar a chamada.

Que portais suportam isso

Publicar empreendimentos não está disponível em todos os portais, e naqueles em que está, o seu cliente precisa ter contratado o produto correspondente — que é diferente do de anúncios soltos. A tabela está em Publicação; se o portal não suportar, a tentativa diz isso sem gastar cota.

Relacionado

Publicar um anúncio — o caso base
O objeto do empreendimento · Verificar · A resposta
Publicar um empreendimento — o endpoint e o contrato dele