{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/immo-spot-com/json-schema/immo-spot-com-audit-energetique-schema.json",
  "title": "AuditEnergetique",
  "description": "Audit énergétique, issu de la base ADEME (dataset \"audit-opendata\"). Un audit évalue un état initial puis un ou plusieurs scénarios de travaux de rénovation : chaque scénario est une entrée distincte, toutes rattachées au même audit via `n_audit`.\n",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/immo-spot-com-api-openapi.yml#/components/schemas/AuditEnergetique",
  "type": "object",
  "properties": {
    "n_audit": {
      "type": [
        "string",
        "null"
      ],
      "description": "Identifiant de l'audit — commun à toutes les entrées (état initial et scénarios) d'un même audit"
    },
    "categorie_scenario": {
      "type": [
        "string",
        "null"
      ],
      "description": "Catégorie de l'entrée au sein de l'audit"
    },
    "etape_travaux": {
      "type": [
        "string",
        "null"
      ],
      "description": "Étape ou combinaison de travaux évaluée par ce scénario"
    },
    "numero_dpe": {
      "type": [
        "string",
        "null"
      ],
      "description": "Numéro du DPE associé à l'audit, le cas échéant"
    },
    "classe_bilan_dpe": {
      "type": [
        "string",
        "null"
      ],
      "description": "Classe DPE résultant du bilan (A à G) pour ce scénario"
    },
    "etiquette_ges": {
      "type": [
        "string",
        "null"
      ],
      "description": "Étiquette GES (émissions de gaz à effet de serre) de A à G"
    },
    "date_etablissement_audit": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date d'établissement de l'audit (YYYY-MM-DD)"
    },
    "date_reception_audit": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date de réception de l'audit par l'ADEME (YYYY-MM-DD)"
    },
    "conso_5_usages": {
      "type": [
        "number",
        "null"
      ],
      "description": "Consommation énergétique totale (5 usages) en kWhEP/an pour ce scénario"
    },
    "conso_5_usages_m2": {
      "type": [
        "number",
        "null"
      ],
      "description": "Consommation énergétique (5 usages) en kWhEP/m²/an pour ce scénario"
    },
    "emission_ges_5_usages_m2": {
      "type": [
        "number",
        "null"
      ],
      "description": "Émissions de GES (5 usages) en kgCO₂/m²/an pour ce scénario"
    },
    "cout_5_usages": {
      "type": [
        "number",
        "null"
      ],
      "description": "Coût annuel estimé (5 usages) en euros pour ce scénario"
    },
    "cout_travaux": {
      "type": [
        "number",
        "null"
      ],
      "description": "Coût des travaux de ce scénario, en euros"
    },
    "couts_cumules_travaux": {
      "type": [
        "number",
        "null"
      ],
      "description": "Coût cumulé des travaux depuis l'état initial jusqu'à ce scénario, en euros"
    },
    "gain_financier_travaux": {
      "type": [
        "number",
        "null"
      ],
      "description": "Gain financier annuel estimé apporté par ce scénario, en euros"
    },
    "gain_financier_cumule": {
      "type": [
        "number",
        "null"
      ],
      "description": "Gain financier annuel cumulé depuis l'état initial, en euros"
    },
    "travaux_realises": {
      "type": [
        "string",
        "null"
      ],
      "description": "Liste en texte libre des travaux déjà réalisés"
    },
    "annee_construction": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Année de construction du bâtiment"
    },
    "periode_construction": {
      "type": [
        "string",
        "null"
      ],
      "description": "Période de construction (tranche)"
    },
    "surface_habitable_logement": {
      "type": [
        "number",
        "null"
      ],
      "description": "Surface habitable du logement en m²"
    },
    "typologie_logement": {
      "type": [
        "string",
        "null"
      ],
      "description": "Typologie du logement (T1, T2, maison…)"
    },
    "adresse": {
      "type": [
        "string",
        "null"
      ],
      "description": "Adresse du logement (BAN si géocodée, sinon adresse brute source)"
    },
    "code_postal": {
      "type": [
        "string",
        "null"
      ],
      "description": "Code postal brut source"
    },
    "commune_insee": {
      "type": [
        "string",
        "null"
      ],
      "description": "Code INSEE de la commune"
    },
    "departement_insee": {
      "type": [
        "string",
        "null"
      ],
      "description": "Code INSEE du département"
    },
    "type_energie_principale_chauffage": {
      "type": [
        "string",
        "null"
      ],
      "description": "Énergie principale utilisée pour le chauffage"
    },
    "type_energie_principale_ecs": {
      "type": [
        "string",
        "null"
      ],
      "description": "Énergie principale utilisée pour l'eau chaude sanitaire"
    }
  }
}