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

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.

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.

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.

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.

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

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

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 specefieke 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 specefieke 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.

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.

New type for stock changes: STOCK_HISTORY_TYPE_MANUAL

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 sales unit of an article is now also available through the API, in the property siUnit.

imageURL was not being filled in correctly in all applicable situations.

Where possible getStockHistory now returns the following related properties: stockId, packingSlipId, invoiceId, receiptId or correctionNumber.

payOrder now checks whether or not the supplied payment methods exist.

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

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.

getOrder now returns GET_ORDER_RESULT_NOT_FOUND when an empty orderId is supplied, in stead of an unintended error message.

getProducts has been heavily optimized to increase speed.

getOrder now returns GET_ORDER_RESULT_NOT_FOUND when an empty orderId is supplied, in stead of an unintended error message.

imageURL was not being filled in correctly in all applicable situations.

Where possible getStockHistory now returns the following related properties: stockId, packingSlipId, invoiceId, receiptId or correctionNumber.

Solved a problem that caused a failure when trying to load products based on PLU number.

Solved an issue that caused various functions to silently fail.

Solved an issue that prevented being able to split a table.

Solved an issue that could cause a database failure while trying to save a table order.

When creating a receipt for a table, it was possible that the API thought you were trying to split up the table order.

This caused the table to remain open, even though there was nothing left on the table.

payTableOrderV2 added, that accepts an additional keepTableName, which does what it says.

getTerminalSettings now returns the property askToKeepTableName, which indicates if this question should be asked when registering payment of a table.

When the button layout that you get through getButtonLayout contains non-existing articles, those are converted to text buttons and the button text is appended with "(article missing)."

The object Terminal now also contains the optional properties terminalSoftwareName and terminalSoftwareVersion. When these are filled out when calling registerTerminal, the contents of these values is also registered. Besides that the function now also registers when it was last called.

It is now possible to pay orders that consist of only text lines.

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

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

New type for stock changes: STOCK_HISTORY_TYPE_MANUAL

imageURL was not being filled in correctly in all applicable situations.

updateStock no longer returns an error state if the stock of a non-stock article is updated.

Solved a problem that caused a failure when trying to load products based on PLU number.

It was not possible to enter duplicate extArticleId's through the API, evne though it was not blocked in the database. The API now no longer checks for the existence of an extArticleId.

Solved an issue that was present since v2.1.0 that prevented turnoverGroup from being changed through createProduct and updateProduct.

When returning a branchAccountNumberList, the first extBranchId was never filled, even when it did exist.

getProducts returned erroneously returned the same article groups multiple times in the groupNumbers and sortOrderGroupList lists of articles.

queueBranchOrder was not yet checkink for duplicate extOrderId's in its own "buffer". This meant that if you were quick about it, you could add multiple orders with the same extOrderId.

getTurnoverGroups was returning an error message if you were using it in combination with separately configured account numbers per branch.

When the Mplus API Service is not run as a service, but directly or through a batch file, a blue text reading "MplusQservice running..." was shown in the top left corner. This text is now hidden by default. Through the start argument --visible this text can be made visisble again.

Each imageList no longer contains images that were deleted.

Support added for stock amounts (quantity), customer balances (balance) and customer credit limits (creditLimit) higher than 2.147.483.647.

Much optimization in processing orders and invoices. Amongst other things, this will reduce the total time it takes to save a table order.

As configured under the setting "POS > Tables > Remember table description", the name of a table will now be properly reset or remembered after completion.

Solved an issue introduced in v2.1.0 where turnover groups were always set to 0 if they were not fully configured.

Solved an issue introduced in v2.1.0 when saving orders.

Solved an issue where the imageList of an article sometimes contained the same image multiple times.

Solved an issue where preparation methods with an article number higher than 2.147.483.647 misfunctioned.

This release has been replaced by v2.1.1.

Solved an issue where transfer of payment between payment methods was not properly returned in the daily totals. This affected getJournals.

Both getInvoices and getReceipts had the problem that when you supplied a syncMarker higher than the highest value in the database, the function ignored the entire syncMarker filter and just started returning data from the start.

The functies getRelations, getProducts, getEmployees, getOrders, getInvoices and getReceipts are now all limited by the predefined default --sync_marker_limit. It is also possible to overwrite this limit with the syncMarkerLimit that can be added to the request. Naturally, the syncMarkerLimit only works in combination with syncMarker.

Solved an issue that occasionally occurred with findRelation, where it would not return the relation even though it did exist.

Solved an issue that occurred when birthDate was not given a value when adding (createRelation) or updating (updateRelation) a relation.

The "table-moved" ticket that is generated through the moveTableOrder function now correctly applies word aliases (this prevent the occurence of {Tafel} on the ticket). Also the employee is now properly displayed on the ticket.

When calling getProducts, getRelations and getEmployees and filtering on syncMarker, the results are now also returned sorted by syncMarker. This is something you would probably have to do yourself anyway when processing the results.

