Bugfix voor foutmelding database error on server met de getOrders call.

Bugfix aan de placeTableOrder call, wanneer je alleen een relatie opgeeft wordt deze nu wel aan de tafel gekoppeld.

getOrderHistory stuurt nu ook de aanbetalingen op.

Uitbreiding van de Api call GetOrderHistory: Bij orderregels is er extra informatie toegevoegd voor samengestelde artikelen en artikelen met bereidingswijze(n): id van de hoofd_regel en subregel aantal en type)

Uitbreiding van de API call GetOrderHistory: element 'orderPaymentList' toegevoegd welke de lijst van de betalingen (inclusief teruggave en afrondingen) op de order bevat.

Uitbreiding van de Api call GetOrderHistory: element 'discountDescription' toegevoegd met de (gewijzigde) kortingsomschrijving ( sales en acties omschrijving)

getOrderHistory call geeft nu de hele order terug(meerdere dagen) als het datum of syncmarker filter de order selecteert.

Voor de api calls getPackingSlips, getInvoice en getInvoices hebben een nieuwe reponse parameter costCenter erbij gekregen.

Deze bevat de waarde die in POS doormiddel van de vraag om kostenplaats toegevoegd is aan de pakbon van de factuur.

Opgelost dat getProducts alleen actieve artikelen teruggeeft als onlyWebshop op true staat, ondanks dat onlyActive op false staat.

Een geannuleerde externe webhookbetaling wordt nu niet meer apart aan de gekoppelde webhook endpoint gemeld, aangezien de externe endpoint in principe degene is die de annulering heeft geïnitieerd. Dit brengt het gedrag van de API ook in lijn met dat van de Q-line.

getPurchaseOrdersV2 geeft nu ook deliveredQuantity terug wanneer een inkoopopdracht door middel van purchaseOrderNumber of extPurchaseOrderId opgevraagd wordt

Via de setRelationPresence kan een tafel met alleen een relatie erop, nu ook naar een tafel met bestelling zonder relatie erop verplaatst worden.

De getInvoices, getReceipts en getOrders geven nu ook het tijdstip van de betaling terug in de paymentList.

Fix voor savePurchaseOrderV2, je kon de regels niet meer wijzigen nadat de opdracht de state PURCHASE-ORDER-STATE-SUPPLIER-RECEIVED heeft bereikt.

Fix uit V53 toegepast op V52

• Fix voor savePurchaseOrderV2, je kon de regels niet meer wijzigen nadat de opdracht de state PURCHASE-ORDER-STATE-SUPPLIER-RECEIVED heeft bereikt.

AddressType verwijderd uit de api definitie. Deze was niet in gebruik, maar gaf wel problemen voor code generatie tools op basis van de wsdl

placeTableOrder en diverse andere routines slaan nu de meegegeven webhookSessionId op bij de order.

De functie placeTableOrder heeft nu ook de mogelijkheid om activityId mee te geven. Als je dit niet doet, wordt gekeken naar de huidige activiteit van de meegegeven werkplek. Zolang je niet zelf expliciet een priceIncl meegeeft, zullen de prijzen behorende bij de activiteit overgenomen worden.

De functie determinePricing maakt nu ook daadwerkelijk gebruik van een evt. meegegeven activityId. Als je deze niet meegeeft, wordt gekeken naar de huidige activiteit van de werkplek.

Standaard houdt getButtonLayoutForBranch nu ook rekening met de ingestelde snelknoppen van de huidige activiteit van de gevraagde werkplek. Dit gedrag kan overschreven worden door gebruik van de eigenschap ignoreCurrentActivity.

De functie getArticlesInLayout retourneert bereidingswijzegroepen voortaan alleen nog maar als het vinkje "POS groep" aan staat.

De functie placeTableOrder ondersteunt nu ook het doorgeven van lineType.

De tafellijst die je kunt opvragen via alle relevante versies van getTableList retourneert nu geen subtafels meer als de kassa in de Q-line die ook niet zou tonen.

Toegevoegd:

• PreparationMethodSimple.specialPrice, PreparationMethodSimple.turnoverGroup.
• ComponentArticleSimple.turnoverGroup.
• ArticleSimple.turnoverGroup.

Ter ondersteuning van de nieuwe filiaal specifieke waarden en van wegwerpartikelen.

API Service, getOrderHistory: de tafel- en subnummer gegevens van tafels 'gesplitst naar' en 'gesplitst van' ontbraken in de response van getorderHistory, deze zijn nu (weer) toegevoegd. Het order-id en de versie werden al wel doorgegeven.

API: getorderhistory: Er is een nieuw veld 'TableOrderNumber' toegevoegd om in de response de bestelnummers van tafelorders te kunnen rapporteren.

Fix MplusQAPIService: Kortingsinformatie aangevuld in getOrderHistory zodat nu ook de gewijzigde kortingswaardes (percentage, bedrag, etc) worden gerapporteerd.

Nieuwe api calls getArticleBranchDeviations en saveArticleBranchDeviations toegevoegd deze kunnen worden gebruikt voor het opvragen en bijwerken van de filiaal specifieke waarden van een artikel.

De API calls getOverview en getArticlesInLayout geven nu de filiaal specifieke omschrijving, brutoprijs, verkoopprijs en speciale prijs terug, mits er een filiaal is meegegeven met de call.

Als je webhook korting doorgeeft aan oa placeTableOrder zullen de automatische kortingen nu niet meer deze korting resetten.

Lost probleem op waardoor je met de placeTableOrder call op een slave api geen tafel kon afrekenen als er regels met BPE opstonden.

Lost probleem op dat placeTableOrder op slave een error geeft als er met BPE gewerkt wordt en hij de BPE budgetten niet kan uploaden naar de master omdat de configuratie van de master niet bekend is (master offline handelde hij wel al goed af).

placeTableOrder verwerkt nu ook weer numberOfGuests en tableDescription als er geen lines meegegeven worden. Note voor numberOfGuests moet er wel een niet leeg order zijn.

Als je géén relationNumber meegeeft aan placeTableOrder, dan blijft de geselecteerde relatie van de order ongewijzigd. Als je de relatie wilt wissen, moet je relationNumber=0 meegeven.

Als je een tafel afrekent waardoor er geen openstaande tijdelijke subtafels meer overblijven, worden nu alle tijdelijke subtafels weer opgeruimd.

Er wordt nu naar standaard error output gelogd als er geen logging configuratie is.

Wanneer je winsw gebruikt zal de log dan in winsw.err.log komen.

placeTableOrder zal nu ook zorgen dat een evt. geclaimde tafel weer vrijgegeven wordt.

Lost probleem op dat wanneer de API een webhook verstuurd er een nul character in de versionNumber veld van de Sender zit.

Note CloudEFT heeft hier last van.

Het onderdrukken van wegwerpverpakkingen in de placeTableOrder en determinePricing call werkte nog niet goed.

• Hij laat nu niet meer ten onrechte andere componenten weg.
• Het onderdrukken werkt nu ook voor de componenten van een bereidingswijze.

createProduct slaat nu eventuele besteleenheid en artnr_lev altijd op bij de standaard uitvoering.

Lost probleem op waardoor verifyEmployeePassword en verifyCredentials konden crashen.

Introductie nieuwe API call getOrderHistory

Met deze call kan de historie van de wijzigingen op (tafel) orders bij de API worden opgevraagd. Dit kan zowel voor een filiaal en periode (en tafelnummer) als ook voor specifieke orderIds worden opgevraagd. Tevens wordt informatie verschaft over het verplaatsen en splitsen van tafels.

• Api heeft nu settingscache die elke minuut update, dit scheelt hoop losse queries terwijl hij toch nog redelijk vlot wijzigingen oppakt.
• De authenticatie token cache van de webhooks werkt nu ook goed in de api
• placeTableOrder maakt geen nieuwe versie van de order meer aan als je alleen een betaling stuurt.

Fix moveTableOrderV3 crash bij volledige verplaatsing als het een filiaal met GKS betreft.

getTableOrderV2 retourneerd nu weer de regels verdicht.

LETOP dit verhelpt probleem met de android handheld dat deze de inhoud van de tafel onverdicht laat zien!

Fix moveTableOrderV3 geen gekke afrondingen van de verkoopprijs meer.

Fix voor API call getorderchanges Het veld pointsAmountExclOld bevat nu de correcte waarde (de het exclusief in plaats van het inclusief bedrag)

Diverse verbeteringen aan savePurchaseOrderV2

• Zolang niet (deels) geleverd kunnen de regels nu volledig gewijzigd worden. Wanneer deelsgeleverd mag er slechts beperkt gewijzigd worden en moeten de bestaande regels in de correcte volgorde in de request aanwezig zijn.
• Diverse velden zijn nu alleen verplicht voor nieuwe opdrachten niet bij het wijzigen in welk geval de huidige waarde behouden blijft.
• Status wijzigingen naar (deels)geannuleerd worden nu ook ondersteunt.
• Annuleringen kunnen ook ongedaan gemaakt worden door de status terug te zetten op openstaand/deelsgeleverd.

saveCredentials met deze call kan het wachtwoord van een relatie of medewerker gewijzigd worden.

Deze call moet expliciet geautoriseerd worden voor clients die hem nodig hebben.

Nieuwe API call passwordReset met deze call kan een key gemaakt worden die naar de gebruiker gemailed kan worden welke dan vervolgens gebruikt kan worden icm saveCredentials. LETOP ivm beveiliging is deze call niet beschikbaar voor elke api gebruiker.

Forceer dat als een relatie op een tafel staat waarop niet geboekt wordt de boeking verhuist wordt naar een andere tafel.

placeTableOrder, createOrder en dergelijke verwerken nu webhookExternalDiscount

getOrder, getTableOrderV3 ed geven nu ook bpeAccordationEmployeeNumber terug.

Wanneer zowel de purchaseOrderNumber als de extPurchaseOrderId meegegeven wordt in savePurchaseOrderV2, zal er nu een controle plaats vinden of deze twee bij elkaar horen zo ja, dan kan de call uitgevoerd worden, horen ze niet bij elkaar krijg je een foutmelding terug.

Het is nu mogelijk om op basis API user ident het oude gedrag te forceren dat bij het maken van orders de componenten van bereidingswijzen niet werden toegepast.

Fix voor API call getorderchanges. Het veld pointsAmountExclOld bevat nu de correcte waarde (de het exclusief in plaats van het inclusief bedrag)

Bugfix in savepurchaseOrderV2 wanneer de leverdatum niet werd meegegeven zou die gelijk moeten zijn aan de opdracht datum.

Verhelp crash in placeTableOrder wanneer deze aangeroepen wordt op een slave database en een regel met BPE bevatte.

