Service Name: VMMS
Company: Circumtec

 

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 to API company GET.
    • Added field is_disable to API company POST to enable or disable company status.
    • Added output field company_id to API dtus.
    • Added parameter linked_only to API machine_models, with linked_only=1 returning only machine types linked to a machine.
    • Added common parameter get_all to API GET operations, with get_all=1 returning all user data regardless of pagination.
    • Introduced a new API: params.

 

Version: 5.0.48


Release Date: 2024-02-26

  • API Updates:
    • Added field location and route to API machines.
    • Added fields category, image_url to API locations.
    • Added parameter cpay_user to API card_accounts with cpay_user=1 returning all Circumpay users, restricted to sysadmin.
  • 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 to API 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 to API cardvends.
    • Added query parameter department_list to API cards, returning all card departments.

 

Version: 5.0.46


Release Date: 2023-08-25

  • API Enhancements: Added output field coin_mech to API 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.
  • API Enhancements:
    • Added output fields build_standard, firmware_ver to API machine.
    • Added output field product_img_url to API coils.
  • 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() if cpay_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 to API machines.
    • Added parameters coil_alarm, location_id, route_id, show_empty_coils, show_low_coils to API coils, supporting Coil Alarm display.
    • Added return fields location_name, machine_place, product_upc_no to API coils.
    • Added machine_id parameter to API reports.
    • For API card accounts, set company_id to 3 when registering or activating Circumpay users.

 

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 the department field of a primary card synchronizes it to all sub-cards.
  • Vend History Update: Added a dropdown for the card department in Vend History.
  • API Enhancements:
    • For API company, added output field user_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 when user_list=1, restricted to administrators, default value is 1.
    • Added parent_company_list parameter, returning all agent companies when parent_company_list=1.
    • Added output fields company_params, company_type, is_disabled, parent_company_id.
    • For API user, added user_role_list parameter, returning all user roles when user_role_list=1.
    • Added user_role output field.
    • When querying an individual user, added output fields user_routes, user_locations.
  • 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 to Card_accounts API.
  • 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, and Current level can now be set to 0. Alarm must be less than or equal to PAR level.
  • New Card Webhook: Added a webhook that triggers when creating a card.

 

Version: 5.0.37


Release Date: 2022-07-12

  • Company Industry Selection with Default Image: In Company Edit -> Advanced, selecting a company industry will now automatically assign a default image.

  • Vend History Summary: A summary section has been added to the bottom of the Cashless->Vend History page.

  • Support Page User Update Bug Fix: Resolved an issue on the support page where updating a user would result in no locations being displayed.

  • Cashless Vend History Report Accuracy: Fixed a bug in the Cashless Vend history report that caused discrepancies of a few cents in transaction records.

  • Cashless API System Gateway Charge Correction: Corrected the cashless API to ensure that the system gateway charge includes agent fees and pre-auth fees.

 

Version: 5.0.36


Release Date: 2022-06-15

  • CircumPay Shop Page Customization: Users can now upload a header image for their CircumPay shop page in "My Profile".

  • Product Category Restrictions for CircumPay: Products not categorized under a virtual product category will be restricted from CircumPay-related configurations.

  • Yearly Sales Report Enhancement: In the Reports->By Product section, yearly reports are now sorted by sales.

  • Bug Fix in Vend History: Resolved an issue in Cashless->Vend History where refund records could erroneously appear duplicated.

 

Version: 5.0.35


Release Date: 2022-04-01

  • Card User Name and Password Length Limit: The character length limit for both card user names and passwords has been extended to 100.

  • VMMS API Program Token Extension: The validity of the program token within the VMMS API has been extended to 10 years.

  • Vend History Receipt Download: In the vend history section, receipts can now be downloaded for all transactions except for those marked as refunds, enhancing record-keeping capabilities.

  • User Route and Location Filter: On the System->User page, selecting a route will now filter the location list to only show locations associated with the selected route.

 

