API Versioning and Deprecation Policy
interworks.cloud Platform API is versioned in order to provide maximum backwards-compatibility to external applications and allow for maximum flexibility for future expansion. From 3.21.1 release, all new platform customers (i.e. all new organizations that will be activated after 3.21.1 release in any cloud or on-premise installation of our platform) are required to include the 'X-Api-Version' header to all API requests.
Before 3.21.1 release, the definition of 'X-Api-Version' header was not necessary and API Version 1.0 was served as default version. We keep this functionality unaffected for the organizations created prior to 3.21.1 release in order not to cause any compatibility issues to our existing customers. But it is strongly advised to update you code and include the 'X-Api-Version' header to all API requests.
For more details, please check API Versioning and Deprecation Policy
Automatic Update of Sell Prices for a Country Tenant or a Tenant Reseller
You now have the option when you update your tenant to update also the sell prices of the products the reseller inherits from you. This option is available in the update tenant process.
- For the tenant reseller this is optional. The distributor can select if he wants for a tenant reseller to update the sell prices too.
- For the country tenant this is enforced automatically from our system. When a country tenant is updated, we always update the sell prices.
For more information, please check Applying Distributor Updates
Improvements in Integration Framework
In 3.21.1 release we included the following fields in supported JSON objects:
- In InvoiceItem object we added the SubscriptionID field that returns the ID of the related subscription.
- We included in ProductType object the attributes arrays.
For more details, please check interworks.cloud JSON Objects
New Fields for Invoice Items Report
In this release we expanded the list of available fields for the Invoice Item object. We included fields related with the subscription and the end customer of the invoice item. These fields will be very useful, especially for Microsoft CSPs, because they will be able to reconcile the charges produced by our platform with the charges they receive from Microsoft.
|Subscription External Id||This field returns the Id that is kept in the provisioning system for the subscription that was billed via the specific invoice item. For Office 365 services, this ID is the ID of the subscription in Microsoft partner center|
|Subscription ID||The internal ID we keep for the subscription record|
|End Customer Country||The country of the end customer that is using the service.|
Note: These fields are available only for the analytical invoice items. The aggregated items are related with more than one subscription or end customer and these fields will return null values.
|EXL-4600||Customer's available credit is not increased when the customer add a payment from Storefront's Billing section|
|EXL-5259||Integration framework - The fields CreatedAt, UpdatedAt of the OrderItem object do not have correct values|
|EXL-5421||Log error at Storefront user reset password|
|EXL-5402||The update tenant process fails if there are more than 2100 items in the pricelist|
|EXL-4376||The value suffix of a product type variation is not copied to tenant BSS during the update tenant process|
|EXL-4765||Pending Azure invoices with zero amount should be generated automatically after 20 days from subscription renewal date.|
|EXL-5371||The subscription amount of a subscription that is for a product billed via excel file is not calculated correctly because of the new currencies culture implementation|
|EXL-5371||The total of an index graph in reports is not displayed correctly because of the new currencies culture implementation|
|EXL-5364||Integration framework - OrderItem object is null in InvoiceItem Object|
|EXL-5396||Integration frameworks - unnecessary or duplicate messages for deletion actions are added in the queue|
|EXL-4857||The "last update" date for the "Get Services Definitions" action is not updated correctly and it remains the previous one.|
|SM-1093||Error message returned for add-on provisioning actions (create/update/cancel) are not getting displayed in Storefront|