Pular para o conteúdo principal

Criar uma nova Solicitação

Descrição​

Essa rota é usada para a criação de solicitações. A autenticação é feita via chave de api a ser fornecida para o integrador.

Endpoint​

https://api.prd.valuation.eemovel.com.br/avr/solicit/integration/create_solicitation

Método: POST

Headers​

x-api-key = <x_api_key>
userid = <user_id>
providerid = <provider_id>

Corpo da requisição​

  • Será fornecido ao integrador uma lista de ids de providers demandantes. O id do provider é passado no body:
    • provider_evaluator_id para avaliações
    • provider_inspector_id para vistorias
    • ambos para solicitações com vistorias
{
    "full_address": {
        "city": "São Paulo",
        "neighborhood": "Bela Vista",
        "number": "1234",
        "postal_code": "01310-100",
        "state": "SP",
        "street": "Avenida Paulista",
        "street_long": "",
        "lat": -23.5634108,
        "lon": -46.6537575,
        "place_id": ""
    },
    "solicitation_type": "real_estate_appraisal",
    "property_type": "Apartamento",
    "business_type": "Aquisição",
    "proposer": "John Doe",
    "proposer_cpf_cnpj": "333.333.333-33",
    "registration": "1.565.843.122",
    "trading_value": "560000",
    "email": "demo@eemovel.com",
    "phone_number": "(00) 99999-9999",
    "provider_demandant_id": "8b00ec5b9e27cc4539faf2d2f5f2a8ee",
    "provider_evaluator_id": "b1e1b7b20d7d32151aff10d80f4d17ee",
    "billing": {},
    "responsible_analyst": "49f3ad1c00a9c625718ba36d66c36de2"
    "inspection_companion_name": "Teste Inspector",
    "provider_inspector_id": "b1e1b7b20d7d32151aaf10880f4fddb5",
    "inspection_type": "on_site_inspection",
    "inspection_delivery_date": "2024-07-25T21:00:13.937Z",
}

Observações​

  • O campo solicitation_type deverá ser um dos possíveis valores;

    • real_estate_appraisal para avaliações
    • inspection para vistoria
    • appraisal_inspection para avaliação com vistoria

  • O campo property_type deverá ser um dos possíveis valores:

    • Apartamento
    • Casa
    • Casa em Condomínio
    • Cobertura
    • Sala Comercial
    • Loja
    • Galpão
    • Rural
    • Terreno
    • Outros

  • O campo business_type deverá ser um dos possíveis valores:

    • Aquisição
    • Consórcio
    • Empréstimo com Garantia
    • Locação
    • Mútuo
    • Não Informado
    • Patrimonial
    • Recuperação
    • Rotativo

  • O campo inspection_type deverá ser on_site_inspection para Vistoria in loco

  • Quando a solicitação for do tipo real_estate_appraisal os seguintes campos não devem ser enviados no corpo da requisição:

{
    "inspection_companion_name": "Teste Inspector",
    "provider_inspector_id": "b1e1b7b20d7d32151aaf1088ff4f17dd",
    "inspection_type": "on_site_inspection",
    "inspection_delivery_date": "2024-07-25T21:00:13.937Z",
}

Success response 201​

Para solicitação de avaliação e vistoria individuais

{
    "data": {
        "id": "66a3d4ce8a6a1b80e071b16d",
        "code": "20240726EEM1354295"
    },
    "message": "Solicitação criada com sucesso!",
    "code": 201,
    "success": true
}

Para solicitação de avaliação com vistoria

{
    "data": {
        "appraisal_id": "679997eb137fda6dd938d548",
        "inspection_id": "679997eb137fda6dd93e1547"
    },
    "message": "Solicitação criada com sucesso!",
    "code": 201,
    "success": true
}

Onde:

  • appraisal_id: Id da avaliação
  • inspection_id: Id da vistoria

Error response 500​

{
    "message": "Um erro desconhecido ocorreu ao tentar essa rota.",
    "code": 500,
    "success": false
}