Versie 1.8.2 MplusKASSA API Service 1.8.2

Releasedatum:
12-05-2016

  • Functie getCustomFieldList toegevoegd waarmee de klantvelden van de artikel-, relatie- en medewerkerkaart opgevraagd kunnen worden.

  • getActiveEmployeeList() retourneert nu per medewerker ook de volgende autorisatie-opties: allowNextCourse, allowSplit en allowPay.

  • Relation bevat nu ook de eigenschap relationCode waarmee het veld relatiecode van de relatiekaart ingelezen en gemanipuleerd kan worden. Maximale lengte van dit veld is 128 alfanumerieke karakters.

  • Het Transaction object bevat nu ook de eigenschap extBranchId.

  • Het VatGroup object bevat nu ook de eigenschap extBranchId.

  • De Order, Invoice en Receipt objecten bevatten nu ook de volgende eigenschappen: entryExtBranchId en financialExtBranchId.

  • Het Payment object in een paymentList bevat nu ook de eigenschappen entryTimestamp, branchNumber, extBranchId, workplaceNumber, employeeNumber en employeeName.

  • getProducts() ondersteunt nu ook de onlyActive parameter. Wanneer deze op TRUE staat, worden alleen de actieve artikelen geretourneerd.

  • getTerminalSettings() retourneert nu ook unknownTableAction. Deze eigenschap geeft aan wat er gedaan moet worden als er een onbekende tafel gekozen wordt.

  • allowTableRetour toegevoegd aan EmployeeName

  • Bij het aanroepen van getJournals(), getFinancialJournal() en getFinancialJournalByCashCount() wordt nu altijd opgeslagen welke data gediend heeft als bron voor het antwoord. Eventueel kan de aanvrager een eigen referentie meegeven.

  • payInvoice() geeft nu goed aan als een betaling niet kan worden uitgevoerd omdat de gewenste betaalwijze is uitgeschakeld.

  • Nieuwe functie requestTableOrderCourse() waarmee een gewenste gang voor een bepaalde tafel kan worden uitgevraagd.

  • Nieuwe functie logMistake() die gebruikt kan worden om een foutaanslag op bijv. een handheld te registreren.

  • Nieuwe functie getTableOrderCourseList() waarmee voor een bepaald filiaal- en tafelnummer de op dat moment aanwezige en uitgevraagde gangen kunnen worden opgevraagd.

  • Gangen hebben nieuwe eigenschappen: sequenceNumber, isPresent en isRequested.

  • Nieuwe functie getCardCategories waarmee de categorieën van de artikel-, relatie- en medewerkerkaarten opgevraagd kunnen worden. Bij relaties gaat het bijvoorbeeld om de categorieën "Klant" en "Leverancier".

  • De BPE-informatie (Breuk/Promotie/Eigen gebruik) wordt nu ook aan artikelregels meegegeven. Zo kan er onderscheid gemaakt worden tussen echte korting en "korting" vanwege BPE. De gebruikte eigenschappen zijn bpeId (interne identificatie), bpeDescription (toonbare omschrijving), bpeAmount (bedrag incl. BTW), bpeAmountExcl (bedrag excl BTW).

  • Nieuwe API-functie getWordAliases die ingestelde woordaliassen kan teruggeven. Kan bijvoorbeeld gebruikt worden om een woord altijd te vertalen naar een ander woord, zoals "Klant" naar "Gast".

  • Bij het opvragen van factuurinformatie wordt nu ook evt. meegegeven of de factuur vergrendeld is (finalized) en wanneer (finalizedTimestamp).

  • Bij het versturen van een bericht via sendMessage kan nu ook de sender en messageType worden meegegeven. Kies uit OK, INFO of WARNING.

  • Bij het opvragen van een kastelling via getCashCountList wordt nu ook het rekeningnummer waarop het kasverschil wordt gestort teruggegeven via de parameter differenceAccountNumber. Ook wordt het rekeningnummer van de afstortrekening teruggegeven via de parameter depositAccountNumber.

  • Je kunt nu ook de parameter sinceCashCountNumber invullen om alle kastellingen sinds een bepaalde kastelling op te vragen.

  • De functie getJournals retourneert nu per betalingswijze ook het betalingswijzesoort, zoals: "BETAAL", "EFT", "TUSSEN", "AFSTORT", "BPE".

  • De finalizeInvoices parameter kan worden toegevoegd aan een getInvoices aanvraag om de facturen die opgehaald zijn te vergrendelen. Gebruik dit wanneer de facturen eenmalig geëxporteerd dienen te worden naar een extern systeem, zoals een boekhoudpakket. Het voorkomt namelijk dat de factuur daarna nog verder gewijzigd kan worden in de kassa.

  • Bij het opvragen van het versienummer van de API via getApiVersion wordt nu ook de ingestelde datum van de API-server teruggegeven via de parameter serverDate. Dit kan gebruikt worden om externe apparaten te synchroniseren met de server.

  • Bij het opvragen van kastellingen via getCashCountList wordt nu ook de eerste en laatste id's van de achterliggende kassabonnen meegegeven, via de eigenschappen shiftFirstReceiptId en shiftLastReceiptId. Daarnaast bevat de eerste en laatste transactie (shiftFirstTransaction en shiftLastTransaction) nu ook het transactielabel via de eigenschap transactionString.

  • De volgende objecten bevatten nu ook het extBranchId (externe referentie voor het filiaal): Branch, CashCount, Journal, FinancialGroup en Shift.

  • De API-functie getEmployees kan nu ook worden gebruikt met een syncMarker. Lees de Sync Marker Tutorial (Engels) voor een uitgebreide uitleg.

  • De API-functie getTurnoverGroups retourneert nu ook de ingestelde externe rekeningnummers per filiaal, via de lijst branchAccountNumberList.

  • API-functies die werken met betaalwijzen per filiaal, zoals getFinancialJournal en getFinancialJournalByCashCount, retourneren nu ook het juiste rekeningnummer in het veld accountNumber als deze afwijkt van het standaard rekeningnummer.

  • API-functies die werken met omzetgroepen per filiaal, zoals getFinancialJournal en getFinancialJournalByCashCount, retourneren nu ook het juiste rekeningnummer in het veld accountNumber als deze afwijkt van het standaard rekeningnummer.

  • Wanneer een API-functie wordt gebruikt met klantvelden (zoals createProduct, createRelation of createEmployee) en de klantvelden zijn verplicht, maar deze worden niet meegegeven en hebben ook geen standaardwaarde, dan wordt er een duidelijke foutmelding teruggegeven.

  • getFinancialJournal geeft nu ook aan of de periode waarover een financieel journaal is aangevraagd al officieel is afgesloten, door middel van het veld financialPeriodClosed. Het kan namelijk voorkomen dat een boekingsdag pas afloopt om 6 uur 's ochtends, in plaats van exact middernacht.

  • Medewerkers kunnen nu ook per stuk opgehaald worden via getEmployee, daarnaast worden daarbij nu ook de klantvelden (de customFieldList) en de volgende standaardvelden meegegeven: syncMarker, changeTimestamp, createTimestamp, extraText, categoryId, personNumber.

  • Bij het ophalen, invoeren en bewerken van relaties kan nu gewerkt worden met klantvelden (de customFieldList) en de volgende standaardvelden: createTimestamp, bankAccountNumber, creditLimit, paymentWithinDays, vatNumber, commerceNumber, extraText, defaultVatMethod, neverPrintOrEmailReceipt, alwaysPrintReceipt, alwaysPrintLargeFormatReceipt, alwaysEmailReceipt, condenseCombinedInvoice.

  • getTableList() retourneert nu ook de informatie over de hoogst uitgevraagde gang van elke tafel, dit gebeurt via de eigenschappen courseNumber, courseName en courseAbbreviation.

  • getJournals kan nu aangeroepen worden zonder filiaalfilter. In dat geval worden alle aanwezige filialen geretourneerd.

  • Het is nu mogelijk om het pasnummer in te vullen en bij te werken via createRelation en updateRelation. Het veld heet cardNumber.

  • Na het uitvoeren van updateOrder was het mogelijk dat de API probeerde een printopdracht te genereren voor het afdrukken van de order. Hierbij werd echter het verkeerde id meegegeven aan de printopdracht, waardoor updateOrder met een exceptie tot stilstand kwam.

  • Kortingspercentage werd per ongeluk ook omgekeerd bij het opslaan van een tegenboeking. Dit gaf problemen in bijv. totaalberekening van een regel.

  • Negatieve decimale aantallen werden niet correct doorgegeven. Elk aantal werd afgerond doorgegeven.

  • Bij het uitvoeren van getJournals met een filter op kassabonnen of facturen worden de lijst met betaalwijzen (paymentList) en BTW-groepen (vatGroupList) nu ook correct gefilterd.