saveSalesRepeatTemplate ondersteunt nu ook yearlyDateMonth en yearlyDateDay, tevens zijn die velden nu optioneel, wat ze al hoorden te zijn.

Opgelost dat de entryTimestamp van betalingen die de getInvoices, getOrders en getReceipts teruggaven niet juist waren.

Opgelost dat getTableOrderV3 geforceerd niet samenvoegen een hogere prioriteit gaf dan geforceerd wel samenvoegen.

getTableOrderV3 uitgebreid met de optie forceCondensedLines. Deze optie negeert de eventuele uncondensedLines optie en wat er in de Q-line qua verdichting staat ingesteld. De teruggegeven regels (ns__Line) bevatten nu ook een uncondensedLines lijst. Dit zijn de regels waarop de verdichte regels gebaseerd zijn.

De determinePricing call geeft nu ook priceExcl, discountAmountExcl en amountExcl terug.

Opgelost dat als een artikel terugroepactie ongedaan gemaakt is d.m.v. setArticleRecalled, de getOverview aanroep alsnog de vorige terugroepactie teruggaf.

Opgelost dat het mogelijk was om een al teruggeroepen artikel nogmaals terug te roepen d.m.v. de setArticleRecalled API functie. De API kan nu één van de volgende foutmeldingen teruggeven: SET-ARTICLE-RECALLED-FAILED-ALREADY-RECALLED of SET-ARTICLE-RECALLED-FAILED-NOT-YET-RECALLED.

Opgelost dat getConfiguration de keukenmanagement instellingen potentieel dubbel teruggaf. De group was dan de ene keer "Keukenmanagment" en de andere keer "keukenmanagment". Nu is dit altijd met kleine letters. Dit had tot gevolg dat onder andere de narrowcasting schermen de instellingen niet goed kon inlezen.

Geheugenlekken verholpen in:

• getConfigurationValues
• updateConfigurationValues
• getArticleGroupChanges

Opgelost dat de webhooks ten onrechte een INVALID_APPLY_TO_QUANTITY error gaven met een session.line.id die niet in de response zat. Dit gebeurde voor negatieve regels in de session.

Versnelt het ophalen van:

• financieel journaal
• facturen
• orders
• pakbonnen
• kassabonnen
• offertes

placeTableOrder heeft request parameter releaseTable er bij gekregen, als deze wordt weggelaten is deze true zodat oude gedrag in stand blijft.

updateLastTableActionTime toegevoegd aan de tableProperties van changeTableProperty. Indien updateLastTableActionTime true is zal changeTableProperty de laatste handeling van de tafel updaten zodat de tafelstatus kleur van oranje naar groen gaat.

Het is nu mogelijk om een kastelling uit te voeren via de API. Hiervoor zijn twee nieuwe API-calls beschikbaar:

1. getCashCountInfo: Retourneert alle benodigde informatie voor het uitvoeren van een kastelling op basis van de opgegeven bronwerkplek en het medewerkernummer.
2. saveCashCount: Registreert de kastelling op basis van de gegevens verkregen via getCashCountInfo. Hierbij wordt verwacht dat een werkplek uit de getCashCountInfo-respons wordt gekozen, de betaalwijzen worden samengevoegd en de getelde bedragen worden ingevuld. Indien er een storting plaatsvindt, moet ook de bestemming van de storting worden opgegeven.

Het interfiliale planningsalgoritme dat door de RunnerApp gebruikt wordt is nu ook via de API aan te roepen via de nieuwe call runInterbranchPlanner.

Dit is ook voorbereiding op het kunnen integreren van de RunnerApp in de mpluskassa.online suite.

Nieuwe API call setArticleRecalled toegevoegd. Hiermee kan een artikel teruggeroepen worden, of een terugroeping ongedaan gemaakt worden.

recalled veld toegevoegd aan getOverview voor producten. Geeft een JSON structuur terug indien het product teruggeroepen is. Formaat:

{
  "reason": "Test reden",
  "recalledOn": "2025-02-28T10:01:54.271711"
}

Nieuwe getFloorplans API call toegevoegd. Deze API call geeft alle tafelplattegronden terug voor het meegegeven filiaal, inclusief of ze momenteel actief zijn, en alle bijhorende wijken. De tafelplattegrond definities worden in JSON formaat teruggestuurd.

De API calls getOrders, getInvoices, getPackingSlips, getProposals en getReceipts zijn efficiënter geworden. Vooral getOrders en getInvoices zijn aanzienlijk sneller indien er heel veel verkoopobjecten teruggegeven worden.

Als de functie savePurchaseOrderV2 tijdens de verwerking tijdens een fout aan loopt in een van de aangeleverde opdrachtregels, dan wordt in de response nu aangegeven op welke regel het probleem zich heeft voorgedaan, samen met andere nuttige informatie.

API calls getBranchInformation, savePurchaseOrderV2, savePurchaseDeliveryV2 uitgebreid ter voorbereiding op online functionaliteit voor inkoop-orders met betrekking tot het opvragen en doorgeven van ontvangstadres gegevens

Als je een lege regeltekst (line.text) meegeeft aan registerGiftcardPayment(v2), dan wordt deze nu niet meer gebruikt om de artikelnaam te overschrijven. Dit lost het probleem op van lege tekstregels op deze bonnen.

Het veld payment.externalPaymentId wordt nu ook daadwerkelijk ingevuld bij het opvragen van kassabonnen, bestellingen, etc.

Opgelost dat in de response van de API call adjustPoints het nieuwe puntsaldo is opgenomen in plaats van het saldo van voor de wijziging

Verhelpt de foutmelding: "This order is currently being paid on terminal ..." vanuit de determinePricing call.

Opgelost dat samengestelde componenten in het resultaat van getReceipts LINE-TYPE-NONE hadden i.p.v. LINE-TYPE-COMPONENT.

Probleem uit v59.8.8 opgelost, het is weer mogelijk om een externalPayment-flow uit te voeren via de API.

getTableOrderV3 controleert nu niet meer of het werkplektype mobiel is.

Als je meerdere webhooks hebt geconfigureerd die naar scanCode luisteren, maar de eerste heeft een pattern filter waardoor het event niet wordt doorgestuurd, dan krijg je nu niet meer de lege response van die eerste webhook terug via de API.

Fix voor placeTableOrder wanneer deze door de kiosk werd gebruikt op een filiaal waar geen tafelplatttegrond gekoppeld is gaf de call de volgende foutmelding: A supplied branch number does not exist in the database ERROR: insert or update on table "tafel_data_plattegrond" violates foreign key constraint "tafel_dataplattegrondfiliaal_nr_plattegrond_nr_fkey" DETAIL: Key (filiaal_nr, plattegrond_nr)=(4, 0) is not present in table "tafel_plattegrond".

De getEmployeeAuthorizationSyncMarkers call houdt nu bij het bepalen van de authGroepRechtenSyncMarker en authGroepSyncMarker ook rekening met de gekoppelde filiaalgroep-autorisatiegroepnummers van de medewerker.

Api getSubTableList: het medewerker-nummer en naam zijn nu toegevoegd aan het resultaat van de api call getSubTableList

API: Snelheid van het openen van de tafellijst gettable (in online) verbeterd

Opgelost dat bij een IDEMPOTENCY_RESULT_REPLAY_RESPONSE response, de methoden placeTableOrder, createInvoiceFromPackingSlips en payOrderV2 niet correct de voucherIssuances en unappliedVoucherIssuances terug gaven zoals bij de oorspronkelijke aanroep.

Het is niet langer mogelijk om payOrder(V2) te gebruiken voor het afrekenen van tafelbestellingen. Gebruik in plaats daarvan payTableOrderV2 of placeTableOrder. Deze wijziging voorkomt tevens een SQL-fout die optrad wanneer payOrder(V2) werd gebruikt bij een tafelbestelling zonder gekoppelde relatie.

