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
Opslaan van orders, pakbonnen, facturen en kassabonnen vereist ten onrechte dat je de averagePurchasePrice meegeeft.
Vanaf deze versie in minimaal Windows 7 of Windows Server 2008r2 vereist voor installatie van het programma.
Deze API-versie werkt niet goed samen met de Android Bestelapp.
getArticleGroups, groupNumber filter werkt niet hij retourneert alles
Het rekeningnummer (accountNumber) van (aan)betalingen op een kassabon, factuur of order klopt nu ook wanneer dit rekeningnummer afwijkt per filiaal of werkplek.
Het artikelveld Uitlopend is toegevoegd als discontinued. Dit veld geeft aan wanneer een artikel nog wel verkoopbaar is, maar qua voorraad niet meer aangevuld zal worden. Bijvoorbeeld doordat de leverancier gestopt is met de productie daarvan.
Probleem verholpen waardoor payOrder van backoffice order synchronisatie problemen met slaves kon veroorzaken.
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 updateConfigurationValuesNieuwe functie savePreparationMethodGroup hiermee kun je bestaande bereidingswijze groepen updaten of nieuwe aanmaken
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 getOrders is uitgebreid met een orderTypeList filter waarmee je nu ook evt. tafelbestellingen en cafetariabonnen kunt uitlezen.
De functie getOrders is uitgebreid met een orderTypeList filter waarmee je nu ook evt. tafelbestellingen en cafetariabonnen kunt uitlezen.
Nieuwe functie getTableOrderV3 waarmee je tafeldetails kan opvragen zonder een ns__Terminal mee te geven.
Nieuwe functie om voedingskenmerken van artikelen mee te wijzigen: updateArticleNutritionalCharacteristics
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 functie getArticleGroups werkt nu ook weer goed als je een syncMarker meegeeft.
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.
scram-sha-256 support voor postgresql authenticatie.
scram-sha-256 support voor postgresql authenticatie.
findRelation gebruikt nu een ORDER BY zodat hij een consistent antwoord geeft.
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
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.
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).
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 :
getArticleGroups filteren van toplevel groepen via groupNumbers werkt weer.
De functie getArticleGroups retourneert nu de product- en artikelnummers op volgorde.
Tevens is deze functie sneller gemaakt.
getArticlesInLayout retourneert nu ook de artikelen die enkel aanwezig zijn op de lokaal (per filiaal) beheerde knopgroep.
Nieuwe functie getStockCorrections welke voorraadcorrecties retourneert, zoals ook te vinden in de Qline onder Hoofdmenu > Voorraad > Correcties.
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.
Ondersteuning voor de bestellijst
Besteleenheid (orderQuantity) wordt nu ook opgeslagen door saveProduct en updateProduct.
Deze functies werken nu ook weer alle velden van de standaard artikeluitvoeringen correct bij.
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
De keuzes moeten gecodeerd als json array meegegeven worden aan het filter.
Reduceer geheugengebruik van getStockHistoryV2
Verbeterde afhandeling databasefouten.
Voorheen werden alle queryfouten hetzelfde gemeldt naar de client, namelijk dat er contact opgenomen moet worden met API Support.
Nu worden constraint-fouten naar de client gemeld als een probleem met de aangeboden data, want dat is vrijwel altijd de oorzaak.
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 getReceipts retourneer nu ook per kassabon het aantal geregistreerde gasten via numberOfGuests.
De ArticleSpecialPrice PRICE_NOT_FOR_SALE is toegevoegd (Niet verkoopbaar).
De purchaseBook functies bestaan nog wel, maar geven direct een foutmelding met verwijziging naar de nieuwe todoList functies die ter vervanging dienen.
De functie verifyCredentials zal voortaan eerst kijken of er een exacte match bestaat op het hoofdlettergebruik in de username, en daarna pas hoofdletters negeren.
Functies toegevoegd voor het werken met todolijsten.
findRelation gebruikt nu een ORDER BY zodat hij een consistent antwoord geeft.
De functie getTerminalSettings retourneert nu ook of je tijdens de direct-afrekenen modus ook nog tafelkeuze hebt, via directPaymentModeAllowTableSelection.
Via de API-functie updateBatch kunnen categorieën (multi_cats) nu ook bijgewerkt worden.
De functie getArticleVariants heeft een flinke speedboost gekregen.
saveStockCorrections geeft nu een foutmelding als een artikel dubbel in de lijst staat.
Het is voor de api namelijk niet zeker of dit een vergissing is en alleen de tweede regel geldig is of dat ze bij elkaar opgeteld moeten worden. Als ze opgeteld moeten worden kan de client dit eenvoudig zelf doen.
Tevens doet de verwerking nu niet meer 2 extra queries per regel maar slechts 2 extra queries per call.
De functie getPurchaseOrders(V2) ondersteunt nu ook het filteren op basis van de inkoopopdrachtstatus via de parameter purchaseOrderStates.
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.
updateProduct en createProduct werken weer.
Verhelpt een conversiefout in getReceipts.
Bugfix in getAuthorizationTree niet alle autorisatie items kwamen terug.
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.
getRelations kan nu omgaan met meerdere sub-records per relatie, en geeft deze relatie dan niet meerdere keren terug.
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.
Verbeteringen voor keukenmanagement.
Geheugen lek in getConfiguration call verholpen, wordt gebruikt door oa de QR-Bestelapp. De call is nu ook sneller.
Geheugen lek in getConfiguration call verholpen, wordt gebruikt door oa de QR-Bestelapp. De call is nu ook sneller.
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.
Verbetering in het maken van geprinte keukenbonnen en keukenmanagement maakbonnen wanneer regels worden verwijderd en weer toegevoegd worden aan orders.
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.
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.
GetOverview bugfix. Deze call gaf alleen de filiaalprijs terug als er ook gebruik gemaakt werd van prijsgroepen. Dit komt nu gewoon terug als je het ingesteld hebt ongeacht prijsgroep wel/niet.
Als je meer dan één prijsgroep/salesprijs hebt, maar bij het aanroepen van updateProduct niet alle prijsgroepen/salesprijzen meegeeft, dan wordt de informatie van de eerste prijsgroep of salesprijs die je wel meegeeft toegepast op de eerste prijsgroep/salesprijs in de database, ook al gaf je bijv. alleen informatie van de derde prijsgroep of de eerste salesprijs.
Dat probleem is nu opgelost.
Probleem verholpen waardoor de getActiveEmployeeList call een databasefout rapporteerde.
De functie getPurchaseOrdersV2 vult nu ook extPurchaseOrderId in (die bleef voorheen altijd NULL, ook al had deze wel een waarde).
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.
payOrder meldt niet meer ten onrechte "Specified orderId not found." als de order gequeued is voor een slave en deze hem nog niet verwerkt heeft.
Probleem verholpen waardoor payOrder weigerde een filiaalorder van een slave te betalen als deze order al naar de master gesynchroniseerd was.
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.