Verhelpt probleem met moveTableOrderV3 dat weglaten van de regellijst of aantallen resulteerde in de melding

It is not possible to move an order consisting of only text lines

sendWebhook (scancode, addsessionline, updatesessionline, removesessionline): De relatie element velden wordt nu gevuld met de bijbehorende gegevens uit de database. In eerdere versies bleven deze velden, behalve het relatienummer, leeg.

Aangevulde relatiegegevens: extRelationId, name, address, zipcode, city, country, deliveryAddress, deliveryZipcode, deliveryCity, deliveryCountry, telephone, mobile, email, cardNumber, bankAccountNumber, vatNumber, commerceNumber

determinePricing en diverse functies voor het maken van orders passen nu ook componenten van samengestelde bereidingswijzen toe.

determinePricing heeft er ook een subLineType bij gekregen om goed onderscheid te kunnen maken tussen bereidingswijzen en componenten.

Voorkom crash in printReceiptV2 als er geen data is voor de opgegeven werkplek.

updateRelation, createRelation en findRelation gingen bij de verwerking van de relationArticleDiscountList niet goed om met relationNumbers buiten 32-bits integer bereik.

Webhooks worden nu weer goed geactiveerd.

Probleem was geintroduceerd in versie 50.0.0

Verhelpt "Access Violation" wanneer geen relationNumber wordt meegegeven in createGiftcard.

Lost probleem op voor Android App met deels via splitsing afrekenen van een tafel via de payTableOrderV2 call.

payTableOrderV2 kan geen splitsing meer betalen hier heeft oa de Android App last van.

Lost probleem op dat printReceipt en printTableReceiptV2 melding geven over missende idempotency key.

getOverview retourneerd nu de bereidingswijze_groep nummers in de juiste volgorde.

printReceipt en printTableReceiptV2 melden ten onrechte dat idempotency key mist terwijl ze die helemaal niet verwachten.

Dit veroorzaakt oa een probleem met tussenbon printen op de Android App.

De calls savePurchaseOrderV2 en savePurchaseDeliveryV2 hebben nu ondersteuning voor toevoegen van regels via supplierArticleNumber of barcode, naast articleNumber of pluNumber. Het is dan niet nodig om articleVariantId mee tegeven, die wordt automatisch geselecteerd op basis van supplierArticleNumber of barcode.

Ook is het mogelijk om de aantallen door te via quantityOfPackagesOrdered of quantityOfPackagesDelivered, intern wordt dit automatisch omgerekend naar de basisaantallen voor de desbetreffende uitvoering.

Nieuwe API call printTableReceiptV3, met de volgende verbeteringen tov. printTableReceiptV2:

• Geen geregistreerde terminal meer nodig.
• Idempotent, dus veilig om (per ongeluk) vaker aan te roepen.

Nieuwe API call printReceiptV2, met de volgende verbeteringen tov. printReceipt:

• Geen geregistreerde terminal meer nodig.
• Idempotent, dus veilig om (per ongeluk) vaker aan te roepen.
• Mogelijkheid om voor een bepaalde tafel de laatste kassabon af te drukken.
• Mogelijkheid om een specifieke kassabon af te drukken.

De tafellijst api calls kunnen nu een extra state teruggeven TABLE-STATUS-RECENTLY-PAID deze wordt gebruikt om aan te geven dat de tafel recentelijk betaald is.

getOverview retourneerd nu de bereidingswijze_groep nummers in de juiste volgorde.

Nieuwe API call getGksInformation waarmee je voor een bepaalde werkplek het GKS productienummer kan opvragen.

setStock heeft nu verbeterde validatie waardoor hij niet meer OK geeft bij ontbrekende input maar duidelijk meld wat er mis is.

Verhelp probleem dat getOverview crasht als hij BTW tarief voor een artikel niet kan vinden.

Verhelpt probleem dat getOverviewFields een numericPrecision van 14 retourneerde voor velden met het type DATA-TYPE-STRING

De functie createRelation in combinatie met condenseCombinedInvoice werkt nu goed.

Probleem opgelost waardoor handmatige prijsaanpassingen weer ongedaan gemaakt werden als je een verkooporder of bestelling wijzigde.

Nieuwe functie performBpeBudgetChecks

Hiermee kan in een enkele aanroep voor een enkele medewerker meerdere BPE limiet checks gedaan worden. Hij retourneert per BPE:

• of deze onder limiet is of dat er gewaarschuwd of geblokkeerd moet worden
• hoeveel over of onder de limiet deze is
• wat de limiet is, als er een limiet is

Bij reconnect pogingen na het verliezen van een werkende database verbinding, worden deze pogingen niet gelogd. Dit voorkomt dat de logs vol geschreven worden met de zelfde meldingen. Er wordt wel gelogd op welk moment de verbinding verloren is en wanneer deze weer terug is.

Wanner getPreparationMethodGroups met een syncMarker werd aangeroepen miste voor sommige groepen de elementen.

Bestellingen die geannuleerd worden via de API (via cancelOrder of cancelTableOrder) worden nu ook geregistreerd in het annuleringslogboek.

Het is nu mogelijk om een externalPaymentId mee te geven aan een Payment. Als het desbetreffende ID daadwerkelijk overeenkomt met een bestaande ExternalPayment, wordt de betaling gekoppeld aan deze ExternalPayment.

Het is nu mogelijk om via de browser property van een Webhook request (zoals startExternalPaymentV2) door te geven welke browser gebruikt wordt om de webhooks te triggeren.

Een webhook endpoint kan op basis hiervan zijn antwoorden aanpassen.

https://developers.mpluskassa.nl/webhooks/json-definitions/#sender

Nieuwe api call getScheduledMealPlans kan gebruikt worden om de ingeplande menuplanning van een bepaald filiaal in de meegegeven periode op te vragen.

Nieuwe api call getMealplanMomentsConfiguration deze call kan gebruikt worden om de configuratie van de maaltijd labels op te vragen.

Waar mogelijk wordt deliveryAddress en invoiceAddress nu ook gevuld met de desbetreffende gegevens van de gekoppelde relatiekaart.

Nieuwe API-functie saveGiftcards waarmee je de reference (Referentie) van een cadeaukaart kunt bijwerken.

De functies getGiftcards en getGiftcard retourneren nu ook de reference (Referentie) van de cadeaukaart.

getTableListV3 geeft nu ook de relatie terug wanneer deze aan een tafel gekoppeld is zonder dat er nog artikelen op geboekt zijn.

De getCurrentSyncMarkers en getCurrentSyncMarkersV2 geven nu ook de preparationMethodGroupSyncMarker, articleNutritionalCharacteristicsSyncMarker en relationNutritionalCharacteristicsSyncMarker terug.

De api call getCardCategories geeft nu ook door of de ingestelde categorie een vip categorie is (isVipGroup).

De api call getOverviewFields bevat nu 2 extra velden in de response containsPersonalData en showInInfoPopup

De functie createOrder(V2) retourneert nu ook het orderId van een evt. reeds bestaande extOrderId. Die hoef je dan dus niet zelf apart op te zoeken met findOrder.

De functie getPackingSlips retourneert nu altijd alleen echte pakbonnen, en geen uitgiftes meer. Voorheen was het mogelijk om ook uitgiftes op te vragen als je niet filterde op syncMarker.

De verschillendegetOrders, getReceipts, getInvoices calls (die meerdere orders/kassabonnen/facturen inlezen) gaven andere totalen in de bereidingswijzen terug dan de calls die enkele tegelijk inlezen.

Het gedrag van de "meervoudige" calls is nu gelijkgetrokken aan het gedrag van de "enkelvoudige" calls.

Omdat sommige koppelingen mogelijk wel uitgingen van de foute resultaten, kun je via een speciale header (MPLUS-RETURN-COMBINED-PREPARATION-LIST) het oude gedrag weer activeren.

Foutmelding verholpen die kon voorkomen bij het queuen van een verkoop order voor een slave kassa.

Als je via savePurchaseOrder(V2) of savePurchaseDelivery(V2) een bestaande inkoopopdracht of levering bijwerkt, dan blijven de niet-meegegeven eigenschappen, zoals besteleenheid of gekozen uitvoering, nu bewaard.

getButtonLayoutGroupDetails retourneert nu correcte posities voor subgroepen met meerdere "rijen" die aan de rechterkant staan.

Dit verhelpt ook problemen met het opslaan van snelknoppen in online omdat saveButtonLayoutGroupDetails deze foute data niet accepteerd.

Voorheen werden de coördinaten uitgerekend alsof de subknoppen boven de layout stonden. Deze aanpassing heeft een minimale kans dat de subgroepen op de Android handheld nu iets anders staan. Dit zal alleen gebeuren als ze meerdere subgroep rijen hebben, deze rechts staan en het aantal artikelknop rijen niet gelijk is aan het aantal artikelknop kolommen.

Strictere validatie van row en column in saveButtonLayoutGroupDetails zodat het duidelijk gemeld kan worden aan de aanroeper wanneer deze verkeerde coordinaten meegeeft.

LETOP: de row en column van hoofd en subgroepen zijn altijd alsof deze bovenaan staan.

getOverview retourneerd nu de bereidingswijze_groep nummers in de juiste volgorde.

payTableOrder mislukte als het om een splitsing ging, de Android bestel app had hier last van.

Twee nieuwe properties IsPosGroup en IsOnlineGroup toegevoegd aan de api calls getPreparationMethodGroups en savePreparationMethodGroup

Probleem opgelost in createOrderV2 waardoor applySalesAndActions altijd FALSE werd als je hem niet meegaf, in plaats van dat hij naar de instelling keek.

getActiveEmployeeList call retourneert nu alleen nog medewerkers die de "Toegang tot android handheld" autorisatie hebben.

Als je op de plek van een decimal string een verkeerd geformatteerde waarde meegeeft, dan krijg je dat nu netjes terug gemeld in de response. Voorheen kreeg je dan gewoon geen reactie meer.

Als je getOrders aanroept met een syncMarker, dan wordt deze nu altijd gebruikt. Ook als de waarde 0 is. Dit voorkomt dat een eerste sync die je (per ongeluk) met 0 ipv. 1 aanroept, gelijk een resultaat van álle orders probeert te retourneren.

Vrije voorraad is nu altijd gebaseerd op dezelfde formule, namelijk aantal minus verkooporder minus interfiliale opdracht. Dit zorgt voor correcte vrije voorraad bij de getStock functie.

In een aantal plaatsen werd alleen een eventuele originele prijs inclusief BTW overgenomen maar werd het genegeerd als de exclusieve was opgegeven.

Wanneer een medewerker geen gekoppelde autorisatie groepen heeft gaf de GetEmployeeAuthorizationGroups call een lijst van alle filialen terug, nu geeft die dan niks terug.

