Sign in

v1

latestOpenAPI 3.0.42026-08-064699207.1 KB
Solicitudes

Crea una solicitud

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).
  • 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 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' 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