Referência da API

Terrenos (Land Plots)

Gerenciar banco de terrenos, due diligence e certidões via API.

Terrenos (Land Plots)

Gerencie o banco de terrenos da sua incorporadora: cadastro, análise, due diligence, certidões e scoring por IA. O pipeline de terrenos acompanha todo o ciclo de vida desde a prospecção até a aquisição ou descarte.

Todos os endpoints requerem autenticação via API Key no header Authorization: Bearer sua_chave_aqui.

GET /v1/land-plots

Lista todos os terrenos da organização com suporte a paginação, filtros e ordenação.

Query Parameters

ParâmetroTipoPadrãoDescrição
pagenumber1Página atual
limitnumber20Itens por página (máx: 100)
statusstring-Filtrar por status único (ex: prospeccao)
statusesstring-Filtrar por múltiplos status separados por vírgula
sourcestring-Filtrar por origem (ex: corretor, indicacao)
prioritynumber-Filtrar por prioridade: 1, 2, 3 ou 4
searchstring-Buscar por nome, endereço ou nome do proprietário
sortstring-created_atCampo de ordenação (prefixo - para descendente)

Campos Ordenáveis

CampoDescrição
nameNome do terreno
total_area_m2Área total
asking_priceValor pedido
statusStatus no pipeline
created_atData de criação
owner_nameNome do proprietário
priorityPrioridade
capture_dateData de captação
ai_scoreCompletude da conferência documental (0–100)

Request

curl -X GET "https://api.octabuild.ai/v1/land-plots?status=prospeccao&priority=2&sort=-asking_price&limit=10" \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Terreno Alphaville Granja Viana",
      "address": "Rod. Raposo Tavares, km 23",
      "street": "Rodovia Raposo Tavares",
      "number": "23000",
      "complement": "Lote 15",
      "neighborhood": "Granja Viana",
      "city": "Cotia",
      "state": "SP",
      "zip_code": "06708-000",
      "latitude": -23.5868,
      "longitude": -46.8578,
      "google_maps_link": "https://maps.google.com/?q=-23.5868,-46.8578",
      "registration_number": "12345",
      "registry_office": "1o Cartório de Registro de Imóveis de Cotia",
      "judicial_district": "Cotia",
      "total_area_m2": 15000.00,
      "zoning": "ZR2",
      "floor_area_ratio": 2.5,
      "max_floors": 8,
      "boundaries": "Norte: Rua A; Sul: Rua B; Leste: Lote 14; Oeste: Lote 16",
      "owner_name": "Espólio de José da Silva",
      "owner_document": "123.456.789-00",
      "asking_price": 8500000.00,
      "appraisal_value": 7200000.00,
      "acquisition_value": null,
      "source": "corretor",
      "status": "prospeccao",
      "priority": 2,
      "ai_score": 78.5,
      "registration_link": "https://storage.example.com/matricula.pdf",
      "topography_link": null,
      "survey_link": null,
      "notes": "Terreno com boa topografia, próximo à estação de trem.",
      "broker_name": "Carlos Mendes",
      "broker_phone": "+55 11 98765-4321",
      "capture_date": "2026-02-10",
      "discard_reason": null,
      "deal_type_id": "uuid-tipo-negocio",
      "deal_type": {
        "id": "uuid-tipo-negocio",
        "name": "Compra e Venda"
      },
      "developments": [
        { "id": "uuid-emp-1", "name": "Residencial Granja Viana" }
      ],
      "created_at": "2026-02-10T14:30:00Z",
      "updated_at": "2026-02-20T09:15:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 47,
    "pages": 5
  }
}

POST /v1/land-plots

Cadastra um novo terreno no banco de terrenos.

Request Body

