SuitePOS Release 4.1

SuitePOS Release 4.1

Please read this carefully before performing any upgrade.
Integration and Access Tokens must be created in advance of this upgrade (to support NetSuite's token-based authentication)
A server-side bundle/package upgrade is required before the App is upgraded
  1. Customers on 4.0.x or earlier will need to remove the App, install the new version and perform a full sync. 
  2. Customers on 4.1.x or above can simply overwrite the App after installing the bundle and likely do not have to perform a full sync.
Please be mindful of  NetSuite Script Error: SSS_REQUEST_LIMIT_EXCEEDED when full syncing many terminals at once.

Release 4.1 History

Release 4.1.42 Build (1129) NS Bundle 4.1.18, SF Package 4.26

  1. Build 1128 recompile for consistency. If you have 1128, no need to install this version.

Release 4.1.41 Build (1128) NS Bundle 4.1.18, SF Package 4.26

  1. Fix some stability issues around item syncs for certain models of iPads
Release 4.1.40 Build (1127) NS Bundle 4.1.18, SF Package 4.26

  1. Fix BT issues with iOS 16.5 and Socket Mobile whereby two apps that use the Socket Mobile SDK (eg. SuitePOS and the Socket Mobile Configurator)  causes problems with the BT connection of the scanner. Socket Mobile issued an urgent SDK upgrade per a bulletin.

Release 4.1.39 Build (1126) NS Bundle 4.1.18, SF Package 4.26

  1. Attempt to fix sporadic core data issues by producing a new build using latest XCODE version
  2. Attempt to fix the occasional promotion core data error by not clearing out the promotions as often
  3. Updated provisioning profiles to 5/16/24 (from 11/11/23)

    Release 4.1.37 Build (1124) NS Bundle 4.1.18, SF Package 4.26

    1. Attempt to fix core data errors/rare crashes that happen when returning items from a sale
    Release 4.1.36 Build (1123) NS Bundle 4.1.18, SF Package 4.26
    1. Attempts to recover from the rare occasion of "Receipt is Empty" error that is posted because of a suspected memory leakage resulting in a blank receipt being posted to NetSuite. This is achieved by searching the transaction again after this is displayed and SuitePOS regenerating the receipt.
    2. Fixed a Fail Queue formatting issue when errors are posted to for the "anonymous" customer.

    3. Fixed a issue where the cursor does not focus on "New Price" field when tapping "Unit Price"

    Release 4.1.35 Build (1122) NS Bundle 4.1.18, SF Package 4.26
    1. Fixed various crashes from Fail Queue changes from Async to Synchronous in Build 1116
    Release 4.1.34 Build (1121) NS Bundle 4.1.18, SF Package 4.26
    1. Compiled with xCode 14 after upgrading Square SDK to 1.6.9. This fixes an issue with Square Terminal V2
    2. Fixed (null) showing on receipt for some gift cards
    3. Fixed the issue when a sale is placed on hold (twice) it disappears
    Release 4.1.33 Build (1120) NS Bundle 4.1.18, SF Package 4.26
    1. Fix price level bug that does not get the right price when there are more than 100 active and inactive price levels.
    Release 4.1.32 Build (1118) NS Bundle 4.1.18, SF Package 4.26
    1. Compiled with xCode 13 to resolve errors for customers using the Square Reader SDK, iOS 16.x and the Square Terminal V2.
    1. Throttling. This is for very high volume customers.  If the writing of Sales to NetSuite starts timing out (or the max concurrency is reached), SuitePOS will throttle the terminal so that all sale transactions (for 45 mins) will go to the failed queues instead of hitting the NetSuite server. This give the NetSuite server a chance to recover while still maintaining a good shopper experience.
      In a later release (4.2.x) the default is OFF and you can manually enable throttling and adjust the time from POS Settings.
    Release 4.1.32 Build (1117) NS Bundle 4.1.18, SF Package 4.26
    1. Fix for an annoying crash on close register. note: this did not impact the actual close.
    Release 4.1.29 Build (1116)  NS Bundle 4.1.18, SF Package 4.26
    1. Fixed issue where under some circumstances the Failed Queue was processing failures asynchronously causing issues with concurrency requests (being exceeded) in NetSuite. 
    Release 4.1.28 Build (1115)  NS Bundle 4.1.18, SF Package 4.26
    1. Salesforce update only: SF Security Review
    Release 4.1.27 Build (1114)  NS Bundle 4.1.18, SF Package 4.15
    1. Fixed another rare issue where Refunds are calculating wrong tax (for Avatax) and ends up stopping the refund. 
    2. Fixes Sales Order Sales Rep issues for orders placed on hold
    3. Fixed rare issue where refunds are calculating the wrong tax (for AvaTax) stopping the refund
    Release 4.1.26 Build (1113) NS Bundle 4.1.18, SF Package 4.15
    1. Fix some Stripe crashes in the SDK
    2. Do not show whole order promotions on gift receipt
    3. Fixes Sales Order Sales Rep issues for orders placed on hold
    4. Fixed rare issue where Refunds are calculating the wrong tax (for AvaTax) stopping the Refund.
    Release 4.1.25 Build (1111) NS Bundle 4.1.18, SF Package 4.15
    1. Update Square Reader SDK (1.6.8) to support iOS16 devices
    2. SuiteTax is now designated GA and no longer in Beta
    3. Fixed issue where inventory link is not displayed on Assembly Items
    4. Fixed Stripe crash issue when a 3D card is used
    5. Update Stripe SDK's. Stripe Terminal (2.12.0) and Stripe (22.8.1)
    6. Update to newer version of SocketScan SDK to support iOS16 devices
    7. Fixed issue where on-demand customer search does not return credit limit data
    8. Fixed rare issue where certain zips do not calculate the correct tax on returns using Avatax
    9. Hide the Void Button on Sales Orders when related transactions to the sales order have been created. This avoids a failed transaction to NetSuite
    10. Do not show Item Level Promotions on a Gift Receipt
    11. Fixed bug where message is displayed inappropriately when Auth to Exceed Credit Limit is required and sale amount equals the credit limit
    12. Fixed License Server message displaying the wrong subsidiary counts when entitlement exceeded
    Release 4.1.20 Build (1102)  NS Bundle 4.1.18, SF Package 4.15
    1. Fixed some minor UI issues for On-Demand Items
    2. Fixed issue where the last item in the cart was not carrying over properly (under rare circumstances) for On-Demand Items
    3. Fixed issue with scanner not working after a diff sync
    4. Added shipping costs to receipt for Sales Orders
    Release 4.1.18 Build (1099)  NS Bundle 4.1.18, SF Package 4.15
    1. Fixed rare issue where taxes were not getting charged when receipt totals zero
    Release 4.1.17 Build (1098)  NS Bundle 4.1.18, SF Package 4.15
    1. Fixed issue where a stripe message was popping up on first sale after starting the App
    Release 4.1.16 Build (1097)  NS Bundle 4.1.18, SF Package 4.15
    1. Some minor UI improvements
    2. Better handling of Voids
    3. Some Fail Queue improvements
    Release 4.1.14 Build (1094) NS Bundle 4.1.18, SF Package 4.15
    1. Better handle account registration by saving the Account Id after app removal and install
    2. Fixed issue/getTax error message with customers using Avatax with Sales Orders and Serialized Items.
    3. Differentiate in the Stripe SDK between a void return and an automatic split cancel return.
    4. Fixed issue/getTax error message with customers using Avatax with Sales Orders and Gift Cards.
    5. Update to the new Square SDK that is supposed to fix Bluetooth connectivity issues
    Release 4.1.11 Build (1091) NS Bundle 4.1.18, SF Package 4.15
    1. Very minor release. Differentiate in the Square Reader SDK between a void return and an automatic split cancel return.
    2. Build 4.1.9 Build (1090) (NS Bundle 4.1.18, SF Package 4.15)
    3. Fixed issue with change not being displayed for cash payments on sale complete screen
    4. New Stripe SDK
    5. Fixed some random UI issues
    Release 4.1.7 Build (1088) NS Bundle 4.1.18, SF Package 4.15
    1. Fixed some UOM label abbreviations
    2. Fixed stripe issue with amex (not accepting 4 digit CVV)
    3. Fixed SuiteTax error when getting tax on serialized/lot items
    4. Improved search performance when UOM enabled (in some accounts)
    5. Improved promotion performance (for some accounts)
    Release 4.1.5 Build (1084) NS Bundle 4.1.18, SF Package 4.15
    1. Fix split payment issue for PayPal and Stipe. Under certain circumstances, the full remaining amount is being split
    Release 4.1.4 Build (1083) NS Bundle 4.1.18, SF Package 4.15
    1. App Store compliance
    Release 4.1.3 Build (1082) NS Bundle 4.1.18, SF Package 4.15
    1. Upgrade Square API version to 2021.12.15
    2. Move from Square Transactions API for Refunds to Refunds API
    3. Add in pop-up for local (storage) scan of duplicate barcode using the scanner to pick one rather than use the first one it comes across.
    4. Support for SuiteTax (Beta) and NetSuite server-side legacy tax calculations
    5. Move inventory column "available" to first column position (when querying inventory)
    6. Add in support for the newer versions of the Square Stand (1st generation)
    Release 4.1.0A-Beta Build (1055A) NS Bundle 4.1.6, SF Package 4.14
    1. Fixed an issue with the item inventory modal not working for iPads
    2. Fixed a navigation issue when manually adding items to the cart (on X out)
    3. Ignore matrix items parent records because they cannot be sold
    Release 4.1.0X-Beta Build (1054X)  NS Bundle 4.1.6, SF Package 4.14
    1. Support for newer Square Stands
    2. Fixed Square OAUTH issues
    Release 4.1.0-Beta Build (1054)  NS Bundle 4.1.4, SF Package 4.14
    1. Fixed the wrong user name being written in the terminal audit fields because of Token-based Authentication
    Release 4.1.0-Beta Build (1053)  NS Bundle 4.1.4, SF Package 4.1

    1. Initial BETA release

    New in Release 4.1

    Token-based Authentication for all SuitePOS Restlets

    NetSuite has deprecated username/password authentication for all new restlets. As such, this method of authentication will no longer be supported. SuitePOS now uses NetSuite's Token-based Authentication (TBA). This has several advantages:
    • TBA is more secure
    • You no longer have to enter a NetSuite username/password during registration. 
    • TBA tokens persist until they are explicitly revoked. Meaning that the password policy of the NetSuite account does not effect SuitePOS registration.
    There are IMPORTANT steps you need to take before you move to TBA (and release 4.1.x). Tutorial: Setting Up Token-based Authentication (TBA) for SuitePOS

    Support for SuiteTax

    We now support SuiteTax. SuiteTax is NetSuite's new tax engine that calculates complex tax scenarios using either NetSuite Tax or Third-Party tax engines. In addition, we have extended this support to allow support of any NetSuite tax scenario, including their legacy tax.  

    Instead of the SuitePOS determining the tax, when "Enable SuiteTax" is enabled, SuitePOS uses NetSuite to determine the tax; whether the NetSuite account is using SuiteTax or the legacy tax engine.

    We have updated SuitePOS and SDK's so that iOS 16.x is now fully supported. 
    If you are running less than iOS 15.1 on any of your terminals, the latest version of SuitePOS will not install

    Store-based Saved Customer/Item Searches for Syncs (NetSuite Only)

    For some retailers, customer or item syncs can take a very long time. Saved Customer/Item Search can significantly enhances sync performance.  Now, on a per store basis (POS Settings), Saved Customer/Item Searches can be unique for specific stores.unique for that store.  More Information
    On-Demand Customer enables NetSuite-side searching of Customers; this was available in n prior release . This used to be a fuzzy search that could take up to 20 seconds for retailers that had massive customer counts. Now, a "direct" option is provided for email and phone number fields. This is fast.  
    Retailers with up to 4M customers have been tested with sub-second retrieval times.
    Example:
    After 3 key strokes (which auto reduces locally stored customers), the magnifying glass is highlighted and two new icons appear to perform direct searching (by email or phone).

    On Demand Items (NetSuite Only)

    Similar to On-Demand Customers, On-Demand Items, when enabled, allows the direct find and retrieval of items from the NetSuite-side if not stored locally (via the sync). This is useful for customers that want to reduce item sync times by not bringing in the items in the first place. 

    For example, you could create a Saved Item Search for a store (POS Settings) that brings in no items at all (or very few). If the item is not found (as a result of a barcode scan) the item is retrieved NetSuite-side automatically and pulled in locally. 
    Retailers with up to 2M items have been tested with consistent sub-second retrieval times.

    Upgrade to Stripe SDK Version 2.x

    Stripe have upgraded their SDK to version 2.x to include a 'Location" concept so that credit cards are better verified and authorized. If you are using Stripe, you will need to create Locations in your Stripe backend and then plug that "Location Id" into the POS Settings. 

    Start and End Times for a Promotion

    With the Advanced Promotion Module, you can not only specify start and end dates for promotions, but now you can specify start and end times. This is useful for time-based promotions perhaps at a specific event or during certain hours of a day. For example, a 4-6pm happy hour or a 2hr flash sale.




    Quick Access of Items

    Prior, there was no way to quickly present (for manual selection in SuitePOS) items that are often used but buried in sub-categories. We have included a flag (on the item record) that allows you to display the item (or category) on the main screen for quick selection. More Information

    Show Transaction Notes on Receipts

    We now allow you to show transaction Notes on Receipts. You can enable this in POS Settings under the Receipt tab.

     

    Show Sales Order Receipt Label

    You can now have different title and footer labels for regular sales and sales orders in order to differentiate them. You can set this label in POS Settings under the receipt tab.

    Show Total Savings

    You can now show the total savings on the receipt for line items where the unit price is shown as different from the default price (denoted by strikethrough). You can enable this in POS Settings under the Receipt tab.

    Customer Alerts

    When this is enabled, customers that have an "alert" message set are displayed in SuitePOS when the customer is selected. This can be used to identify VIP's, problematic customers or any authorized contacts. 

    Removal of Time Zone Dependency

    Prior to this, the time zone of NetSuite (or Salesforce) must match the time zone of the device. Failure to ensure that would result in a warning and potential data sync issues. Now we handle time zones automatically and independent of the server. This means the time zone of the device will persist (avoiding a lot of confusion when devices are taken across time zones).

    Add Commas to Receipts (for amounts)

    We have now put in commas to make larger amounts more readable on receipts.

    Various SDK updates

    Various third-party SDK's have been updated to newer versions. These include, but are not limited to, Stripe, Square POS, Square Reader and the Socket Scanner.

    Renaming Square Gateways

    Square and Square Plus gateway setting in POS Settings has now been renamed to Square POS and Square Reader respectively. This better reflects Squares SDK nomenclature. 

    Ignore Matrix Item Parents

    Prior to this release matrix item parents are brought in via the item sync. To exclude these "parents" (because they cannot be sold, the workaround was to exclude them from the Active Saved Item Search.  Now, these "parents" are excluded from both the item sync and also on-demand item search so adding the criteria to the saved search is no longer necessary. 

    Bug Fix: Whole Orders Discounts on Sales Orders

    On retrieval of a Sales Order (or an Invoice that was generated from a Sales Order) the discount associated with that transaction is now retrieved.

    NetSuite Update Steps

    If you have custom forms linked to the locked SPOS iOS Device role, updating the bundle will revert these forms to the SPOS Default forms. In order to correct this, you will need to set your custom forms back on the SPOS iOS Device role.  If you are already using a custom SPOS iOS Device role (recommended), this does not apply.
    1. Update to the latest supported SuitePOS Bundle
    2. Install the latest SuitePOS App https://www.suiteretail.com/prod 

    Salesforce Upgrade Steps

    1. Update to the latest SuitePOS (4.26) Package
      https://login.salesforce.com/packaging/installPackage.apexp?p0=04t6f000000ThQ5 
    2. Install the latest SuitePOS App https://www.suiteretail.com/prod 

    POS Settings Object

    Change SPOS__Gateway1__c Field List Values. "Square" Value and API Name to be renamed to "Square POS", "Square Plus" Value and API Name to be renamed to "Square Reader". Add in "Square Terminal" Value and API Name under "Square Reader".


    POS Settings Layout

    Remove SPOS__Cash_Payment_Signature_Capture__c, SPOS__Cash_Payment_Signature_Disclaimer__c, SPOS__Cash_Refund_Signature_Capture__c and SPOS__Cash_Refund_Signature_Disclaimer__c fields from POS Settings.




    Add SPOS__Show_Transaction_Notes__c, SPOS__Show_Total_Savings__c, SPOS__Sales_Order_Receipt_Label__c, SPOS__Alert_Field__c, SPOS__Stripe_Location__c fields to POS Settings layouts and associated profiles.







    Account Layout

    Add SPOS__Alert__c fields to Account layouts and associated profiles.


    Product Layout

    Add SPOS__Quick_Access__c fields to Account layouts and associated profiles.



      • Related Articles

      • SuitePOS Release 3.7

        Release 3.7 History 3.7.3B Build 767B - Production Release (NS Bundle 3.1.22/25, SF Package 3.41) iOS 13 messages in the system now work. note: this build does not officially support iOS 13 just yet. 3.7.3 Build 767A - Production Release (NS Bundle ...
      • SuitePOS Release 4.2

        Please read this carefully before performing any upgrade. A server-side Bundle/Package upgrade is required before the App is upgraded Customer on 4.1.x can simply install over the existing App. If there are issues, please remove and install the App ...
      • SuitePOS Release 3.5

        This release requires: A server-side bundle/package upgrade (NetSuite or Salesforce) A client-side terminal/device upgrade, Re-registration and Full Sync. PLEASE READ THIS CAREFULLY BEFORE PERFORMING ANY UPGRADE. Note: You may be on a very old ...
      • SuitePOS Release 3.9

        Release 3.9 History 3.9.16 Build 830Q (NS Bundle 3.1.36, SF Package 3.48) Fixed issue in Stripe for manual cards in live accounts - parameter renamed Example cart showing dynamic options being added automatically: Ability to manually set shipping ...
      • SuitePOS Release 4.0

        Release 4.0 History Build 973YY (PRODUCTION) (NS Bundle 4.0.12, SF Package 4.12) Support for new Square OAUTH flow Support for newer Square Stands Build 973Y (PRODUCTION) (NS Bundle 4.0.12, SF Package 4.12) Step back PayPal SDK to 2.1.0320297000 ...