Factor Manage

Map a factor to a utility resource

Sets which utility resource the factor's rows count under on the Utility page (a manual mapping, which the rule never overwrites, including when the factor is renamed or moved), or with null returns the factor to the rule mapping derived from its category and name. Factors of the organization's own libraries need the organization's write access, and every emission row using the factor is reclassified in the same transaction (200). Factors of public (shared) libraries are mapped for every organization at once: only Greentally platform staff holding the factor_library.write platform capability may do it (anyone else, and every API key, gets 403 PLATFORM_CAPABILITY_REQUIRED), a non-blank reason is required (400 without one), and the change is recorded in the platform audit trail with its before and after mapping (resource, source, library and factor name), the reason and the job. The mapping change commits at once (202) and the rows of every organization using the factor are reclassified in the background, one organization per transaction, by the returned job (GET /factor/utility-reclassify-jobs/{jobId}).

put/factor/entries/{entryId}/utility-resource

Path parameters

entryIdstring required

Request body

reasonstring

Why the mapping changes. Required and non-blank for a factor of a public library (recorded in the platform audit trail); ignored for the organization's own factors.

utilityResource'electricity' | 'natural_gas' | 'lpg' | 'heating_oil' | 'gas_oil' | 'diesel' | 'petrol' | 'water' | 'waste' | 'heat_steam' | 'other' required

Response

The factor with its new mapping, and how many rows were reclassified.

Changes

Changed in 1 of the 11 revisions of this API.1