When getProducts is used to retrieve all products since a specific syncMarker, the product now contains all its articles in the articleList instead of just the articles since the provided syncMarker.

Because of our transition to a new IDE, we could no longer build the Mplus API Service as a console application. The log file of the API must now explicitly be set through the start up argument --output.

Solved a problem where transfer of payment between payment methods was not properly returned in the daily totals. This affected getJournals.

Both getInvoices and getReceipts had the problem that when you supplied a syncMarker higher than the highest value in the database, the function ignored the entire syncMarker filter and just started returning data from the start.

The functies getRelations, getProducts, getEmployees, getOrders, getInvoices and getReceipts are now all limited by the predefined default --sync_marker_limit. It is also possible to overwrite this limit with the syncMarkerLimit that can be added to the request. Naturally the syncMarkerLimit only works in combination with syncMarker.

getCashCountList now requires a WorkplaceYearNumber instead of a YearNumber as the third optional parameter. This was added because only a year and number is not an unique value across all cash counts.

Through the property active and the function updateProduct you can now set whether or not an article should be active.

Fixed a bug in the functions updateProduct, updateRelation and updateEmployee that was introduced recently.

When completely moving a table through the API function moveTableOrder, the "movement ticket" is now also printed on all relevant printer locations, as is expected.

The function getArticleGroups now also returns a list of all product numbers for every group.

The function payOrder with property prepay = TRUE now also supports a partial prepayment.

New function setStock that accepts an absolute value for the stock.

The parameter dataType of the object CustomField is now optional. When sending this to the API, you do not have to supply it, because the database knows which type these fields have.

The Article object now also contains the changeTimestamp and createTimestamp properties that contain the timestamp of the last change to an article and the timestamp when the article was first created, respectively.

When no productNumber is used in a call to updateProduct, the service will now try to determine the correct productNumber through the supplied articleNumbers.

Faster implementation of getReceipts added.

createProduct and updateProduct now properly process the customFieldList.

Added function getCustomFieldList which can be used to retrieve the custom fields from the article, relation and employee layout.

