Offres Neuf by M2

Recherche des logements neufs (lots) dans le catalogue des programmes partenaires de M2, et les affiche sous forme de cartes. Utiliser dès qu'un acquéreur décrit un projet : ville, typologie (T2, T3...), budget, surface, extérieur (terrasse, balcon...), date de livraison, promoteur. Par défaut seuls les lots disponibles sont renvoyés, triés par prix croissant. Chaque lot porte un indicateur de fraîcheur : si `reliability` vaut `low`, prévenir l'utilisateur que la disponibilité doit être confirmée (check_availability). Ne jamais inventer de logement absent des résultats. Ne jamais retirer ni assouplir un critère de l'acquéreur de sa propre initiative : en l'absence de résultat, présenter les pistes d'élargissement renvoyées (`relaxations`) et laisser l'acquéreur choisir. Les cartes sont affichées directement à l'utilisateur : ne pas recopier la liste dans la réponse.

{
  "type": "object",
  "properties": {
    "city": {
      "description": "Ville recherchée, ex. « Lyon ».",
      "type": "string"
    },
    "district": {
      "description": "Arrondissement (Paris, Lyon, Marseille), ex. 7 pour Lyon 7e.",
      "type": "integer"
    },
    "promoter": {
      "description": "Nom ou identifiant (`slug`) du promoteur, ex. « LNC ». Voir list_promoters.",
      "type": "string"
    },
    "unit_types": {
      "description": "Typologies acceptées.",
      "items": {
        "enum": [
          "studio",
          "T1",
          "T2",
          "T3",
          "T4",
          "T5",
          "house"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "min_price": {
      "description": "Prix TTC minimum en euros.",
      "type": "integer"
    },
    "max_price": {
      "description": "Prix TTC maximum en euros (budget).",
      "type": "integer"
    },
    "min_area": {
      "description": "Surface habitable minimum en m².",
      "type": "number"
    },
    "outdoor_spaces": {
      "description": "Types d'extérieur acceptés.",
      "items": {
        "enum": [
          "terrace",
          "balcony",
          "loggia",
          "garden"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "min_outdoor_area": {
      "description": "Surface minimum de l'extérieur en m².",
      "type": "number"
    },
    "latest_delivery_date": {
      "description": "Date de livraison maximale (AAAA-MM-JJ). « Livrable en 2027 » → 2027-12-31.",
      "format": "date",
      "type": "string"
    },
    "incentive": {
      "description": "Dispositif d'aide ou fiscal éligible.",
      "enum": [
        "ptz",
        "reduced_vat",
        "lmnp"
      ],
      "type": "string"
    },
    "include_unavailable": {
      "description": "Inclure les lots optionnés, réservés ou vendus. Faux par défaut.",
      "type": "boolean"
    },
    "limit": {
      "description": "Nombre maximum de lots renvoyés (1 à 20, 6 par défaut).",
      "type": "integer"
    }
  }
}

Renvoie la fiche complète d'un lot : surface, étage, extérieur, orientation, parking, plan, prix, statut et fraîcheur de la donnée, ainsi que le programme (adresse, livraison, prestations, points forts, dispositifs éligibles). Utiliser quand l'acquéreur veut « voir le détail » d'un logement.

{
  "type": "object",
  "properties": {
    "lot_id": {
      "description": "Identifiant du lot (champ `id` renvoyé par search_lots).",
      "type": "integer"
    }
  },
  "required": [
    "lot_id"
  ]
}

Renvoie la présentation d'un programme immobilier neuf (promoteur, localisation, description, livraison, prestations, points forts, dispositifs éligibles) et la liste de ses lots disponibles. Utiliser quand l'acquéreur s'intéresse à une résidence dans son ensemble plutôt qu'à un lot précis.

{
  "type": "object",
  "properties": {
    "program_id": {
      "description": "Identifiant du programme (champ `program.id` d'un lot).",
      "type": "integer"
    }
  },
  "required": [
    "program_id"
  ]
}

Affiche un tableau comparatif de 2 à 4 lots (prix, surface, extérieur, étage, livraison, points forts, statut et fraîcheur). Pour formuler une recommandation, renseigner `recommended_lot_id` avec le lot le plus adapté au projet exprimé par l'acquéreur (résidence principale, investissement, budget…) et `reasons` avec 2 à 4 justifications courtes, fondées uniquement sur les données des lots comparés. La recommandation est mise en évidence dans le tableau. Le tableau se termine par un formulaire de mise en relation (nom, e-mail, téléphone, projet, créneau, message) qui transmet directement la demande au conseiller : ne pas redemander ces informations dans la conversation, inviter l'acquéreur à utiliser le formulaire. Le tableau est affiché directement à l'utilisateur : ne pas le recopier dans la réponse.

{
  "type": "object",
  "properties": {
    "lot_ids": {
      "description": "Identifiants des lots à comparer, dans l'ordre d'affichage.",
      "minItems": 2,
      "maxItems": 4,
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "recommended_lot_id": {
      "description": "Identifiant du lot recommandé pour le projet de l'acquéreur (optionnel).",
      "type": "integer"
    },
    "reasons": {
      "description": "Raisons courtes justifiant la recommandation, ex. « Un bon équilibre entre prix, surface et terrasse ».",
      "maxItems": 4,
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "lot_ids"
  ]
}

Vérifie le statut commercial actuel (`available` disponible, `on_hold` optionné, `reserved` réservé, `sold` vendu) d'un ou plusieurs lots, avec la date de dernière mise à jour transmise par le promoteur et un indice de fiabilité (`high` < 24 h, `medium` < 72 h, `low` au-delà). Utiliser avant de recommander un lot ou de proposer une mise en relation, et quand l'acquéreur demande si un logement est toujours disponible.

{
  "type": "object",
  "properties": {
    "lot_ids": {
      "description": "Identifiants des lots à vérifier.",
      "minItems": 1,
      "maxItems": 20,
      "items": {
        "type": "integer"
      },
      "type": "array"
    }
  },
  "required": [
    "lot_ids"
  ]
}

Liste les promoteurs partenaires de M2 présents dans le catalogue, avec leur nombre de programmes et de lots disponibles. Utiliser pour identifier un promoteur cité par l'acquéreur avant de filtrer search_lots.

{
  "type": "object",
  "properties": {}
}

Transmet une demande de mise en relation avec un conseiller commercial du promoteur, à propos d'un lot ou d'un programme. N'appeler qu'après accord explicite de l'acquéreur, avec les coordonnées qu'il a lui-même fournies dans la conversation (ne jamais les inventer). Le conseiller recontacte l'acquéreur ; aucun rendez-vous n'est confirmé par cet outil.

{
  "type": "object",
  "properties": {
    "lot_id": {
      "description": "Lot concerné. Requis si program_id est absent.",
      "type": "integer"
    },
    "program_id": {
      "description": "Programme concerné. Requis si lot_id est absent.",
      "type": "integer"
    },
    "name": {
      "description": "Nom et prénom de l'acquéreur.",
      "type": "string"
    },
    "email": {
      "description": "E-mail de l'acquéreur.",
      "format": "email",
      "type": "string"
    },
    "phone": {
      "description": "Téléphone de l'acquéreur.",
      "type": "string"
    },
    "purpose": {
      "description": "Nature du projet d'achat.",
      "enum": [
        "primary_residence",
        "secondary_residence",
        "investment"
      ],
      "type": "string"
    },
    "message": {
      "description": "Contexte utile au conseiller (critères, questions, financement…).",
      "type": "string"
    },
    "preferred_callback_time": {
      "description": "Disponibilités de l'acquéreur pour être rappelé, ex. « mardi après-midi ».",
      "type": "string"
    },
    "budget": {
      "description": "Budget d'achat TTC en euros, s'il a été exprimé par l'acquéreur.",
      "type": "integer"
    },
    "incentive": {
      "description": "Dispositif envisagé par l'acquéreur (PTZ, TVA réduite, LMNP), s'il l'a mentionné.",
      "enum": [
        "ptz",
        "reduced_vat",
        "lmnp"
      ],
      "type": "string"
    },
    "channel": {
      "description": "Origine de la demande : `conversation` (défaut) ou `comparison_form` (formulaire du comparatif).",
      "enum": [
        "comparison_form",
        "conversation"
      ],
      "type": "string"
    }
  },
  "required": [
    "name",
    "email"
  ]
}