CampoTipoObrigatórioDescrição
namestringSimNome identificador do terreno
addressstringNãoEndereço completo (texto livre)
streetstringNãoLogradouro
numberstringNãoNúmero
complementstringNãoComplemento
neighborhoodstringNãoBairro
citystringNãoCidade
statestringNãoUF (2 letras)
zip_codestringNãoCEP
latitudenumberNãoLatitude (decimal)
longitudenumberNãoLongitude (decimal)
google_maps_linkstringNãoLink do Google Maps
registration_numberstringNãoNúmero da matrícula
registry_officestringNãoCartório de registro
judicial_districtstringNãoComarca
total_area_m2numberNãoÁrea total em m²
zoningstringNãoZoneamento (ex: ZR2, ZM)
floor_area_rationumberNãoCoeficiente de aproveitamento
max_floorsnumberNãoGabarito máximo de pavimentos
boundariesstringNãoConfrontações
owner_namestringNãoNome do proprietário
owner_documentstringNãoCPF/CNPJ do proprietário
asking_pricenumberNãoValor pedido (R$)
appraisal_valuenumberNãoValor de avaliação (R$)
acquisition_valuenumberNãoValor de aquisição (R$)
sourcestringNãoOrigem (ex: corretor, indicacao, site)
statusstringNãoStatus no pipeline (padrão: prospeccao)
prioritynumberNãoPrioridade: 1 a 4
registration_linkstringNãoURL do arquivo da matrícula
topography_linkstringNãoURL do levantamento topográfico
survey_linkstringNãoURL da sondagem
notesstringNãoObservações
broker_namestringNãoNome do corretor
broker_phonestringNãoTelefone do corretor
capture_datestringNãoData de captação (YYYY-MM-DD)
discard_reasonstringNãoMotivo de descarte
deal_type_idstringNãoID do tipo de negócio

Request

curl -X POST https://api.octabuild.ai/v1/land-plots \
  -H "Authorization: Bearer ea_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Terreno Vila Madalena",
    "address": "Rua Harmonia, 250 - Vila Madalena, São Paulo/SP",
    "street": "Rua Harmonia",
    "number": "250",
    "neighborhood": "Vila Madalena",
    "city": "São Paulo",
    "state": "SP",
    "zip_code": "05435-000",
    "latitude": -23.5456,
    "longitude": -46.6913,
    "total_area_m2": 2400.00,
    "zoning": "ZM",
    "floor_area_ratio": 4.0,
    "max_floors": 15,
    "owner_name": "Maria Aparecida Santos",
    "owner_document": "987.654.321-00",
    "asking_price": 12000000.00,
    "source": "corretor",
    "status": "prospeccao",
    "priority": 2,
    "broker_name": "Roberto Lima",
    "broker_phone": "+55 11 91234-5678",
    "capture_date": "2026-02-25",
    "notes": "Esquina com a Rua Fidalga, alta visibilidade."
  }'

Response

{
  "success": true,
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Terreno Vila Madalena",
    "address": "Rua Harmonia, 250 - Vila Madalena, São Paulo/SP",
    "street": "Rua Harmonia",
    "number": "250",
    "complement": null,
    "neighborhood": "Vila Madalena",
    "city": "São Paulo",
    "state": "SP",
    "zip_code": "05435-000",
    "latitude": -23.5456,
    "longitude": -46.6913,
    "google_maps_link": null,
    "registration_number": null,
    "registry_office": null,
    "judicial_district": null,
    "total_area_m2": 2400.00,
    "zoning": "ZM",
    "floor_area_ratio": 4.0,
    "max_floors": 15,
    "boundaries": null,
    "owner_name": "Maria Aparecida Santos",
    "owner_document": "987.654.321-00",
    "asking_price": 12000000.00,
    "appraisal_value": null,
    "acquisition_value": null,
    "source": "corretor",
    "status": "prospeccao",
    "priority": 2,
    "ai_score": null,
    "registration_link": null,
    "topography_link": null,
    "survey_link": null,
    "notes": "Esquina com a Rua Fidalga, alta visibilidade.",
    "broker_name": "Roberto Lima",
    "broker_phone": "+55 11 91234-5678",
    "capture_date": "2026-02-25",
    "discard_reason": null,
    "deal_type_id": null,
    "deal_type": null,
    "created_at": "2026-02-25T10:30:00Z",
    "updated_at": "2026-02-25T10:30:00Z"
  }
}

GET /v1/land-plots/:id

Busca um terreno específico com seus dados completos, incluindo certidões e empreendimentos vinculados.

Request

