{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/immo-spot-com/json-schema/immo-spot-com-dpe-schema.json",
  "title": "Dpe",
  "description": "Diagnostic de Performance Énergétique (DPE), issu de la base ADEME. Couvre logements existants, logements neufs et bâtiments tertiaires. Format DPE V3 (opposable). Un DPE est valide 10 ans.\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/Dpe",
  "type": "object",
  "properties": {
    "etiquette_dpe": {
      "type": [
        "string",
        "null"
      ],
      "description": "Étiquette DPE de A (très performant) à G (très énergivore)"
    },
    "etiquette_ges": {
      "type": [
        "string",
        "null"
      ],
      "description": "Étiquette GES (émissions de gaz à effet de serre) de A à G"
    },
    "conso_kwhep_m2_an": {
      "type": [
        "number",
        "null"
      ],
      "description": "Consommation énergétique en kWhEP/m²/an"
    },
    "emission_ges_kg_co2_m2_an": {
      "type": [
        "number",
        "null"
      ],
      "description": "Émissions de GES en kgCO₂/m²/an"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Type de DPE : logement-existant, logement-neuf ou tertiaire"
    },
    "modele_dpe": {
      "type": [
        "string",
        "null"
      ],
      "description": "Modèle de méthode de calcul DPE utilisé"
    },
    "version_dpe": {
      "type": [
        "string",
        "null"
      ],
      "description": "Version du logiciel DPE"
    },
    "methode_dpe": {
      "type": [
        "string",
        "null"
      ],
      "description": "Méthode d'application du DPE. Sur les logements, elle décide de la portée des montants absolus : `dpe immeuble collectif` et `dpe issu d'une étude thermique réglementaire RT2012 bâtiment : immeuble` chiffrent le bâtiment entier — frais annuels comme surface — quand les autres méthodes chiffrent un logement. Les consommations au m², elles, restent comparables dans tous les cas.\n"
    },
    "date_etablissement_dpe": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date d'établissement du DPE (YYYY-MM-DD)"
    },
    "date_fin_validite_dpe": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date de fin de validité du DPE (YYYY-MM-DD)"
    },
    "type_batiment": {
      "type": [
        "string",
        "null"
      ],
      "description": "Type de bâtiment : maison, appartement, immeuble…"
    },
    "secteur_activite": {
      "type": [
        "string",
        "null"
      ],
      "description": "Secteur d'activité pour les bâtiments tertiaires"
    },
    "annee_construction": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Année de construction du bâtiment"
    },
    "periode_construction": {
      "type": [
        "string",
        "null"
      ],
      "description": "Période de construction (tranche)"
    },
    "nombre_occupant": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Nombre d'occupants pris en compte dans le calcul DPE"
    },
    "surface_habitable_logement": {
      "type": [
        "number",
        "null"
      ],
      "description": "Surface habitable du logement en m²"
    },
    "surface_utile": {
      "type": [
        "number",
        "null"
      ],
      "description": "Surface utile en m² (bâtiments tertiaires)"
    },
    "surface_shon": {
      "type": [
        "number",
        "null"
      ],
      "description": "Surface hors œuvre nette en m²"
    },
    "adresse": {
      "type": [
        "string",
        "null"
      ],
      "description": "Adresse retenue par le géocodage BAN. C'est elle qui a produit la position du DPE, donc son rattachement à la parcelle ou à la zone interrogée — voir `geocodage`.\n"
    },
    "commune_insee": {
      "type": [
        "string",
        "null"
      ],
      "description": "Code INSEE de la commune, issu du géocodage et non de la déclaration : un DPE mal géocodé est rattaché à la commune où le point est tombé.\n"
    },
    "departement_insee": {
      "type": [
        "string",
        "null"
      ],
      "description": "Code INSEE du département"
    },
    "geocodage": {
      "$ref": "#/$defs/DpeGeocodage"
    },
    "type_energie_n1": {
      "type": [
        "string",
        "null"
      ],
      "description": "Énergie principale utilisée"
    },
    "frais_annuel_energie_n1": {
      "type": [
        "number",
        "null"
      ],
      "description": "Frais annuels estimés pour l'énergie principale, en euros. Montant absolu : sur un DPE établi à l'échelle de l'immeuble, il porte sur tout le bâtiment — voir `methode_dpe`.\n"
    },
    "type_energie_n2": {
      "type": [
        "string",
        "null"
      ],
      "description": "Deuxième énergie utilisée (si applicable)"
    },
    "frais_annuel_energie_n2": {
      "type": [
        "number",
        "null"
      ],
      "description": "Frais annuels estimés pour la deuxième énergie en euros"
    },
    "type_energie_n3": {
      "type": [
        "string",
        "null"
      ],
      "description": "Troisième énergie utilisée (si applicable)"
    },
    "frais_annuel_energie_n3": {
      "type": [
        "number",
        "null"
      ],
      "description": "Frais annuels estimés pour la troisième énergie en euros"
    }
  },
  "$defs": {
    "DpeGeocodage": {
      "type": "object",
      "description": "Comment ce DPE a été rattaché au périmètre demandé, et ce que vaut sa position.\nUn DPE ne porte aucune référence cadastrale : l'ADEME ne connaît du bien que l'adresse saisie par le diagnostiqueur, qu'elle fait géocoder par la BAN. C'est le point ainsi obtenu — et lui seul — qui rattache le diagnostic à une parcelle ou à une zone. Quand le géocodage se trompe, le DPE remonte sur un autre bien, parfois dans un autre département.\nLes deux adresses sont donc rendues : `adresse_declaree` est celle du terrain, `adresse_geocodee` celle qui a placé le point. `incoherent` signale les cas où elles se contredisent (3,8 % des DPE en base).\n",
      "properties": {
        "rattachement": {
          "type": "string",
          "description": "Mode de rattachement au périmètre demandé. Toujours `proximite_geographique` pour les DPE : aucune autre clé ne les relie à une parcelle.\n"
        },
        "adresse_declaree": {
          "type": [
            "string",
            "null"
          ],
          "description": "Adresse du bien telle que le diagnostiqueur l'a saisie, sans retraitement"
        },
        "code_postal_declare": {
          "type": [
            "string",
            "null"
          ],
          "description": "Code postal déclaré par le diagnostiqueur"
        },
        "commune_declaree": {
          "type": [
            "string",
            "null"
          ],
          "description": "Commune déclarée par le diagnostiqueur, en saisie libre"
        },
        "adresse_geocodee": {
          "type": [
            "string",
            "null"
          ],
          "description": "Adresse retenue par la BAN, celle qui a produit la position"
        },
        "score_ban": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Score de géocodage BAN, de 0 à 100. Fourni brut, sans interprétation : mesuré sur l'ensemble de la base, il ne distingue nettement que les scores supérieurs à 90 (0,4 % d'incohérences) et inférieurs à 40 (10,2 %) ; entre les deux le taux oscille entre 2,4 % et 5,9 % sans ordre net. Un score moyen n'indique donc pas une position douteuse.\n"
        },
        "incoherent": {
          "type": "boolean",
          "description": "`true` quand le code postal déclaré et le code postal géocodé se contredisent : la position du DPE est alors probablement fausse, et son rattachement avec elle.\n"
        },
        "avertissement": {
          "type": "string",
          "description": "Message à afficher à l'utilisateur, adapté selon `incoherent`"
        }
      }
    }
  }
}