Version: 5.0.34


Release Date: 2022-03-17

  • Image Upload for CircumPay in My Profile: Users can now upload images directly in their CircumPay profile section.

  • Company Address Update with Geolocation: Updating a company's address now automatically includes latitude and longitude parameters for enhanced location accuracy.

  • Location Condition in Vend History: A new filter based on location has been added to the vend history.

  • New DTUs API: Introduced a new API for DTUs, supporting only HTTP GET requests for easier data retrieval.

  • QR Code URL Update for Compatibility: To accommodate older phone models, the QR code URL logic for machines has been updated from a secure HTTPS URL to a more compatible HTTP format, including specific parameters for machine identification and table numbers.
    Old URL Example:
    https://www.circumpay.com/download.html?info={“imei“:“VC136822021101601“}
    New URL Example:
    http://localhost:8100/pwa?IMEI=VC136822021101601&table_no=17

  • MQTT Command Update for Newer PI Versions: For PI versions newer than 1.1.21i, MQTT commands will now mandatorily use AWS IoT, ensuring enhanced security and reliability in device communications.

 

 

Version: 5.0.33


Release Date: 2022-01-28

  • Coil API Enhancement: The Coil API now supports setting alarm levels, par levels, and current stock levels to 0.

 

 

Version: 5.0.32


Release Date: 2022-01-10
  • Bug Fix for Reporting: Addressed and resolved an issue preventing the creation of machine monthly and product monthly reports.

 

Version: 4.1.51


Release Date: 2020-09-02

  • Credit-Weekly Statements Format Improvement: The format of Credit-weekly statements has been enhanced for better readability and comprehensive analysis.

  • Card Accounts API Enhancements:

    • Mobile Phone Login: Users can now log in using their mobile phone number, improving access convenience.
    • Full Record Access Post-Login: After logging in, users will receive their full card account record.
    • Token Field Addition: A token field has been added to bolster security measures, providing an extra layer of authentication for user sessions.

 

Version: 4.1.50


Release Date: 2020-08-25

  • Standardized API Response Format: All API GET and POST requests now return in a unified format, ensuring consistency across the system. This includes fields for status, info, page_info (with total_page, record_per_page, current_page, total_record), and an array of records. Example:
    {
    "status": "1",
    "info": "success",
    "page_info": {
    "total_page": "1",
    "record_per_page": "1",
    "current_page": "1",
    "total_record": "1"
    },
    "records": [{}]
    }

  • Record Update via API: The system now supports updating records through API POST requests.

  • Modifications to Card_Accounts API: Changes include making the email field optional and replacing the "phone" field with "mobile" in the API's result structure, aligning with contemporary communication standards.

 

Version: 4.1.49


Release Date: 2020-08-19
  • New CircumPay User Verification: Implement a verification process for mobile phones or emails for new CircumPay users, enhancing security and authenticity.
  • Company API Enhancement: The Company API now includes an img_url field in its results, providing a direct link to the company's logo or relevant image.
  • Xero Import Functionality: A new "import from Xero" function has been added to the company profile section under the support page for system administrators.

 

Version: 4.1.48


Release Date: 2020-08-06

  • Machine Monthly Report Issue Fixed: Addressed a problem where the Machine Monthly report creation failed due to excessively large cash vend numbers and values in the machine daily report. Now, only total cash vends and paid vends within the range of 0 to 65535 are accepted; any records outside this range will be disregarded, ensuring the integrity and feasibility of monthly reporting.

 

Version: 4.1.47


Release Date: 2020-07-27
  • Import Company and User from Xero: On the support page, there's now a feature exclusively for ADMIN use that allows for the importing of company and user details directly from Xero.

 

Version: 4.1.46


Release Date: 2020-07-21

  • Automatic Export to Xero: Companies are now automatically exported to Xero after any changes to their profiles.

 

Version: 4.1.45


