Model & serial number fields in Snugg Pro

Snugg Pro will be reformatting the HVAC model and serial number fields for air conditioners and heat pumps. Currently, heat pumps have one field for heating model and serial number, and one field for cooling serial number. Air conditioners have one field each for model and serial number.

These fields were inadequate because heat pumps and air conditioners have an indoor model number for the A-coil and an outdoor model number for the compressor unit, and the indoor and outdoor units have their own serial numbers as well. Thus, we have added new fields with space to add both indoor and outdoor model and serial numbers for all air source heat pumps and air conditioners.

Central AC UI changes

Air source heat pump UI changes

There are two primary reasons for this change. The first is practical, as some pending programs utilizing Snugg Pro require collection of both indoor and outdoor model and serial numbers for air conditioners and heat pumps. Second, having both indoor and outdoor model numbers allow users to look up the system’s SEER and/or HSPF and improve the precision of modeling results in Snugg Pro.

The performance specifications for heat pumps and air conditioners are a result of the pairing of indoor and outdoor models. One indoor model may pair with dozens of outdoor models with many different efficiencies, and vice versa. By collecting both indoor and outdoor models, users can look up the performance specifications of that specific pairing in the AHRI database to obtain the correct SEER data for both heat pumps and air conditioners and HSPF for heat pumps. Obtaining and entering the precise SEER and HSPF will produce more accurate pre- and post-installation modeling results.

We recognize that many existing jobs already have data in the model and serial number fields. This update retains those numbers already entered. For air conditioners, the model and serial numbers have transferred to the indoor model and serial number fields. For heat pumps, the heating model and serial numbers have transferred to the indoor model and serial number fields; the cooling serial number has transferred to the outdoor serial number field.

We are implementing updates to our API that include field relocations as well as new fields being added. Below is a table outlining the current field mappings for the affected systems and JSON payloads for API users.

Field mapping table

Please note: All existing data in the “Current Fields” will remain populated after the update to ensure continuity and prevent any disruption to your existing integrations. The data will be duplicated in the Current Field and the New Field where applicable.

System	Current Field	New Field	UI Section and Field Name
Heat Pump	hvacHeatingSystemModel	hvacHeatingSystemIndoorModel	Heating-->Indoor Model #
Heat Pump	hvacHeatingSystemSerialNumber	hvacHeatingSystemIndoorSerialNumber	Heating-->Indoor Serial Number
Heat Pump	hvacCoolingSystemModel	hvacHeatingSystemOutdoorModel	Heating-->Outdoor Model #
Heat Pump	hvacCoolingSystemSerialNumber	hvacHeatingSystemOutdoorSerialNumber	Heating-->Outdoor Serial Number
Heat Pump	hvacHeatingSystemModelImproved	hvacHeatingSystemIndoorModelImproved	Improved Heating-->Indoor Model #
Heat Pump	hvacHeatingSystemSerialNumberImproved	hvacHeatingSystemIndoorSerialNumberImproved	Improved Heating-->Indoor Serial Number
Heat Pump	hvacCoolingSystemModelImproved	hvacHeatingSystemOutdoorModelImproved	Improved Heating-->Outdoor Model #
Heat Pump	hvacCoolingSystemSerialNumberImproved	hvacHeatingSystemOutdoorSerialNumberImproved	Improved Heating-->Outdoor Serial Number
Furnace/Central AC, or Central AC	hvacCoolingSystemModel	hvacCoolingSystemIndoorModel	Cooling-->Indoor Model #
Furnace/Central AC, or Central AC	hvacCoolingSystemSerialNumber	hvacCoolingSystemIndoorSerialNumber	Cooling-->Indoor Serial Number
Furnace/Central AC, or Central AC	N/A	hvacCoolingSystemOutdoorModel	Cooling-->Outdoor Model #
Furnace/Central AC, or Central AC	N/A	hvacCoolingSystemOutdoorSerialNumber	Cooling-->Outdoor Serial Number
Furnace/Central AC, or Central AC	hvacCoolingSystemModelImproved	hvacCoolingSystemIndoorModelImproved	Improved Cooling-->Indoor Model #
Furnace/Central AC, or Central AC	hvacCoolingSystemSerialNumberImproved	hvacCoolingSystemIndoorSerialNumberImproved	Improved Cooling-->Indoor Serial Number
Furnace/Central AC, or Central AC	N/A	hvacCoolingSystemOutdoorModelImproved	Improved Cooling-->Outdoor Model #
Furnace/Central AC, or Central AC	N/A	hvacCoolingSystemOutdoorSerialNumberImproved	Improved Cooling-->Outdoor Serial Number

JSON Payloads for API users

Here are the sample payloads with the new fields highlighted:

Payload for GET jobs/{jobId}/hvacs