Als je savePurchaseDeliveryV2 aanroept met een fromPurchaseOrder, dan heb je nu niet meer het probleem dat "In order" onterecht blijft ophogen.

Sommige calls gaven geen foutmeldingen terug als je invoer niet klopte, in plaats daarvan bleef de call hangen.

Voorbeeld hiervan was bijv. savePurchaseDeliveryV2 die geen foutmeldingen gaf als je bijv. een onbekend relationNumber opgaf.

Bug fix voor de melding database error on server bij de volgende API calls getCurrentTableOrders, getInvoices, getPackingSlips.

De getOverview gaf een foutmelding wanneer alleen de brutoprijs of alleen de verkoopprijs werd opgevraagd.

Twee nieuwe API calls setRelationPresence en getRelationPresence Met de setRelationPresence call kun je een relatie aanmelden bij een filiaal en optioneel meegeven op welke tafel deze zit. Met de getRelationsPresence kun je de laatst bekende status van de relatie opvragen.

getOverview heeft nu een extra veld bereidingswijze_groepen die de nummers van de gekoppelde bereidingswijzen als json array retourneerd.

Dit nieuwe veld en multi selectie velden retourneren nu als ze leeg zijn een lege json array ipv een json null waarde.

Extra veld quantityOfPackagesOrdered toegevoegd aan de getPurchaseOrder en getPurchaseOrderV2 api calls

De api calls die een ns__Address object teruggeven kunnen nu ook een extra veld label bevatten

getPreparationMethodGroups kan nu aangeroepen worden met een syncMarker in de request. Hij zal op volgorde van syncMarker de groepen vanaf de opgegeven syncMarker retourneren en niet meer groupen dan limit.

Zonder syncMarker retourneerd hij alle niet verwijderde groepen. Met syncMarker worden ook verwijderde groepen geretourneerd te herkennen aan deletedOn. De call geeft nu ook buttonColour terug met de kleuren die ingesteld zijn in de qline.

savePreparationMethodGroup kan nu ook kleuren opslaan. Als buttonColour of translation niet meegegeven worden dan blijft bij bestaande items die inhoud ongewijzigd en nieuwe items krijgen standaard grijze kleur.

Het meegeven van een onbekend medewerkernummer in de Mplus-Employee header zorgt niet meer voor een foutmelding in de API.

De functie sendMessage geeft geen foutmelding meer als je een onbekend werkpleknummer (terminalNumber) opgeeft.

Fixes voor gevallen waar de sync_marker van de artikelen niet altijd ge-update werden.

• multi selectie velden zoals de categorieën (ook bij medewerkers en relaties)
• gekoppelde afbeeldingen (ook bij medewerkers en relaties)
• uitvoeringen
• gekoppelde bereidingswijze groepen

Over het algemeen ging het wel goed als je deze dingen aanpaste via bewerken van een artikelkaart maar niet via andere routes.

getArticleGroup en getArticleGroupChanges geven nu ook informatie over verwijderde groepen.

Bij getArticleGroup is het hiervoor wel nodig om een syncMarker mee te geven. Bevat tevens diverse performance verbeteringen.

Een tegelijkertijd uitgevoerde placeTableOrder op dezelfde tafel zal nu niet meer veroorzaken dat de laatste binnenkomende bestelling de eerdere weer laat verdwijnen.

Tweede bestelling voor een keukenbon zal de bestelling niet meer naar de prullenbak sturen.

getNutritionalCharacteristics kan nu ook op basis van syncMarker werken.

Per kaart wordt altijd de complete lijst geretourneerd als kenmerken weggehaald worden komt de kaart dus terug met alle overgebleven kenmerken.

GKS ondertekening toegevoegd aan deliverOrder(V2) en saveInvoice.

Verbeteringen aan saveButtonLayoutGroupDetails

• Als de subgroepen rechts stonden werden de knoppen verkeerd opgeslagen of crashte de API.
• Het is nu ook mogelijk de standaard hoofd- en subgroep op te slaan.

Verhelpt probleem waardoor api kon crashen bij onvoldoende geheugen beschikbaar.

getVatGroupList uitbreiding en documentatie.

Gedocumenteerd dat hij de huidige tarieven voor alle filialen retourneerd en dat hij nooit de bedrag velden zal vullen.

De landcode van het filiaal toegevoegd en het accountNumber wordt nu gevuld.

Problemen met het splitsen van tafels.

Betreft zowel de " relation number does not exist" melding als de onterechte melding "U kunt alleen maar splitsen van een tafel naar een andere tafel".

saveOrder probleem opgelost dat ervoor zorgde dat een meegegeven prijs niet toegepast werd.

De api call 'saveButtonLayoutGroupDetails' geeft nu de nieuwe of aangepaste 'buttonLayoutGroupId' terug.

Fix dat versie 46.0.0. database schema 45 verwachte.

De api call 'SaveButtonLayoutGroupDetailsResponse' gaat nu goed om met de property 'isTableComment'

saveOrder probleem opgelost dat ervoor zorgde dat een meegegeven prijs niet toegepast werd.

createImageFromUrl functie toegevoegd. Deze voegt een afbeelding toe door hem te downloaden van de opgegeven URL.

De afbeelding kan ook direct aan artikelen, relaties of medewerkers gekoppeld worden. createImage heeft ook de mogelijkheid gekregen ze direct te koppelen.

Deze functies kunnen alleen gebruikt worden als het gebruik van de Mplus Image Service geactiveerd is.

De API vereist dat als er een entryBranchNumber wordt meegegeven er ook een workplaceNumber wordt meegegeven.

createOrder doet nu ook GKS ondertekening als de GKS module aanstaat.

Verder ook bij de diverse order varianten gecontroleerd dat er correct transacties gebruikt worden zodat een order niet zonder ondertekening opgeslagen kan worden. Wanneer de GKS ondertekening mislukt wordt dit gelogd.

Verhelp probleem met getProduct waardoor de course van een article voor een paar velden foutieve data bevatte.

Bugfix voor getGiftcards, waardoor je de call nu ook weer kunt uitvoeren zonder cardTypeId.

Bug opgelost in het toepassen van BPE via verscheidene API calls, zoals placeTableOrder.

Via placeTableOrder kunnen nu ook externe EFT transactiedetails doorgegeven worden, via eftTransactionDetails.

getTableOrderCourseListV3 heeft nu de eigenschappen:

• requestedAt
• isTableSet
• tableSetAt
• isWineServed
• wineServedAt

Bug opgelost in het filteren op articleNumber via getPurchaseOrders en getPurchaseDeliveries.

Wanneer er meer dan één custom field in de updateRelation meegegeven was werd alleen de eerste bijgewerkt. Nu zal die ze allemaal bijwerken Hetzelfde probleem was aanwezig in de createArticle, createRelation en createEmployee calls

Wanneer je via een handheld een tweede menu toevoegde aan een tafel, dan werd de berekende toeslag/korting van het eerste menu vergeten. Dit zal nu goed onthouden worden.

Hij bijwerken van de categorieën van artikelen, relaties en medewerkers mbv het oude categoryId veld werkt weer. Het is wel aanbevolen om over te stappen op het gebruik van categoryIds.

API call getPurchaseDeliveriesV2 heeft nu de mogelijkheid om een enkele inkooplevering in te lezen op basis van purchaseDeliveryNumber of extPurchaseDeliveryId.

Uitbreiding op de calls getPurchaseOrders(V2), getPurchaseDeliveries(V2), getStockCorrections, en getTodoLists, zodat je kunt aangeven dat je de regels van de betreffende objecten niet wilt ontvangen.

• getPurchaseOrders(V2).includeLineList
• getPurchaseDeliveries(V2).includeLineList
• getStockCorrections.includeStockCorrectionLineList
• getTodoLists.includeEntries

Dit maakt de calls veel sneller, en kan gebruikt worden voor het tonen van overzichten. Daarnaast worden er nu ook minder queries uitgevoerd als includeLineList wel aan staat.

Ook zijn de savePurchaseDelivery(V2) en savePurchaseOrder(V2) call geoptimaliseerd.

Verbeterde foutafhandeling in de createImage functie.

Duidelijker foutmeldingen en API crasht niet meer als gebruik van Mplus Image Service niet geactiveerd is in de database.

Verbetering in getStock waardoor deze beter om kan gaan met heel veel articleNumbers in het request.

getOverviewFields heeft er een branchNumber request parameter bij gekregen zodat de BTW keuzelijst de juiste percentages bevat.

Wordt er geen branchNumber mee gegeven dan worden de percentages van filiaal 1 nu gebruikt in plaats van landcode 1.

Verhelp probleem met getProduct waardoor de course van een article voor een paar velden foutieve data bevatte.

Wanneer je via een handheld een tweede menu toevoegde aan een tafel, dan werd de berekende toeslag/korting van het eerste menu vergeten. Dit zal nu goed onthouden worden.

Wanneer er meer dan één custom field in de updateRelation meegegeven was werd alleen de eerste bijgewerkt. Nu zal die ze allemaal bijwerken Hetzelfde probleem was aanwezig in de createArticle, createRelation en createEmployee calls.

De calls createActivity en updateActivity hebben nu ook de mogelijkheid om activityTypeId mee te geven.

Toegevoegde calls: getActivityTypes, saveActivityTypes, en saveActivity.

Als createImage wordt aangeroepen terwijl de media sync modus niet is ingesteld op Mplus Image service dan crasht de API en krijgt de client een HTTP 500 error terug.

LETOP de api's zien de gewijzigde instelling pas na een herstart.

Functie getCurrentSyncMarkersV2 toegevoegd. In deze nieuwe versie kun je kiezen wélke syncMarkers je wilt terugkrijgen ipv. dat standaard álle syncMarkers worden geretourneerd.

De API zet nu de listen port, api ident en functie naam in de application_name van de database connectie, hierdoor is het beter te herleiden waar belasting van postgresql vandaan komt als je in pg_stat_activity kijkt.

De application_name kan ook gelogd worden in de postgresql log. Voeg hiervoor %a toe aan de log_line_prefix.

Verhelp probleem met getProduct waardoor de course van een article voor een paar velden foutieve data bevatte.

Verbetering in getStock waardoor deze beter om kan gaan met heel veel articleNumbers in het request.

Uitbreiding op de calls getPurchaseOrders(V2), getPurchaseDeliveries(V2), getStockCorrections, en getTodoLists, zodat je kunt aangeven dat je de regels van de betreffende objecten niet wilt ontvangen.

• getPurchaseOrders(V2).includeLineList
• getPurchaseDeliveries(V2).includeLineList
• getStockCorrections.includeStockCorrectionLineList
• getTodoLists.includeEntries