De API gaf onterecht de waarde 3 terug in plaats van YEAR in het geval van bpeConfiguration.budgetPeriod.

Opgelost dat o.a. getOrders in het resultaat nooit discountAmountExcl invult.

Opgelost dat API geen requests meer kon afhandelen nadat een verloren verbinding succesvol opnieuw opgezet werd.

Opgelost dat wanneer je met determinePricing of placeTableOrder een menu samenstelt via de velden menuId en menuLinesId, bij succesvolle creatie van het menu de oorspronkelijke tempId niet werd teruggegeven op het nieuwe menu hoofdartikel.

getOrderHistory kon een foute query genereren, wat de volgende foutmelding in de API veroorzaakte:

> trailing junk after parameter at or near

De API stuurt nu altijd het webhook scanCode object door, ook als de scannedCode leeg is, op die manier is het consistent met de Q-line.

De response van GetInvoices en GetReceipts (en GetInvoice en GetReceipt) is uitgebreid met de verkoopcategorie informatie.

Opgelost dat het updaten van een artikel btw-code er voor kon zorgen dat de API een SQL foutmelding teruggaf, indien er geen brutoprijs was ingesteld op het artikel en er gebruik werd gemaakt van de verkoopprijs. Deze fout kon optreden bij alle formule velden die opnieuw berekend moesten worden omdat een refererend veld veranderd werd en er uit de formule geen waarde kwam.

getTableOrderV3 had al een optie om de opgevraagde tafel ook te claimen, maar je kunt nu ook een bestaande claim overschrijven via '<claimMethod>FORCE</claimMethod>'.

Als je via de API een tafel claimt, dan wordt de claim nu ook daadwerkelijk bij alle andere werkplekken verwijderd.

Opgelost dat getPaymentMethods en getPaymentMethodsV2 een SQL error konden geven indien de cadeaukaarten ook opgevraagd werden.

Opgelost dat getOverview een SQL error kon veroorzaken, wanneer er gebruik wordt gemaakt van een sortOrder.

Probleem opgelost dat je in sommige gevallen geen inkoopopdrachten of inkoopleveringen via de API meer kon aanmaken.

Via sendWebhook kun je nu ook de events startSession, pauseSession, resumeSession, and cancelSession versturen.

1. getPackingSlips geeft nu ook proposalId, extProposalId, proposalNumber terug als de pakbon is gemaakt op basis van een order welke gemaakt is op basis van een offerte.
2. getInvoices resultaat toevoegingen:

• orderNumbers
• packingSlipIds, packingSlipNumbers indien de factuur gemaakt is op basis van één of meerdere pakbonnen.
• proposalIds, extProposalIds, proposalNumbers iendien de factuur gemaakt is op basis van een offerte, of op basis van een pakbon die gemaakt is op basis van een order welke gemaakt is op basis van een offerte.

3. getProposals resultaat toevoegingen:

• orderNumber
• packingSlipIds, packingSlipNumbers indien er op basis van de offerte een order is gemaakt waarvan weer pakbonnen zijn gemaakt.
• invoiceIds, extInvoiceIds, invoiceNumbers indien er op basis van de offerte een factuur is gemaakt, of er op basis van de offerte een order is gemaakt waarvan weer pakbonnen zijn gemaakt waarvan weer facturen zijn gemaakt.

4. getOrders resultaat toevoegingen:

• invoiceNumbers
• packingSlipIds, packingSlipNumbers indien er op basis van de order pakbonnen zijn gemaakt.
• proposalId, extProposalId, proposalNumber indien de order op basis van een offerte is gemaakt.

Daarnaast opgelost dat een pakbon/factuur soms geen order informatie terug gaf, en vice versa.

Nieuwe API-call getPrintLayoutMarkup waarmee je een printlayout kunt genereren in een bepaalde opmaak. Momenteel wordt enkel nog de Star Document Markup ondersteund.

getOverview ondersteunt nu ook de filter operators BIGGER_OR_EQUAL en SMALLER_OR_EQUAL.

getReceipts retourneert nu ook evt. tableNumber/tableSubNumber. Ook kun je nu direct op basis van specifieke receiptIds opvragen.

Nieuwe API call toegevoegd printPrintLayout om een print lay-out naar een printer te sturen die aan de Q-line gekoppeld staat. De printer en print lay-out combinaties van Beheer - Instellingen - Print lay-outs toewijzen worden hiervoor gehanteerd.

De functie getEmployeeAuthorizationSyncMarkers heeft nu ook een employeeBranchGroupSyncMarker die wijzigt als er een filiaalgroep aan de desbetreffende medewerker wordt gekoppeld of ontkoppeld. Tevens wordt nu ook direct de desbetreffende employeeSyncMarker geretourneerd.

Je kunt nu de branchGroupSyncMarker opvragen met getCurrentSyncMarkersV2.

De API retourneert nu ook webhookConsumerId bij de lineAdditions, lineChanges, en lineDeletions, zodat je weet welke webhook-koppeling de regels heeft aangeleverd.

Het opslaan/aanmaken van een order d.m.v. de API respecteert nu de aangegeven sequenceNumber om de volgorde van de regels te bepalen.

Bij het aanmaken van een factuur op basis van een order, bijv. bij deliverOrderV2, wordt de kredietlimiet van de relatie nu pas gecontroleerd nadat evt. aanbetalingen verrekend zijn. Als de gehele order immers al aanbetaald was, zal het krediet van de relatie niet wijzigen.

Mocht de kredietlimiet alsnog overschreden worden, dan volgt er nu een duidelijkere terugkoppeling in de errorMessage.

Opgelost dat als een artikel gedeeltelijk van een tafel wordt afgesplitst, en datzelfde artikel daarvoor ook al eens gedeeltelijk was afgesplitst op diezelfde tafel, de daarbijhorende keukenscherm maakbonnen niet worden geüpdate.

Opgelost dat getOverview een SQL foutmelding kon geven.

• ERROR: syntax error at or near AND
• column reference nr is ambiguous

cancelOrderV2 kan nu ook een geannuleerde order weer niet geannuleerd maken. Dit werkt alleen voor niet-filiaalorders.

saveSalesRepeatTemplate gedrag aangepast, als er een regelid meegegeven wordt zal die regel aangepast worden. Als er een bepaalde regel niet meer meegegeven wordt, zal die verwijderd worden. Als je een nieuwe regel meegeeft zonder id zal die toegevoegd worden.

cancelOrderV2 kan nu ook een geannuleerde order weer niet geannuleerd maken. Dit werkt alleen voor niet-filiaalorders.

saveSalesRepeatTemplate gedrag aangepast, als er een regelid meegegeven wordt zal die regel aangepast worden. Als er een bepaalde regel niet meer meegegeven wordt, zal die verwijderd worden. Als je een nieuwe regel meegeeft zonder id zal die toegevoegd worden.

cancelOrderV2 kan nu ook een geannuleerde order weer niet geannuleerd maken. Dit werkt alleen voor niet-filiaalorders.

saveSalesRepeatTemplate gedrag aangepast, als er een regelid meegegeven wordt zal die regel aangepast worden. Als er een bepaalde regel niet meer meegegeven wordt, zal die verwijderd worden. Als je een nieuwe regel meegeeft zonder id zal die toegevoegd worden.

cancelOrderV2 kan nu ook een geannuleerde order weer niet geannuleerd maken. Dit werkt alleen voor niet-filiaalorders.

saveSalesRepeatTemplate gedrag aangepast, als er een regelid meegegeven wordt zal die regel aangepast worden. Als er een bepaalde regel niet meer meegegeven wordt, zal die verwijderd worden. Als je een nieuwe regel meegeeft zonder id zal die toegevoegd worden.