[

{

"uuid": "214f5943-142b-423f-95f0-db34739fde2c",

"hvacSystemName": "Some text value",

"hvacSystemEquipmentType": "Boiler",

"hvacUpgradeAction": "Remove a system permanently",

"hvacHeatingEnergySource": "None",

"hvacHeatingEnergySourceImproved": "None",

"hvacHeatingIsCondensing": "Yes",

"hvacPercentOfTotalHeatingLoad": 82,

"hvacPercentOfTotalHeatingLoadImproved": 61,

"hvacHeatingCapacity": 48000,

"hvacHeatingCapacityImproved": 48000,

"hvacDuctLocation": "string",

"hvacDuctLocationImproved": "string",

"hvacDuctInsulation": "Fiberglass 1.25\"",

"hvacDuctInsulationImproved": "Duct Board 1.5\"",

"hvacDuctLeakageValue": 5317.73,

"hvacDuctLeakageValueImproved": 9885.18,

"hvacDuctEfficiency": 11,

"hvacDuctEfficiencyImproved": 58,

"hvacPercentOfTotalCoolingLoad": 14,

"hvacPercentOfTotalCoolingLoadImproved": 38,

"hvacCoolingCapacity": 24000,

"hvacCoolingCapacityImproved": 24000,

"hvacCoolingSystemEfficiency": 51.37,

"hvacCoolingSystemEfficiencyImproved": 55.54,

"hvacHeatingSystemEfficiency": 78,

"hvacHeatingSystemEfficiencyImproved": 78,

"hvacDuctLeakage": "15% - Somewhat leaky",

"hvacDuctLeakageImproved": "3% - Very tight",

"hvacCoolingSystemManufacturer": "Utica",

"hvacCoolingSystemManufacturerImproved": "Payne",

"hvacCoolingSystemModel": "Some text value",

"hvacCoolingSystemModelImproved": "Some text value",

"hvacCoolingSystemIndoorModel": "Some text value",

"hvacCoolingSystemIndoorModelImproved": "Some text value",

"hvacCoolingSystemModelYear": "1995",

"hvacCoolingSystemModelYearImproved": "1995",

"hvacHeatingSystemManufacturer": "Lennox",

"hvacHeatingSystemManufacturerImproved": "Daikin",

"hvacHeatingSystemModelYear": "1998",

"hvacHeatingSystemModelYearImproved": "1998",

"hvacHeatingSystemModel": "Some text value",

"hvacHeatingSystemModelImproved": "Some text value",

"hvacHeatingSystemIndoorModel": "Some text value",

"hvacHeatingSystemIndoorModelImproved": "Some text value",

"hvacDuctInsulationValue": 13.22,

"hvacDuctInsulationValueImproved": 6.63,

"hvacHeatPumpInverter": "No",

"hvacHeatPumpInverterImproved": "Yes",

"hvacCoolingSystemSerialNumber": "Some text value",

"hvacCoolingSystemSerialNumberImproved": "Some text value",

"hvacCoolingSystemIndoorSerialNumber": "Some text value",

"hvacCoolingSystemIndoorSerialNumberImproved": "Some text value",

"hvacCoolingSystemOutdoorModel": "Some text value",

"hvacCoolingSystemOutdoorModelImproved": "Some text value",

"hvacCoolingSystemOutdoorSerialNumber": "Some text value",

"hvacCoolingSystemOutdoorSerialNumberImproved": "Some text value",

"hvacHeatingSystemSerialNumber": "Some text value",

"hvacHeatingSystemSerialNumberImproved": "Some text value",

"hvacHeatingSystemIndoorSerialNumber": "Some text value",

"hvacHeatingSystemIndoorSerialNumberImproved": "Some text value",

"hvacHeatingSystemOutdoorModel": "Some text value",

"hvacHeatingSystemOutdoorModelImproved": "Some text value",

"hvacHeatingSystemOutdoorSerialNumber": "Some text value",

"hvacHeatingSystemOutdoorSerialNumberImproved": "Some text value",

"hvacHeatingSystemEquivalentFullLoadHours": 212.73,

"hvacHeatingSystemEquivalentFullLoadHoursImproved": 629.72,

"hvacCoolingSystemEquivalentFullLoadHours": 74.25,

"hvacCoolingSystemEquivalentFullLoadHoursImproved": 210.17,

"hvacHeatSavedMbtu": 95.42,

"hvacHeatSavedKwh": 752.76,

"hvacHeatSavedTherms": 162.2,

"hvacHeatSavedThermsGas": 66.53,

"hvacHeatSavedThermsPropane": 356.46,

"hvacHeatSavedThermsOil": 260.31,

"hvacHeatSavedThermsWood": 95.3,

"hvacHeatSavedThermsPellets": 804.76,

"hvacHeatSavedThermsCoal": 143.26,

"hvacHeatSavedThermsKerosene": 193.43,

"hvacCoolSavedMbtu": 931.02,

"hvacCoolSavedKwh": 639.46,

"hvacCoolSavedTherms": 576.58,

"hvacCoolSavedThermsGas": 524.67,

"hvacCoolSavedThermsPropane": 839.65,

"hvacCoolSavedThermsOil": 924.81,

"hvacCoolSavedThermsWood": 623.29,

"hvacCoolSavedThermsPellets": 263.29,

"hvacCoolSavedThermsCoal": 324.52,

"hvacCoolSavedThermsKerosene": 65.96,

"hvacSteadyStateEfficiency": 73,

"hvacSteadyStateEfficiencyImproved": 74,

"energyStarColdClimateHeatPump": 0,

"energyStarColdClimateHeatPumpImproved": 0,

"hvacCoolingSystemEfficiencyRatingUnit": "string",

"hvacCoolingSystemEfficiencyRatingUnitImproved": "string",

"hvacHeatingSystemEfficiencyRatingUnit": "string",

"hvacHeatingSystemEfficiencyRatingUnitImproved": "string",

"hvacHeatingMaintenanceStarRating": "2",

"hvacCoolingMaintenanceStarRating": null,

"customFields": [

{

"key": "unique_custom_field_key",

"valueAsString": "10.67",

"valueType": "decimal",

"description": "Approximate custom value",

"min": 0.05,

"max": 49,

"options": "string 1, string 2, string3"

}

]

}

]

Payload for POST jobs/hvac/{uuid}

{