Versie 10.0.0 MplusKASSA API Service 10.0.0

Releasedatum:
11-04-2018

  • De functie getShifts() retourneert nu ook de evt. inhoud van de "Betreft"-regel, via het veld reference.

  • Nieuwe functie deliverOrderV2 die het mogelijk maakt om deelleveringen te maken. Zo is het mogelijk om meerdere pakbonnen van een order te maken.

  • Nieuwe functie getPackingSlipsByOrder die de pakbon(nen) van de opgegeven order retourneert.

  • Het is nu ook mogelijk om bij een pinbetaling de gerelateerde transactiedetails op te vragen. Er moet wel autorisatie gegeven worden voor toegang tot deze gegevens. U kunt bekijken welke autorisatie u hebt op uw Partnerpagina.

  • De API-functie getProducts retourneert nu maximaal syncMarkerLimit aantal articles ipv. products. Echter, als het eerste product meer dan deze limiet aan articles bevat, dan zal dit product in zijn geheel geretourneerd worden. Anders kun je in de situatie terechtkomen waarin getProducts niets meer retourneert.

  • De API-functie getProducts icm. een filter zoals onlyActive en een syncMarker gaven niet altijd alle gewijzigde artikelen terug sinds de opgegeven syncMarker. Er konden artikelen overgeslagen worden in het resultaat.

  • De API-functie getButtonLayout retourneert nu een lay-out gebaseerd op de aanname dat hoofdgroepen altijd boven de subgroepen en artikelknoppen getoond worden. Zoals ook het geval is bij de Android app.

  • Bij elke API-functie die terminal als parameter heeft, wordt het Laatste ping tijdstip nu ook bijgewerkt.

  • Nieuwe functies voor het beheren van offertes:

    • getProposals - haal lijst van offertes op
    • getProposal - haal enkele offerte op
    • saveProposal - sla nieuwe offerte op of werk bestaande offerte bij
    • cancelProposal - annuleer offerte, indien mogelijk
    • createOrderFromProposal - maak order van offerte, indien mogelijk
    • createInvoiceFromProposal - maak factuur van offerte, indien mogelijk
  • Nieuwe functie getArticleGroupChanges() die elke gewijzigde artikelgroep teruggeeft sinds de vorige syncMarker. Het is ook mogeijk om te filteren op bepaalde groupNumbers. Het verschil met getArticleGroups is dat de laatstgenoemde de artikelgroepen in de hiërarchische structuur retourneert, terwijl deze nieuwe functie de artikelgroepen "plat" retourneert. Gebruik de parentGroupNumber om te bepalen waar de artikelgroep moet zitten.

  • Het was mogelijk dat de BTW-percentages van artikelen in de componentArticleList onjuist waren, ook konden artikelen onterecht meerdere keren voorkomen. Dit is opgelost.

  • De regels van kassabonnen, orders en facturen bevatten nu ook evt. metadata behorende bij Webhooks. Dit gaat om de volgende optionele eigenschappen:

    • line.webhookData.webhookLineId - De UUID van de regel zoals via de Webhooks gecommuniceerd.
    • line.webhookData.webhookConsumerId - (optioneel) De UUID van de Webhook Consumer (externe applicatie) indien deze regel door deze externe applicatie is toegevoegd.
    • line.webhookData.webhookExternalDiscount.discountId - (optioneel) De UUID van de korting als die via een Webhook Consumer is toegevoegd.
    • line.webhookData.webhookExternalDiscount.discountDescription - (optioneel) Omschrijving van de externe korting indien die bij het toevoegen is opgegeven.
    • line.webhookData.webhookExternalDiscount.webhookConsumerId - (optioneel) De UUID van de Webhook Consumer (externe applicatie) die deze korting heeft toegevoegd.
    • line.webhookData.webhookExternalDiscount.discountPercentage - (optioneel) Het extern toegepaste kortingspercentage.
    • line.webhookData.webhookExternalDiscount.discountAmount - (optioneel) Het extern toegepaste kortingsbedrag.
  • Nieuwe artikeleigenschappen:

    • article.course - Toont aan bij welke gang het artikel hoort, inclusief de naam, afkorting en volgnummer van de gang.
    • article.specialPrice - Geeft aan of er een speciale prijsafhandeling bij het artikel hoort, zoals "Gratis", "Vraagprijs (positief)" of "Vraagprijs (negatief)".
    • article.showPreparationMethodsDirectly - Geeft aan of de bereidingswijzen direct geopend moeten worden bij het selecteren van het artikel.
    • article.showPreparationMethodsPerGroup - Geeft aan of de bereidingswijzen per groep getoond moeten worden of allemaal in één keer.
  • Een verkooporder (order) bevat nu de eigenschappen onDeliveryUrl en onInvoiceUrl. De URL's die je hieraan meegeeft zullen in MplusKASSA geopend worden in de standaardbrowser op het moment dat je resp. een pakbon van de verkooporder maakt of een factuur.

  • Een omzetgroepnummer (turnoverGroup) buiten het ondersteunde bereik (0-999) wordt nu geweigerd.

  • Na het voltooien van een aanvraag is de API nu sneller gereed om de volgende aanvraag af te handelen.