Dit maakt de calls veel sneller, en kan gebruikt worden voor het tonen van overzichten. Daarnaast worden er nu ook minder queries uitgevoerd als includeLineList wel aan staat.

Ook zijn de savePurchaseDelivery(V2) en savePurchaseOrder(V2) call geoptimaliseerd.

Dit lost een probleem op waardoor het niet meer mogelijk was om zelf een afwijkende prijs mee te geven aan een aantal API-calls. Dit maakte het onmogelijk om extern een vrij bedrag voor bijvoorbeeld "fooi" door te geven. Ook kon je door deze bug niet meer een afwijkende prijs via de Android Bestelapp doorgeven.

Ondersteuning voor authenticatie van een basic authentication header in plaats van ident en secret in de request parameters van de URL.

Probleem opgelost in WSDL met onbekend type CategoryIds.

De functie createAndPayTableOrder liet altijd de order op de tafel staan, terwijl er wel gewoon een kassabon gemaakt werd.

Verhelpt fout als er in de hostname van de computer waar MplusQservice op draait tekens gebruikt zijn die niet onder standaard 7 bit ASCII vallen.

Feitelijk mag dit niet eens maar blijkt toch voor te kunnen komen op Windows.

Wanneer aan getRelations een lijst van nummers werd meegegeven als filter retourneerde hij toch alle relaties.

Fix saveOrder en saveTableOrder overschrijven niet meer de binnenkomende price met priceExcl omgerekend naar inclusief als beide gezet zijn en order inclusief ingesteld is.

De API-call requestNextTableOrderCourseV3 toegevoegd. Deze vereist geen geregistreerde Terminal.

De API-call getPurchaseDeliveries(V2) retourneert nu evt. ook informatie vanuit de gekoppelde inkoopopdracht, zoals welke uitvoering het betreft.

De API-call savePurchaseDeliveryV2 heeft nu ondersteuning voor het maken van een inkooplevering gebaseerd op een inkoopopdracht. Gebruik hiervoor de extra eigenschap fromPurchaseOrder. Je moet alle regels van de inkoopopdracht meegeven, of specificeren welke regels je levert via de eigenschap lineNumber.

Om die laatste flow te ondersteunen, retourneert getPurchaseOrdersV2 nu ook het lineNumber van elke regel.

De API-call updateNutritionalCharacteristics gaf soms een foutieve resultaatwaarde:

UPDATE-ARTICLE-NUTRITIONAL-CHARACTERISTICS-RESULT-OK is nu UPDATE-NUTRITIONAL-CHARACTERISTICS-RESULT-OK

Verhelp probleem met getProduct waardoor de course van een article voor een paar velden foutieve data bevatte.

Wanneer aan getRelations een lijst van nummers werd meegegeven als filter retourneerde hij toch alle relaties.

Probleem opgelost in WSDL met onbekend type CategoryIds.

Fix saveOrder en saveTableOrder overschrijven niet meer de binnenkomende price met priceExcl omgerekend naar inclusief als beide gezet zijn en order inclusief ingesteld is.

Problemen opgelost met de verwerking van custom velden bij artikelen, medewerkers en relaties.

Het probleem kon onder andere de volgende melding veroorzaken "The request caused a constraint error in the database, most likely some of the data supplied is incorrect".

In sommige gevallen kon de melding You're trying to move more articles than were in the original order. optreden als je zowel de inclusief- als de exclusiefprijs van een bestelregel opstuurde naar moveTableOrder of payTableOrder.

Bereidingswijzeteksten werden gewist als ze niet expliciet in API-calls werden meegegeven. Hierdoor ontstonden lege regels op de bestelbonnen, en kreeg je bij het afrekenen de melding You're trying to move more articles than were in the original order.

Bij bereidingswijzeteksten die voorzien waren van overbodige witruimte kon het probleem optreden bij betalen en splitsen van tafelbestellingen: You're trying to move more articles than were in the original order.

Ondersteuning voor door klant gemaakte multiselectie velden in de diverse routines voor opvragen en bewerken van artikelen, medewerkers en relaties.

Nieuwe calls: getGiftcards en restituteGiftcards

Het activiteiten response object heeft nu optioneel twee extra velden die mee terugkomen activityTypeId en activityTypeDescription

UpdateProduct: Neemt nu de besteleenheid altijd over naar de standaarduitvoering. De besteleenheid werd niet overgenomen als die nog niet eerder ingevuld was.

Bugfix aan de getProposals call voor "Database error on the server." melding

fix updateBatch maakt nu ook uitvoering en uitvoering leverancier records aan.

De diverse artikel, relatie en medewerker functies bij langs geweest zodat ze nu allemaal door klant gemaakte multiselect velden ondersteunen.

Probleem verholpen waardoor c:\ProgramData\MplusQservice\global.ini niet meer gelezen werd.

Bereidingswijzeteksten werden gewist als ze niet expliciet in API-calls werden meegegeven. Hierdoor ontstonden lege regels op de bestelbonnen, en kreeg je bij het afrekenen de melding You're trying to move more articles than were in the original order.

In sommige gevallen kon de melding You're trying to move more articles than were in the original order. optreden als je zowel de inclusief- als de exclusiefprijs van een bestelregel opstuurde naar moveTableOrder of payTableOrder.

Bij bereidingswijzeteksten die voorzien waren van overbodige witruimte kon het probleem optreden bij betalen en splitsen van tafelbestellingen: You're trying to move more articles than were in the original order.

Bugfix in een aantal order-gerelateerde calls waardoor subregels altijd als samengestelde (COMPONENT) regels werden verwerkt, ipv. bereidingswijzen (PREPARATION).

Lost het probleem op dat als er vanaf de handheld achter elkaar twee keer het zelfde artikel besteld wordt op een tafel er voor de tweede geen bestelbon uit de printer komt.

Probleem verholpen waardoor de API niet meer de omzetgroep van de artikelkaart gebruikte wanneer bij het maken van een order geen omzetgroepen opgegeven werden.

Het opvragen van meerdere facturen, pakbonnen, orders of offertes versneld.

Deze optimalisatie was eerder al gedaan voor kassabonnen.

Bij bereidingswijzeteksten die voorzien waren van overbodige witruimte kon het probleem optreden bij betalen en splitsen van tafelbestellingen: You're trying to move more articles than were in the original order.

De functie placeTableOrder ondersteunt nu ook tableDescription en numberOfGuests.

De functie getOverview heeft nu een property aggregateValues waarmee aangegeven kan worden dat samengestelde artikelen hun totaalprijs doorgeven.

getAuthorizationTree heeft branchNumber param erbij gekregen die wordt gebruikt voor modulecheck. Geef je deze niet mee dan komen alle autorisaties nu terug.

De inhoud van de velden afleveradres en factuuradres in de getOrders waren omgewisseld.

De API service kan zijn logs nu ook naar een UDP poort sturen.

De functie reportPrintableFinancialTotals is toegevoegd. Deze functie retourneert de inhoud van het overzicht Financieel > Totalen.

De functie reportArticlePerformance is toegevoegd. Deze functie retourneert de inhoud van het overzicht Artikelprestatie.

Api calls voor snelknoppen beheer

• getButtonLayoutGroupWithAssignedWorkplaces Hiermee kun je een lijst van beschikbare layouts en de filialen waaraan ze gekoppeld zijn opvragen.

• getButtonLayoutGroupDetails Hiermee kun je op basis van layoutid de tabs en snelknoppen informatie van de layout opvragen.

• saveButtonLayoutGroupDetails Hiermee kun je doorgeven welke wijzigingen er moeten plaats vinden in de tabs of snelknoppen, dit kan door de opgevraagde structuur van getButtonLayoutGroupDetails aan te passen en weer terug te geven. Ook kun je nieuwe layouts aanmaken door tab id 0 en layout id 0 te gebruiken.

• deleteButtonLayoutGroup Hiermee kun je layout verwijderen werkt alleen als er geen werkplekken meer aan gekoppeld zijn. Je krijgt melding terug als je niet aan deze eis voldoet

• assignButtonLayoutGroupToWorkplace Hiermee koppel je een layout aan een of meerdere filiaal/werkpleken

Verbeteringen aan findTableOrder

• De functie retourneert niet meer orders van een ander filiaal dan de geregistreerde terminal.
• Functie had geen ondersteuning voor subtafels waardoor bij gebruik van subtafels altijd de order van subtafel 1 werd geretourneerd ongeacht op welke subtafel de juiste order stond.

Nieuwe API call getEmployeeAuthorizationSyncMarkers hiermee kun je de huidige maximale syncmarkers van de autorisatiegroepen en individuele status van de medewerker opvragen. kan gebruikt worden om te bepalen of er iets aan de autorisaties van de medewerker gewijzigd kunnen zijn.

Drie nieuwe API calls voor het inlezen en updaten van de instellingen

• getConfigurationTree
• getConfigurationValues
• updateConfigurationValues

De functie updateArticleGroup heeft de optie erbij gekregen om een parentGroupNumber mee te geven, waarmee je de desbetreffende groep kan verplaatsen naar een andere hoofdgroep.

Deze API versie werkt niet goed samen met automatische wsdl import tools.

De functie placeTableOrder ondersteunt nu ook tableDescription en numberOfGuests.

Correcte ondersteuning voor vatCountryCode/vatCountryIso3 in een aantal API-calls:

• saveOrder
• updateOrder
• updateOrderV2
• createAndPayTableOrder
• placeTableOrder

Probleem opgelost in getProducts waardoor product.description soms een UTF-8 karakter bestaande uit meerdere bytes verkeerd afbrak waardoor een ongeldig karakter ontstond.

Nieuwe functie savePreparationMethodGroup hiermee kun je bestaande bereidingswijze groepen updaten of nieuwe aanmaken

Bugfix in getAuthorizationTree niet alle autorisatie items kwamen terug.

Nieuwe functie createImage hiermee kunnen images aangemaakt worden die vervolgens aan een artikel of relatie gekoppeld kunnen worden.

LETOP dit werkt alleen als de API geconfigureerd en geautoriseerd is om te verbinden met de Mplus Image Service.

Nieuwe functie updateEmployeeAuthorizationGroups hiermee krijg je voor de meegegeven medewerker de autorisatiegroepen per filiaal instellen.

Nieuwe functie getEmployeeAuthorizationGroups hiermee krijg je voor de meegegeven medewerker een lijst van filialen en hun ingestelde autorisatiegroep terug.

Nieuwe functie deleteAuthorizationGroup hiermee kunnen bestaande autorisatie groepen verwijderd worden

Nieuwe functie saveAutorizationGroup hiermee kunnen bestaande autorisatie groepen gewijzigd of nieuwe aangemaakt worden

