Changelog
Monta.comGuidesAPI ReferenceChangelog
Back to All

September 2023

12 months ago

2023-09-29

🚀 Feature

  • When creating a Subscription you can set discountPercentage and discountAbsolute
  • New endpoint for Charges at /charges/:id/breakdown to retrieve price and cost breakdown
  • New endpoints to manage Installer Jobs - they can be created, deleted, and retrieved
  • New Webhook entity added: Team Members - you can use this to get informed when a team member accepts their invite.
  • You can use the Webhook Config endpoint to limit webhooks to certain Event Types, currently:
    • charges
    • charge-points
    • sites
    • team-members
    • or provide * to get all entity changes delivered to your webhook endpoint
  • Added two new fields to Wallet Transactions:
    • kind: gives a hint about the reason for this transaction, ie. charge-sponsored, tax-refund, ...; Note that as of now we have 118 kinds and this list will grow over time. We will add more docs moving forward.
    • vatPercentage: the amount of VAT that was part of this transaction
  • Allow filtering Subscriptions by subscriptionPurchaseId. This allows you to find a subscription related to a wallet transaction with referenceType SUBSCRIPTION_PURCHASE and its referenceId
  • New endpoint to delete a Tariff Period Group
  • New endpoint to delete a Tariff Recurring Period
  • New endpoint to delete a Site
  • New endpoint to delete a Charge Point
  • Added currency as part of the Teams
  • Team Members have a new field `canRequestSponsoring which you can read/write
  • Webhooks are enabled for all existing and new consumers
  • Charges that you paid for can be obtained by using the new operatorRole filter on GET /charges with value payer
  • Added new fields to Charge Point model to determine its Price Groups
    • priceGroupId - id of the public price group
    • roamingPriceGroupId - id of the roaming price group
    • costPriceGroupId - id of the cost price group
    • sponsoredPriceGroupId - id of the sponsored price group
  • Added new endpoints to retrieve your Payment Terminals
  • Added new endpoints to retrieve your Subscription Purchases
  • Added new endpoints to retrieve and setup Charge Point Integrations
  • New Webhook entity added: Wallet Transaction - you can now get notified when a wallet transaction is created or updated.
  • New Webhook entity added: Subscription - you can use this to get informed when this entity is created or updated.
  • New Webhook entity added: Plan - you can use this to get informed when this entity is created or updated.
  • New Webhook entity added: Installer Job - you can use this to get informed when this entity is created or updated.
  • New Webhook entity added: Price Group - you can use this to get informed when this entity is created or updated.
  • New Webhook entity added: Team - you can use this to get informed when this entity is created or updated.
  • New Webhook entity added: Team - you can use this to get informed when this entity is created or updated.
  • Add new metadata section for Wallet Transactions metadata section will used to enrich transactions with either Charge or Tax Refund data.
  • Added granular scopes: you can now specify not only the entities accessible by a consumer but also if they can read, write, or delete (read more)
  • From now onwards, it is possible to patch the Team owner via Api
  • Exposing the chargePointKw for the Charges response.
  • chargePointIds are not mandatory anymore for patching a Team Members
  • Exposing the serialNumber for Sponsored Charge Points responses.

🐛 Fix

  • Fixed connectorId is not mandatory to create Charge Point Integrations anymore.
  • Add a new flag called autoConnectto allow setting up Charge Point Integrations without having to point the Charge Point to Monta
  • Fixed issue when setting up Charge Point Integrations the connectorId was being set to 0 instead of 1 when not provided.
  • Sorting Charge Points and Sites by location now allows negative latitude and longitude.

2023-09-19

🚀 Feature

  • When creating a Subscription of type tax-refund you can modify payoutPerKwh and priceIncludesVAT field.

🐛 Fix

  • Update Plans and Subscription models
  • Fixed fromDate/toDate filter for Wallet Transactions
  • Add endDayOfWeek to Tariff Recurring Period

2023-09-14

🚧

Deprecation Note

  • We have deprecated operatorId field on Team models. Use the new field operator instead. The old field will be removed by 01.12.23.
  • We have deprecated maxKW field on various model. Use the new field maxKw instead. The old field will be removed by 01.12.23.

🚀 Feature

  • Introduced endpoints for listing and retrieving Sponsored Charge Points
  • Added endpoints for listing and retrieving Plans
  • Implemented endpoints for creating, updating, canceling, and fetching Subscriptions
  • Added support for specifying multiple days for Tariffs Recurring Periods
  • Charge Auth Tokens Added support for the following fields when creating or updating:
    • userId
    • teamId
    • montaNetwork
    • roamingNetwork
    • activelUntil
  • Price Groups
    • New endpoint to set a default price group
    • New endpoint to apply a price group to Team Members, Charge Points, and Sites
    • Added the ability to specify a from/to dates for a fee
    • Price groups now support multiple tariffs
  • Webhooks
    • Expanded webhook support for Charge Points and Sites
    • Charges events will also be triggered when the charge was paid by the operator

🐛 Bugs

  • Fixed display name missing for team members on the charges endpoint

📝 Docs

  • Updated and added API documentation for Price Groups, Subscriptions, Sponsored Charge Points, and more