RefrigerantTracking

Get leak tracking preferences

Shows refrigerant leak tracking preferences, including Commercial Refrigerant Trigger Rate, HVAC Trigger Rate, PM Leak Inspection NTE, and more, configured for the subscriber. <br />When the RefrigerationTracking feature flag is turned off for the subscriber, the method returns the default — EPA standard — values.

get/refrigeranttracking

Request

Query parameters

subscriberIdinteger required

Unique numeric identifier of the subscriber.

Response

Refrigerant tracking settings for the specified subscriber are in the response.

UnitsOfMeasurestring byte

Unit of measure for tracking refrigerant use. <br />The possible response values:  • 0: Pounds and decimals of pounds  • 1: Pounds and ounces  • 2: Kilograms and grams <br />Note: To use kilograms and grams as a unit of measure, turn on the RefrigerantSettingsEU feature flag.

SubscriberIdinteger

Unique numeric identifier of the subscriber.

InventoryLocationstring byte

Defines whether technicians can take refrigerant from any inventory location or from the locations in the technician's area only. <br />The possible response values:  • 0: Only in technician’s area  • 1: Any location

CalculationMethodstring byte

Preferred method of refrigerant leak calculation:  • 0: Annualized  • 1: Rolling Average <br />Check how each calculation method works in SCU.

ChargeThresholdnumber double

Minimum amount of refrigerant that a system can contain for leak tracking to occur. The charge threshold value is displayed in the specified unit of measure. Check the UnitsOfMeasure parameter value.

ComercialRefTriggerRatenumber double

Minimum percentage of the total system charge that can be lost before refrigerant tracking to occur. This rate is set for commercial refrigeration appliances. <br />It applies to asset types with the refrigerant use purpose set to Commercial Refrigeration.

IndustrialRefTriggerRatenumber double

Minimum percentage of the total system charge that can be lost before refrigerant tracking to occur. This rate is set for industrial refrigeration appliances. <br />It applies to asset types with the refrigerant use purpose set to Industrial Refrigeration.

HVACTriggerRatenumber double

Minimum percentage of the total system charge that can be lost before refrigerant tracking to occur. This rate is set for HVAC appliances. <br />It applies to asset types with the refrigerant use purpose set to Comfort Cooling (AC).

OthersTriggerRatenumber double

Minimum percentage of the total system charge that can be lost before refrigerant tracking to occur. This trigger rate is set for appliances that don’t fall under any of the following groups: commercial appliances, industrial appliances, HVAC appliances. <br />It applies to asset types with the refrigerant use purpose set to Other Types of Refrigerated Asset.

Yearlynumber double

Minimum threshold for annual leak inspections. The value defines the minimum system charge required to create an annual PM leak inspection work order if a leak has met or exceeded the EPA leak threshold. <br />Check the UnitsOfMeasure parameter value to see the corresponding unit of measure.

Quarterlynumber double

Minimum threshold for quarterly leak inspections. The value defines the minimum system charge required to create quarterly PM leak inspection work orders if a leak has met or exceeded the EPA leak threshold. <br />Check the UnitsOfMeasure parameter value to see the corresponding unit of measure.

RunCARBReportboolean

Refrigerant tracking preference that allows subscribers to run the California Air Resources Board report. <br />The possible response values:  • true: The CARB reporting is activated for the subscriber.  • false: The CARB reporting is deactivated for the subscriber. <br />Learn about the CARB reporting in SCU.

ComplianceAcknowledgmentForAllLeaksRefrigerantUseboolean

Compliance acknowledgement message that gets triggered for every reported leak or refrigerant use to confirm that a full inspection has been conducted. <br />The possible response values:  • true: The compliance acknowledgement message is enabled in the SC Provider mobile app, Service Automation, and Provider Automation.  • false: The compliance acknowledgement message is deactivated. <br />Note: The RefLeakInspectionAcknowledgementAll feature flag should be turned on.

DelayedSecondaryVerificationboolean