curl -X GET https://api.octabuild.ai/v1/land-plots/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Terreno Alphaville Granja Viana",
    "address": "Rod. Raposo Tavares, km 23",
    "street": "Rodovia Raposo Tavares",
    "number": "23000",
    "complement": "Lote 15",
    "neighborhood": "Granja Viana",
    "city": "Cotia",
    "state": "SP",
    "zip_code": "06708-000",
    "latitude": -23.5868,
    "longitude": -46.8578,
    "google_maps_link": "https://maps.google.com/?q=-23.5868,-46.8578",
    "registration_number": "12345",
    "registry_office": "1o Cartório de Registro de Imóveis de Cotia",
    "judicial_district": "Cotia",
    "total_area_m2": 15000.00,
    "zoning": "ZR2",
    "floor_area_ratio": 2.5,
    "max_floors": 8,
    "boundaries": "Norte: Rua A; Sul: Rua B; Leste: Lote 14; Oeste: Lote 16",
    "owner_name": "Espólio de José da Silva",
    "owner_document": "123.456.789-00",
    "asking_price": 8500000.00,
    "appraisal_value": 7200000.00,
    "acquisition_value": null,
    "source": "corretor",
    "status": "analise_preliminar",
    "priority": 2,
    "ai_score": 78.5,
    "registration_link": "https://storage.example.com/matricula.pdf",
    "topography_link": null,
    "survey_link": null,
    "notes": "Terreno com boa topografia, próximo à estação de trem.",
    "broker_name": "Carlos Mendes",
    "broker_phone": "+55 11 98765-4321",
    "capture_date": "2026-02-10",
    "discard_reason": null,
    "deal_type_id": "uuid-tipo-negocio",
    "deal_type": {
      "id": "uuid-tipo-negocio",
      "name": "Compra e Venda"
    },
    "developments": [
      { "id": "uuid-emp-1", "name": "Residencial Granja Viana" }
    ],
    "certificates": [
      {
        "id": "cert-uuid-001",
        "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
        "type": "Certidão de Ônus Reais",
        "issuing_authority": "1o CRI de Cotia",
        "status": "obtida",
        "issued_at": "2026-02-12",
        "expires_at": "2026-05-12",
        "file_url": "https://storage.example.com/certidao-onus.pdf",
        "notes": null,
        "created_at": "2026-02-12T11:00:00Z",
        "updated_at": "2026-02-12T11:00:00Z"
      }
    ],
    "created_at": "2026-02-10T14:30:00Z",
    "updated_at": "2026-02-20T09:15:00Z"
  }
}

PUT /v1/land-plots/:id

Atualiza parcialmente um terreno existente. Envie apenas os campos que deseja alterar.

Request

curl -X PUT https://api.octabuild.ai/v1/land-plots/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer ea_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "negociacao",
    "appraisal_value": 7800000.00,
    "priority": 1,
    "notes": "Proprietário aceitou negociar. Agendar visita técnica."
  }'

Response

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Terreno Alphaville Granja Viana",
    "status": "negociacao",
    "appraisal_value": 7800000.00,
    "priority": 1,
    "notes": "Proprietário aceitou negociar. Agendar visita técnica.",
    "deal_type": {
      "id": "uuid-tipo-negocio",
      "name": "Compra e Venda"
    },
    "updated_at": "2026-02-25T15:00:00Z"
  }
}

DELETE /v1/land-plots/:id

Remove permanentemente um terreno.

Esta operação é irreversível. Terrenos com empreendimentos vinculados podem gerar erros de integridade referencial. Considere alterar o status para descartado em vez de deletar.

Request

curl -X DELETE https://api.octabuild.ai/v1/land-plots/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "deleted": true
  }
}

GET /v1/land-plots/:id/due-diligence

Lista os itens da Conferência e documentos do terreno (o checklist em pastas da tela do terreno), no formato de due diligence desta API, ordenados por ordem e data de criação.

Desde outubro/2026 estes endpoints leem e gravam o checklist do terreno. O formato não mudou, mas alguns campos não têm equivalente: priority, deadline e estimated_cost sempre voltam null e, na entrada, são aceitos e ignorados. category é a pasta (juridica = Aquisição ou Registro de incorporação, ambiental, tecnica = Técnico; pasta criada pela organização volta com o próprio nome) e subcategory é a subpasta (ex.: Vendedor). file_url/file_name mostram o primeiro documento anexado ao item; enviar file_url anexa um link ao item. status: "concluido" exige documento anexado (envie file_url junto); nao_aplicavel usa assessment_justification (ou notes) como justificativa da dispensa. assessment só é aproveitado quando vermelho (item com pendência, devolvido como em_andamento). Remover item (DELETE /v1/land-plots/:id/due-diligence/:itemId) é decisão da diretoria no OctaBuild e responde 403 FORBIDDEN: para tirar o item da conta, dispense-o com PUT enviando status: "nao_aplicavel" e assessment_justification.

Request

