Changelog

Here are the latest updates and improvements to the Alasco Public API.

2025-08-22

Changes: Add include parameter to buildings endpoint [ESG]

  • Added: include parameter to /buildings/ endpoint to retrieve energy certificates and building certificates.

2025-07-22

Changes: Cooling meters support in utilities API [ESG]

  • Added: COOLING enum to category attribute of utility meters (GET, POST, PATCH).
  • Added: cooling_system attribute to utility meters (GET, POST, PATCH).

2025-07-01

Changes: download annotated files for invoices and change orders [FinCon] [CapEx], upload invoices to an asset [CapEx]

  • Added: download-annotated endpoints for invoices and change orders. If there is no annotated file for the document, the original is downloaded instead.
  • Added: submit-invoice endpoint to upload invoices for a specified asset in state NEW and start the corresponding workflow.

2025-06-16

Changes: Bulk meter reading upsert endpoint [ESG]

  • Added: New endpoint to bulk upsert meter readings (POST).

2025-06-06

Changes: New filters for contractors endpoint

  • Added: Option to filter for contractors in a given project (FinCon only).
  • Added: Option to filter for contractors in a given asset (CapEx only).

2025-06-03

Changes: Added endpoint to update utility meters and improved error handling with codes in error response [ESG]

  • Added: New endpoint to update utility meters including error codes (PATCH).
  • Improved: Error codes for utility meter create endpoint (POST, communicated in code property of error response).

2025-05-15

Changes: introduce create contract endpoint, and improve update contract capabilities [CapEx, FinCon]

  • Added: new endpoint to create contracts
    • It is possible to provide base data, for instance name, description, and contract volume.
    • Contracts are always created in status DRAFT.
    • It is not possible to create recurring or multi-part contracts.
  • Improved: endpoint to update contracts
    • It is now possible to update the status, and relationships to contractor, contracting entity and measure (CapEx) or contract unit (FinCon).

2025-05-06

Changes: Support for tracking fine-grained data source information with Utility Data Batch Info object [ESG]

  • Added: New endpoint to Utility Data Batch Info objects for fine-grained data source & batch tracking for utility endpoints (POST).
  • Added: Ability to specify data source via batch_info_uuid field (optional) when creating meters, meter readings and consumption intervals.

2025-04-16

Changes: Bulk consumption interval API endpoint with error codes [ESG]

  • Added: Bulk consumption interval public API endpoint to create/edit consumption intervals (POST).
  • Added: Error codes for consumption interval create endpoint (communicated in code property of error response).

2025-04-03

Changes: some changes and new endpoint for custom fields [FinCon]

  • Improved: custom field definition endpoint
    • Now returns and additional unit attribute that can further specify decimal fields.
    • Instances with field type MONEY will now be returned as field type DECIMAL with unit CURRENCY.
  • Added: new endpoint to get custom field values for a project

2025-03-14

Changes: new endpoints for invoices, contracts and contractors [CapEx]

  • Added: endpoints to submit and update new invoices, and to register payment for an invoice
  • Added: endpoint to update contracts (basic data)
  • Added: endpoints to get and create contract documents
  • Added: endpoint to create and update contractors

2025-02-12

Changes: new endpoint to post a utility meter [ESG]

  • Added: new /utility-meters/ endpoint to create utility meter.

2025-01-24

Changes: new endpoint to post utility meter consumption [ESG]

  • Added: new /consumption-intervals/ endpoint to allow creating consumption for a utility meter.

2025-01-21

Changes: add more data to meters and buildings endpoints [ESG]

  • Improved: meters and buildings endpoints by adding external_id attribute.

2024-12-16

Changes: public release of version 1 of Public API for ESG [ESG]

  • Added: endpoints to retrieve buildings and meters, and two options to post meter readings.

2024-12-11

Changes: add cost element reporting capabilities to Reporting API [FinCon]

  • Added: endpoints for cost reporting structured by cost elements on account, contract unit and contract levels. Important: using a project filter is required for these endpoints.

2024-09-30

Changes: launch new public API gateway and developer portal [FinCon] [ESG] [CapEx]

  • Added: landing page and sections for the different product APIs to developer.alasco.de
  • Added: support for files larger than 10MB for all file endpoints.

2024-09-11

Changes: add more data to cost reporting endpoints [FinCon]

  • Improved: cost reporting endpoints by adding progress_reported, contractual_discounts, and contractual_cost_allocations attributes.

2024-08-30

Changes: introduce Paid Invoices that skip the workflow [FinCon] [CapEx]

  • Added: endpoints to create, update, and delete invoices directly in status PAID
    • Such invoices do not trigger a workflow and can be changed and deleted.
    • They count as paid invoices for all relevant features. It is possible to add additional documents to them. A coversheet is generated when creating the paid invoice.
    • Only invoices of type SINGLE are supported.
  • Added: financing data to the cost reporting endpoints.

2024-08-02

Changes: add more data to Contract endpoints [FinCon] [CapEx]

  • Improved: Contract GET endpoints by adding contract_type attribute.

2024-07-25

Changes: add endpoint to read contract terms of a contract [FinCon] [CapEx]

  • Added: an endpoint to the contractor resource to get the contract terms.

2024-05-24

Changes: support Tax Waiver for Contractor endpoints, get more details from Contracts and Change Orders [FinCon] [CapEx]

  • Added: support for setting a security number to the Contractor endpoints.
    • Setting it creates a related tax waiver object if none exists, and sets the tax_waiver_required attribute (app only) to TRUE. This requires the tax_authority and tax_id attributes to be set first.
    • Setting it empty sets the tax_waiver_required attribute (app only) to FALSE.
  • Added: new endpoints to upload and download tax waiver documents.
  • Improved: contract and change order endpoints by adding financial data.