cancelOrderV2 kan nu ook een geannuleerde order weer niet geannuleerd maken. Dit werkt alleen voor niet-filiaalorders.

saveSalesRepeatTemplate gedrag aangepast, als er een regelid meegegeven wordt zal die regel aangepast worden. Als er een bepaalde regel niet meer meegegeven wordt, zal die verwijderd worden. Als je een nieuwe regel meegeeft zonder id zal die toegevoegd worden.

cancelOrderV2 kan nu ook een geannuleerde order weer niet geannuleerd maken. Dit werkt alleen voor niet-filiaalorders.

saveSalesRepeatTemplate gedrag aangepast, als er een regelid meegegeven wordt zal die regel aangepast worden. Als er een bepaalde regel niet meer meegegeven wordt, zal die verwijderd worden. Als je een nieuwe regel meegeeft zonder id zal die toegevoegd worden.

cancelOrderV2 kan nu ook een geannuleerde order weer niet geannuleerd maken. Dit werkt alleen voor niet-filiaalorders.

saveSalesRepeatTemplate gedrag aangepast, als er een regelid meegegeven wordt zal die regel aangepast worden. Als er een bepaalde regel niet meer meegegeven wordt, zal die verwijderd worden. Als je een nieuwe regel meegeeft zonder id zal die toegevoegd worden.

Fix voor de melding "502 Bad Gateway" die voor kon komen bij de API calls voor saveInvoice en creditInvoice.

getSubTableList geeft nu ook claimedBy terug en houdt rekening met het actuele subtafel aantal. Daarnaast worden tafels niet meer teruggegeven als ze puur alleen standaard waardes bevatten, daar is getMainTableList voor bedoeld.

getOverview heeft nu ondersteuning voor filiaal_brutoprijs en filiaal_verkoopprijs. Hiervoor moet branchNumber in de request ook ingevuld zijn.

Optimalisatie van getOverview doorgevoerd, waardoor filters op categorie veel sneller zijn geworden.

Opgelost dat het mogelijk was dat updateOrderV2 soms een kortingspercentage niet toepast omdat er ook een automatische korting toegepast kon worden.

Er is nu een releaseTableV2 die aangeroepen kan worden zonder geregistreerde terminal.

Opgelost dat determinePricing het meegegeven kortingspercentage niet toepast als er onderwater automatisch een prijsgroep toegepast wordt.

