Vincular imóveis ao empreendimento

Liga até 50 imóveis a um empreendimento de uma vez. Os dois lados vão pelos SEUS códigos: o do empreendimento em partner_code e os dos imóveis em property_partner_codes.

Um imóvel pertence a no máximo UM empreendimento. Vincular um imóvel que já está em outro TROCA o vínculo, sem erro e sem aviso. Imóvel que já estava neste mesmo empreendimento volta em skipped, e nada é regravado.

Não há como desvincular por esta API — nem por aqui, nem mandando realty_cluster_id nulo no imóvel. Tirar um imóvel de um empreendimento é operação do painel.

O empreendimento e os imóveis precisam existir na imobiliária do token, e os dois casos são tratados de forma diferente de propósito: partner_code do empreendimento desconhecido derruba a chamada com 404, antes de vincular qualquer coisa; já código de IMÓVEL desconhecido vira erro daquele item dentro da resposta 201 (errors[].errorCode: PARTNER_PROPERTY_NOT_FOUND), e os demais são vinculados — numa remessa de 50, derrubar tudo por causa de um código velho obrigaria você a descobrir qual é por tentativa e erro.

O vínculo fica registrado no histórico do imóvel, como qualquer alteração feita pelo painel.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201

application/json

Resultado item a item: linked, skipped e errors.

Bodyapplication/json

Example

{
    "partner_code": "AP-1024",
    "realty_cluster_id": 42,
    "linked": [
        {
            "property_id": 1547,
            "property_partner_code": "string"
        }
    ],
    "skipped": [
        {
            "property_id": 1547,
            "property_partner_code": "string"
        }
    ],
    "errors": [
        {
            "errorCode": "PARTNER_PROPERTY_NOT_FOUND",
            "property_partner_code": "string",
            "errorMessage": "string"
        }
    ]
}

🟠400

🟠401

🟠403

🟠404

🟠429

🔴500