MOmobiliagestion
Solicitudes

Crea una solicitud

Changed on

Crea una solicitud en la agencia con la información enviada y devuelve su información.

Notas:

  • Debe indicarse un email o un telefono (al menos uno de los dos).
  • La respuesta 200 devuelve la solicitud creada, incluida su referencia, que es el identificador a usar en las consultas posteriores (GET /solicitudes/{referencia}).
  • La creación es visible de forma inmediata mediante GET (consistencia de lectura tras escritura).
  • Puede crearse sin inmueble; para vincular inmuebles se envía la lista inmuebles con sus referencias.
  • Para vincular una promoción se envía promocion con su referencia (la referencia de la promoción, no su id interno).
  • Para vincular un cliente se envía referenciaCliente (la referencia del cliente, no su id interno).
  • idioma indica el idioma en el que se responde al solicitante (email de cortesía). Si no se indica, se usa el del cliente vinculado y, si tampoco lo hay, el español.
  • Los errores de validación devuelven 400 con el detalle por campo.
  • No se aplica deduplicación: dos peticiones idénticas crean dos solicitudes distintas.

Requisitos:

  • solicitudes_create
post/api/v1/solicitudes

Request

  • Base URL
    https://api.mobiliagestion.es (the document declares no server; this is the origin it was published from)
  • Auth
    API key in header Authorization

Request body

emailstring nullable

Correo electrónico del solicitante

nombrestring nullable required

Nombre completo del solicitante

telefonostring nullable

Número de teléfono del solicitante

mensajestring nullable

Mensaje o comentario enviado por el solicitante

idCampanainteger nullable

Id de la campaña

tipoOperacion'Venta' | 'Alquiler' | 'Traspaso'
estado'Sin_atender' | 'Atendido' | 'En_espera' | 'No_contesta' | 'Descartada' | 'Archivado' | 'Calificada_IA' | 'En_Proceso_IA' | 'Descartada_IA'
tipoSolicitud'Llamada' | 'Email' | 'VisitaInmobiliaria' | 'Web' | 'Otros' | 'API' | 'MetaAds' required
idAgenteinteger nullable

Id del agente que hace la petición

inmueblesstring[] nullable

Referencias de inmuebles a vincular: null = sin cambios; vacía = borra todas; con elementos = vincula las referencias.

promocionstring nullable

Referencia de la promoción a vincular: null = sin cambios; vacía = desvincula; con valor = vincula esa promoción.

referenciaClienteinteger nullable

Referencia del cliente a vincular

poblacionstring nullable

Poblacion de la solicitud

zonastring nullable

Zona de la solicitud

precioMaximostring nullable

Precio máximo de la solicitud

idioma'es' | 'ca' | 'de' | 'en' | 'eu' | 'fr' | 'gl' | 'it' | 'nl' | 'no' | 'pl' | 'pt' | 'ru' | 'sv' | 'uk'

Response

OK

Changes

  • d893803b00d5Revision changes
    • info

      added the optional property / to the response with the status

  • bb4b9d91fad8Revision changes
    • warning

      added the new MetaAds enum value to the / response property for the response status

    • info

      added the new MetaAds enum value to the request property (media type: application/json-patch+json)

    • info

      added the new MetaAds enum value to the request property (media type: application/json)

    • info

      added the new MetaAds enum value to the request property (media type: text/json)

    • info

      added the new MetaAds enum value to the request property (media type: application/*+json)

    • info

      added the optional property / to the response with the status