curl -X GET https://api.octabuild.ai/v1/land-plots/550e8400-e29b-41d4-a716-446655440000/due-diligence \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": [
    {
      "id": "dd-uuid-001",
      "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Certidão de Matrícula Atualizada",
      "category": "juridica",
      "subcategory": "documentacao",
      "status": "concluido",
      "priority": "alta",
      "responsible": "Dr. Fernando Alves",
      "notes": "Matrícula sem ônus ou gravames.",
      "completed_at": "2026-02-15T10:00:00Z",
      "deadline": "2026-02-20",
      "file_url": "https://storage.example.com/matricula-atualizada.pdf",
      "file_name": "matricula-atualizada.pdf",
      "assessment": "verde",
      "assessment_justification": "Imóvel livre e desembaraçado.",
      "estimated_cost": 150.00,
      "order": 1,
      "created_at": "2026-02-10T14:30:00Z",
      "updated_at": "2026-02-15T10:00:00Z"
    },
    {
      "id": "dd-uuid-002",
      "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Laudo Ambiental",
      "category": "ambiental",
      "subcategory": "analise_solo",
      "status": "em_andamento",
      "priority": "alta",
      "responsible": "Eng. Ana Paula Costa",
      "notes": "Aguardando resultado da análise de solo.",
      "completed_at": null,
      "deadline": "2026-03-15",
      "file_url": null,
      "file_name": null,
      "assessment": null,
      "assessment_justification": null,
      "estimated_cost": 8500.00,
      "order": 2,
      "created_at": "2026-02-10T14:35:00Z",
      "updated_at": "2026-02-22T08:00:00Z"
    },
    {
      "id": "dd-uuid-003",
      "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Viabilidade Urbanística",
      "category": "urbanistica",
      "subcategory": "zoneamento",
      "status": "pendente",
      "priority": "media",
      "responsible": null,
      "notes": null,
      "completed_at": null,
      "deadline": "2026-03-30",
      "file_url": null,
      "file_name": null,
      "assessment": null,
      "assessment_justification": null,
      "estimated_cost": 3000.00,
      "order": 3,
      "created_at": "2026-02-10T14:40:00Z",
      "updated_at": "2026-02-10T14:40:00Z"
    }
  ]
}

POST /v1/land-plots/:id/due-diligence

Cria um novo item de due diligence para um terreno.

Request Body

CampoTipoObrigatórioDescrição
namestringSimNome do item de due diligence
categorystringNãoPasta: juridica, ambiental, urbanistica (vira Técnico), tecnica ou o nome de uma pasta da organização. Sem valor reconhecido, vai para a primeira pasta
subcategorystringNãoNome de uma subpasta da pasta (ex.: Vendedor); outro valor é ignorado
statusstringNãoStatus: pendente, em_andamento, concluido, nao_aplicavel
prioritystringNãoAceito e ignorado (sem equivalente no checklist)
responsiblestringNãoNome do responsável
notesstringNãoObservações
completed_atstringNãoAceito e ignorado (a data é registrada quando o item é concluído)
deadlinestringNãoAceito e ignorado (sem equivalente no checklist)
file_urlstringNãoURL http(s) anexada ao item como documento
file_namestringNãoNome do arquivo
assessmentstringNãoSó vermelho é aproveitado (registra pendência); demais valores são ignorados
assessment_justificationstringNãoJustificativa da dispensa quando status = nao_aplicavel
estimated_costnumberNãoAceito e ignorado (sem equivalente no checklist)
ordernumberNãoOrdem de exibição

Request

curl -X POST https://api.octabuild.ai/v1/land-plots/550e8400-e29b-41d4-a716-446655440000/due-diligence \
  -H "Authorization: Bearer ea_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Análise de Passivos Trabalhistas",
    "category": "juridica",
    "subcategory": "passivos",
    "status": "pendente",
    "priority": "media",
    "responsible": "Dr. Fernando Alves",
    "deadline": "2026-03-20",
    "estimated_cost": 2500.00,
    "order": 4
  }'

Response

{
  "success": true,
  "data": {
    "id": "dd-uuid-004",
    "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Análise de Passivos Trabalhistas",
    "category": "juridica",
    "subcategory": "passivos",
    "status": "pendente",
    "priority": "media",
    "responsible": "Dr. Fernando Alves",
    "notes": null,
    "completed_at": null,
    "deadline": "2026-03-20",
    "file_url": null,
    "file_name": null,
    "assessment": null,
    "assessment_justification": null,
    "estimated_cost": 2500.00,
    "order": 4,
    "created_at": "2026-02-25T11:00:00Z",
    "updated_at": "2026-02-25T11:00:00Z"
  }
}

