VERSIE: 6.0.2026Istanbul
INHOUDSOPGAVE
Ondersteuning voor Buckaroo-betaalterminals
ASPOS ondersteunt vanaf nu de integratie met Buckaroo-betaalterminals. Hierdoor kunnen winkels die gebruikmaken van Buckaroo, hun betalingen direct via de kassa (POS) verwerken. Dit werkt op een vergelijkbare manier als bij andere ondersteunde betaalterminals en zorgt voor een soepele en consistente betaalervaring.
Wat dit betekent voor gebruikers:
Direct betalen: Pinbetalingen kunnen eenvoudig direct vanuit de kassa worden gestart via de Buckaroo-terminal.
Automatische statusupdates: De actuele betaalstatus wordt direct en automatisch bijgewerkt in ASPOS.
Retourpinnen (Refunds): Terugbetalingen voor eerdere transacties worden volledig ondersteund.
Zowel gekoppelde (referenced) als, indien ingeschakeld, ongekoppelde (unreferenced) terugbetalingen zijn mogelijk.
Let op: Om een ongekoppelde terugbetaling uit te voeren via de kassa, moet de instelling POSEFTRefundReq op False worden gezet.
Kassabonnen: Alle benodigde betaalgegevens zijn beschikbaar en worden correct afgedrukt op de kassabon.
CN 71291
Optimalisatie actie berekening
Wijziging doorgevoerd in de discount optimizer, waardoor diverse acties en combinaties weer correct af gaan op de POS.
CN 68883
Eerste implementatie GS1-scancodes
We hebben de eerste stap gezet voor het accepteren en verwerken van GS1-scancodes direct in de kassa (POS).
Deze nieuwe functionaliteit in de kassa maakt aan de achterkant gebruik van de vernieuwde verwerking van scancodes. Voor meer inhoudelijke details over hoe deze complexe codes worden uitgelezen en welke data we daar precies uithalen, verwijzen we je graag naar het gerelateerde release notes-item: Implementatie QR-codes uploaden (CN 72505).
CN 72504
Enviso museumtickets printen via Boca-printer
In navolging van de eerdere Enviso-integratie voor de verkoop van museumtickets in de kassa, is het nu ook mogelijk om deze tickets direct af te drukken op een speciale Boca-printer. Om deze functionaliteit optimaal te gebruiken, is een eenmalige configuratie van hardware, software en kassa-instellingen vereist.
1. Hardware & Software installatie
Boca-printer installeren
Download en installeer de vereiste driver (dpinstx64.exe).
Let op! Voer deze installatie uit voordat je de hardware aansluit. Hiermee voorkom je dat Windows automatisch een verkeerde standaarddriver installeert.
Sluit de printer aan en stel het papierformaat in op "Ski" om het gewenste ticketformaat correct te printen.
Foxit PDF Reader installeren
De tickets worden door Enviso aangemaakt als PDF-bestand. Omdat sommige standaard PDF-readers weergaveproblemen veroorzaken, raden wij met klem de gratis Foxit PDF reader aan.
Download en installeer Foxit PDF reader.
Zoek het installatiepad op (meestal is dit: C:\Program Files\Foxit Software\Foxit PDF Reader\FoxitPDFReader.exe).
Vul dit pad in bij de geavanceerde ASPOS-instelling AcrobatInstallPath. Zo weet de kassa precies welke software gebruikt moet worden voor het printen van de tickets.
2. Geavanceerde instellingen configureren
Zorg ervoor dat de volgende geavanceerde instellingen in ASPOS correct zijn gevuld voor zowel de printer als de Enviso-koppeling:
Print-instellingen:
POSPrintPDFDirect: True
POSPDFWaitForExit: False
POSPrintDirectArguments: /t "{0}" "{1}"
Enviso-instellingen:
EnvisoApiKey: De sleutel voor connectie met de Enviso API.
EnvisoApiSecret: Het wachtwoord voor connectie met de Enviso API.
EnvisoBaseUrl: De URL van de Enviso API.
EnvisoTennantSecretKey: De sleutel om de aanbieders van de tickets op te halen.
EnvisoTicketsProduct: Het ASPOS-artikelnummer waaraan de tickets gekoppeld zijn, zodat deze correct aangeslagen en afgerekend kunnen worden in de kassa.
3. Hoe werkt het in de kassa?
Zodra de inrichting compleet is, is het verkopen en printen van tickets heel eenvoudig:
Druk in het transactiescherm op CTRL+Y om de nieuwe Enviso-flow te openen.
Selecteer het gewenste museum of evenement.
Kies een tijdvak. Je ziet hier direct hoeveel tickets er nog beschikbaar zijn (deze voorraad wordt bijgewerkt bij de start van elke tickettransactie).
Kies het type en aantal tickets (bijv. volwassene of kind). De selectie wordt overzichtelijk aan de rechterzijde getoond.
Klik op afronden om terug te keren naar het reguliere kassa-scherm.
Zodra je de betaling afrondt, worden zowel de reguliere kassabon als het museumticket (via de Boca-printer) geprint!
CN 72997
Aanpassing factuur layout
Er is een aanpassing doorgevoerd op een klant specifiek template.
CN 73196
Rework schaplabel
Er is een aanpassing doorgevoerd op een klant specifiek label.
CN 74032
Uitbreiding product import/export
We hebben een aantal aanpassingen gemaakt in de product import functionaliteit in de backoffice.
De volgende velden zijn importeerbaar gemaakt. Deze velden waren voorheen enkel beschikbaar als read-only velden.
Label Layout
Label type
Onderstaande velden zijn toegevoegd in de import/export functionaliteit.
Bestelformule
Seizoen
Maat
Collectie
CN 71865
Extern ID veld voor merken en productgroepen Backoffice Next
Er is een nieuw veld toegevoegd voor een Externe ID (External ID). Dit veld is specifiek ontworpen om de koppelingen (integraties) met externe systemen beter te ondersteunen.
Waar vind je dit nieuwe veld?
De Externe ID is vanaf nu beschikbaar bij de volgende onderdelen:
Merken (Brands)
Productgroepen
Productsubgroepen
Goed om te weten:
Alleen-lezen (Read-only): Het Extern ID-veld is wel zichtbaar in de Backoffice, maar kan hier niet handmatig worden aangepast.
Zoekfunctie: Het is mogelijk om direct op de Externe ID te zoeken, zodat je de gekoppelde records snel en eenvoudig kunt terugvinden in het systeem.
CN 71865
Rapportages Transactiebeheer Backoffice Next
Automatische weergave in het Transacties-overzicht
Het 'Dock' wordt nu automatisch weergegeven in het Transacties-overzicht (grid). Handmatig in- of uitschakelen is hierdoor niet meer nodig.
De transactielijst die op dat moment zichtbaar is op je scherm, wordt nu direct overgenomen als selectie voor je rapporten. Dit garandeert dat elk gegenereerd rapport exact overeenkomt met de gegevens die je in het overzicht ziet.
Rapporten op basis van gebruikersrechten
De sectie Rapporten toont vanaf nu uitsluitend de rapporten waarvoor de ingelogde gebruiker de juiste rechten (permissies) heeft. Dit geldt voor de volgende rapporten:
Transactie overzicht (TRANSACTIONRECORDS)
Transactie journaal (TRANSACTIONJOURNAL)
X-afslag (TRANSACTIONXDEMISSION)
Kopie bonnen (REPORTCOPYRECEIPTS)
CN 73111
Magazijn instelling retour orders
Wijziging doorgevoerd zodat in de bestaande setting WebshopOrderReturnStore het warehouseOID (OID van het magazijn) ingevuld kan worden, de voorraadboeking van webshop retouren op het desbetreffende magazijn gebeuren. Hiervoor moet de setting gevuld worden met W{WarehouseOID}.
CN 72681
Vernieuwde API-validator
We hebben onder de motorkap een nieuwe validator geïmplementeerd. Dit maakt het in de toekomst veel eenvoudiger om datavalidaties toe te voegen en te onderhouden. Deze nieuwe validator wordt vanaf nu gebruikt op de POST- en PATCH-endpoints van: brand, brand storesettings, productgroup en productgroup storesettings.
Wat betekent dit voor regressietesten en API-gebruikers?
Aangepaste tekst in foutmeldingen: De structuur van de response body (HTTP 400) blijft exact hetzelfde, maar de specifieke foutmeldingen zijn iets gewijzigd en consistenter opgebouwd. Ze zijn nu vaak opgesplitst in meerdere regels.
Voorbeeld oud: "Code must be between 1 and 15 characters"
Voorbeeld nieuw: "Must not be null" én "Must be between 1 and 15 characters"
Test-advies: Zorg ervoor dat geautomatiseerde tests controleren óf er een foutmelding op een bepaalde eigenschap (property) wordt teruggegeven, in plaats van te valideren op de exacte tekst van de melding.
Gewijzigde validatielogica voor bonuspunten
De afhankelijkheid tussen datums is losgelaten: BonusPointsFactorStartDate en BonusPointsFactorEndDate in de storesettings worden niet langer gevalideerd tegen de start- en einddatums van het bovenliggende merk (brand) of de productgroep (group).
Waarom? Deze controle bleek in de praktijk niet waterdicht. Als de datum op merkniveau achteraf werd gewijzigd, kon de database alsnog ongeldige combinaties bevatten. Om dit volledig sluitend te maken zou er een tweeweg-controle gebouwd moeten worden. Voor nu is deze specifieke dataregeling daarom komen te vervallen.
CN 68041
Nieuw endpoint voor het mailen van inkooporders
Er is een nieuw REST-endpoint toegevoegd: POST /api/purchase-orders/{id}/SendMail. Hiermee is het mogelijk om direct vanuit een inkooporder een e-mail met de order in de bijlage naar de betreffende leverancier te sturen. Hierbij worden zowel de oude als de nieuwe REST-tags in de e-mailtemplates ondersteund.
Aanmaken of direct verzenden
Via de body van het request kun je het gedrag sturen met de optionele parameter createOnly:
Direct verzenden (false of niet meegeven): Dit is de standaard. De e-mail wordt aangemaakt en direct verstuurd.
Klaarzetten (true): De e-mail wordt wel aangemaakt in het systeem, maar nog niet verzonden.
Bijlagen: PDF of CSV
Standaard: De inkooporder wordt standaard als PDF-bestand als bijlage toegevoegd.
CSV: Wanneer bij de leverancier de instelling OrderFileType op EmailAttachmentCSV staat ingesteld, wordt er automatisch een CSV-bestand bijgevoegd in plaats van een PDF.
E-mailinstellingen & Routering
Het endpoint stelt de e-mail slim samen op basis van de volgende instellingen:
Template: Het uiterlijk van de mail wordt bepaald door de template-code die is ingevuld bij de instelling EmailPurchOrdTemplateCode.
Afzender (From): Er wordt gebruikgemaakt van het e-mailadres in de instelling PurchaseOrderEmailFrom. Is deze niet gevuld? Dan valt het systeem automatisch terug op het standaard e-mailadres van de winkel.
Ontvanger (To): De e-mail wordt verstuurd naar het specifieke 'order e-mailadres' van de leverancier. Is dat veld leeg, dan wordt het standaard e-mailadres van de leverancier gebruikt.
Kopie (CC): Dit wordt gestuurd door de instelling IgnoreMailCC. Staat deze op false, dan wordt er ter controle een CC-kopie gestuurd naar het afzender e-mailadres (From). Staat deze op true, dan wordt er geen CC verstuurd.
Validaties en restricties
Om fouten te voorkomen, faalt het endpoint en kan er geen e-mail worden verstuurd in de volgende situaties:
Het betreft een dropshipment order (IsDropShipmentOrder = true).
De leverancier heeft in de stamgegevens géén order e-mailadres én géén standaard e-mailadres.
De verzendende winkel heeft géén standaard e-mailadres ingesteld én tegelijkertijd is de instelling PurchaseOrderEmailFrom leeg.
CN 72066
Implementatie QR-codes uploaden
We hebben de verwerking van scancodes (/api/scancodes/load) uitgebreid. Je kunt nu ook moderne GS1 Digital Link QR-codes scannen.
Wat levert dit op?
Meer data met één scan: Je haalt nu direct extra gegevens op, zoals batchnummers en houdbaarheidsdata. Hierdoor zijn we niet meer afhankelijk van externe GS1-diensten.
Automatische herkenning: Het systeem ziet vanzelf of je een traditionele barcode scant of een nieuwe GS1-link (bijvoorbeeld door te letten op de /01/ code).
Direct uitlezen van gegevens: We hebben een lokale lezer toegevoegd die direct de belangrijkste gegevens (Application Identifiers of AI's) uit de scan haalt:
Artikelnummer / GTIN (AI 01)
Batch/Lot nummer (AI 10)
Vervaldatum (AI 17)
Serienummer (AI 21)
Slim zoeken & Fallback: Het uitgelezen artikelnummer (GTIN) wordt automatisch gebruikt om het product op te zoeken, precies zoals je gewend bent. Gegevens in de code die we niet kennen, worden simpelweg genegeerd. Is de scan toch geen geldige GS1-link? Dan valt het systeem automatisch terug op de standaard manier van scannen.
Voorbeelden van ondersteunde scancodes:
(01)02200010000566(10)LOT123(17)251231(21)SN98765
https://id.gs1.org/01/02200010000566/10/LOT123/17/251231/21/SN98765
https://id.gs1.org/01/02200010000566?10=LOT123&17=251231&21=SN98765
CN 72505
Ondersteuning PDF beheer inkooporders
In de REST services is ondersteuning toegevoegd voor het beheren van PDF documenten bij een inkooporder. De volgende nieuwe endpoints zijn hiervoor toegevoegd:
GET /api/purchase-order-files
POST /api/purchase-order-files
DELETE /api/purchase-order-files/{id}
GET /api/purchase-order-files/{id}
GET /api/purchase-order-files/{id}/download
POST /api/purchase-order-files/{id}/upload
CN 72952
Uitbreiding Purchase Orders endpoints
De REST API-endpoints voor inkooporders (purchase-orders) zijn flink uitgebreid met nieuwe velden en expand-opties. Hierdoor kun je meer gedetailleerde logistieke- en orderinformatie ophalen en wegschrijven.
Nieuwe Expands (GET-endpoints)
Bij het ophalen van inkooporders kun je nu de volgende gerelateerde data direct meeladen via expands:
store
groupUser
warehouse
allowedOperations
Nieuwe 'Read-only' velden (GET-endpoints)
De GET-endpoints retourneren nu standaard de volgende extra status- en systeeminformatie:
stateDescription
creationDate
lastModifiedDate
sourceDescription
typeDescription
Nieuwe bewerkbare velden (POST, PATCH & GET)
Er is een uitgebreide set nieuwe velden toegevoegd die je kunt meesturen bij het aanmaken (POST) of wijzigen (PATCH) van een inkooporder. Deze velden worden uiteraard ook geretourneerd in de GET-requests. Voor de overzichtelijkheid zijn ze hieronder gegroepeerd:
Algemene en Financiële ordergegevens:
purchaserGroupUserId
externalOrderReference
orderConfirmationDate
expirationDate
planningPeriodCode (inclusief planningPeriodCodeDescription)
currencyCode (inclusief currencyCodeDescription)
Logistiek en Transport:
productionDate
supplierSendDate
deliveryConditionCode (inclusief deliverConditionDescription)
carrierName
Vertrek: departurePortDate, departurePort, departureDock
Aankomst: arrivalPortDate, arrivalPort, arrivalDock
Vervoersmiddel: shipName, containerName
CN 72976
Flexibel toepassen van handlingskosten
Er is een nieuwe optie toegevoegd voor de verwerking van klantorders. Je kunt nu per order bepalen of er handlingskosten berekend moeten worden bij het verdelen van de order.
Wat is er veranderd?
Bij het gebruik van het endpoint customer-orders/{id}/process in combinatie met OrderDistributionMode = 3, kun je vanaf nu de nieuwe parameter excludeHandlingCosts meesturen in de request.
Handlingskosten berekenen (Standaard / False): Geef je de parameter niet mee in de call (of zet je deze expliciet op False)? Dan worden de handlingskosten, zoals deze zijn geconfigureerd in de storesettings, automatisch toegevoegd aan de resulterende filiaalorder (indien van toepassing).
Handlingskosten uitsluiten (True): Zet je de parameter op True? Dan wordt de order verwerkt zonder dat er handlingskosten worden toegevoegd. Dit geeft je meer controle over de kostenberekening in specifieke situaties.
CN 73488
Verwerking van deels gepickte klantorders
We hebben een verbetering doorgevoerd in de manier waarop deels gepickte orders worden afgehandeld via de API.
Wat is er veranderd?
Bij het gebruik van het endpoint customers-orders/{id}/process is het vanaf nu mogelijk om de nog niet-gepickte orderregels van een reeds deels gepickte klantorder succesvol te verwerken.
Voorwaarde: Deze wijziging is specifiek van toepassing wanneer de instelling OrderDistributionMode gelijk is aan 3.
Voordeel: Dit biedt meer flexibiliteit in het logistieke proces en voorkomt blokkades bij het afhandelen van klantorders waarbij (nog) niet alle artikelen verzameld konden worden.
CN 73490
Nieuwe Search endpoints voor inkooporders
Er zijn twee nieuwe zoek-endpoints (Search) toegevoegd aan de REST API, waarmee je specifieker kunt zoeken naar inkooporders en bijbehorende orderregels. Daarnaast is er een handige nieuwe zoek-operator geïntroduceerd.
Nieuwe Search endpoints
POST /api/purchase-orders/Search
Wanneer je dit endpoint gebruikt, wordt er gezocht binnen de volgende velden: Number, Description en ExternalOrderReference.
POST /api/purchase-order-lines/Search
Wanneer je dit endpoint gebruikt, wordt er gezocht binnen het veld: SupplierProductCode.
Nieuwe zoek-operator: "Like" (Wildcard zoeken)
Er is een nieuwe operator toegevoegd genaamd Like.
Hiermee is het mogelijk om op delen van een woord te zoeken door het %-teken voor of na je trefwoord te plaatsen (bijvoorbeeld %zoekterm of zoekterm%).
Let op: Deze operator werkt uitsluitend voor tekstvelden (textField).
CN 73531
Bulk toevoegen van inkooporderregels
Er is een nieuw REST-endpoint toegevoegd om sneller en efficiënter te kunnen werken met inkooporders: POST /api/purchase-order-lines/bulk.
Wat is er veranderd?
Meerdere regels in één keer: Je kunt vanaf nu in één enkele actie meerdere inkooporderregels tegelijkertijd toevoegen aan een bestaande inkooporder.
Efficiënter: Waar je voorheen voor elke orderregel een aparte API-call moest doen, kun je de data nu gegroepeerd als een bulk-actie doorsturen. Dit bespaart tijd en verlaagt de belasting op de API.
CN 73723
Geannuleerde inkooporderregels ophalen
Er is een kleine, maar handige toevoeging gedaan aan het REST-endpoint GET /api/purchase-order-lines. Je kunt nu zelf bepalen of je geannuleerde orderregels in de resultaten wilt zien.
Wat is er veranderd?
Je kunt nu de nieuwe parameter includeCancelledLines meesturen in je request.
Standaard weergave (false of niet meegegeven): Geef je de parameter niet mee? Dan werkt het endpoint zoals je gewend bent en worden geannuleerde inkooporderregels niet geretourneerd in de response.
Geannuleerde regels inbegrepen (true): Zet je de parameter op true? Dan worden alle inkooporderregels teruggegeven, inclusief de regels die de status 'geannuleerd' hebben.
CN 74096
Uitbreiding product-endpoints met 'Abc'-veld en filiaalstatistieken
Er zijn nieuwe datavelden en expand-opties toegevoegd aan de REST API voor producten en product-winkelinstellingen (product storesettings).
Nieuw veld: 'Abc'
Aan zowel de product als de product storesettings endpoints is het nieuwe veld Abc toegevoegd.
Dit veld is volledig te beheren via de API: je kunt de waarde ophalen (GET), toevoegen (POST) en wijzigen (PATCH).
Nieuwe Expand: 'storeStatistic' (GET-endpoints)
Bij het ophalen van producten (GET) kun je vanaf nu de nieuwe expand storeStatistic meesturen.
Deze expand retourneert onder andere het veld hasState.
Wat betekent dit? Met hasState kun je in één oogopslag zien of een product een actieve status heeft binnen de betreffende winkel. Het systeem kijkt hierbij overkoepelend naar de status op alle magazijnen die aan die specifieke winkel zijn gekoppeld.
CN 74102