Release Date: 2020-07-19

  • 2in1 DTU Fix: Corrected an issue with the 2in1 DTU. Now, when selecting DTU->Collection, the system correctly sends an action="collection" command instead of mistakenly sending a restock command.
  • API Enhancement: Introduced the capability to perform delete SQL operations through the API.

 

Version: 4.1.44


Release Date: 2020-07-10

  • Enhanced Search in Vend History: Searching by a master card number in Vend history now retrieves Vend records for both the master and any associated additional cards.

  • Sum-Only Support in Cardvend API: The cardvends API now includes a sum_only parameter. When set to 1, the API returns a summarized result showing total vends, total value, total service charge, system service charge, service charge balance, and total payable. Example:                        {
    "status": "1",
    "info": "success",
    "page_info": {
    "total_page": "1",
    "record_per_page": "30",
    "current_page": "1",
    "total_record": "1"
    },
    "sum_info":
    {
    "total_vends": "10",
    "total_value": "13.0",
    "total_service_charge": "2.3",
    "system_service_charge": "2.5",
    "service_charge_balance": "-0.2",
    "total_payable": "12.8"
    }

 

Version: 4.1.43


Release Date: 2020-06-30

  • On the support page, when selecting a company profile, two significant updates have been made to enhance user interaction and company categorization:

    • Status Change to Drop-Down List: The status field has been converted into a drop-down list.

    • Add Agent Option: A new feature has been introduced allowing the designation of a company as an "agent company." 

 

 

Version: 4.1.42


Release Date: 2020-06-30

  • Xero Import/Export Function Upgrade: The Xero import/export functionality has been enhanced for improved efficiency and user experience.

 

Version: 4.1.41


Release Date: 2020-06-15
Details:

  • Bug Fix for Card List Export: Resolved an issue where the title was missing in the exported card list.

  • Import Card List Bug Fix: Addressed and fixed a bug where importing a card list sometimes failed.

  • Support for Additional Card Imports: Enhanced the system to support the importation of additional cards, allowing for more efficient and flexible card management.

  • Xero Integration: Added "Export To Xero" and "Import From Xero" functionalities in the company profile on the support page, facilitating seamless financial data integration between the platform and Xero accounting software.

 

Version: 4.1.40


Release Date: 2020-03-28

  • Agent Charge Monthly Report List: A new feature has been added that allows agent companies to view a list of their monthly reports. This enhancement facilitates easier access to and management of financial data for agents.

  • Parameter Update: The parameter previously known as FORWARD_DEX_TO_SFTP has been updated and renamed to DEX_TO_SFTP.

 

Version: 4.1.38


Release Date: 2020-03-02 (function 1), 2020-03-04 (function 2)

  • Agent Charge Monthly Report: The system will now automatically generate a monthly report detailing Agent Charges, streamlining financial tracking and reporting for companies.

  • New Input Parameters for Cardvends API:

    • start_time: Specifies the beginning of the vend time range for the search.
    • end_time: Specifies the end of the vend time range for the search.
    • sum: If set to 1, the API returns only the total number of vends (total_vends) and the total transaction value (total_value). Otherwise, it returns detailed information for all card vends within the specified time range.

 

Version: 4.1.37


Release Date: 2020-02-14

  • Surcharge Setup Function: A feature for setting up surcharges has been introduced on the support page for companies, enabling them to apply additional fees as needed.

  • Fee Setup Group: This includes the introduction of an Agent Charge, credit surcharge, and a monthly fee setup group, providing comprehensive options for financial management and customisation.

 

Version: 4.1.36


Release Date: 2020-02-12

  • API Enhancement: The Cardvends API has been updated to include a new parameter, machine_id, allowing for more specific queries related to transactions on individual machines.

  • Documentation Update: The API documentation has been revised to reflect the latest changes and additions, ensuring users have access to the most current information for integration and usage.                                https://www.circumvend.com.au/vmms/doc/CircumvendApi.html

 

Version: 4.1.35

Release Date: 2020-01-08

  • Company Logo Upload: The "System->My Profile" section now allows users to upload their company logo, enhancing brand visibility within the platform.

  • Bug Fix: Corrected issues in the machine yearly (detail) reports where card value, card vends, and card percent were displaying incorrect results.

  • Email Login Support in API: Enhanced the API to support email-based login, streamlining access for users.

  • Advam Reconcile Result Menu: Added a new 'Advam Reconcile Result' option under the Tools menu on the support page, which displays daily reconciliation results, improving transparency and tracking.

 

Version: 4.1.34


Release Date: 2019-12-17

  • API Enhancement: A new field, user_type, has been introduced in the card_account API, facilitating more granified user management and allowing for customized user categorization within the system.

 

Version: 4.1.33


Release Date: 2019-12-03

  • Database Update for Card Users:

    • A new field, issue_date, has been added to the card user database to track the issuance date of cards.
    • The length for email addresses and card user names has been extended to 100 characters.

  • Refund Record Fix:

    • Addressed an issue where refund records did not properly log the card user ID and the credit status was incorrectly set.

  • Card User Creation:

    • Now, the issue date is recorded when creating a new card user, ensuring accurate tracking from the outset.

  • Vend History Page Bug Fix:

    • Resolved a malfunction where the Print and Export functions were not working on the Vend History page.

  • Admin Page Support:

    • Enhanced the admin page to allow searches by business name.

 

Version: 4.1.32


Release Date: 2019-10-17

  • Image Storage Enhancement: All product images are now hosted on AWS S3, ensuring secure and scalable storage solutions.

  • Product API Introduction: A new Product API has been added to streamline product management and integration processes.

  • Report Storage Update: Weekly and monthly reports are now automatically uploaded to AWS S3. The filename and directory structure on S3 are specified in the t_statement_types configuration, optimizing report management and access.

  • Cashless Statement Addition: Introduced a new feature in Cashless -> Statement for Credit Card Monthly statements, enhancing financial tracking and reporting capabilities.

 

Version: 4.1.31


Release Date: 2019-09-20

  • Bug Fixes:

    • Resolved an issue where changing the machine transaction fee could result in a Null Pointer Error.
    • Addressed a potential Null Pointer Error that could occur when creating a new category.

  • Virtual Machine for CircumPay:

    • Companies can now add a Virtual Machine specifically for use with CircumPay. This flexibility allows for the conversion of a physical machine into a Virtual Machine.
    • Automatically generates a virtual DTU for each virtual machine with a unique IMEI format: VC + company_id + Machine_id, streamlining setup and integration.

  • Virtual Category in Product Category:

    • Introduced a "Virtual Category" property within the product category settings. This ensures that only products assigned to this category can be utilized in Virtual Machines, enhancing product management and compatibility.

 

Version: 4.1.30


Release Date: 2019-09-13

  • Enable CircumPay Selection: The Company page now includes an option to activate the CircumPay feature. This addition enhances payment flexibility for companies.

  • Industry Option Activation: Upon enabling CircumPay, companies gain access to select "industry".

  • API Enhancement: The API has been expanded to include Company-related functionalities, facilitating easier integration and management of company data within external systems.

 

Version: 4.1.29


Release Date: 2019-09-04

  • COFFEE_MACHINE_REPORT Option: A feature to allow adding a "COFFEE_MACHINE_REPORT" option for companies. This will generate reports exclusively for coffee machine owners.

  • Machine Info Enhancements: New fields - Monthly Fee, Rebate, Cup Min, Cup Max - have been added to machine information for a more detailed overview. Default values for all parameters are set and stored in the database for consistency.

  • Customer ID for Locations: Users can include a Customer ID in location settings, enhancing location-specific management.

  • Bug Fix: Addressed and resolved an issue where a null pointer error occurred during the first card interaction, improving system reliability.

 

Version: 4.1.28


Release Date: 2019-07-12

  • Credit Card Invoice Enhancement: The credit card invoice will now include additional details such as AID (Application Identifier), Authcode (Authorization Code), card type, and vend type, offering more comprehensive transaction information.

  • Card API Updates:

    • Filter Condition: Introduces a new feature allowing for the addition of filter conditions to streamline searches within the Card API.
    • Auto Top-up Configuration: Users can now modify the auto top-up settings directly through the Card API.

 

Version: 4.1.27


Release Date: 2019-05-13 

  • Cards API Improvement: The improvement to the Cards API includes the addition of several fields to enhance functionality and security. These new fields are:

    • company_id: Identifies the company ID.
    • is_default: Indicates if the card is the default choice.
    • bsb_no: Bank State Branch number for banking in Australia.
    • security_code: Card security code for verification.
    • token: A unique token associated with the card for secure transactions.
    • expire_date: The expiration date of the card.
       
  • Card Edit Window Enhancement: The card edit window will now retrieve a list of primary cards, making it easier for users to manage and select their main payment method.
  • Addition of Card Transactions to API: A new feature has been introduced in the API to include card transactions for query purposes only. This allows for more detailed tracking and management of card usage and activity.
     

Version: 4.1.25


Release Date: 2019-03-30

  • Remote Price Changing: Operators can now remotely adjust coil prices within the system. For detailed instructions, click here

  • Additional Fleet Card Support: It's now possible to add extra cards to an existing fleet card, enhancing flexibility for users.

  • Backend Improvements: The backend infrastructure has been enhanced for better support, ensuring smoother operations and user experience.

 

Version: 4.1.17


Release Date: 2018-09-07

  • RESTful API Availability: Customers must contact Circumtec to enable API functionality. For the latest API documentation, please click here.
  • Unlinked Credit Card Vends Processing: Addresses scenarios where credit card readers are installed without linking to an account, or when a DTU is swapped without updating the IMEI. Such transactions temporarily reside in the Circumtec Trust account until the DTU is linked, with records appearing in next week's statement.

 

Version: 4.1.16


Release Date: 2018-07-20

  • Real-Time Command Support:

    • Compatibility: Requires DTU with firmware version 3.00.92L or higher, and PI Unit version 1.0.43i or later.
    • Functionality: In System -> Machine, if compatible, the IMEI will display a dropdown menu with options:
      • DEX Now: Initiates a DEX report, duration depends on network and machine status.
      • Restock: Mimics pressing and holding the Restock button on the DTU.
      • Collection: Mimics pressing and holding the Collection button on the DTU.
      • CREDIT: Sends a free credit to the machine for issues like coin jams, allowing a free purchase.

    Once executed, a new entry appears in Cashless -> Vend History as "FREE_VEND" indicating the free credit, which is denoted in cents (e.g., 500 for $5).

  • New Reporting Format:

    • Implementation of new report formats for daily and monthly machine and product analyses.

  • Dex Decoder Enhancement:

    • A new Dex decoder accommodates files without set prices, specifically for MAP coffee scenarios.

  • Receipt Download:

    • Within cashless->Vend History, clicking a vend ID now allows for downloading a receipt.

  • Product Management Updates:

    • In the create/edit product window, new buttons facilitate the creation of new Brands/Categories.

 

Version: 4.1.10


Release Date: 2017-11-05

  • Vend History Separation: Implement two distinct views for Vend History: a Normal view for Credit Card users and a PPE View, catering to different user needs.
  • Refund Functionality: Introduce a refund function within Cashless -> Vend History, allowing for straightforward processing of refunds.
  • Weekly Statement Format: Launch a new report format for the cashless weekly statement, enhancing readability and user comprehension.
  • Bug Fixes: Address and resolve identified bugs to improve system performance and user experience. 

 

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.