Versie 10.0.0 MplusKASSA API Service 10.0.0

Releasedatum:
11-04-2018

  • The function getShifts() now also returns the field reference.

  • New function deliverOrderV2 that enables you to create partial shipments. This makes it possible to create multiple packing slips of an order.

  • New function getPackingSlipsByOrder that returns the packing slip(s) of the given order.

  • It is now possible to retrieve related transaction details for EFT (or PIN) payments. You need to have the correct authorization to see this data. To find out which autorisation you have, you can check your Partner Page.

  • The API function getProducts now at most returns syncMarkerLimit number of articles instead of products. However, when the first product contains more than this limit of articles, this product will be returned completely. Otherwise the situation could occur wherein getProducts returns nothing at all.

  • The API function getProducts using a filter such as onlyActive and a syncMarker could fail to return some of the changed articles since the provided syncMarker. This could result in articles not being returned by getProducts.

  • The API function getButtonLayout now returns a lay-out based on the assumption that main groups are always shown above the sub groups and article buttons. As is the case with the Android app.

  • With every API call that has terminal as a parameter, the Last ping time will be also updated.

  • New functions for the management of proposals:

    • getProposals - retrieve list of proposals
    • getProposal - retrieve single proposal
    • saveProposal - save new proposal or change existing proposal
    • cancelProposal - cancel proposal, where possible
    • createOrderFromProposal - create order from proposal, where possible
    • createInvoiceFromProposal - create invoice from proposal, where possible
  • New function getArticleGroupChanges() that returns all changed article groups since the previous syncMarker. It is also possible to filter on specific groupNumbers. The difference between this function and the already existing getArticleGroups is that the latter returns article groups in their hierarchical structure, while the new function returns the article groups in a "flat" list. Use the parentGroupNumber property to determine where the changed article group should go.

  • It was possible for the VAT percentages of articles in the componentArticleList to be wrong. It was also possible that articles erroneously occured multiple times. This has been resolved.

  • The lines of receipts, orders and invoices now contain optional metadata related to Webhooks. These are the following optional properties:

    • line.webhookData.webhookLineId - The UUID of the line regel as communicated through the Webhooks.
    • line.webhookData.webhookConsumerId - (optional) The UUID of the Webhook Consumer (external application) if this line has been added by this external application.
    • line.webhookData.webhookExternalDiscount.discountId - (optional) The UUID of the discount if it has been added by a Webhook Consumer.
    • line.webhookData.webhookExternalDiscount.discountDescription - (optional) Description of the external discount if it was supplied.
    • line.webhookData.webhookExternalDiscount.webhookConsumerId - (optional) The UUID of the Webhook Consumer (external application) that added this discount.
    • line.webhookData.webhookExternalDiscount.discountPercentage - (optional) The externally applied discount percentage.
    • line.webhookData.webhookExternalDiscount.discountAmount - (optional) The externally applied discount amount.
  • New article properties:

    • article.course - Indicates to which course the article belongs, including name, abbreviaton and sequence number of the course.
    • article.specialPrice - Indicates whether the article has special price handling, such as "Free", "Ask price (positive)" or "Ask price (negative)".
    • article.showPreparationMethodsDirectly - Indicates whether the available preparation methods should be shown directly after selecting the article.
    • article.showPreparationMethodsPerGroup - Indicates whether the available preparation methods should be shown per group or all at once.
  • A sales order (order) now contains the properties onDeliveryUrl and onInvoiceUrl. The URL's that you supply here will be opened from MplusKASSA in the default browser at the moment that you create a packing slip or an invoice from the order.

  • A turnover group number (turnoverGroup) outside of the supported range (0-999) will now be refused.

  • After completing a request the API now takes much less time to get ready to accept the next request.