Allows subscribers to enforce a time delay between the initial and the secondary verifications when a leak event takes place. <br />The possible response values:  • true: Time delay is activated by the subscriber. The number of days is specified for each refrigerant type:    * HVACDelayDays    * IndustrialRefrigerationDelayDays    * CommercialRefrigerationDelayDays    * OtherTypesDelayDays  • false: Time delay is not enabled by the subscriber. <br />Note: The subscriber should have the RefrigerationTrackingDelayedSecondaryVerification feature flag enabled. <br />Read more about this feature in SCU.

LeakInspectionNTEnumber double

Default not-to-exceed (NTE) amount for all PM work orders generated for quarterly and annual follow-up leak inspections.

RefrigerationPriorityNamestring

Priority name for Planned Maintenance work orders that are automatically generated for follow-up leak inspections.

EmailNotificationEnableboolean

Allows subscribers to create an email notification that will be sent to the specified recipients when the amount of refrigerant added by a technician meets or exceeds the system total charge. <br />The possible response values:  • false: The email notification is not enabled by the subscriber.  • true: The email notification is enabled. The recipients and the message text are specified in the response. When the response value is true, check the EmailNotification object.

GenerateFollowUpWorkOrderstring byte

Defines whether a follow-up work order should be generated when there is an open leak, and the provider wants to close the original work order. <br />The possible response values:  • 0: No follow-up work orders should be generated. The work order cannot be closed and invoiced until the leak record is closed. The Never option is set by the subscriber for the Follow-Up Work Order setting in Refrigerant Tracking Admin.  • 1: A follow-up work order can be generated for the provider to close the leak record. The Open Leak option is set by the subscriber for the Follow-Up Work Order setting in Refrigerant Tracking Admin. <br />Note: If the Open Leak option is not available for the subscriber, try turning the RTMultiLeakFollowUp feature flag on.

Compliancestring

Shows the region to which the configured refrigerant tracking settings get applied, following the compliance requirements. <br />The possible response values:  • US: Refrigerant tracking compliance for the USA  • EU: Refrigerant tracking compliance for the European Union  • CA: Refrigerant tracking compliance for Canada

MaxLocCountinteger

Maximum number of locations where refrigerant tracking should be recorded. It relates to the RtLimitedAppliance parameter.

RtLimitedAppliancestring byte

Specifies whether refrigerant tracking should happen across all locations or at those where it’s required. <br />The possible response values:  • 0: Across all locations  • 1: For limited locations only <br />When the response returns 1, check the related MaxLocCount parameter to learn the max number of locations.

Settingsstring

Refrigerant tracking preferences configured for the subscriber.

RefrigerantTrackingProviderIdinteger

Unique numeric identifier of the provider who is assigned retrofit and retirement work orders, as well as work orders created in the event of adding a refrigerant part use record from the asset details page.

GenerateLeakInspectionOptionstring byte

Specifies which refrigerant types require PM leak inspection work orders: only ODS (Ozone Depleting Substance) refrigerant types or all refrigerant types. <br />The possible response values:  • 0: For all refrigerant types  • 1: For ODS refrigerant types

EnableCARBInspectionsboolean

Shows whether the subscriber has activated PM leak inspections for appliances tracked by CARB (California Air Resources Board). <br />The possible response values:  • true: PM leak inspections are enabled for appliances tracked by CARB. When the parameter is true, check the related parameters:    * DateFormat    * CalendarStartDate    * CalendarStartDateStr  • false: PM leak inspections are deactivated for appliances tracked by CARB.

DateFormatstring

Date format applied to the CalendarStartDate parameter.

CalendarStartDatestring date-time

Date that becomes a call date for all CARB leak inspection PM work orders. The date format is YYYY-MM-DDThh:mm:ss. <br />Check the EnableCARBInspections parameter for more information.

CalendarStartDateStrstring

Date that becomes a call date for all CARB leak inspection PM work orders. The date format is MMM DD, YYYY.

LeakInspectionPMGenerationAdvanceTimeframeinteger

