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.
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.
Als tijdens het starten van een sessie (startSession) op een tafel ook direct regels aan de orders worden toegevoegd (via lineAdditions), dan veroorzaakt dat geen fout (!m_IsOpgeslagen) meer in opvolgende boekingen op de tafel.
Probleem verholpen waardoor payOrder van backoffice order synchronisatie problemen met slaves kon veroorzaken.
Ondersteuning voor de vernieuwde artikeluitvoeringen.
createAndPayTableOrder toegevoegd
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.
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.
createAndPayTableOrder toegevoegd
createAndPayTableOrder toegevoegd
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.
Werking van savePurchaseOrder en savePurchaseOrderV2 verbeterd.
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.
Het is nu mogelijk om getPurchaseOrders of getPurchaseOrdersV2 aan te roepen met purchaseOrderNumber of extPurchaseOrderId om een specifieke purchase order in te lezen.
De customfields van de artikel, relatie en medewerkerkaarten werkt nu met unicode.
(ook aanwezig in 24.0.2 maar niet in tussenliggende versies)
getKitchenTicket call response uitgebreid met tafel of bestelnummer
updateProduct en createProduct werken weer.
Verhelpt een conversiefout in getReceipts.
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.
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.
queueBranchOrder crashte als je geen extOrderId mee gaf.
Fixes in de articleVariants (artikel uitvoeringen).
Probleem in saveProduct verholpen waardoor deze mislukte zonder toelichting.
Gemiddelde inkoopprijs wordt nu ook teruggegeven met getProducts zie veld averagePurchasePrice
Probleem verholpen waardoor het invoeren of bijwerken van artikelen, medewerkers of relaties kon mislukken.
Herstellen van database connecties werkt nu betrouwbaarder en efficienter.
API v26.3.0 bevatte een compilatiefout waardoor in elk geval het bijwerken van relaties (updateRelation) problemen kon opleveren.
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.
Geheugenlek verholpen.
Probleem verholpen waardoor getApiVersion soms access violations of integer overflows veroorzaakte.