Nieuwe functie getFilterProfiles deze call geeft een lijst van alle active filterprofielen terug.

Nieuwe functie reportPaymentMethodDetails toegevoegd. Met deze call kun je een lijst van betalingen terug krijgen, van een specifieke betaalwijze over een mee te geven periode.

De functie updateGroupAuthorizations heeft een extra request parameter gekregen updateBehavior hiermee kun je aangeven wat er met de meegegeven autorisaties moet gebeuren. De mogelijkheden zijn toevoegen aan de groep, of de groep vervangen voor de meegegeven set.

De functie getEmployeeAuthorizations heeft een extra request parameter gekregen loadOnlyEmployeeSpecificAuthorizations Hiermee kun je aangeven dat je alleen geïnteresseerd bent in medewerker specifieke autorisaties.

De functie getAutorizationGroups geeft nu in zijn response ook het filterprofielId en rankOrder mee terug.

De functie getOrders is uitgebreid met een orderTypeList filter waarmee je nu ook evt. tafelbestellingen en cafetariabonnen kunt uitlezen.

De functie getReceipts retourneer nu ook per kassabon het aantal geregistreerde gasten via numberOfGuests.

Het probleem waardoor API v39.1.* niet goed werkte met de Android BestelApp is nu weer opgelost.

getRelations kan nu omgaan met meerdere sub-records per relatie, en geeft deze relatie dan niet meerdere keren terug.

De functie getArticlesNutritionalCharacteristics heeft een aanzienlijke performance boost gekregen.

De functies getEmployee, getEmployees en findEmployee retourneren nu ook weer de customFieldList.

onlyQuantityButtons toegevoegd aan getTerminalSettings

Instelling heet in de Qlijn "Alleen aantal knoppen" en staat onder "Handheld-only".

Nieuwe functie getButtonLayoutGroupForBranch.

Deze retourneerd de gehele ingestelde tabgroep. Mbv opties kan opgegeven worden of de layouts ook mee geretourneerd moeten worden en of de lijst van bijbehorende artikelen gevuld moet worden. Als hij de layouts retourneerd genereerd hij eventueel ook die van de menuplanning.

De ArticleSpecialPrice PRICE_NOT_FOR_SALE is toegevoegd (Niet verkoopbaar).

Functies toegevoegd voor het werken met todolijsten.

• createTodoList
• getTodoList
• addToTodoList, voeg artikelen toe, artikelen blijven uniek, aantallen worden bij elkaar opgeteld
• saveTodoList, herschrijf de hele lijst
• removeTodoList

Het filter changedSinceTimestamp van getProducts werkt nu weer.

Bugfix aan de updateBatch deze call werkte niet als die gebruikt werd om alleen de categorieën te updaten.

De functie placeTableOrder ondersteunt nu ook tableDescription en numberOfGuests.

De functie getOrders is uitgebreid met een orderTypeList filter waarmee je nu ook evt. tafelbestellingen en cafetariabonnen kunt uitlezen.

getRelations kan nu omgaan met meerdere sub-records per relatie, en geeft deze relatie dan niet meerdere keren terug.

Vanaf deze versie in minimaal Windows 7 of Windows Server 2008r2 vereist voor installatie van het programma.

Verbeteringen voor keukenmanagement.

Het is niet meer mogelijk om createGiftCard of reloadGiftCard op een Slave-API uit te voeren. Het is ook niet meer mogelijk om met een cadeaupas te betalen op een Slave-API als "Offline toegestaan" uitgeschakeld is, omdat een Slave-API niet direct met de Master communiceert.

De functie getArticleGroups werkt nu ook weer goed als je een syncMarker meegeeft.

scram-sha-256 support voor postgresql authenticatie.

findRelation gebruikt nu een ORDER BY zodat hij een consistent antwoord geeft.

Geheugen lek in getConfiguration call verholpen, wordt gebruikt door oa de QR-Bestelapp. De call is nu ook sneller.

updateProduct en createProduct werken weer.

De nieuwste versie van PostgreSQL gebruikt scram-sha-256 als authenticatiemethode. Dit wordt nog niet ondersteund door de API. Gebruik deze handleiding om PostgreSQL te "downgraden" van scram naar md5: https://docs.google.com/document/d/1uh4-D6Fa9YphXoxGjudM6O7Z3YeiVAfsUrKwSMTwb5U

Probleem met getArticlesVariants opgelost als er artikelen zijn zonder uitvoeringen (dit hoort niet voor te komen bij normaal gebruik).

Probleem met AccessViolation opgelost in placeTableOrder.

Vanaf 1 juli 2021 gelden nieuwe btw-regels voor e-commerce (zie hier voor meer info).

Dit betekent dat onder bepaalde omstandigheden gerekend moet gaan worden met het BTW-percentage van het land waar de order naartoe gaat, en niet meer met het BTW-percentage van het land waar de webshop gevestigd is.

De order-functies (saveOrder, queueBranchOrder, etc) en factuur-functies (saveInvoice, etc) hebben twee nieuwe eigenschappen gekregen: vatCountryCode en vatCountryIso3.

Door een van deze mee te geven kun je zorgen dat alle BTW wordt doorgerekend op basis van de BTW-tarieven die in MplusKASSA voor dát land ingesteld staan.

Geef je dit niet mee, dan wordt (zoals vanouds) gebruik gemaakt van de BTW-tarieven van het land van het filiaal waar de order op aangemaakt wordt.

De opvraag-functies (getOrder(s), getInvoice(s)) retourneren de vatCountryCode/vatCountryIso3 ook indien die ingesteld is.

Omdat vatCountryCode een MplusKASSA-specifieke nummering is, die niet per definitie overal bekend is, kun je ook gebruik maken van de ISO3 landcode van het land waar de order heen gaat, via vatCountryIso3.

De lijst van ISO3 codes is hier te vinden: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3

Fix bug in api calls getPurchaseDeliveries(V2) waar de formattering van de datum filter velden ervoor zorgde dat het datum filter niet functioneerde

aan de volgende API calls is een deliveryAddress toegevoegd :

• getPurchaseDeliveries
• getPurchaseDeliveriesV2
• getPurchaseOrders
• getPurchaseOrdersV2

scram-sha-256 support voor postgresql authenticatie.

findRelation gebruikt nu een ORDER BY zodat hij een consistent antwoord geeft.

Geheugen lek in getConfiguration call verholpen, wordt gebruikt door oa de QR-Bestelapp. De call is nu ook sneller.

Bugfix voor getOverview: Als er geen scopeValues argument werd meegegeven, dan werd er toch getracht om een scoped veld op te halen, dat leverde een database-fout op. Dat is nu opgelost.

Tevens blijft nu de scoped indicator in het resultaat null als je geen scopeValues hebt opgevraagd.

De functie getTerminalSettings retourneert nu ook of je tijdens de direct-afrekenen modus ook nog tafelkeuze hebt, via directPaymentModeAllowTableSelection.

Bij het wijzigen van een (tafel)bestelling of verkooporder kun je nu van een regel ook alleen de korting wijzigen en dat wordt nu correct opgeslagen.

Via de nieuwe API-functie changeTableProperty kan nu de VIP-status van de keukenbonnen van een tafel gewijzigd worden. In de toekomst wordt deze functie uitgebreid om meer (indirecte) eigenschappen van een tafel te kunnen wijzigen, zonder een hele tafelbestelling door te hoeven geven.

Het object OccupiedTableDetails bevat nu ook de eigenschap isVip die aangeeft of de keukenbonnen van de tafel op dat moment VIP-status hebben.

De API-functie getTerminalSettings retourneert nu ook of het bijbehorende filiaal een keukenscherm heeft (branchHasKitchenScreen).

Via de API-functie updateBatch kunnen categorieën (multi_cats) nu ook bijgewerkt worden.

De preparationList van regels in een order worden nu ook weer gevuld, bijv. als je getOrders aanroept.

De eigenschappen deliveryDate, deliveryPeriodBegin en deliveryPeriodEnd zijn nu ook aanpasbaar via saveOrder en updateOrder.

Bij het gedeeltelijk splitsen van een tafelbestelling (via moveTableOrder) worden de juiste keukenbonnen nu ook aangemaakt.

Fix voor bijwerken merk (brandName) van een artikel via createProduct of updateProduct.

Fix voor toekennen locatie aan keukenbonnen

Bugfix in updateProduct (eigenlijk in dieperliggende import-functie), waardoor je nu in één aanroep van updateProduct meerdere imports kunt doen met verschillende kaartkolommen.

Reduceer geheugengebruik van getStockHistoryV2

Probleem verholpen waardoor de getActiveEmployeeList call een databasefout rapporteerde.

De functie getPurchaseOrders(V2) ondersteunt nu ook het filteren op basis van de inkoopopdrachtstatus via de parameter purchaseOrderStates.

The account number (accountNumber) of (pre) payments on a receipt, invoice or order is now also correct when it is an account number for a specifc branch or workplace.

Nieuwe functie getStockCorrections welke voorraadcorrecties retourneert, zoals ook te vinden in de Qline onder Hoofdmenu > Voorraad > Correcties.

Verhelpt een conversiefout in getReceipts.

De functie getPurchaseOrdersV2 vult nu ook extPurchaseOrderId in (die bleef voorheen altijd NULL, ook al had deze wel een waarde).

De nieuwe functie reportAverageSpending retourneert een overzicht van de gemiddelde besteding per (bestel-)bon en per gast (indien gastenregistratie ingeschakeld is). Er kan gefilterd worden op periode, filiaal en medewerker.

De velden articleVariantId (artikel_uitvoering_id), quantityInPackaging (verpakkingsvorm_aantal_eenheden) en packagingType (verpakkingsvorm) zijn toegevoegd aan elke functie die betrekking heeft op de opslag en opvragen van inkoopopdrachten en inkoopleveringen.

De functie getOverviewFields retourneert nu per veld ook de kolom en rij zoals ze op de kaart staan. De gebruikte eigenschappen hiervoor zijn cardColumn en cardRow.

De functie reportTurnover retourneert nu pér turnoverGroupType een record, en niet meer cumulatief van alle typen. Het is namelijk verwarrend en onzinnig om bijv. omzetrekeningen en tussenrekeningen op te tellen.

Als je dat alsnog wilt doen, dan heb je natuurlijk achteraf alsnog de mogelijkheid om dat zelf te doen.

Daarnaast kun je ook filteren op turnoverGroupTypes. Als je het filter niet meegeeft krijg je alles terug.

De functie getReceipts retourneert nu ook betaalwijze-wissel bonnen (ook wel betaalwijze overboeking of betaalwijzeboeking genoemd). De receiptType van deze bonnen is RECEIPT-TYPE-PAYMENT-METHOD-TRANSFER.