getActiveEmployeeList() now also returns the following authorization options for every employee: allowNextCourse,allowSplitandallowPay`.

Relation now also contains the property relationCode. Maximum length for this value is 128 alphanumeric characters.

The Transaction object now also contains the property extBranchId.

The VatGroup object now also contains the property extBranchId.

The Order, Invoice and Receipt objects now also contain the following properties: entryExtBranchId en financialExtBranchId.

The Payment object in a paymentList now also contains the properties entryTimestamp, branchNumber, extBranchId, workplaceNumber, employeeNumber and employeeName.

getProducts() now also supports the onlyActive parameter. When this is set to TRUE, only the active products are returned.

getTerminalSettings() now also returns unknownTableAction. This property indicates what should happen when an unknown table is selected.

allowTableRetour added to EmployeeName

When calling getJournals() the API stores which data served as source for the reply. The requester can add an optional reference.

New function requestTableOrderCourse() that can be used to request a certain course for a specific table.

payInvoice() now returns a proper message when a payment fails because the payment method is disabled.

New function logMistake() which can be used to record a mistake made on a handheld or similar device.

New function getTableOrderCourseList() which can be used to retrieve the currently present and already delivered course of a specified branch and table number.

Courses have new properties: sequenceNumber, isPresent and isDelivered.

New function getCardCategories which can be used to retrieve the categories of the article, relation and employee cards. For example, in the case of relations, these can be "Customer" and "Supplier".

Any menu prices are automatically applied. This can be disabled through a setting in the Mplus POS. When this setting is disabled, the POS will ask which menu's should be made when you open the table.

Menu information is now also added to article lines. Can be used to see whether or not an article line is part of a larger menu. The properties used are menuHash (unique value per menu combination), menuDescription (representable description of the menu), menuAmount (total amount of this article within the menu combination).

The BPE information (Dutch abbrevation that stands for Breakage/Promotion/Own use) is now also added to the article lines. This can be used to differentiatie between actual discounts and "discounts" because of breakage/promotion/own use. The properties used are bpeId (internal identification), bpeDescription (representable description), bpeAmount (amount incl. VAT), bpeAmountExcl (amount excl. VAT).

New API function getWordAliases that returns the configured word aliases. Can be used to translate a certain word to another word, like converting "Customer" to "Guest".

When retrieving an invoice you can now also see whether an invoice is finalized (finalized) and when (finalizedTimestamp).

When sending a message through sendMessage you can now also specify the sender and the messageType. Choose from OK, INFO and WARNING.

When retrieving a cash count through getCashCountList the account number of the difference is now also returned through the parameter differenceAccountNumber. The account number of the deposit account is also returned through the parameter depositAccountNumber.

You can now use the parameter sinceCashCountNumber to retrieve all cash counts since a certain cash count.

The function getJournals now also returns the payment type per payment method, such as: "PAYMENT", "EFT", "SUSPENSE, "DEPOSIT", "BPE".

You can now add the finalizeInvoices parameter to a getInvoices request to lock the invoices after retrieving them. Use this when you want to do a one-time export of the invoices to an external system, like accountancy software, to prevent the invoice from being changed anymore in the Mplus POS.

When requesting the version number of the API through getApiVersion there is a new parameter called serverDate which returns the set date of the API server and can be used to synchronize external devices with the server.

When retrieving cash counts through getCashCountList the first and last id's of the related receipts are also returned, via the properties shiftFirstReceiptId and shiftLastReceiptId. The first and last transaction (shiftFirstTransaction en shiftLastTransaction) now also contain the transaction label via the property transactionString.

The following objects now also contains the extBranchId (external reference for the branch): Branch, CashCount, Journal, FinancialGroup and Shift.

The API function getEmployees can now also be used with a syncMarker. Read the Sync Marker Tutorial for an in-depth explanation.

The API function getTurnoverGroups now also returns the externe account numbers that have been defined for every branch, through the list branchAccountNumberList.

API functions that return payment methods per branch (such as getFinancialJournal and getFinancialJournalByCashCount) now also return the correct account number (through the field accountNumber) when this differs from the default account number.

API functions that return turnover groups per branch (such as getFinancialJournal and getFinancialJournalByCashCount) now also return the correct account number (through the field accountNumber) when this differs from the default account number.

When an API function with customer fields is used (such as createProduct, createRelation or createEmployee) and the customer fields are required, but these are not supplied and don't have a default value, there will be a clear error message.

Through the field financialPeriodClosed, getFinancialJournal now also shows whether or not the period for which a financial journal has been requested has officially concluded. It is possible that a financial date doesn't end until 6 AM instead of midnight exactly.

Employee can now also be retrieved individually through getEmployee. Additionally, it now also returns the customer field (the customFieldList) and the following standard fields: syncMarker, changeTimestamp, createTimestamp, extraText, categoryId, personNumber.

When retrieving, creating and updating relations, it is now also possible to work with customer fields (the customFieldList) and the following standard fields: createTimestamp, bankAccountNumber, creditLimit, paymentWithinDays, vatNumber, commerceNumber, extraText, defaultVatMethod, neverPrintOrEmailReceipt, alwaysPrintReceipt, alwaysPrintLargeFormatReceipt, alwaysEmailReceipt, condenseCombinedInvoice.

When storing returned order line through saveTableOrder the API will also store a "reason for return" to be used in various reports.

getTableList() now also returns the information about the highest requested course of each table, through the properties courseNumber, courseName and courseAbbreviation.

getJournals can now be called without a branch filter, this will return all available branches.

It is now possible to insert and update the customer's card number through createRelation and updateRelation. The name of the field is cardNumber.

After running updateOrder it was possible for the API to try to generate a print job for the updated order. However, the wrong id was used for this, causing the updateOrder to crash to a halt with an exception.

Discount percentage was accidentally inverted when saving a counter line. This gave problems, for example when calculating the total amount of a line.

Negative decimal amounts were not correctly returned. Every amount was rounded to the nearest integer.

When running getJournals with a filter for receipts or invoices the list with payments (paymentList) and VAT groups (vatGroupList) will now also be properly filtered.

When the customer is using a Master/Slave setup, it is now possible to set a wait time during which the function saveOrder will wait until the Slave has synchronized a branch order. By default this wait time is set to 0 seconds. In that case the API does not wait at all. There is also an upper limit of 5 minutes.

By checking the function result you can see whether or not the order has been synchronized to the Slave. When the parameter orderQueued is set to TRUE, the order still has to be synchronized, when it is set to FALSE it has already been synchronized and you can rest assured that the Slave has received the order.

The functionality of queueBranchOrder has been combined with saveOrder. This means the API developer no longer has to pay attention to calling the proper function based on the master/slave-configuration of the customer. If the order has been added to the queue of a slave-branch, the function will return a special boolean called orderQueued with value TRUE.

If the rate for a certain VAT-code has not been properly configured in Mplus, the API will now return the following error message: The rate for VAT-code 2 is not properly configured. Please contact API support at dev@mpluskassa.nl.

This prevents the misconfiguration being missed and wrong tax rates being used by our API developers.

Problem solved where turnover groups with accents and other strange characters in their names could not be requested.

When retrieving relations the properties active, changeTimestamp and syncMarker are now properly filled out. There is also a new property, createTimestamp.

Problem solved in updateRelation that caused failure in updating certain properties of relations, like the active parameter.

The number of receipts returned by getReceipts when searching from a specific syncMarker is now also configurable through the parameter sync_marker_limit. Default is 1000.

Sped up implementation of getReceipts, which is not only much faster than the old implementation, but also returns a limited amount of receipts, to prevent memory problems.