Number of days to generate PM leak inspection work orders in advance upon identifying a leak. The default value is 7 days.

LeakInspectionPMGenerationAdvanceAppliedToExistingPMsstring byte
LeakInspectionCategoryIdinteger

Unique numeric identifier of the category for PM leak inspection work orders.

SCProviderMessageEnableboolean

Shows whether the subscriber has enabled the compliance acknowledgment message to be displayed for providers in the SC Provider mobile app. Providers receive the message when checking out of PM leak inspection work orders with at least one refrigerated asset. <br />The possible response values:  • true: The acknowledgement message is enabled.  • false: The acknowledgement message is deactivated. <br />Read about the related SCProviderMessage parameter to view the message text. <br />Note: The RefLeakInspectionAcknowledgement and RTMultiLeakFlow feature flags should be turned on.

ServiceAutomationMessageEnableboolean

Shows whether the subscriber has enabled the compliance acknowledgment message to be displayed for subscribers in Service Automation. The message appears when subscribers are entering leak verification information for PM leak inspection work orders with at least one refrigerated asset. <br />The possible response values:  • true: The message is enabled.  • false: The message is deactivated. <br />Check the related ServiceAutomationMessage parameter to view the message text. <br />Note: The RefLeakInspectionAcknowledgement and RTMultiLeakFlow feature flags should be turned on.

ProviderAutomationMessageEnableboolean

Shows whether the subscriber has enabled the compliance acknowledgment message to be displayed for providers in Provider Automation. The message is displayed when providers are entering leak verification information for PM leak inspection work orders with at least one refrigerated asset. <br />The possible response values:  • true: The acknowledgment message is enabled.  • false: The acknowledgment message is deactivated. <br />Check the related ProviderAutomationMessage parameter to view the message text. <br />Note: The RefLeakInspectionAcknowledgement and RTMultiLeakFlow feature flags should be turned on.

SCProviderMessagestring

Compliance acknowledgement message that is displayed for providers in SC Provider upon checking out of PM leak inspection work orders with at least one refrigerated asset. See the parent SCProviderMessageEnable parameter for more details.

ServiceAutomationMessagestring

Compliance acknowledgement message that is displayed for subscribers in Service Automation. Subscribers see the message when they are entering leak verification information for PM leak inspection work orders with at least one refrigerated asset.

ProviderAutomationMessagestring

Compliance acknowledgement message that is displayed for providers in Provider Automation. Providers see the message when they are entering leak verification information for PM leak inspection work orders with at least one refrigerated asset.

CertificationExceptionRecipientsstring

Email addresses of people to be notified whenever technicians specify that they don’t have the required trade certification/license while completing a refrigerant or HVAC work order via SC Provider. <br />Note: Available with the RefCertSCP feature flag.

GreenChillReportReceiptingboolean

Shows whether the subscriber has enabled GreenChill Report to use provided email address instead of default recipient email address. <br />Check the related 'GreenChillReportRecipientEmail' parameter to view the email address.

GreenChillReportRecipientEmailstring

Email Address that is displayed in GreenChill Report.

CertificationExceptionRecipientEmailsstring[]

Email addresses of people to be notified whenever technicians specify that they don’t have the required trade certification/license while completing a refrigerant or HVAC work order via SC Provider. Available with the RefCertSCP feature flag.

HVACDelayDaysinteger

Time delay between the initial and the secondary verifications for HVAC assets. Specified in days.

IndustrialRefrigerationDelayDaysinteger

Time delay between the initial and the secondary verifications for assets of the industrial refrigeration group. Specified in days.

CommercialRefrigerationDelayDaysinteger

Time delay between the initial and the secondary verifications for assets of the commercial refrigeration type. Specified in days.

OtherTypesDelayDaysinteger

Time delay between the initial and the secondary verifications for other types of assets that don’t fall under the industrial refrigeration, commercial refrigeration, or HVAC groups. Specified in days.

RefrigerationPriorityIdinteger

Changes

No recorded changes to this operation across all 1 revision of this API.