Extra validatie toegevoegd vlak voordat dat de giftcard betaling geregisteerd wordt in RegisterGiftcardPayment

Filteren op einddatum werkt nu ook in de getStockHistoryV2 call.

De achterliggende query is nu ook efficienter. Veel calls zullen nu ook een duidelijker foutmelding geven bij onvoldoende geheugen.

The article property "Uitlopend" has been added discontinued. This property indicates that an article is still for sale, but only as long as stock lasts.

Ondersteuning voor de bestellijst

• getPurchaseBook haal de lijst op voor opgegeven filiaal
• savePurchaseBook vervang de lijst van opgegeven filiaal met opgegeven lijst
• addToPurchaseBook voeg de opgegeven artikelen toe aan de lijst van het opgegeven filiaal

Besteleenheid (orderQuantity) wordt nu ook opgeslagen door saveProduct en updateProduct.

Deze functies werken nu ook weer alle velden van de standaard artikeluitvoeringen correct bij.

Verbeterde afhandeling database fouten.

Voorheen werden alle query fouten het zelfde gemeld naar de client, namelijk dat er contact opgenomen moet worden met apisupport. Nu worden constraint fouten naar de client gemeld als een probleem met de aangeboden data want dit is vrijwel altijd de oorzaak.

Probleem verholpen waardoor payOrder weigerde een filiaalorder van een slave te betalen als deze order al naar de master gesynchroniseerd was.

getOverview ondersteund nu multi selectie velden in de select lijst.

De keuzes worden als een json array geretourneerd in de value.

getOverview heeft nu ondersteuning voor het filteren op multi selectie velden

Er zijn drie operators

• CONTAINS alle keuzes uit filter moeten aanwezig zijn op de kaart
• OVERLAP minimaal 1 keuze uit het filter moet aanwezig zijn
• IS alle keuzes en geen andere keuzes moeten aanwezig zijn

De keuzes moeten gecodeerd als json array meegegeven worden aan het filter.

Fix crash in getReceipts waarschijnlijk ook in alle gerelateerde calls zoals getInvoices, getOrders.

Op api.mpluskassa.nl resulteerd dit in een 502 Bad Gateway error van de loadbalancer.

getReceipts is nu ook een stuk sneller als er veel bonnen in het resultaat zitten.

Probleem opgelost waardoor databaseconnecties niet goed hersteld werden na een netwerkstoring.

Probleem verholpen waardoor het opslaan van orders, pakbonnen, facturen, kassabonnen vereiste dat je de averagePurchasePrice mee gaf terwijl dit een readonly-veld is.

Opslaan van orders, pakbonnen, facturen en kassabonnen vereist ten onrechte dat je de averagePurchasePrice meegeeft.

Probleem verholpen waardoor payOrder van backoffice order synchronisatie problemen met slaves kon veroorzaken.

Mogelijkheid om van een filiaalorder een kassabon te maken

Dit kan via queueBranchOrderPayment door de bookingMethod op te geven of payOrder met prepay=false

In bon-, factuur-, pakbon- en orderregels wordt nu ook de gemiddelde inkoopprijs geretourneerd averagePurchasePrice deze is van type xsd:decimal om meer dan 2 decimalen te kunnen ondersteunen.

Routines voor het opvragen en opslaan van artikel, relatie en medewerker kaarten ondersteunen nu meerdere categorieën.

Ondersteuning voor de vernieuwde artikeluitvoeringen.

• getArticleVariants
• newArticleVariant
• updateArticleVariant
• deleteArticleVariants

Het is nu mogelijk om getPurchaseOrders of getPurchaseOrdersV2 aan te roepen met purchaseOrderNumber of extPurchaseOrderId om een specifieke purchase order in te lezen.

Werking van savePurchaseOrder en savePurchaseOrderV2 verbeterd.

• extPurchaseOrderId is niet meer verplicht maar dan moet wel purchaseOrderNumber opgegeven zijn
• fix: functie maakte nieuwe purchaseOrder aan ingevallen waar hij eigenlijk een bestaande had moeten aanpassen

queueBranchOrder crashte als je geen extOrderId mee gaf.

Fixes in de articleVariants (artikel uitvoeringen).

• wijzigingen aan de standaard uitvoering worden nu ook doorgezet naar de kaart
• het instellen van een andere uitvoering als de standaard uitvoering werkt nu ook

Deze instelling werd door een naamswijziging nog niet correct uitgelezen in de API.

Wanneer een artikel met samengestelde artikelen op BPE werd gezet (bijv. via de Android-app) dan werden de subartikelen niet automatisch op BPE gezet.

Probleem in saveProduct verholpen waardoor deze mislukte zonder toelichting.

createAndPayTableOrder toegevoegd

getKitchenTicket call response uitgebreid met tafel of bestelnummer

createAndPayTableOrder toegevoegd

When lines are added (lineAdditions) during the start of a session (startSession), this will no longer cause an error (!m_IsOpgeslagen) in subsequent booking.

getApiVersion retourneert nu correct of een slave een filiaal- of een werkplek-slave is. Hiervoor werd altijd een filiaal-slave geretourneerd.

Geheugenlek verholpen bij gebruik van webhooks.

createAndPayTableOrder toegevoegd

API v26.3.0 bevatte een compilatiefout waardoor in elk geval het bijwerken van relaties (updateRelation) problemen kon opleveren.

De customfields van de artikel, relatie en medewerkerkaarten werkt nu met unicode.

(ook aanwezig in 24.0.2 maar niet in tussenliggende versies)

Bugfix voor getProducts waardoor deze weer altijd alle resultaten retourneert.

Diverse verbeteringen aan de stabiliteit.

The getConfiguration call works again.

De nieuwe functie getKitchenTickets kan gebruikt worden om keukenbonnetjes voor een bepaalde orderId of een bepaalde werkplek (branchNumber+workplaceNumber) op te vragen.

Performance van getProducts-call verbeterd voor artikelen met bereidingswijzen.

Nieuwe functie getTableListV3 die geen geregistreerde terminal meer vereist. Er moet wel een branchNumber meegegeven worden om aan te geven voor welk filiaal de tafels geretourneerd moeten worden.

Probleem hersteld waardoor handhelds ten onrechte de melding "non-existing order.relationNumber specified" terug kregen van de API.

Retourneert ten onrechte de volgende fout aan de handheld "non-existing order.relationNumber specified" bij het plaatsen van een bestelling.

De functie payOrder retourneert nu PAY_ORDER_RESULT_ORDER_ALREADY_INVOICED als de betaling mislukt omdat de order al gefactureerd is.

Validatie/foutmeldingen master/slave bestellingen uitgebreid voor API calls :

• createOrder
• createOrderV2
• payOrder
• saveOrder
• updateOrder
• updateOrderV2
• cancelOrder

Mogelijkheid om een slave order te betalen via API call payOrder ook als de bestelling nog niet op de slave aanwezig is.

Mogelijkheid om een slave order te annuleren via API call cancelOrder ook als de bestelling nog niet op de slave aanwezig is.

Gemiddelde inkoopprijs wordt nu ook teruggegeven met getProducts zie veld averagePurchasePrice

Geheugenlek verholpen.

Probleem verholpen waardoor getApiVersion soms access violations of integer overflows veroorzaakte.

De customfields van de artikel, relatie en medewerkerkaarten werkt nu met unicode.

The call getBranches once again works.

Probleem opgelost: Tafelbestellingen via de handheld kwamen niet meer binnen op het keukenscherm. Dit ging mis bij bestellingen op tafels waar al eerder op was besteld. Bestelling op lege tafel kwam wel goed binnen.

An incoming relationArticleDiscountList is once again properly processed.

In principe zelfde versie als 23.0.0, maar deze versie rapporteert zijn interne versienummer correct.

Externe referentie van de medewerker- (extEmployeeId) en relatiekaart (extRelationId) mag nu 512 karakters zijn, ipv. 50.

The function getTableList works again.

The function reportTurnoverByArticle now actually looks at the supplied turnoverGroupFilter.

De functie getTurnoverGroups kan nu aangeroepen worden met de parameter onlyActive om alleen omzetgroepen te retourneren die in gebruik zijn.

Nieuwe functie reportBranchPerformance die over een bepaalde periode per filiaal een aantal kernwaarden laat zien.

API v22.2.0 werkt niet goed samen met de laatste versie van de Q-line, daarom bij deze v22.2.1.

De functie getProducts is uitgebreid met de volgende functionaliteit:

• Er is een syncMarker veld toegevoegd aan preparationMethod.
• De product syncMarker word nu ook geupdate wanneer de preparationMethod.syncMarker wordt geüpdate.
• De syncMarker van de preparationMethod word ook gebruikt als je syncMarker als argument meegeeft aan de getProducts functie.

Prijsgroepen worden nu correct toegepast op basis van welke werkplek de bestelling plaats.

payOrder dacht van bepaalde orders ten onrechte dat dit filiaalorders waren en weigerde deze te betalen.

getPackingSlips werkt niet, geeft SQL error

getProducts() retourneert nu voor de bereidingswijzen (preparationMethod) ook de vatCode en vatPercentage.

Gebruik van ns:Uuid verwijderd sommige tools waaronder SoapUI gaven hier een foutmelding op.

It is now possible to indicate whether an order will be eaten in the establishment, or taken out. Use the property vatChange for this, with the possible values of VAT-CHANGE-TAKE-OUT and VAT-CHANGE-EAT-HERE.

queueBranchOrderPayment toegevoegd.

Met deze functie kunnen betalingen klaargezet worden voor filiaalorders die via queueBranchOrder aangemaakt zijn.

The function getArticlesInLayout didn't correctly return a different price set on a component article. It always returned the basis price of the article.

Regressie in functionaliteit van getStock ongedaan gemaakt. Als je getStock aanroept met branchNumber=0 krijg je nu weer de voorraad van alle filialen terug, in plaats van enkel die van het tussenfiliaal.

Nieuwe API call getSalePromotions toegevoegd hiermee kunnen de ingestelde sales en acties uitgelezen worden.

Resolved an issue in getStock when requesting stock from an intermediary branch during interbranch movements.

Resolved an issue in price calculation when a different vatPercentage is submitted, but no price.

De functie getAvailableTerminalList retourneert nu een SoapException als de Slave-configuratie niet compatibel is met tafelbestellingen.

Resolved an issue with missing column vor_bw_prijstype in certain functions.

Article ask-for is now also available through the API (article.askFor).

Price group (priceGroupNumber) added to the getBranches function.

Resolved an issue with missing column vor_bw_prijstype in certain functions.

getTerminalSettings() now also returns splitLineOnAddPreparationMethod

Solved an issue when working with preparation methods with a VAT percentage that differs from the normal VAT percentage of that preparation method.