GET /v1/land-plots/:id/certificates

Lista todas as certidões de um terreno, ordenadas pela mais recente.

Desde outubro/2026 as certidões são os documentos de certidão da Conferência e documentos do terreno — a mesma certidão aparece aqui, na tela do terreno e na página Certidões do projeto. O formato não mudou. Certidão criada pela API vai para o item do checklist cujo nome é igual ao type (ex.: Certidão de ônus reais) ou, sem item correspondente, para a pasta Aquisição. status aceita só pendente, obtida ou vencida (outro valor é ignorado). Arquivo do armazenamento interno sai em file_url como link autenticado do OctaBuild.

Request

curl -X GET https://api.octabuild.ai/v1/land-plots/550e8400-e29b-41d4-a716-446655440000/certificates \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": [
    {
      "id": "cert-uuid-001",
      "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "Certidão de Ônus Reais",
      "issuing_authority": "1o CRI de Cotia",
      "status": "obtida",
      "issued_at": "2026-02-12",
      "expires_at": "2026-05-12",
      "file_url": "https://storage.example.com/certidao-onus.pdf",
      "notes": null,
      "created_at": "2026-02-12T11:00:00Z",
      "updated_at": "2026-02-12T11:00:00Z"
    },
    {
      "id": "cert-uuid-002",
      "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "Certidão Negativa de Débitos Municipais",
      "issuing_authority": "Prefeitura Municipal de Cotia",
      "status": "pendente",
      "issued_at": null,
      "expires_at": null,
      "file_url": null,
      "notes": "Solicitada em 20/02/2026, prazo de 10 dias úteis.",
      "created_at": "2026-02-20T09:00:00Z",
      "updated_at": "2026-02-20T09:00:00Z"
    }
  ]
}

POST /v1/land-plots/:id/certificates

Cria uma nova certidão vinculada a um terreno.

Request Body

CampoTipoObrigatórioDescrição
typestringSimTipo da certidão (ex: Certidão de Ônus Reais)
issuing_authoritystringNãoÓrgão emissor
statusstringNãoStatus: pendente, obtida, vencida
issued_atstringNãoData de emissão (YYYY-MM-DD)
expires_atstringNãoData de validade (YYYY-MM-DD)
file_urlstringNãoURL do arquivo da certidão
notesstringNãoObservações

Request

curl -X POST https://api.octabuild.ai/v1/land-plots/550e8400-e29b-41d4-a716-446655440000/certificates \
  -H "Authorization: Bearer ea_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "Certidão Negativa de Débitos Trabalhistas",
    "issuing_authority": "Tribunal Superior do Trabalho",
    "status": "obtida",
    "issued_at": "2026-02-20",
    "expires_at": "2026-08-20",
    "file_url": "https://storage.example.com/cndt.pdf",
    "notes": "CNDT válida por 180 dias."
  }'

Response

{
  "success": true,
  "data": {
    "id": "cert-uuid-003",
    "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "Certidão Negativa de Débitos Trabalhistas",
    "issuing_authority": "Tribunal Superior do Trabalho",
    "status": "obtida",
    "issued_at": "2026-02-20",
    "expires_at": "2026-08-20",
    "file_url": "https://storage.example.com/cndt.pdf",
    "notes": "CNDT válida por 180 dias.",
    "created_at": "2026-02-25T11:30:00Z",
    "updated_at": "2026-02-25T11:30:00Z"
  }
}

POST /v1/land-plots/:id/score

Retorna o score do terreno: a completude da conferência documental — itens do checklist concluídos (com documento anexado) ou dispensados (com justificativa), sobre o total de itens. O valor é mantido automaticamente no campo ai_score a cada mudança no checklist; esta rota só o detalha.

Terreno sem nenhum item no checklist devolve score: null. O nome ai_score foi mantido por compatibilidade: o valor não vem de modelo de IA.

Request

curl -X POST https://api.octabuild.ai/v1/land-plots/550e8400-e29b-41d4-a716-446655440000/score \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
    "score": 67,
    "breakdown": {
      "total_items": 30,
      "closed_items": 20,
      "completeness_pct": 67
    }
  }
}

GET /v1/land-plots/stats

Retorna estatísticas agregadas do pipeline de terrenos: totais por status, por origem, score médio, valor do pipeline e novos cadastros recentes.

