Service Name: VMMS
Company: Circumtec
Version: 6.0.06
Release Date: 2025-03-25
-
Show L/Restock column for service man.
-
Show Developer Center for Cashless Admin/Admin/Owner, not only owner.
-
API cards: Allow top-up operations with negative values. Added a new parameter
top_up_desc
to customize card transaction descriptions. On successful top-up, the card transaction ID will be returned. -
Changed the data type of
Transactions.creditTime
fromDate
toTimestamp
. -
Updated
Vends.toRefundRecord()
: During a refund transaction, setvendCount=-1
. -
Ensured that
refund
andrefund fee
records maintain the samevend_type
as the original vend record. -
Fixed an issue where the generated refund record's
vendtime
only displayed the date with time as00:00:00
. -
Fixed the error "incompatible with sql_mode=only_full_group_by" after upgrading to MySQL 8.
-
Fixed a bug where
jdbc.properties
configurations were not being read correctly.
Version: 6.0.05
Release Date: 2025-02-17
-
Restock Manager no longer uses HTTP but utilizes SQS instead.
-
The SQS name is generated based on
serverId
:restock_manager_serverId.fifo
, e.g.,restock_manager_vmms.fifo
.
Version: 6.0.04
Release Date: 2025-01-14
-
Fixed the formatting error caused by
API JSONObject
, replacingJSONObject
withObjectNode
. -
For all devices with
APN=BLE
, the offline alarm will not be set.
Version: 6.0.03
Release Date: 2024-12-05
Added new libraries to resolve API access issues:
-
'org.glassfish.jersey.containers:jersey-container-servlet-core:2.35'
-
'org.glassfish.jersey.inject:jersey-hk2:2.35'
Version: 6.0.02
Release Date: 2024-11-13
-
API
cardvends
: Added query parametersvend_id
andtxn_id
. -
API
cardvends
withaction=refund
: Upon successful refund, returns thevend_id
of the refund record. -
Added options to upload logs and view parameters in the DTU MQTT menu.
Version: 6.0.01
Release Date: 2024-10-23
-
Upgraded from Tomcat 7 to Tomcat 9.
-
Upgraded from Java 1.8 to Java 17.
-
Converted
WEB-INF/web.xml
toWebAppInitializer.java
, removedweb.xml
from the live folder. -
Converted
WEB-INF/Springs/applicationContext.xml
toAppConfig.java
, removedapplicationContext.xml
from the live folder. -
Upgraded Spring library from version
3.0.6
to5.3.39
.
Version: 5.0.59
Release Date: 2024-09-18
-
Weekly Task: Added
company_id
to limit processing to one company for "Weekly Task-3: Create Card Vends Weekly Statement". -
Regeneration of "Weekly Task-4: Create Card Vends Weekly Summary".
-
Machine Type: Prevented deletion of a Machine Type if it is still used by machines.
-
Company Edit: Sending
company_params_update
to the data change queue when parameters change. -
Fixed bugs.
Version: 5.0.58
Release Date: 2024-09-11
-
API cards: Added a new parameter
global_unique
when creating cards. The default value is 1.-
If
global_unique=0
, the card number will have the formatcompanyId-cardNo
.
-
-
Updated API documentation.
-
Request Refund Page: When a top-up transaction fails due to insufficient balance, the prompt will now display the recharged card number, amount, and current balance.
Version: 5.0.57
Release Date: 2024-09-05
-
API
locations
:-
Added output fields:
notes
,home_phone
,country
,customer_id
. -
Added modifiable fields:
image_url
,customer_id
,category
.
-
-
API
machine
:-
Added a new field
machine_params
when retrieving a single machine. -
Machine List -> IMEI -> Send Free Credit: Fixed JSON format errors when the product name contains special characters.
-
-
Added new API:
templates
. -
MQTT Controller: Added a new parameter
ack=1
,model_no
,version
when sending messages. -
Introduced a test API that requires no parameters and supports
GET
,POST
,DELETE
. -
Fixed a null pointer error in
ApiLambdaController
when the client uploads a null value.
Version: 5.0.56
Release Date: 2024-06-28
-
Timezone Management:
-
Machine creation page now supports selecting a timezone, which is saved in
t_machines
andt_machines_params
. -
Synchronization of timezones when creating a machine or editing a route.
-
-
Notification Type:
-
Added a dropdown menu for notification type during machine creation.
-
Depending on the selection, additional fields such as
secondsPerDollar
andworkTime
are displayed.
-
-
Route Deletion:
-
Prevented deletion of a route if it has associated machines.
-
-
Timezone Sync:
-
When editing a route's timezone, associated machines will also update their timezone.
-
Version: 5.0.55
Release Date: 2024-06-27
-
API
cardvends
:-
Added a new action:
refund
. -
Added output field:
aid
.
-
-
Updated API documentation.
- After a successful refund, the data change will synchronize updates to DynamoDB.
Version: 5.0.54
Release Date: 2024-06-20
- Vend History Update for CircumPay Transactions: Added a mobile icon in front of card numbers for Circumpay transactions in the Vend History.
- Users can now send messages directly to CircumPay users.
- New Request Refund Page: Added a new page under Cashless -> Request Refund.
- Product List Synchronization Bug Fix: Fixed an issue where the product list did not update after updating a virtual machine.
- Card List Search Bug Fix: Resolved an issue where sub-cards could not be searched in the Card List. Can search additional cards
- Can send credit to M5_LITE relay unit
Version: 5.0.52
Release Date: 2024-05-10
- Message Sending in Card List: Added the functionality to send messages to Circumpay users in the Card List.
Version: 5.0.50
Release Date: 2024-03-27
- API Enhancements:
- Added query fields
is_disabled
,agent_only
toAPI company GET
. - Added field
is_disable
toAPI company POST
to enable or disable company status. - Added output field
company_id
toAPI dtus
. - Added parameter
linked_only
toAPI machine_models
, withlinked_only=1
returning only machine types linked to a machine. - Added common parameter
get_all
to API GET operations, withget_all=1
returning all user data regardless of pagination. - Introduced a new API:
params
.
- Added query fields
Version: 5.0.48
Release Date: 2024-02-26
- API Updates:
- Added field
location
androute
toAPI machines
. - Added fields
category
,image_url
toAPI locations
. - Added parameter
cpay_user
toAPI card_accounts
withcpay_user=1
returning all Circumpay users, restricted to sysadmin.
- Added field
- Cashless Refund Enhancements:
- In Cashless -> Vend History, refunds for Worldpay transactions are now directly requested via Lambda.
- Added refund functionality to Cashless -> Transaction History for Worldpay credit card transactions and direct card balance adjustments for regular card transactions.
Version: 5.0.47
Release Date: 2023-12-11
- API Enhancements:
- Added
refund
operation toAPI cardvends
. - When performing a refund, the
country
field in the refund record now uses the country of the refunded vend. - Added query parameters
location_id
,department
toAPI cardvends
. - Added query parameter
department_list
toAPI cards
, returning all card departments.
- Added
Version: 5.0.46
Release Date: 2023-08-25
- API Enhancements: Added output field
coin_mech
toAPI machines
. - Promo Enhancements:
- Added "Buy X Get Y Free" option to Promos and optimized related pages to maintain consistency with the existing style.
- Introduced a new API:
templates
.
- Transaction List Update: Added a refund button for credit card transactions in the Transaction List.
Version: 5.0.45
Release Date: 2023-03-30
- API Security Enhancements: Fixed issues where some APIs did not verify if the record to be deleted belonged to the operator's company during delete operations.
- User Role Field Update: Added
user_role
field to the return information of successful VMMS API user logins. - Machine API Enhancements: Added
machine_user_name
parameter, allowing search for machines by username.
Version: 5.0.44
Release Date: 2023-02-28
- Data Synchronization with Circumpay:
- Operations on Coils (add, delete, update), Product (update, delete), Category (update, delete), and Brand (update, delete) now trigger
updateToCircumpay()
to send a queue to AWS SQS (vmms_data_change
). - When deleting Category, Brand, or Product, if there are related products in coils, a prompt will display the associated machine IDs and ask if the deletion should proceed.
- Operations on Coils (add, delete, update), Product (update, delete), Category (update, delete), and Brand (update, delete) now trigger
- API Enhancements:
- Added output fields
build_standard
,firmware_ver
toAPI machine
. - Added output field
product_img_url
toAPI coils
.
- Added output fields
- Export Log Cleanup: Successfully deleting a user now synchronizes the deletion in the
t_export_log
table. - Card List Bug Fix: Fixed an issue where sorting was not functioning correctly in the Card List.
Version: 5.0.43
Release Date: 2022-12-20
- Default Circumpay Activation for New Companies: Circumpay is now enabled by default when creating a company, with "Vending" selected as the default value.
- Data Synchronization with Circumpay: Operations on Machine coils (add, delete, update) now trigger
updateToCircumpay()
ifcpay_buy_method
is not equal to 0. - API Reports Enhancements: Added default values for parameters
start_date
,end_date
,log_day
as the current day. - Param Create Page Update: Parameters in the dropdown menu are now sorted by display name.
- API Enhancements:
- Added return fields
temperature
,place
,roi
,purchase_price
,dep_rate
,current_value
,weight
toAPI machines
. - Added parameters
coil_alarm
,location_id
,route_id
,show_empty_coils
,show_low_coils
toAPI coils
, supporting Coil Alarm display. - Added return fields
location_name
,machine_place
,product_upc_no
toAPI coils
. - Added
machine_id
parameter toAPI reports
. - For
API card accounts
, setcompany_id
to 3 when registering or activating Circumpay users.
- Added return fields
Version: 5.0.42
Release Date: 2022-10-28
- New API: Added
maps
API to return map data for the homepage. - Google Map API Key Update: Updated the Google Map API key to retrieve map coordinates based on location updates.
- Card List Enhancements:
- Sub-cards can no longer modify the
department
field. Modifying thedepartment
field of a primary card synchronizes it to all sub-cards.
- Sub-cards can no longer modify the
- Vend History Update: Added a dropdown for the
card department
in Vend History. - API Enhancements:
- For
API company
, added output fielduser_list
when retrieving the company list, returning all users under the company. This applies to ordinary users querying, or administrators querying specified company information. - Added
user_list
parameter, returning all users under the company whenuser_list=1
, restricted to administrators, default value is 1. - Added
parent_company_list
parameter, returning all agent companies whenparent_company_list=1
. - Added output fields
company_params
,company_type
,is_disabled
,parent_company_id
. - For
API user
, addeduser_role_list
parameter, returning all user roles whenuser_role_list=1
. - Added
user_role
output field. - When querying an individual user, added output fields
user_routes
,user_locations
.
- For
- DTUs API Enhancements: Added support for sending MQTT commands, currently supporting actions:
dex: Report Dex
restock_only: Restock the machine, resetting the current level of all coils to the PAR level
restock: Restock the machine, resetting the current level of all coils to the PAR level and creating a collection report
remote_credit: Send a credit to DTU
Version: 5.0.41
Release Date: 2022-09-30
- New API Controller: Added
ApiLambdaController
to support deployment to AWS LAMBDA and invocation via API GATEWAY. - New APIs:
- Tickets
- Alarms
- Reports
- API Improvements:
- Added several output fields to
Locations API
. Users API
now supports password modification.- Added
country
field toCard_accounts API
.
- Added several output fields to
- Support Interface Update: In the DTU list on the Support page, after searching for DTU or machine, clicking the company ID now directly displays the company instead of performing a fuzzy search.
Version: 5.0.40
Release Date: 2022-08-18
- Coil Update:
PAR
,Alarm
, andCurrent level
can now be set to 0.Alarm
must be less than or equal toPAR level
. - New Card Webhook: Added a webhook that triggers when creating a card.
Version: 5.0.37
Release Date: 2022-07-12
Version: 4.1.4
Release Date: 2015-11-25
- Ticket Creation: To report a general issue, navigate to Help -> Contact Us and create a generic ticket. For machine-specific issues, go to System -> Machine, and click the
button located at the end of each machine's record.
- Online Help: Access our comprehensive online help documentation via Help -> More Help Menu.
- Credit Card Transaction Fees: Configure transaction fees for each machine individually.
- Time Zone Support: Each account can now set up its time zone.
- Backend Management Enhancements: Enhanced backend functionalities now allow account owners to modify inventory and other capabilities.
- Email Notifications: Introducing a new email notification system powered by mailgun.org for improved communication.
- Bug Fixes: Resolved several issues to enhance user experience.