Valoración

Cuatro herramientas de valoración. Se admiten pisos, casas y terrenos; la valoración exprés y el informe rechazan los inmuebles comerciales y los complejos residenciales con 422 business_rule; la estimación del alquiler también funciona para inmuebles comerciales.

Valoración exprés

POST /valuation/express: ámbito tools:valuation, al momento. Una llamada a la API más el precio de la valoración exprés.

curl -X POST https://developers.grem.capital/api/v1/valuation/express \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5b8c3f7e-2a71-4c55-8d0e-9f1a6b2c4d10" \
  -d '{"propertyCategory":"apartment","addressText":"Torstraße 12, Berlin","totalArea":64,"rooms":2,"currency":"EUR"}'

Respuesta:

Sin superficie o con una propertyCategory desconocida, 400 validation; inmuebles comerciales, 422 business_rule con code: commercial_unsupported.

Informe de valoración completo

POST /valuation/report: ámbito tools:valuation, trabajo. Un informe con análisis de mercado y PDF. Los campos obligatorios dependen de propertyCategory. Envíe solo los campos de su categoría: un campo de otra categoría (por ejemplo, houseLevels en un piso, parking en una casa) se rechaza con 400. Solo piso: livingArea, kitchenArea, bathrooms, ceilingHeight, floor, storeys, balcony, elevator, parking, houseType, apartmentType. Solo casa: houseLevels. Solo terreno: zoning. Casa y terreno: utilities.

curl -X POST https://developers.grem.capital/api/v1/valuation/report \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "propertyCategory": "apartment",
    "address": { "country": "Germany", "city": "Berlin", "street": "Torstraße", "streetNumber": "12" },
    "currency": "EUR", "language": "spa",
    "apartmentType": "Residential", "houseType": "panel",
    "totalArea": 64, "rooms": 2, "floor": 3, "storeys": 5,
    "balcony": true, "elevator": false, "condition": "good"
  }'

Respuesta 202: { "jobId": "...", "status": "processing", "state": "running" }. El trabajo terminado (GET /valuation/report/jobs/{id}) contiene:

Los inmuebles comerciales (también apartmentType Commercial o Industrial) se rechazan con 422 business_rule y code: commercial_unsupported; su alquiler se estima con POST /valuation/rent. Un complejo residencial (apartmentType: Complex): 422 con code: complex_unsupported; valore un piso o una casa del complejo.

PDF: GET /artifacts/v1/ai/appraisal/reports/{id}/pdf. Eventos: valuation.completed / valuation.failed.

Estimación del alquiler

POST /valuation/rent: ámbito tools:rent, al momento. Describa el inmueble con campos o pase el objectId de un inmueble propio o público.

curl -X POST https://developers.grem.capital/api/v1/valuation/rent \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"propertyCategory":"apartment","country":"Germany","city":"Berlin","totalArea":50,"rooms":2,"currency":"EUR"}'

Respuesta:

Sin superficie o ciudad, 400 con un detail como "Missing or invalid: totalArea".

Revisión de informe

POST /valuation/review: ámbito tools:review. Suba un informe de valoración (PDF, DOCX, DOC, RTF; hasta 40 MB): GREM lo lee y contrasta el valor con datos de mercado.

Cuerpo: multipart/form-data:

curl -X POST https://developers.grem.capital/api/v1/valuation/review \
  -H "Authorization: Bearer gsk_live_xxx" \
  -F "[email protected]" \
  -F "language=spa" -F "currency=EUR"

El documento se lee al momento. La respuesta 202 contiene jobId, status y state:

• action_required (status: need_confirm): extracted contiene los datos leídos del documento. Revíselos y confirme: POST /valuation/review/jobs/{id}/confirm (Trabajos y resultados). Tras confirmar, el trabajo pasa a running.
• failed (status: rejected): el documento no es un informe de valoración inmobiliaria.

El resultado terminado: GET /valuation/review/jobs/{id}; el informe de revisión: GET /artifacts/v1/ai/appraisal/reviews/{id}/report.pdf o report.docx. Eventos: review.completed / review.failed; el seguimiento por webhook empieza tras la confirmación.

Artículos relacionados

• Trabajos y resultados
• Errores
• Límites y cobro