Starstruk Logo MarkStarstruk

v1.7.0

getlago/lagov1.7.0Jul 16, 2024by vincent-pochet

AI Summary

A major API upgrade focusing on the removal of the deprecated 'groups' system in favor of a new 'filters' dimension system, along with mandatory external subscription IDs for events.

Key Highlights

  • Replaced the deprecated 'groups' dimension system with a new 'filters' system.
  • Marked external_subscription_id as mandatory for event ingestion to enable real-time billing.
  • Removed deprecated API fields to preserve API quality.
  • Added ClickHouse pre-aggregation configuration.

Breaking Changes

  • Removed the deprecated group handling system.
  • Events without external_subscription_id are now ignored.
  • Several legacy API fields have been permanently removed.

New Features

  • Sync invoice with Xero.
  • Add ClickHouse pre-aggregation config.
  • Add logic for creating applied taxes based on external provider.

Full Release Notes

## :warning:  **Reminder: API changes**

As announced a few months ago, this release updates the event ingestion process and removes deprecated API fields.
Changes include:

### :one: Replacing groups with filters
The new dimension system based on filters is already available. It allows users to create billable metrics with more than two dimensions, and makes it easier to create charges based on custom event properties. The former dimension system based on groups is now permanently removed from the Lago API ([see all changes](https://docs.getlago.com/guide/migration/migration-to-v1.2.0#1-transition-from-group-to-filters)).

### :two: Marking  external_subscription_id as mandatory for events
Events that only include external_customer_id will no longer be taken into account when aggregating usage ([learn more](https://docs.getlago.com/guide/migration/migration-to-v1.2.0#2-mandatory-external-subscription-id-field-in-event-payloads)). This change will streamline the event validation process and enable real-time billing capabilities.

### :three: Removing deprecated API fields
For the sake of clarity and to preserve the quality of the API, we’ve deprecated several legacy fields ([see full list](https://docs.getlago.com/guide/migration/migration-to-v1.2.0#3-deprecated-fields)).

:point_right: [Migration to v1.2.0 (full post)](https://docs.getlago.com/guide/migration/migration-to-v1.2.0)

____

## Front changes
* feat: sync invoice with Xero by @ansmonjol in https://github.com/getlago/lago-front/pull/1606
* bug: prevent chain form update by @ansmonjol in https://github.com/getlago/lago-front/pull/1608


**Full Changelog**: https://github.com/getlago/lago-front/compare/v1.6.4...v1.7.0

## API changes
* feat(event): Add clickhouse pre-aggregation config by @vincent-pochet in https://github.com/getlago/lago-api/pull/2252
* misc: Remove deprecated group handling by @vincent-pochet in https://github.com/getlago/lago-api/pull/2257
* misc: Remove deprecated API fields by @vincent-pochet in https://github.com/getlago/lago-api/pull/2261
* misc: Force external_subscription_id when creating events by @rsempe in https://github.com/getlago/lago-api/pull/2270
* feat(applied-taxes): add logic for creating applied taxes based on external provider by @lovrocolic in https://github.com/getlago/lago-api/pull/2267


**Full Changelog**: https://github.com/getlago/lago-api/compare/v1.6.4...v1.7.0

## What's Changed
* misc(version): Bump to v1.7.0 by @vincent-pochet in https://github.com/getlago/lago/pull/381


**Full Changelog**: https://github.com/getlago/lago/compare/v1.6.4...v1.7.0