It is now possible to call getProducts with productNumbers. This allows for the requesting of all the colour- and size-articles of a product.

Besides that, it is now also possible to add the parameter includeAllArticlesOfSelectedProducts when requesting by articleNumber, to include all the other colours and sizes of a product in the response.

The resullts of the function getOrderChanges have been improved in some instances.

Solved an issue where the API would fail when passing along the parameter siUnit in the function createProduct and updateProduct.

The resullts of the function getOrderChanges have been improved in some instances.

Resolved an issue that caused the API function queueBranchOrder to return a generic error when the supplied relationNumber did not exist in the administration. The generic error has been replaced with a specific error that explains that the relation could not be found.

The function getOrders once again returns entryBranchNumber, deliveryDate, deliveryPeriodBegin, deliveryPeriodEnd, invoiceAddress and deliveryAddress.

The API function getOrderChanges did not return the old and new total amount of a line if only the quantity of a line was changed. This made it hard to determine the financial consequences of a quantity change, since you would have to recollect a previous change to retrieve the price and use that in the calculation of the new amount. This will no longer be necessary.

When placing an order with text preparation methods, the entire line was being corrected and added again. That has been resolved now.

The installer for version 16.2.0 was missing a file. This has been resolved.

Delivery time (deliveryPeriod) will no longer be automatically filled out based on delivery date (deliveryDate), because this leads to delivery times of 00:00 (midnight).

The functions getPurchaseOrders and getPurchaseDeliveries no longer returns errors when the administration contains purchase orders or deliveries without lines.

Solved two issues where the API would give an unmerited error message, including one in findRelation.

Solved an issue where the API would fail when passing along the parameter siUnit in the function createProduct and updateProduct.

In various places the priceExcl is now being filled in, since this information is usually available.

Solved an issue where getPackingSlips would occasionally trigger errors.

New API function: getCurrentTableOrders()

If you use getStock with branchNumber 0, you now receive stock of all branches.

Solved an issue that temporarily made it impossible to create table orders.

Solved an issue when working with preparation methods with a VAT percentage that differs from the normal VAT percentage of that preparation method.

Solved an issue where getPackingSlips did not work when a packing slip was linked to a front-office transaction instead of a back-office transaction.

Solved an issue with getPackingSlips.

Solved a small issue in regards to delivery times of a table order.

Resolved an issue in getFinancialJournalByCashCount which could cause discrepancies in the resulsts.

Resolved an issue with the handheld and table orders containing a preparation method.

getPackingSlips return an error when filtering on date. Filtering on syncMarker did work properly.

Also when using getOrder to retrieve branch orders, the field order.branchOrderNumber will be filled, instead of order.orderNumber.

Fixed an issue in getProducts which caused almost all requests to fail.

When retrieving branch orders, the field order.branchOrderNumber will be filled, instead of order.orderNumber.

The fields article.colourSequenceNumber and article.sizeSequenceNumber have been added, this designate the position of the colour and size in the colour list and the size list, respectively.

Saving the field extRelationId now works correctly.

The API now checks if a valid siUnit is supplied when using createProduct and updateProduct. An invalid value will trigger a SOAP fault that explains this.

New function for retrieving packing slips: getPackingSlips

New API functions for managing activities:

• getActivities
• createActivity
• updateActivity
• deleteActivity

Also added the following properties:

• receipt.activityId
• invoice.activityId
• order.activityId
• proposal.activityId
• packingSlip.activityId

And the following filter properties:

• getReceipts(activityId)
• getInvoices(activityId)
• getOrders(activityId)
• getProposals(activityId)

The line.data now also contains (when applicable) cancelledQuantity and cancelledDecimalPlaces to return how much of an order line has been cancelled.

New function for retrieving cashdrawer balancing moments: getCashDrawerBalancingList

New V2 of the functions savePurchaseOrderV2 and savePurchaseDeliveryV2 where purchasePrice is a string instead of an int64. This allows for decimal values with more than two decimal places.

New V2 of the functions getPurchaseOrdersV2 and getPurchaseDeliveriesV2 that also return purchasePrice as a string instead of a int64 .

All functions that return relationNumber and relationName, now also return relationCategoryId and relationBankAccountNumber (e.g. getOrders, getReceipts, getInvoices).

The function getOrder now also returns a filled-in paymentList (as long as actual order down payments were made of course).

When articles, relations or employees have more than 117 cards fields, the creation or updating of these cards through the API did not work.

The resullts of the function getOrderChanges have been improved in some instances.

The function getOrder now also returns a filled-in paymentList (as long as actual order down payments were made of course).

getTicketCounterSales now also returns entryTimestamp and financialDate.

When retrieving tables (getTableList and getTableListV2), you will also receive configured NFC tags (also known as RFID or MIFARE). Amongst other things, this enables the Android order app to open tables based on NFC tags.

Solved an issue with lock-ups during execution of deliverOrder.

Added new API call: getRelationPoints. The syncMarker that is used here has also been added as relationPointsSyncMarker to the result of getCurrentSyncMarkers.

getTableListV2 now also returns the OnFloorPlan property.

Solved an issue when using component articles through the API.

Solved an issue: When applying a discount percentage to an article (eg. in the handheld), this article will no longer be designated as a return.

The function getOrder now also returns a filled-in paymentList (as long as actual order down payments were made of course).

Added support for the TURNOVER_GROUP_TYPE_BALANCE_UPGRADE type. In case unknown types are detected, the API will return these as TURNOVER_GROUP_TYPE_UNKNOWN.

Solved an issue when using component articles through the API.

payTableOrder now returns an extended error message, when certain problems occur.

Added support for CA-signed certificates when calling Webhooks.

The API now also supports the webhook event completeSession. This event is called when using the function payTableOrder(V2).

Resolved an issue in getFinancialJournalByCashCount which could cause discrepancies in the resulsts.

This version correctly works with the 11.0.0 database.

This version does not yet correctly work with the 11.0.0 database.

Under special circumstances, it was possible that createProduct and updateProduct froze.

The workplace number that is supplied with queueBranchOrder is now actually used when saving the branch order, instead of reverting to the default workplace 1.

The function getReceipts() has received an extra includeOrderReferences request parameter, which can be used to request references (receipt.orderIds) to the order(s) that preceded each receipt in the response. Default behaviour used to be that these references were automatically included, but this is no longer the case because it can severely impact performance.

We suspect few used these references, but if you are please update your integration. The PHP client has also been updated to support this parameter.

When articles, relations or employees have more than 117 cards fields, the creation or updating of these cards through the API did not work.

Under special circumstances, it was possible that createProduct and updateProduct froze.

Solved an issue with getRelations.

Solved an issue with getPurchaseOrders and getPurchaseDeliveries.

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.

Solved an issue with getPurchaseOrders and getPurchaseDeliveries.

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.

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.

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

Orders with weight articles that were updated through the API were always removed and added again, even though the respective lines did not change.

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.

getCashCountList now also returns the details of each extra workplace that was included in the count, through cashCountExtraWorkplaceList.

getReceiptsByCashCount could return more receipts than intended. Receipts from other branches that had a coincidental overlap with the selected cash count were also returned.

Orders with weight articles that were updated through the API were always removed and added again, even though the respective lines did not change.

The imageList of an article is now equal for all articles of a product.

The properties priceIncl, priceExcl, originalPriceIncl and originalPriceExcl are now filled out where they were missing.

The function getReceipts now also returns answered questions for every receipt, that were asked during the check-out process. These answers (and the accompanying questions) can be found in the property receipt.answerList.

Added the function setSubTableCount.

This function sets the maximum amount of sub tables of a table.

cancelInvoice has now been implemented. Cancelling an invoice creates a credit invoice for the cancelled invoice.

Where applicable, getArticleGroups now also returns the image of an article group (through image).

New functions: getRetailSpaceRental() and getRetailSpaceRentals().

New properties: order.orderBarcode, receipt.receiptNumber, receipt.receiptBarcode, invoice.invoiceBarcode, saveInvoice.info.invoiceNumber, saveInvoice.info.invoiceBarcode, articleStockHistory.invoiceBarcode, articleStockHistory.receiptBarcode.

New property: line.data.turnoverGroupAccountNumber. This contains the account number for the specific turnover group and the specific branch.

New functions getPurchaseOrders, getPurchaseDeliveries, savePurchaseOrder and savePurchaseDelivery, to respectively request and store purchase orders and purchase deliveries.

getInvoices and getReceipts now also return orderIds when the invoices or receipts are based of order(s). The property extOrderIds will also be returned when the original order(s) had these.

New function getLicenceInformation which can be used to retrieve information about the license, including which modules are enabled.

The function getLicenseInformation now also returns the value isGKS with each branch, which indicates whether or not the licensed branch has a GKS license.

New functions added to provide support for sub tables (e.g. table 1A, 1B, etc):

• getTableListV2
• getTableOrderCourseListV2
• requestNextTableOrderCourseV2
• cancelTableOrderV2
• printTableReceiptV2

New fields for sub tables:

• order.tableSubNumber
• MoveTableOrderRequest.tableSubNumber
• GetTableOrderRequest.tableSubNumber
• ReleaseTableRequest.tableSubNumber
• GetTableOrderCourseListResponse.tableSubNumber

If these new fields are not supplied, the default sub table 1 (A) will be used.

The property product.description will never be based on the description of a non-active article, if there are also active articles present.

The recent addition of turnoverGroupAccountNumber caused an error when it was not filled in.

Solved an issue that could occur when determining a free articleNumber when inserting new articles.

New function getTicketCounterSales().

Solved an issue that could occur when determining a free articleNumber when inserting new articles.

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 turnover group number (turnoverGroup) outside of the supported range (0-999) will now be refused.

getCashCountList now also returns the details of each extra workplace that was included in the count, through cashCountExtraWorkplaceList.

getReceiptsByCashCount could return more receipts than intended. Receipts from other branches that had a coincidental overlap with the selected cash count were also returned.

The imageList of an article is now equal for all articles of a product.

The properties priceIncl, priceExcl, originalPriceIncl and originalPriceExcl are now filled out where they were missing.

The function getReceipts now also returns answered questions for every receipt, that were asked during the check-out process. These answers (and the accompanying questions) can be found in the property receipt.answerList.

The properties order.lineList.line.pluNumber, .supplierRelationNumber and .supplierArticleNumber are now also filled out.

Since Q-line v8.0.0 it was possible to manage article button per branch. These locally managed article buttons are now also supported by the API.

It is now possible to import priceGroupList and salesPriceList through createProduct and updateProduct.

The property vatGroupList is now always present, even when its contents are empty.

When the pickup-and-delivery module is enabled, a new order will produce table-order-tickets, instead of order tickets

Solved an issue with stock changes caused by order changes.