Opgelost dat er een duidelijkere foutmelding wordt geretourneerd als CreateRelation wordt aangeroepen op een API die een slave db connectie heeft. (Dit wordt alleen ondersteund voor API's met een master-db connectie)

Alle releasenotes van API v59.5.2.

Probleem met deze API versie: Subtafels verdwijnen direct na toevoegen in online handheld.

Databasefout in de API opgelost bij het uitvoeren van getNutritionalCharacteristics voor een relatie.

API calls houden nu rekening met relatie budgetten.

Opgelost dat in een API call maximaal 100.000 regels in een elementlijst kan worden doorgegeven. Maximum verhoogd tot 2.147.483.647 (max.voor 32bits gehele getallen)

getWebhookConsumers kan nu aangeroepen worden met een syncMarker en retourneert nu ook:

• event.polling
• event.cancelRequiresAuth
• pattern.reject
• articleFilter
• companyName
• priority
• syncMarker

Opgelost dat getPurchaseDeliveries de volgende foutmelding gaf:

ERROR:  missing FROM-clause entry for table "artikel"

De API call getPrintLayouts is nu aan te roepen met een extra fieldType filter om enkel layouts in te lezen die een bepaald veldtype bevatten.

De functie determinePricing retourneert nu ook de opgestuurde webhookData.

Verhelpt dat de API een soapfault geeft als je getOverview een INCOLLECTION filter geeft met een lege lijst.

Opgelost dat Api call getfinancialjournal de btw specificatie ook doorgeeft als voor een omzetgroep het verkoopbedrag 0 is en het inkoopbedrag hoger is dan 0

getArticlesVariants is nu aanzienlijk sneller

Databasefout in de API opgelost bij het uitvoeren van getNutritionalCharacteristics voor een relatie.

API: Incidenteel een afrondingsfout in de berekening voor totaalincl bedragen van een (bon)regel bij percentage korting en volledig spaarpunten verzilveren

Een BoostAssertionException opgelost die kon optreden als je een inkoopopdracht of inkooplevering bewerkte zónder een aritkeluitvoering te specificeren.

Diverse verbeteringen aan opslaan van inkoopopdrachten en levering

• Melding "Voorwaarde niet voldaan: riter->LevelVerpakking > 0" verholpen
• Onterechte meldingen "No article variants found with this articleVariantId" verholpen, in sommige gevallen kan het zijn dat hij nu een andere melding geeft met het werkelijke probleem.
• Controle of op leverancier gebeurd nu bij opdrachten als dit aangezet is en nooit bij leveringen
• Controle op leverbaarheid van de uitvoering gebeurd nu alleen bij opdrachten niet bij leveringen

De API call createInvoiceFromPackingSlipsRequest keurde een lege forcedActivityId altijd af, ook al is die parameter optioneel.

Probleem opgelost waardoor het niet meer mogelijk was verkooporders af te drukken.

Api call getOrderChanges : Er is opgelost dat als er alleen een syncmarker in de request aanwezig is, en de lijst van dus ordertypes leeg is, dat dan de wijzigingen van alle ordertypes in de response wordt doorgegeven in plaats van alleen die van verkoop-, herhaal-, en externe-orders.

Opgelost dat getSubTableList ook tafeldata van andere filialen terug kon geven.

De properties dialog.dialogIdAsString en dialog.options[].optionIdAsString worden nu ook geserialized in de idempotency opslag.

Contractregels ondersteuning toegevoegd.

1. determineContractLines call toegevoegd die de contractregels teruggeeft op basis van de meegegeven regels.
2. Resultaat uit determineContractLines kan doorgegeven aan API calls die een LineList verwachten.
3. getOrders, getReceipts, getPackingSlips, getProposals, getInvoices geven nu allemaal ook de opgeslagen contractregels terug.
4. getSalesRepeatTemplates heeft nu een contractFrequencyFilter om specifieke contracten op te vragen. In het resultaat staat ook een contractFrequency.
5. createOrder(V2) en saveOrder vullen automatisch de contractLines in indien die nog niet ingevuld waren.

Opgelost dat API call getRenderedPrintLayout bij het opvragen van de afdruk van meer dan een factuur de juiste factuurinformatie voor alle facturen oplevert.

MplusQAPIService: Extra filters voor call getSalesRepeatTemplates. Er kan nu ook op specifieke 'template-ids' en/of template types (ORDER/FACTUUR) gefilterd worden

getOrderCategories geeft nu ook de categorie afhankelijkheden terug via orderCategoryDependencyNumbers. Aanmaken/bewerken van orders geeft nu het volgende bericht terug als het niet mag i.v.m. afhankelijkheden van de orderCategoryNumber:

Invalid orderCategoryNumber supplied. Ensure that the category exists, and that the category is either dependent on the current category, or that it, AND the current category have no dependencies.

Daarnaast worden ook de wijzig autorisaties van die categorieën gecontroleerd.

MplusQService API: Opgelost dat voor updateProduct de update van prijsgroep informatie correct wordt uitgevoerd (en tevens voor salesprijzen)

Het is nu mogelijk om d.m.v. scannedVoucherIssuanceCodes gescande vouchers door te geven aan determinePricing, placeTableOrder, createOrderV2 en createOrderV3. determinePricing geeft in zijn resultaat daarnaast ook nog een lijst terug van scannedVoucherIssuances.

Het is nu mogelijk om voucher uitgifte ingangsdatums aan te geven door pendingVoucherIssuanceStartTs op ns__LineData of ns__PlaceTableOrderLineDataElem in te vullen.

getTableOrderV3 geeft nu ook de voucher uitgifte kandidaten terug in voucherIssuanceCandidates.

MplusQAPIService: nieuwe API call getOrdersByExtOrderIds: opvragen van orders aan de hand van de externe referentie(s)

unappliedVoucherIssuances (vouchers die niet toegepast zijn i.v.m. een verzilver restrictie) toegevoegd aan response van de onderstaande calls:

• CreateInvoiceFromPackingSlips
• DeliverOrder
• DeliverOrderV2
• PayTableOrder
• CreateAndPayTableOrder
• PlaceTableOrder
• PrepayTableOrderV2
• PayOrder
• PayOrderV2
• CreateInvoiceFromProposal
• CreateOrderFromProposal

getVoucherSettings call toegevoegd waarmee in bulk de instellingen van verschillende vouchers opgevraagd kan worden. De requestedVoucherId is een voucher id die opgevraagd werd, voucherId is de voucher id + versie van de instellingen, die daar daadwerkelijk voor teruggegeven is. (Als je b.v.b. versie 0 opvraagd, krijg je de nieuwste versie terug.)

Opgelost dat het kortingspercentage wordt gecontroleerd bij het toevoegen of een wijzigen van een relatie. Het kortingspercentage van een relatie mag maximaal 100 procent zijn (en moet hoger dan 0 zijn)

getNutritionalCharacteristicsRequest ondersteund nu combinatie van syncMarker en numbers filter.

Voorheen retourneerde zo'n request de data voor alle gevraagde nummers, nu is deze data ook werkelijk gefilterd op syncMarker en het antwoordt bevat ook de syncMarkers.

getVoucherIssuances heeft nu een fromDate en throughDate in het request object.

De API zal nu minder vaak de melding input is too large for an __int64 geven bij het inlezen van orders, bestellingen, kassabonnen, facturen, etc.

Bugfix:getProducts gedrag; customfields: multiselect velden worden doorgestuurd ook als deze voor het artikel/product nog geen waarde hebben.

Het is nu mogelijk om via DeliverOrder en DeliverOrderV2 een kassabon aan te maken, eerder kon alleen maar een factuur aan worden gemaakt.

Het is nu mogelijk dat er automatisch een factuur kan worden afgedrukt nadat een order betaald wordt via de api via de call payorder. Dit is afhankelijk van een instelling: Beheer->Instellingen->Instellingen, Api->Afdrukken 'Automatisch printen van de factuur'

Tevens is er een bug opgelost dat de instelling voor Automatisch printen van de kassabon ook gecontroleerd wordt, deze instelling was er al wel maar werkte nog niet.

getJournals zorgt er nu voor dat de teruggegeven betalingen voor JOURNAL-FILTER-ORDER opgeteld nu altijd op 0 uitkomt, door tegen te boeken op de "Verrekening aanbetaling" betaalwijze. Zodra er daadwerkelijk omzet is gemaakt, zullen deze betalingen namelijk opgehaald kunnen worden met JOURNAL-FILTER-RECEIPT/JOURNAL-FILTER-INVOICE.

Als je dialog.id of dialog.options[].id "asString" doorgeeft, dan wordt dat nu ook goed doorgespeeld in de uiteindelijke webhook payload.

Alle releasenotes van 58.4.3 zitten hier ook in.

bugfix API call 'getordersbyreceiptids'

De moveTableOrder API calls houden nu ook rekening mee met of er op de virtuele relatie aanwezigheidstafel range geboekt mag worden of niet, afhankelijk van hoe die instellingen staan.

Het is nu mogelijk om via de nieuwe API call getOrdersByReceipts de ordergegevens op te vragen aan de hand van een lijst van receipt-ids (kassabon-ids)

Opgelost dat saveSalesRepeatTemplate een access violation SOAP exception kon geven.

Opgelost dat getOrders deze error teruggaf: Unknown consumption location indien je gebruik maakte van consumptie locaties per regel.

Opgelost dat setRelationPresence aangaf dat de tafel bezet was, indien er aangemeld probeerd te worden op een tafel die nog nooit eerder gebruikt was.

Opgelost dat setRelationPresence soms ten onrechte aangaf dat de tafel al bezet was als er een specifieke subtafel werd gebruikt om op aan te melden.

Het ns__Address object bevat nu ook supplierInformation. Dit is informatie voor een specifieke leverancier dat ingevuld kan staan op ontvangstadressen van inkoopopdrachten.

Nieuwe instelling toegevoegd waarmee aangegeven kan worden of het verplicht is om een deliveryAddress in te vullen voor savePurchaseOrderV2.

forcedActivityId toegevoegd aan de CreateInvoiceFromPackingSlips request. De aangegeven activiteit id zal gebruikt worden indien er pakbonnen zijn opgegeven met verschillende activiteiten. Dit werkt alleen als de nieuwe instelling aan staat.

Verzamelfactuur kunnen maken van pakbonnen met verschillende activiteiten

isSupplierGroup toegevoegd aan ns__CardCategorie. Hiermee geeft getCardCategories nu terug of het om een leverancier relatie categorie gaat.

createRelation en updateRelation ondersteunen nu beide branchesNonPurchasable.

findRelationV2, getRelation en getRelations geven nu allemaal branchesNonPurchasable terug. Dit zijn de filialen waarop geen artikelen besteld mogen worden van deze leverancier.

setRelationPresence zal nu ook relatie synchronisatie starten op de slave als de relatie gewijzigd is op de master

De placeTableOrder call geoptimaliseerd.

Verhelpt probleem dat bij gebruik van placeTableOrder om af te rekenen met automatisch afdrukken van de bon aan de TSE gegevens missen op de bon.

getPackingSlips, getReceipts, getInvoices werkt weer.

De createOrder functies trekken niet meer de component prijs af van de opgegeven prijs.

Tevens probleem opgelost dat de functie faalde met een assertion failure nadat de order correct opgeslagen was.

getOrders retourneerd nu ook deliveredQuantity en cancelledQuantity

Het oude menu systeem houdt nu ook rekening met SUP artikelen op het hoofdartikel van menu's. Het nieuwe menu systeem hield hier al rekening mee. Lost vreemde situatie op in de api. Neem bijvoorbeeld de volgende situatie:

1. saveTableOrderV2 met een menuartikel. Oude menu systeem voegt automatisch hoofdartikel toe. Hoofdartikel hoort normaal gesproken ook een SUP toeslag subartikel te krijgen. Dit wordt nu niet gedaan.
2. getTableOrderV2 om de order zoals die op de tafel staat op te vragen.
3. payTableOrderV2 om deze order af te rekenen. De api geeft terug dat de VerkoopPrijsIncl niet overeen komt, omdat payTableOrderV2 door heeft dat het SUP toeslag subartikel mist, en dit automatisch toevoegt aan de regels die zijn meegegeven. Echter komt dat dus niet meer overeen met wat er op de tafel staat.

Via een instelling is het oude gedrag van de getPackingSlips functie (van vóór v48) weer te activeren. Daardoor retourneert deze functie alle uitgifte-types, en niet enkel pakbonnen.

Herstelt dat oa getTableOrderV3 verkeerde aantallen voor bereidingwijze kon retourneren als uncondensedLines false is. Hier had oa de Android handheld last van.

getNutritionalCharacteristics geeft nu ook de allergieën terug van de ingrediënten van een artikel

Opgelost dat de minimum prijs berekening van een artikel de minimum prijs van een verplichte bereidingswijze op het hoofdartikel meenam op de prijs van een vervangend artikel, indien het vervangend artikel goedkoper is. Dit is niet logisch omdat de bereidingswijze keuze voor het hoofdartikel is, niet voor het vervangend artikel. Deze berekening kan d.m.v. min_price_incl opgevraagd worden met de getOverview call.

Opgelost dat getArticleVariants een SOAP exceptie gaf als de call artikelen probeerde terug te geven welke geen uitvoeringen bevatten.

Verholpen dat in de WSDL en documentatie miste dat sommige response types een basis type hadden.

Dit verhelpt dat calls die deze types retourneerden niet goed werkten als je de service importeerde in visual studio.

Als de API een betaling probeert uit te voeren op een betaalwijze die wel aanwezig is, maar uitgeschakeld, dan veroorzaakt dat nu geen fout meer.

Het uitschakelen van een betaalwijze moet invloed hebben op de keuze welke betaalwijzes je kan selecteren, maar als er eenmaal een betaling op uitgevoerd is mogen we die niet meer weigeren.

Dit lost bijvoorbeeld de volgende foutmelding op: One or more payment methods are NOT enabled WEBSHOP.

Oplossing gevonden voor het probleem dat meldingen als "No order.orderId specified" en "Error while trying to save packing slip of order." kon veroorzaken bij het betalen van een tafel via de online handheld.

Error logging uitgebreid voor placetableorder

Probleem opgelost met savePurchaseDelivery.

getPackingSlips, getReceipts, getInvoices werkt weer.

MplusQAPI: Controle op aanwezigheid en inhoud van het veld 'reference' bij saveProposal en saveInvoice is vervallen

Opgelost dat getPurchaseDeliveries(V2) een verkeerd totalExclAmount kon laten zien op de regel wanneer er met verpakkingen gewerkt werd. Daarnaast ook opgelost dat quantityOfPackagesDelivered niet ingevuld was terwijl dat wel moest gebeuren.

Lost probleem op waardoor API meer CPU belasting kon geven dan zou moeten.

Opgelost dat updateProduct altijd alle prijsgroepen en salesprijzen van de te updaten artikelen afhaalde. Om toch nog specifiek een prijsgroep/salesprijs van een artikel af te halen met deze call, is dit mogelijk door alleen de priceGroupNumber/salesPriceNumber in te vullen.

Crash opgelost in de getOverview call wanneer de min_price_incl opgevraagd werd van een artikel dat d.m.v. menu/vervangend artikel/bijverkoop zichzelf weer kon verkopen. Dit lost bijvoorbeeld de volgende scenario op:

artikel A -> artikel B (vervangend artikel) -> artikel A (bijverkoop)

Verhelp "Database error on the server" foutmelding bij getPurchaseDeliveriesV2

Fout zat er in sinds v58.3.0.

deliverOrderV2 levert nu weer de opgegeven aantallen ipv een volledige levering te doen.

Nieuwe idempotent API call toegevoegd: registerGiftcardPaymentV2. Het is noodzakelijk om aan deze nieuwe call een lineList op te geven. Het totaalbedrag van alle regels is uiteindelijk de cadeaupas betaling. De call maakt automatisch een kassabon, een transactie en historie aan, om de cadeaupas betaling te verantwoorden.

De oude registerGiftcardPayment call verwacht nu ook een lineList, en zal intern doorverwijzen naar registerGiftcardPaymentV2.

Het is nu mogelijk om via payInvoice en placeTableOrder een cadeaupas betaling te doen. Het is noodzakelijk om een giftcardNumber aan de betaling mee te geven, als je een cadeaupas betaalwijze opgeeft. De cadeaupas betaling zal terechtkomen in het cadeaupassen overzicht.

De setRelationPresence zal nu de melding "Can't move relation to table, the requested table is not empty." terug geven, wanneer de tafel die in de request wordt meegegeven al bezet is door een relatie.

Nieuwe call getBranchInformation voor het ophalen van stamgegevens van filialen.

ns__Line bevat nu ook retourReason. Verkooptypen die retourneren ondersteunen vullen in hun calls retourReason in.

Twee nieuwe API calls: getMainTableList en getSubTableList. De calls kunnen gebruikt worden om een tafellijst op te bouwen, i.p.v. getTableListV3 te gebruiken. getMainTableList geeft de hoofdtafels terug van het meegegeven filiaal met de absolute basis data. getSubTableList geeft alle subtafels terug die afwijken van de standaard met hun specifieke data.

Het is nu mogelijk om aan placeTableOrder en andere API calls die een order aanmaken/aanpassen een fooi/toeslag artikel toe te voegen. Het is de bedoeling dat dan alleen het artikelnummer en prijs van de fooi/toeslag ingevuld wordt. De overige regel waarden wordt automatisch door de API ingevuld.

Alle calls die een order retourneren, zoals getOrder(s) of findOrder, bevatten nu ook het "bestelnummer" dat ingevuld wordt door (tafel)bestelbonnen. In de API heet dit veld cateringOrderNumber.

Nieuwe call linkGiftcardsToRelation toegevoegd. Deze call kan gebruikt worden om een of meerdere cadeaupassen aan een relatie te koppelen.

Probleem in de API gefixed voor Online Handheld betalingen in Duitsland (issue met place-tableorder en TSE/Fiscaltrust module)

Opgelost dat placeTableOrder, prepayTableOrderV2, payTableOrder en payTableOrderV2 de volgende foutmelding konden geven als er een receiptFooter werd teruggegeven als antwoord op een completeSession webhook, die niet als blocking was ingesteld:

The request caused a constraint error in the database, most likely some of the data supplied is incorrect.

Fix dat SetRelationPresence ten onrechte de volgende exceptie kon geven: The request is trying to add duplicate data to the database, please check your inputs

Gefixed dat een getupdateV2 call naar de MplusQAPIService de tekstregelposities in de orderregels behoudt

getInvoices geeft nu ook onderstaande velden terug:

- orderCategoryNumber
- creditedReason
- sessionId

Update 20-8-2024: In de response van elke API call die een ns__Line teruggeeft, wordt ns__Line::suppressDisposableComponent en ns__Line::tempId weglaten indien ze geen waarde hebben.

getReceipts en getInvoices geven nu in hun resultaat terug van welke kassabon/factuur de eventuele creditering gemaakt is. Zie ns__Receipt::creditedReceiptId en ns__Invoice::creditedInvoiceId

Nieuwe idempotente API call toegevoegd: createInvoiceFromPackingSlips. Deze API call kan gebruikt worden om van één of meerdere pakbonnen een factuur te maken.

Het is nu mogelijk om proposalIds of proposalNumbers mee te geven aan getProposals. Daarnaast bevat ns__Proposal nu orderCategoryNumber.

Nieuwe idempotente saveTodoListV2 die een todolijst zowel kan toevoegen (branchNumber, category en name vereist) en als bijwerken (id vereist).

Opgelost dat getInvoices, getOrders, getPackingSlips, getProposals, getReceipts en getSalesRepeatTemplates deze error konden teruggeven:

Database error on the server. Please contact API support at dev@mpluskassa.nl.

Fix voor raceconditie in setRelationPresence call als er gelijktijdig 2 relaties aangemeld worden bij hetzelfde filiaal was er een kans dat ze hetzelfde tafel nummer toegewezen kregen.

Verhelpt probleem waardoor de API de juiste regels niet kan vinden tijdens het splitsen van een bestelling. Trad op als er spaarpunt attributen van de omzetgroep van het artikel waren gewijzigd.

Sinds payOrderV2 in v58 is toegevoegd, werkte payOrder niet meer. Dat is bij deze opgelost.

Als er ooit een artikel verkocht is met omzetgroep 0, geven de API-functies reportTurnoverByTurnoverGoup, reportTurnoverByArticle en reportBPE nu geen foutmeldingen meer, in plaats daarvan retournerneren ze de standaardwaarde voor omzetgroep.

Bij het doorgeven van eftTransactionDetails kan nu ook worden aangegeven dat de betaling betaald is via een offline-modus.

(state = EFT-TRANSACTION-STATE-PAID-OFFLINE)

getFinancialJournal geeft nu ook purchaseAmount terug voor groep types anders dan BPE.

De idempotente calls placeTableOrder en createOrderV3 doen nu geen lock meer op de transactietabel, maar vertrouwen op het retry-mechanisme van de API om bij een evt. conflict de order nogmaals proberen te plaatsen.

Alle idempotente requests hebben nu in principe ondersteuning voor het automatisch herhalen van een request als er tijdens de uitvoer een potentieel gelijktijdigheidsprobleem optreedt.

Dat wil niet automatisch betekenen dat vaker herhalen altijd het probleem zal oplossen.

getConfiguration geeft nu ook per terug, wat aangeeft of de instelling per kassa, filiaal of globaal ingesteld mag worden.

Oplossing gevonden voor het probleem dat meldingen als "No order.orderId specified" en "Error while trying to save packing slip of order." kon veroorzaken bij het betalen van een tafel via de online handheld.

Lost probleem op waardoor API meer CPU belasting kon geven dan zou moeten.

Release van API v57.5.0

Subtiele raceconditie in IdempotentRequests opgelost waardoor bij de parallel uitvoer van twee identieke requests, de ene request niet goed "zag" dat de andere request al hetzelfde gedaan had.

Daardoor kon de tweede call allerlei verschillende fouten gaan geven omdat de uitvoer dus niet meer mogelijk was.

Er wordt ook in deze situaties nu weer correct teruggevallen op het IdempotentRequest principe, waardoor beide calls exact hetzelfde antwoord geven, zonder foutmeldingen, en zonder dubbele uitvoer.

Verhelpt probleem waardoor getArticlesInLayout tekst bereidingswijze dubbel retourneerde. Deze call wordt door de MplusKASSA Android Bestel App gebruikt.

Probleem opgelost waardoor getCurrentTableOrders alle orders retourneerde als er geen actieve tafelorders waren. Dit resulteerde bij klanten met veel historie in out of memory errors.

Verhelpt probleem waardoor de API de juiste regels niet kan vinden tijdens het splitsen van een bestelling. Trad op als er spaarpunt attributen van de omzetgroep van het artikel waren gewijzigd.

Het is nu mogelijk om met findRelation een relatie te zoeken op custom velden.

Order.reference is nu niet meer verplicht bij het aanmaken/aanpassen van orders.

getRenderedPrintLayout geeft nu een error terug als het om een bon print lay-out gaat, dat als PDF gerenderd dient te worden. Dit is alleen mogelijk voor grafische print lay-outs (A4).

Opgelost dat het aanpassen van een orderregel op een verkooporder er voor zorgt dat na het opslaan alle geleverde aantallen van de verkooporder verdwenen zijn.

Opgelost dat het verplaatsen van een volledige tafel order d.m.v. moveTableOrderV2 en moveTableOrderV3 de volgende foutmelding gaf als er gebruikt werd gemaakt van TSE:

Error on the server. Please contact API support at dev@mpluskassa.nl.
Voorwaarde niet voldaan: Order.VersieNr > 1

Opgelost dat placeTableOrder niet meer TSE-data opstuurde. Dit lost onder andere het probleem op dat een tafelorder doen en/of betalen met de Android handheld geen TSE-data opstuurt.

Uitbreiding van getArticleVariants. ArticleVariant bevat nu een lijst van leveranciers (suppliers) welke relationNumber, isPreferredSupplier en isPurchasable bevatten.

Opgelost dat priceType van een determinePricing regel een niet valide waarde bevatte als het om een tekstregel ging.

Opgelost dat splitsen d.m.v. moveTableOrderV3 een SOAP exception gaf als de te splitsen tafel wijzigingen heeft gehad, door bijvoorbeeld meerdere keren artikelen op de tafel te boeken.

Bugfix updateProducts ging mis wanneer er alleen een update of een insert gedaan moest worden.

Gaf dan een UPDATE-PRODUCT-RESULT-FAILED in de response.

getOrders error opgelost:

Database error on the server. Please contact API support at dev@mpluskassa.nl.

Fix voor API request PayTableOrderV2: error: You're trying to move more articles than were in the original order.' als sales-en-acties actief is op artikelen

Ondersteuning toegevoegd om via de sendWebhook call ook de startPayment en cancelPayment webhooks te triggeren.

De volgende API calls hebben nu ondersteuning om op basis van een of meerdere ids of numbers te filteren:

• getPackingSlips.packingSlipIds & packingSlipNumbers
• getInvoices.invoiceIds & invoiceNumbers
• getOrders.orderIds & orderNumbers

getCardCategories houdt nu rekening met eigenaarslabels als het eigenaarslabelssysteem en het filiaalgroepensysteem aan staan.

createImage en createImageFromUrl retourneren nu een aparte resultaatcode CREATE_IMAGE_NOT_SUPPORTED als het uploaden van afbeeldingen via de API überhaupt niet ondersteund wordt, omdat MIS niet aan staat. Zo zien we het sneller in onze online apps.

De call getPackingSlips retourneert nu ook:

• packingSlipType
• orderCategoryNr
• vatMethod
• sessionId

De functie placeTableOrder ondersteunt nu ook het doorgeven van een levertijdstip (via deliveryPeriodBegin).

getOrders, getInvoices en getPackingSlips input validatie minder restrictief gemaakt. Het is daardoor nu weer mogelijk om een sync marker en datum filter toe te passen.

Opgelost dat kassabonnen/bestelbonnen niet uitgeprint werden wanneer er gebruik werd gemaakt van het nieuwe print lay-out systeem.

Probleem opgelost als je een order ging opslaan mét deliveryPeriodBegin maar zónder deliveryPeriodEnd.

Opgelost dat wanneer met updateArticleGroup d.m.v. sortOrder een artikelgroep naar de één na laatste plek werd gesorteerd, de artikelgroep op de laatste plek terechtkwam.

Foutmelding opgelost als je in een GKS-administratie een tafel volledig wilde verplaatsen.

Het kassaldo en kasverschil dat geretourneerd wordt door reportPrintableFinancialTotals() wordt nu niet meer verborgen, mits de medewerker daarvoor geautoriseerd is.

De functie updateProduct geeft nu ook apart een foutmelding als een opgegeven artikelnummer al bestaat: UPDATE_PRODUCT_RESULT_FAILED_ARTICLE_NUMBER_ALREADY_TAKEN

Database connectie herstel werkt weer.

Elke API-call retourneert nu het versienummer van de API in een aparte Mplus-Service-Version response header.

Bijvoorbeeld:

Mplus-Service-Version: 57.2.0.0

Opgelost dat het uitvoeren van de getJournals of getFinancialJournal API call een foutmelding gaf.

Database error on the server. Please contact API support at dev@mpluskassa.nl.

GetBranchGroups API call geeft nu ook per filiaalgroep ownerLabelId terug, als het filiaalgroep een gekoppelde eigenaarslabel heeft.

De functie getAuthorizationTree retourneert nu onlineAuthorizationsVersion en de functie updateOnlineAuthorizationTree accepteert nu onlineAuthorizationsVersion. Op die wijze is snel te controleren of de autorisatieboom up-to-date is.

Als het nieuwe filiaalgroepen systeem aan staat, zal de getCardCategories API call nu op basis van de Mplus-Employee header de kaart categorieën ophalen, i.p.v. op basis van de Mplus-Workplace header.

Lost probleem op waardoor de API vooral voor online extra traag kon zijn als de optie "Mag een medewerker op meerdere werkplekken tegelijk ingelogd zijn?" aan stond.

Probleem opgelost waardoor je geen categorieën meer kon bijwerken via createProduct, updateProduct, createRelation, updateRelation, createEmployee en updateEmployee.

Optionele workplaceNumber toegevoegd aan getButtonLayoutGroupDetails, daarnaast is de al bestaande buttonLayoutGroupId ook optioneel gemaakt. Wanneer er een workplaceNumber en een branchNumber wordt meegegeven, zal de snelknoppen indeling details van de huidig actieve snelknoppen lay-out voor de meegegeven werkplek teruggegeven worden.

getOverview bevat nu twee nieuwe velden: owners en owners_uuid. owners geeft per medewerker het nummer van elk gekoppelde eigenaarslabel terug, owners_uuid geeft gelijk de uuids terug van elk gekoppelde eigenaarslabel.

Er wordt nu rekening gehouden met filiaalgroepen en eigenaarslabels in:

- GetCardCategories
- GetButtonLayoutGrupsWithAssignedWorkplaces
- UpdateEmployeeAuthorizationGroups
- GetEmployeeAuthorizations
- GetEmployeeBranchAuthorizations
- GetEmployeeAuthorizationGroups

ownerFilter en branchGroupFilter toegevoegd aan:

- ReportArticlePerformance
- ReportAverageSpending
- ReportBPE
- ReportBranchPerformance
- ReportPaymentMethods
- ReportPrintableFinancialTotals
- ReportTables
- ReportTurnoverByActivity
- ReportTurnoverByArticle
- ReportTurnoverByBranch
- ReportTurnoverByEmployee
- ReportTurnoverByTurnoverGroup
- ReportTurnover
- ReportCancellations
- GetReceipts

Nieuwe instelling toegevoegd waarmee aangegeven kan worden of de filiaalspecifieke artikel omschrijving aangepast mag worden met de saveArticleBranchDeviations call. Als dit niet mag, zal de oude filiaalspecifieke omschrijving gebruikt worden, of zal er geen omschrijving gezet worden indien die er nog niet was.

API: Gefixed dat de wijziging voor het alternatieve btwcode veld ook wordt opgeslagen in de database

getBranches geeft nu ook voor elke werkplek de externe referentie terug onder de naam extWorkplaceId indien de externe referentie niet leeg is.

DeterminePricing gaat nu correct om met arrangementen. Je kan nu een orderId of table meegeven, waarmee de bestaande order wordt bepaald, om die regels mee te nemen in de prijsberekening. Daarnaast kan je nu aan elke regel een tempId meegeven, die ook weer teruggegeven wordt, om gemakkelijker de regels te identificeren. Tenslotte wordt er nog een priceType teruggegeven. Wanneer die op PRICE-TYPE-FIXED staat, gaat het om een arrangement.

De API is nu zelf in staat om bij idempotente requests (zoals placeTableOrder) zelf een aantal retries te proberen als er een concurrency issue voorkomt. Dit vermindert de kans dat de call mislukt door bijv. een detected deadlock.

De functie getPaymentMethodsV2 retourneert nu optioneel ook de bpeConfiguration. Stel hiervoor in de request de parameter includeBpeConfiguration in.

Ook is het nu mogelijk om in de request te filteren op paymentMethodTypes.

API Service: getOrderHistory : medewerker die betaling heeft gedaan toegevoegd

getButtonLayoutGroupForBranch retourneert nu de knoptekst van de artikelkaart in articlesInLayouts.buttonText.

Dit is tbv. de android handheld.

getInvoices, getReceipts en getOrders vullen nu net zoals getInvoice ook de onderstaande Payment velden in, indien van toepassing.

branchNumber
extBranchId
workplaceNumber
employeeNumber
employeeName

Probleem verholpen met de webhooks (HTTP_PARSING_ERROR).

Sinds een recente update ging de API waar mogelijk ineens onbedoeld proberen te communiceren via HTTP/2. Dit werd echter nog niet goed ondersteund door de rest van onze software. Daarom wordt nu geforceerd dat we altijd HTTP/1.1 gebruiken.

Opgelost dat savePurchaseOrderV2 geen besteleenheden opsloeg, indien die op de artikelen ingesteld stonden. Daarnaast geeft getPurchaseOrdersV2 nu ook de besteleenheid terug onder de naam orderUnit.

API call getArticlesInLayout retourneert nu weer alleen daadwerkelijke bereidingswijzegroepen, en niet bijverkoop of vervangend artikelen.

Opgelost dat reportTurnoverByEmployee de volgende foutmelding gaf wanneer een omzet gemaakt was met een medewerker nummer hoger dan 2.147.483.647.

Database error on the server. Please contact API support at dev@mpluskassa.nl.

Elke tien minuten voert de API een statuscontrole van de databaseverbinding uit. Als er tijdens deze controle iets mis ging, dan werd de volgende controle direct uitgevoerd ipv. tien minuten later. Dat is nu opgelost.

Probleem opgelost in placeTableOrder als je wel numberOfGuests meegeeft, maar geen lineList.

Het is nu mogelijk om expliciet de order types mee te geven aan getCurrentSyncMarkersV2. Standaard zijn dit SALES_ORDER, REPEAT_SALES_ORDER, en EXTERNAL_SALES_ORDER.

Elke API-call retourneert nu het versienummer van de API in een aparte Mplus-Service-Version response header.

Bijvoorbeeld:

Mplus-Service-Version: 56.3.0.0

De functie createOrderV2 retourneert nu ook het ingevulde order-object bij een filiaalorder (Slave-filiaal) die binnen de "Wachttijd synchronisatie Master naar Slave" verwerkt is, en bij het resultaat CREATE_ORDER_RESULT_EXT_ORDER_ID_ALREADY_EXISTS.

Dit maakt het gedrag van de call weer consistent ongeacht of het filiaal toevallig een Slave is.

getOverview geeft nu de juiste minimumprijs terug.

Probleem verholpen met de webhooks (HTTP_PARSING_ERROR).

Sinds een recente update ging de API waar mogelijk ineens onbedoeld proberen te communiceren via HTTP/2. Dit werd echter nog niet goed ondersteund door de rest van onze software. Daarom wordt nu geforceerd dat we altijd HTTP/1.1 gebruiken.

Probleem opgelost in placeTableOrder als je wel numberOfGuests meegeeft, maar geen lineList.

Gefixed dat de wijziging voor het alternatieve btwcode veld ook wordt opgeslagen in de database

Opgelost dat o.a. getOrders, getInvoices en getPackingSlips de volgende foutmelding teruggaven:

Kolom niet gevonden: afl_adres_bedrijfsnaam

De placeTableOrder call geeft een foutmelding in de handheld als de instelling Aantal gasten verplicht aan staat

Ondersteuning voor voedingswaarden toegevoegd in de API.

getNutrientTypes: geeft de voedingswaarde types terug

updateArticleNutrients: update de voedingswaarden voor een bepaald artikel

Daarnaast is er een nieuw veld voor getOverview, nutrients. Dit geeft in een JSON-structuur de ingestelde voedingswaarden voor een artikel terug.

API-calls getPrintLayouts en getRenderedPrintLayout zijn nu zichtbaar in de ?wsdl en ?docs.

Deze calls kunnen gebruikt worden om via de API een print van een layout van het nieuwe printlayoutsysteem te maken.

Wanneer je via de saveArticleBranchDeviations wijzigingen inschoot werd de artikel syncmarker niet geüpdatet.

Crash opgelost die kon voorkomen als je moveTableOrder gebruikte terwijl de instelling "automatisch korting toepassen" uitgeschakeld was.

Opgelost dat o.a. getOrders, getInvoices en getPackingSlips de volgende foutmelding teruggaven:

Kolom niet gevonden: afl_adres_bedrijfsnaam

Verhelpt probleem waardoor het aanmaken en wijzigen van artikel-, medewerker- of relatiekaarten kan blijven hangen.

Probleem kan optreden bij oa letters met accenten.

Probleem verholpen met de webhooks (HTTP_PARSING_ERROR).

Sinds een recente update ging de API waar mogelijk ineens onbedoeld proberen te communiceren via HTTP/2. Dit werd echter nog niet goed ondersteund door de rest van onze software. Daarom wordt nu geforceerd dat we altijd HTTP/1.1 gebruiken.

Eerdere fix uit 55.0.7 miste nog op 55.1.x

Opgelost dat o.a. getOrders, getInvoices en getPackingSlips de volgende foutmelding teruggaven:

Kolom niet gevonden: afl_adres_bedrijfsnaam

De functie getPaymentMethodsV2 retourneert nu optioneel ook de bpeConfiguration. Stel hiervoor in de request de parameter includeBpeConfiguration in.

Ook is het nu mogelijk om in de request te filteren op paymentMethodTypes.

API call getArticlesInLayout retourneert nu weer alleen daadwerkelijke bereidingswijzegroepen, en niet bijverkoop of vervangend artikelen.

Opgelost dat o.a. getOrders, getInvoices en getPackingSlips de volgende foutmelding teruggaven:

Kolom niet gevonden: afl_adres_bedrijfsnaam

Performance verbeteringen in alle ordergerelateerde calls, zoals placeTableOrder.

Subtiele bug opgelost waardoor in uitzonderlijke gevallen verkeerde BTW-tarieven konden worden berekend.

De waarde voor de eigenschap vatCodeAlternative die je kon meegeven aan createProduct en updateProduct werd niet overgenomen.

Fix aan de API call getNutritionalCharacteristics en getPreparationMethodGroups wanneer je deze op basis van het hoogste syncmarker + 1 opvroeg kon je één resultaat missen.

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

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

getOrderHistory stuurt nu ook de aanbetalingen op.

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

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

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

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

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

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

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

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

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

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

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

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

Fix uit V53 toegepast op V52

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

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

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

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

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

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

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

De functie placeTableOrder ondersteunt nu ook het doorgeven van lineType.

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

Toegevoegd:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Note CloudEFT heeft hier last van.

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

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

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

Lost probleem op waardoor verifyEmployeePassword en verifyCredentials konden crashen.

Introductie nieuwe API call getOrderHistory

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

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

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

getTableOrderV2 retourneerd nu weer de regels verdicht.

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

Fix moveTableOrderV3 geen gekke afrondingen van de verkoopprijs meer.

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

Diverse verbeteringen aan savePurchaseOrderV2

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

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

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

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

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

placeTableOrder, createOrder en dergelijke verwerken nu webhookExternalDiscount

getOrder, getTableOrderV3 ed geven nu ook bpeAccordationEmployeeNumber terug.

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

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

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

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

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

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

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

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

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

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

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

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

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

Webhooks worden nu weer goed geactiveerd.

Probleem was geintroduceerd in versie 50.0.0

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

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

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

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

getOverview retourneerd nu de bereidingswijze_groep nummers in de juiste volgorde.

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

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

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

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

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

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

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

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

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

getOverview retourneerd nu de bereidingswijze_groep nummers in de juiste volgorde.

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

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

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

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

De functie createRelation in combinatie met condenseCombinedInvoice werkt nu goed.

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

Nieuwe functie performBpeBudgetChecks

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

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

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

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

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

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

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

Een webhook endpoint kan op basis hiervan zijn antwoorden aanpassen.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

getOverview retourneerd nu de bereidingswijze_groep nummers in de juiste volgorde.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Extra veld quantityOfPackagesOrdered toegevoegd aan de getPurchaseOrder en getPurchaseOrderV2 api calls

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

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

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

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

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

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

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

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

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

getArticleGroup en getArticleGroupChanges geven nu ook informatie over verwijderde groepen.

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

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

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

getNutritionalCharacteristics kan nu ook op basis van syncMarker werken.

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

GKS ondertekening toegevoegd aan deliverOrder(V2) en saveInvoice.

Verbeteringen aan saveButtonLayoutGroupDetails

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

Verhelpt probleem waardoor api kon crashen bij onvoldoende geheugen beschikbaar.

getVatGroupList uitbreiding en documentatie.

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

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

Problemen met het splitsen van tafels.

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

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

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

Fix dat versie 46.0.0. database schema 45 verwachte.

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

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

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

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

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

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

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

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

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

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

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

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

getTableOrderCourseListV3 heeft nu de eigenschappen:

• requestedAt
• isTableSet
• tableSetAt
• isWineServed
• wineServedAt

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

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

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

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

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

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

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

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

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

Verbeterde foutafhandeling in de createImage functie.

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

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

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

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

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

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

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

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

Toegevoegde calls: getActivityTypes, saveActivityTypes, en saveActivity.

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

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

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

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

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

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

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

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

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

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

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

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

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

Probleem opgelost in WSDL met onbekend type CategoryIds.

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

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

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

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

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

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

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

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

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

De API-call updateNutritionalCharacteristics gaf soms een foutieve resultaatwaarde:

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

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

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

Probleem opgelost in WSDL met onbekend type CategoryIds.

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

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

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

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

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

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

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

Nieuwe calls: getGiftcards en restituteGiftcards

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

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

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

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

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

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

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

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

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

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

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

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

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

Deze optimalisatie was eerder al gedaan voor kassabonnen.

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

De functie placeTableOrder ondersteunt nu ook tableDescription en numberOfGuests.

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

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

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

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

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

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

Api calls voor snelknoppen beheer

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

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

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

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

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

Verbeteringen aan findTableOrder

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

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

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

• getConfigurationTree
• getConfigurationValues
• updateConfigurationValues

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

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

De functie placeTableOrder ondersteunt nu ook tableDescription en numberOfGuests.

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

• saveOrder
• updateOrder
• updateOrderV2
• createAndPayTableOrder
• placeTableOrder

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

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

Bugfix in getAuthorizationTree niet alle autorisatie items kwamen terug.

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

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

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

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

Nieuwe functie deleteAuthorizationGroup hiermee kunnen bestaande autorisatie groepen verwijderd worden

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

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

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

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

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

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

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

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

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

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

De functie getArticlesNutritionalCharacteristics heeft een aanzienlijke performance boost gekregen.

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

onlyQuantityButtons toegevoegd aan getTerminalSettings

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

Nieuwe functie getButtonLayoutGroupForBranch.

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

De ArticleSpecialPrice PRICE_NOT_FOR_SALE is toegevoegd (Niet verkoopbaar).

Functies toegevoegd voor het werken met todolijsten.

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

Het filter changedSinceTimestamp van getProducts werkt nu weer.

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

De functie placeTableOrder ondersteunt nu ook tableDescription en numberOfGuests.

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

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

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

Verbeteringen voor keukenmanagement.

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

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

scram-sha-256 support voor postgresql authenticatie.

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

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

updateProduct en createProduct werken weer.

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

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

Probleem met AccessViolation opgelost in placeTableOrder.

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

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

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

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

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

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

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

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

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

aan de volgende API calls is een deliveryAddress toegevoegd :

• getPurchaseDeliveries
• getPurchaseDeliveriesV2
• getPurchaseOrders
• getPurchaseOrdersV2

scram-sha-256 support voor postgresql authenticatie.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Fix voor toekennen locatie aan keukenbonnen

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

Reduceer geheugengebruik van getStockHistoryV2

Probleem verholpen waardoor de getActiveEmployeeList call een databasefout rapporteerde.

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

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

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

Verhelpt een conversiefout in getReceipts.

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

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

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

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

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

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

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

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

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

Filteren op einddatum werkt nu ook in de getStockHistoryV2 call.

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

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

Ondersteuning voor de bestellijst

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

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

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

Verbeterde afhandeling databasefouten.

Voorheen werden alle queryfouten hetzelfde gemeldt naar de client, namelijk dat er contact opgenomen moet worden met API Support.

Nu worden constraint-fouten naar de client gemeld als een probleem met de aangeboden data, want dat is vrijwel altijd de oorzaak.

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.