Request

curl -X GET https://api.octabuild.ai/v1/land-plots/stats \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "total": 47,
    "by_status": {
      "prospeccao": 18,
      "analise_preliminar": 10,
      "estudo_massa": 5,
      "negociacao": 6,
      "due_diligence": 3,
      "aprovado": 2,
      "adquirido": 1,
      "descartado": 2
    },
    "by_source": {
      "corretor": 22,
      "indicacao": 12,
      "site": 8,
      "prospecao_ativa": 5
    },
    "average_score": 62.35,
    "pipeline_value": 185000000.00,
    "new_last_7_days": 4
  }
}

O campo pipeline_value soma o asking_price apenas dos terrenos nos status de prospecção ativa: prospeccao, analise_preliminar, estudo_massa, negociacao e due_diligence.

Referência de Status

StatusDescriçãoEtapa
prospeccaoTerreno identificado, aguardando análise inicialCaptação
analise_preliminarPrimeira análise de viabilidade em andamentoAnálise
estudo_massaEstudo de massa e viabilidade técnicaAnálise
negociacaoEm negociação com proprietárioNegociação
due_diligenceProcesso de due diligence em andamentoJurídico
aprovadoAprovado pela diretoria para aquisiçãoAprovação
adquiridoTerreno adquirido com sucessoConcluído
descartadoDescartado (informar discard_reason)Encerrado

Referência de Prioridade

ValorNívelDescrição
1UrgenteRequer ação imediata
2AltaAlta prioridade de análise
3NormalPrioridade padrão
4BaixaBaixa prioridade

Categorias de Due Diligence

CategoriaDescrição
juridicaPastas Aquisição e Registro de incorporação
ambientalPasta Ambiental
urbanisticaEntrada aceita; grava na pasta Técnico e volta como tecnica
tecnicaPasta Técnico

Status de Due Diligence

StatusDescrição
pendenteAinda não iniciado
em_andamentoNa leitura: item com pendência registrada. Na escrita: volta a pendente
concluidoConcluído com documento anexado
nao_aplicavelDispensado com justificativa

Pareceres de Due Diligence

ParecerSignificado
verdeSem restrições ou riscos identificados
amareloRestrições parciais ou riscos mitigáveis
vermelhoRestrições graves ou riscos elevados

Status de Certidões

StatusDescrição
pendenteCertidão solicitada, aguardando emissão
obtidaCertidão emitida e válida
vencidaCertidão com prazo de validade expirado

Erros Comuns

CódigoErroSolução
400VALIDATION_ERROR - Invalid JSON bodyVerifique se o corpo da requisição é um JSON válido
400VALIDATION_ERROR - Field 'name' is requiredO campo name é obrigatório ao criar terrenos
400VALIDATION_ERROR - Field 'type' is requiredO campo type é obrigatório ao criar certidões
404NOT_FOUND - Land plot not foundO terreno não existe ou não pertence à sua organização
401UNAUTHORIZEDAPI Key ausente ou inválida
403FORBIDDENSem permissão para acessar este recurso
500QUERY_ERRORErro interno ao consultar dados
500INSERT_ERRORErro interno ao inserir registro
500UPDATE_ERRORErro interno ao atualizar registro
500DELETE_ERRORErro interno ao deletar registro
500SCORE_ERROR - Failed to calculate scoreErro ao calcular a completude

Autenticação

Como autenticar suas requisições à API OctaBuild usando API Keys.

Empreendimentos

Criar e gerenciar empreendimentos imobiliarios, blocos e tipologias via API.

On this page

Terrenos (Land Plots)GET /v1/land-plotsQuery ParametersCampos OrdenáveisRequestResponsePOST /v1/land-plotsRequest BodyRequestResponseGET /v1/land-plots/:idRequestResponsePUT /v1/land-plots/:idRequestResponseDELETE /v1/land-plots/:idRequestResponseGET /v1/land-plots/:id/due-diligenceRequestResponsePOST /v1/land-plots/:id/due-diligenceRequest BodyRequestResponseGET /v1/land-plots/:id/certificatesRequestResponsePOST /v1/land-plots/:id/certificatesRequest BodyRequestResponsePOST /v1/land-plots/:id/scoreRequestResponseGET /v1/land-plots/statsRequestResponseReferência de StatusReferência de PrioridadeCategorias de Due DiligenceStatus de Due DiligencePareceres de Due DiligenceStatus de CertidõesErros Comuns