Optimalisation which drastically reduces the overhead of each API call.

If the total of prepay payments is lower than the amount that was going to be prepaid, the API will now return an error.

When calling saveInvoice without a financialDate, the API did not automatically use the current financial date, but instead return an error message: Voorwaarde niet voldaan: BoekDag != TDate()

The function getReceipts now also returns answered questions for every receipt, that were asked during the check-out process. These answers (and the accompanying questions) can be found in the property receipt.answerList.

The imageList of an article is now equal for all articles of a product.

The properties priceIncl, priceExcl, originalPriceIncl and originalPriceExcl are now filled out where they were missing.

Solved a sometimes occurring issue with printing tickets when moving the contents of a table to another table.

When calling saveInvoice without a financialDate, the API did not automatically use the current financial date, but instead return an error message: Voorwaarde niet voldaan: BoekDag != TDate()

Optimalisation which drastically reduces the overhead of each API call.

To prevent a crash, a change has been made in the function that claims tables for specific workplaces.

Article links can now be read from the API through the property article.linkedArticleList.

To prevent a crash, a change has been made in the function that claims tables for specific workplaces.

Resolved an issue that could occur when processing composite articles.

Added support for v7.1.0.

Article links can now be read from the API through the property article.linkedArticleList.

To prevent a crash, a change has been made in the function that claims tables for specific workplaces.

To prevent a crash, a change has been made in the function that claims tables for specific workplaces.

Resolved an issue that could occur when processing composite articles.

getDatabaseVersion now contains serverMajorNumber, serverMinorNumber and serverRevisionNumber, which is the version of the database server. getApiVersion now contains serviceDate, which is the date of the machine where the API service is running. serverDate is now used for the date of the machine where the database is running.

The property tableStatus now remains set to TABLE-STATUS-TAKEN-AND-RECEIPT-PRINTED until a table has finished or until a change has been made to the table. Previously the table would change to TABLE-STATUS-TAKEN-AND-ACTION-REQUIRED or TABLE-STATUS-TAKEN-AND-TIME-LIMIT-REACHED after a variable amount of time.

getReceiptsByCashCount could return the same receipt for multiple cash counts . Obviously this was not our intent and has now been fixed.

Solved an issue that could occur when determining a free articleNumber when inserting new articles.

getReceiptsByCashCount could return the same receipt for multiple cash counts . Obviously this was not our intent and has now been fixed.

getReceipts didn't return results anymore when you filtered on date. Filtering by syncMarker did still work.

New function getReceiptsByCashCount() which can be used to retrieve all receipts in the period of the supplied cash count.

When reading tables through getTableList the returned tables now contain the properties createTimestamp (when the current order on the table started), changeTimestamp (when the current order on the table was changed), totalInclAmount, totalExclAmount and prepaidAmount. When the table has no current order, these properties will not be present.

Solved an issue with saveInvoice which caused the financial date that was supplied through financialDate to not be used with new invoices.

registerTerminal now returns an error message if you try to register a terminal without an uniqueDeviceIdentifier.

ArticleStockHistory now contains internalShipmentNumber and internalDeliveryNumber when relevant.

Added function getStockHistoryV2 that can be used to request stock history for more than one branch number.

Article now has a property stockArticle that signifies whether the article is a stock article.

getStockHistory now also returns invoiceNumber, receiptNumber and deliveryNumber in ArticleStockHistory (where applicable).

registerTerminal now returns an error message if you try to register a terminal without an uniqueDeviceIdentifier.

Minimal changes to part of the service defintion file (WSDL), which should solve the problem with a missing definition of a property type called ns__NumberLst.

To prevent a crash, a change has been made in the function that claims tables for specific workplaces.

getReceipts didn't return results anymore when you filtered on date. Filtering by syncMarker did still work.

New function getReceiptsByCashCount() which can be used to retrieve all receipts in the period of the supplied cash count.

registerTerminal now returns an error message if you try to register a terminal without an uniqueDeviceIdentifier.

ArticleStockHistory now contains internalShipmentNumber and internalDeliveryNumber when relevant.

Added function getStockHistoryV2 that can be used to request stock history for more than one branch number.

Article now has a property stockArticle that signifies whether the article is a stock article.

getStockHistory now also returns invoiceNumber, receiptNumber and deliveryNumber in ArticleStockHistory (where applicable).

Solved issues in getOrderChanges and getArticlesInLayout.

v6.3.0 was a wrong build, old bugs were reintroduced. This release is what v6.3.0 should have been.

Resolved an issue that could occur when processing composite articles.

getReceipts didn't return results anymore when you filtered on date. Filtering by syncMarker did still work.

New function getReceiptsByCashCount() which can be used to retrieve all receipts in the period of the supplied cash count.

Solved issues in getOrderChanges and getArticlesInLayout.

Minimal changes to part of the service defintion file (WSDL), which should solve the problem with a missing definition of a property type called ns__NumberLst.

Solved issues with regards to the release of table claims after (pre)payment and moving (parts of) orders.

Moving a full order to another table through moveTableOrder works properly again.

Solved an issue that could occur when calling payTableOrder on a table order with text preparation methods.

Solved an issue in getOrderChanges that prevented requests based on syncMarker from functioning properly.

Protocol version 1.0.1

A call to registerTerminal now also releases any possible claims to tables the terminal had.

getButtonLayout now also contains the optionally defined default main group (defaultMainGroup) and sub group (defaultSubGroup).

New function getOrderChanges, returns all changes to (table) orders, grouped by version number.

Downgrade to API v1.0.0.

Solved an issue in getOrderChanges that prevented requests based on syncMarker from functioning properly.

Protocol version 1.0.1

A call to registerTerminal now also releases any possible claims to tables the terminal had.

getButtonLayout now also contains the optionally defined default main group (defaultMainGroup) and sub group (defaultSubGroup).

New function getOrderChanges, returns all changes to (table) orders, grouped by version number.

New functions: getRetailSpaceRental() and getRetailSpaceRentals().

getStockHistory now also returns the stock values before (beforeCorrectionQuantity) and after (afterCorrectionQuantity) the correction, but of course only when the change was made through a correction. Even when the stock values before and after are equal, the change will be returned, so you can rely on afterCorrectionQuantity being present.

When getStock is requested based on stockId, the result is now also sorted on stockId.

The property article.categoryId was never being filled, even though it was defined in the object and could have a database value. This has now been added.

This releasenote does not really apply to the API, but is being placed here so the API developers will also receive it. It is now possible to submit an issue report for a specific API directly from the patner page. This will help our support team quickly determine the subject of the issue.

invoiceAddress and deliveryAddress is now properly stored when calling queueBranchOrder

New properties: order.orderBarcode, receipt.receiptNumber, receipt.receiptBarcode, invoice.invoiceBarcode, saveInvoice.info.invoiceNumber, saveInvoice.info.invoiceBarcode, articleStockHistory.invoiceBarcode, articleStockHistory.receiptBarcode.

The recent addition of turnoverGroupAccountNumber caused an error when it was not filled in.

New property: line.data.turnoverGroupAccountNumber. This contains the account number for the specific turnover group and the specific branch.

registerTerminal now returns an error message if you try to register a terminal without an uniqueDeviceIdentifier.

ArticleStockHistory now contains internalShipmentNumber and internalDeliveryNumber when relevant.

Added function getStockHistoryV2 that can be used to request stock history for more than one branch number.

Article now has a property stockArticle that signifies whether the article is a stock article.

getStockHistory now also returns invoiceNumber, receiptNumber and deliveryNumber in ArticleStockHistory (where applicable).

Solved an issue with saveInvoice which caused the financial date that was supplied through financialDate to not be used with new invoices.

Solved an issue that could occur when calling payTableOrder on a table order with text preparation methods.

Solved an issue that caused wrong numbers to be returned when using create and update of product, relation and employee.

When getStock is requested based on stockId, the result is now also sorted on stockId.

getStockHistory now also returns the stock values before (beforeCorrectionQuantity) and after (afterCorrectionQuantity) the correction, but of course only when the change was made through a correction. Even when the stock values before and after are equal, the change will be returned, so you can rely on afterCorrectionQuantity being present.

Allergens per article can be requested and saved. See the property allergenList of article for the required structure.

getArticlesInLayout now also uses the default price groups of the terminal that is doing the request and also takes into account differing prices for the specific branch.

Minimal changes to part of the service defintion file (WSDL), which should solve the problem with a missing definition of a property type called ns__NumberLst.

getButtonLayout now also contains the optionally defined default main group (defaultMainGroup) and sub group (defaultSubGroup).

New type for stock changes: STOCK_HISTORY_TYPE_MANUAL

getProducts has been heavily optimized to increase speed.

When getStock is requested based on stockId, the result is now also sorted on stockId.

getStockHistory now also returns the stock values before (beforeCorrectionQuantity) and after (afterCorrectionQuantity) the correction, but of course only when the change was made through a correction. Even when the stock values before and after are equal, the change will be returned, so you can rely on afterCorrectionQuantity being present.

paymentList in getJournals once again has contents, as intended.

The property product.description will never be based on the description of a non-active article, if there are also active articles present.

registerTerminal now returns an error message if you try to register a terminal without an uniqueDeviceIdentifier.

ArticleStockHistory now contains internalShipmentNumber and internalDeliveryNumber when relevant.

Added function getStockHistoryV2 that can be used to request stock history for more than one branch number.

Article now has a property stockArticle that signifies whether the article is a stock article.

getStockHistory now also returns invoiceNumber, receiptNumber and deliveryNumber in ArticleStockHistory (where applicable).

Solved an issue with saveInvoice which caused the financial date that was supplied through financialDate to not be used with new invoices.

When getStock is requested based on stockId, the result is now also sorted on stockId.

getStockHistory now also returns the stock values before (beforeCorrectionQuantity) and after (afterCorrectionQuantity) the correction, but of course only when the change was made through a correction. Even when the stock values before and after are equal, the change will be returned, so you can rely on afterCorrectionQuantity being present.

getProducts has been heavily optimized to increase speed.

Entering a value of PICKUP in the deliveryMethod of an order now translates into an actual pickup order, and a value of DELIVERY translates into a delivery order.

The function getTableList now also returns whether or not a table is ready to be served, through the tableStatus TABLE_ORDER_READY_TO_BE_SERVED.

New function getMessages() which returns the messages that have been sent to a specific workplace (branchNumber and terminalNumber). Optionally messages can be retrieved from a specific starting message ID (sinceMessageId). You can also specify whether the messages should be registered as having been "read" (setDelivered) and whether to only return unread messages (onlyUndelivered).

Account numbers through getTurnoverGroups and getPaymentMethods(V2) are now always returned, even if they have a value of zero or lower.