Snelknoppen die gemaakt zijn in versie 1.17.1+ van de Q-line werken niet in deze versie van de API service en dus ook niet in de handheld-applicaties. Gebruik versie 1.2.3+.
Deze nieuwe versie van de API installeert zichzelf in een submap van de normale installatiemap.
De installatielocatie zal daardoor bijv. C:\Program Files (x86)\MplusQservice\0.6.4 worden.
Hierdoor zullen bestaande snelknoppelingen voor het opstarten van de service aangepast moeten worden.
We denken na over een betere oplossing voor de toekomst.
Deze nieuwe versie van de API installeert zichzelf in een submap van de normale installatiemap.
De installatielocatie zal daardoor bijv. C:\Program Files (x86)\MplusQservice\0.6.1 worden.
Hierdoor zullen bestaande snelknoppelingen voor het opstarten van de service aangepast moeten worden.
We denken na over een betere oplossing voor de toekomst.
Deze nieuwe versie van de API installeert zichzelf in een submap van de normale installatiemap.
De installatielocatie zal daardoor bijv. C:\Program Files (x86)\MplusQservice\0.6.0 worden.
Hierdoor zullen bestaande snelknoppelingen voor het opstarten van de service aangepast moeten worden.
We denken na over een betere oplossing voor de volgende release.
Bij het opvragen van de actieve medewerkerlijst (getActiveEmployeeList) worden nu alleen de medewerkers geretourneerd die ook zijn geautoriseerd voor het betreffende filiaal (terminal.branchNumber).
Compatibiliteit met schema 1.19.0 toegevoegd.
ns__Article bevat nu ook supplierArticleNumber, oftwel het artikelnummer van de leverancier.
Het is nu mogelijk het deliveryAddress en invoiceAdress van een order op te geven. Erg nuttig voor als dit afwijkt van het adres van de relatie.
De salesprijzen van artikelen worden nu ook meegegeven via de eigenschap salesPriceList van het Article.
Het is nu mogelijk de deliveryMethod van een Order op te geven. Hier mogen alleen vooraf ingestelde waardes gebruikt worden die via getDeliveryMethods zijn op te vragen.
Het is nu mogelijk het orderCategoryNumber van een Order op te geven. Dat komt overeen met het ordersoort in de kassa.
Order bevat nu ook vatGroupList.
Via getOrders kunnen orders nu in bulk ingelezen worden, via syncMarker en andere filteropties kan de selectie beperkt worden.
Via getOrderCategories kan een lijst van beschikbare ordersoorten opgevraagd worden.
Relaties (klanten, leverancies, etc.) kunnen nu in bulk worden opgevraagd via getRelations, door middel van syncMarker kan vanaf een bepaalde wijziging de relaties worden opgevraagd.
lineData zoals die bijv. wordt meegeven aan de regels van een Invoice, Receipt of Order bevat nu ook de inkoopprijs, in de vorm van de waarde purchasePrice.
findRelation doorzoekt nu op basis van lowercase en gedeelten van de zoekopdracht. Zo zal een relatie met de naam "Jan de Boer" bijv. gevonden worden door te zoeken op "jan de b".
Als saveInvoice een extOrderId meekrijgt die al bestaat, dan wordt die extOrderId nu zelf ook in de foutmelding getoond.
Bij het opslaan van een bestelling via saveTableOrder of saveOrder wordt nu ook rekening gehouden met de evt. ingestelde standaard BTW-wisselkeuze "Hier opeten" of "Meenemen".
De functie saveTableOrder sluit nu ook de tafel als er geen regels meer over zijn.
getArticlesInLayout geeft nu ook samengestelde artikelen terug, via ArticleSimple.componentArticles.
Als een bereidingswijze in getArticlesInLayout geen opmerking bevat, dan wordt het veld PreparationMethodSimple.name nu gevuld met de omschrijving van het evt. bijbehorende artikel.
quantity wordt nu vergezeld van decimalPlaces om zo ook decimale getallen door te kunnen geven. decimalPlaces geeft aan met hoeveel posities de komma moet worden opgeschoven.
Stel dat het getal 1,55 moet worden doorgegeven: quantity = 155 decimalPlaces = 2
Of het getal 935,401: quantity = 935401 decimalPlaces = 3
Tenslotte, een geheel getal, 50: quantity = 50 decimalPlaces = 0
Het Table object dat bijv. in getTableList gebruikt wordt retourneert nu ook evt. het relationNumber en de relationName op die tafel.
Het is nu mogelijk een gedeelte van een tafelbestelling te betalen (payTableOrder). De overgebleven artikelen blijven dan op de tafelbestelling staan.
Het is nu mogelijk artikelen van de ene tafel naar de andere tafel te verplaatsen (moveTableOrder).
Ondersteunt de GET requests ?wsdl en ?docs die respectievelijk de WSDL en de documentatie gegenereerd vanuit de WSDL retourneren.
Bij het opvragen van producten (getProducts) kan nu aangegeven worden vanaf welk tijdstip de laatste wijziging gedaan moet zijn.
Het is nu mogelijk van verkooporders een pakbon te maken (deliverOrder).
Het is nu mogelijk verkooporders te betalen (payOrder).
Daarbij kan gekozen worden voor een aanbetaling of een factuur.
Het is nu mogelijk de urenregistratie op te vragen op basis van gewerkte diensten (getShifts).
Het is nu mogelijk afbeeldingen op te vragen (getImages), inclusief de data van de afbeelding, zodat synchronisatie van de afbeeldingen via de API kan verlopen.
Het is nu mogelijk alle medewerkers op te vragen (getEmployees).
Bij de artikelen (ArticleSimple) van een snelknoppenindeling (getArticlesInLayout) staat nu ook het PLU-nummer en of de bereidingswijzen direct getoond moeten worden.
Compatibiliteit toegevoegd met schema 1.12.0.
Compatibiliteit toegevoegd met schema 1.11.0.
Het versienummer van de API is vanaf dit moment onafhankelijk van het versienummer van de API Service. Hierdoor kunnen we dit programma updaten, zonder dat daardoor per se de API van versienummer verandert.
Compatibiliteit toegevoegd met schema 1.10.0.
Bij elke aanroep wordt nu gecontroleerd of er geldige credentials meegestuurd worden.
De installatiemethode voor de API Service is gewijzigd. Bekijk punt 3 van de Handleiding voor de nieuwe methode. Het voordeel van deze methode is dat de API Service als Windows service wordt geïnstalleerd en ook automatisch zal herstarten nadat deze crasht.
Mogelijkheid om --nossl toe te voegen aan programma waardoor geforceerd zonder SSL kan worden opgestart.
Ondersteunt nu SSL in standalone modus. Hiervoor moet in de %ProgramData%\MplusQservice map het bestand global.ini aangemaakt worden met daarin
[SSL]
ServerCert=<pad en bestandsnaam van certificaat>
ServerCertPassword=<evt benodigd wachtwoord>
De Installatiehandleiding laat nu ook zien hoe het batchbestand voor de API service onzichtbaar kan worden uitgevoerd.
Algemene optimalisatie ter verbetering van de snelheid van de API.
Overal waar een relatie wordt opgevraagd (zoals findRelation en getRelation) worden nu alle velden goed gevuld. Wat bijv. nog miste was city en alle velden van het afleveradres.
De functies createOrder, updateOrder en saveOrder zullen nu ook een orderbon afdrukken.
De functie getArticlesInLayout geeft nu ook bereidingswijzeregels zonder artikel door.
De aanroep getAvailableTerminalList kijkt nu of de database een master of een slave is en retourneert alleen werkplekken die mogen verbinden met deze database.
Dit houdt in dat wanneer hij verbind met de master-database hij geen werkplekken terug zal geven voor welke er een slave-database is en als hij met een slave is verbonden retourneert hij alleen werkplekken die met die specifieke slave mogen verbinden.
createOrder controleert nu of het meegegeven employeeNumber daadwerkelijk bestaat, om zo een databasefout te voorkomen.
getTableOrder zal nu ook de lineId's van de regels vullen, ook al gaat het hier om verdichte regels. De ingevulde lineId's zullen gewoon beginnen bij 1 en vanaf daar optellen.
Het object ButtonLayout_Button dat via getButtonLayout is op te vragen bevat twee nieuwe eigenschappen:
askForText: Geeft aan of bij het aanslaan van dit artikel om een tekst gevraagd moet worden, die vervolgens als naam van de regel gebruikt moet worden.isPreparationMethod: Geeft aan of het gaat om een bereidingswijze, die toegepast moet worden op de laatst geselecteerde artikelregel.relationNumber in Order is nu optioneel en daarnaast is ook relationName toegevoegd.
Elke exceptie wordt nu teruggegeven als een SOAP-foutmelding, i.p.v. dat ze stilletjes het programma doen crashen.
Article bevat nu ook het webshop veld.
Als de versie van de database niet wordt ondersteund, dan wordt dat met uitgebreide foutcodes weergegeven. Bijv. dat de versie van de database te hoog of te laag is.
Wanneer de API geen configuratie heeft ingeladen of verbonden is met een niet ondersteunde databaseversie, dan wordt dit nu via een SoapFault teruggestuurd naar de API client. Voorheen kreeg je gewoon geen antwoord.
getProducts(): Retourneert de producten nu ingepakt in een productList variabele. De variabele waarin de artikelen van een product werden ingepakt is hernoemd van articles naar articleList om consistenter te zijn met de rest van de API.
createOrder(): Geeft in het antwoord een orderUuid terug ipv. een orderId.
findOrder(): Toegevoegd: orderDeliveryState/orderCancelState/orderCompleteState
Vereist nu ook in standalone modus een ident + secret.
De installer is aangepast zodat hij vanaf nu de service in een map met het versienummer installeert en niet meer de oude versie upgrade.
Problemen opgelost met opruimen geheugen. Dit leidde o.a. tot problemen in findOrder.
Bij het opslaan van een order (via saveTableOrder, createOrder, updateOrder, saveOrder) worden evt. kortingsbedragen nu goed omgezet van centen naar euro's. Dit lost het probleem met steeds groter wordende kortingsbedragen op.
Verbetering in de stabiliteit van o.a. getTableOrder.
Probleem opgelost bij moveTableOrder of payTableOrder waardoor een AccessViolation kon optreden.
Probleem opgelost bij het uitvoeren van payTableOrder waardoor soms ten onrechte geprobeerd werd de bestelling te splitsen, wat een crash tot gevolg had.
Bij payTableOrder wordt nu beter gecontroleerd of een binnengekomen order gelijk is aan de bestaande order.
saveTableOrder zal nu identieke regels die los van elkaar staan op de juiste manier samenvoegen en niet een gedeelte weglaten.
Wanneer updateRelation wordt aangeroepen zonder relationNumber krijg je dat nu (zoals was bedoeld) als foutmelding terug, in plaats van dat de service crasht.
Als saveOrder of updateOrder wordt aangeroepen op een order die al (deels) geleverd of (deels) geannuleerd is komt er nu een duidelijke foutmelding terug, in plaats van een exception.
Op sommige plaatsen werd vatPercentage nog niet met 100 vermenigvuldigd voordat het via de API verzonden werd.
Overal waar ns__LineData gebruikt wordt, wordt nu ook turnoverGroup, vatCode en vatPercentage correct ingevuld.
Als een artikel met bereidingswijzen meerdere malen werd besteld werden evt. meerprijzen van de bereidingswijzen ook telkens weer één keer extra opgeteld bij het totaalbedrag van de regel.
getVatGroupList retourneert nu ook het branchNumber, omdat het BTW-percentage sinds Q-line 1.18.0 per filiaal kan verschillen.
getInvoices vult nu ook de transactionString van de geretourneerde facturen.
Wanneer er op een snelknoppen indeling een standaard hoofd- en subgroep was ingesteld en vervolgens groepen verwijderd werden kon u in de situatie komen waar er fout optrad omdat de software een standaard subgroep probeerde in te stellen voor een niet bestaande hoofdgroep. Het programma zet de standaard subgroep nu dan automatisch uit.
De functie saveTableOrder en saveOrder zal tekstregels niet meer van bestellingen afgooien.
Probleem opgelost in saveOrder en saveTableOrder waardoor een bestelling die onverdicht binnenkomt niet in de exacte volgorde van binnenkomst werd opgeslagen.
Binnenkomende teksten worden goed geconverteerd vanuit UTF-8.
De functie getButtonLayout gebruikt nu juiste UTF-8 codering zodat speciale tekens goed worden doorgegeven.
Wanneer payTableOrder wordt uitgevoerd met een gedeelte van de bestelling wordt er nu goed gecontroleerd op de inhoud van de regels, i.p.v. enkel een vergelijking van het aantal regels. Dat leverde namelijk problemen op als het gedeelte van de bestelling evenveel regels had als de gehele bestelling, maar met andere aantallen.
Afbeeldingen bij getProducts worden nu gesorteerd op volgnummer, ipv. volgorde van toevoegen. Op die manier worden wijzigingen in die volgorde goed doorgegeven.
Wanneer saveTableOrder een order binnenkrijgt waarin geen wijzigingen zijn te vinden, dan wordt de order nu niet alsnog opgeslagen.
Zo voorkomen we dat er steeds identieke bestelbonnetjes uit de printer komen.
Bij het opslaan en betalen van tafelbestellingen wordt nu het volledige tijdstip gebruikt, ipv. slechts de boekdag.
Als er een database connectie probleem is blijft hij niet meer hangen maar gaat het opnieuw proberen.
Probleem in de netwerk communicatie verholpen waardoor de service kon stoppen te reageren.
Snelknoppen die gemaakt zijn in versie 1.17.1+ van de Q-line werken nu ook weer in de API service en dus ook in handheld-applicaties.
Foutmeldingen over incorrecte databaseschemaversies worden nu niet meer in een dialoog getoond maar net zoals de rest van de uitvoer naar de console of het log gestuurd. (Het probleem met de dialoog was dat je hem niet zag als het programma als service draaide.)