Cadastrar empreendimentos em lote

POST

/partner/v1/realty-cluster/batch

Até 50 empreendimentos por chamada — um quarto do teto de 200 das outras entidades, porque cada empreendimento são DUAS gravações do lado da Homfy (o cadastro e a complementação com endereço). A resposta separa created de skipped, então a carga inteira pode ser reenviada após uma falha sem duplicar nada — lembrando que skipped NÃO atualiza o que já existe.

partner_code repetido DENTRO da mesma carga é recusado com 400 e nada é gravado. Já um código que existe de uma carga anterior não é erro: volta em skipped.

A resposta 201 pode conter falha: um item pode falhar sozinho e os demais serem criados. Cada entrada de errors identifica o empreendimento pelo partner_code.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Example

{
    "realty_clusters": [
        {
            "type": "Empreendimento",
            "partner_code": "EMP-1024",
            "name": "Residencial Bela Vista",
            "is_active": true,
            "description": "Condomínio fechado com 4 torres, entregue em 2019.",
            "email": "contato@belavista.com.br",
            "phone": "(48) 3333-4444",
            "whatsapp": "48999998888",
            "address": {
                "state": "SC",
                "zipcode": "88015-600",
                "city": "Florianópolis",
                "district": "Centro",
                "street": "Bocaiúva",
                "street_number": "120",
                "street_type": "Rua",
                "reference": "Próximo ao mercado",
                "complement": "Apto 302",
                "block": "Torre B",
                "latitude": "-27.593500",
                "longitude": "-48.548500"
            }
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/partner/v1/realty-cluster/batch' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "realty_clusters": [
        {
            "type": "Empreendimento",
            "partner_code": "EMP-1024",
            "name": "Residencial Bela Vista",
            "is_active": true,
            "description": "Condomínio fechado com 4 torres, entregue em 2019.",
            "email": "contato@belavista.com.br",
            "phone": "(48) 3333-4444",
            "whatsapp": "48999998888",
            "address": {
                "state": "SC",
                "zipcode": "88015-600",
                "city": "Florianópolis",
                "district": "Centro",
                "street": "Bocaiúva",
                "street_number": "120",
                "street_type": "Rua",
                "reference": "Próximo ao mercado",
                "complement": "Apto 302",
                "block": "Torre B",
                "latitude": "-27.593500",
                "longitude": "-48.548500"
            }
        }
    ]
}'

Responses

🟢201

application/json

Resultado item a item: created, skipped e errors. Os errorCode de errors[] são os mesmos do cadastro individual: PARTNER_REALTY_CLUSTER_INCOMPLETE, PARTNER_REALTY_CLUSTER_ALREADY_EXISTS e PARTNER_REALTY_CLUSTER_REGISTER_FAILED.

Bodyapplication/json

Example

{
    "created": [
        {
            "partner_code": "AP-1024",
            "realty_cluster_id": 42,
            "code": "SC1547"
        }
    ],
    "skipped": [
        {
            "partner_code": "AP-1024",
            "realty_cluster_id": 42
        }
    ],
    "errors": [
        {
            "partner_code": "AP-1024",
            "errorCode": "PARTNER_PROPERTY_NOT_FOUND",
            "errorMessage": "string"
        }
    ]
}

🟠400

🟠401

🟠403

🟠429

🔴500

Modified at 2026-08-20 16:06:11

Atualizar empreendimento

Consultar empreendimento