SalesPad Mobile Release Notes

Version 1.4.1

Release Date 10/7/24

iOS/Android

FIXED: App: The app now uses the server's decimal separator character for numeric values in order to prevent errors such as "ConvertInvalidPrimitive" when looking up or saving entities.

iOS

UPDATED: App: Increased the iOS SDK version in order to optimize compatibility for devices running iOS 18.

Version 1.4.0

Release Date 9/30/24

iOS/Android/Server

ADDED: Square: There is now a Square integration for payment processing using Square credit card readers. This integration is licensed, and most of its functionality will only appear for users who have a valid license.

ADDED: Sales Documents: Payment Entry: Users can now make credit card authorizations and charges using a Square Reader.

ADDED: Sales Documents: Payments Tab: Square transactions will now appear on the Payments tab.

ADDED: Sales Documents: Payments Tab: Users can now capture and void Square authorizations.

ADDED: Sales Documents: Payments Tab: Users can now credit Square payments and deposits.

ADDED: Accessories: Square Reader Settings: The Accessories page now has a subpage for configuring Square Readers.

ADDED: Setting: Square: Currency Denomination Offset - The difference between your Square currency's normal denomination (e.g. dollars) and its smallest denomination (e.g. cents). For United States Dollars and many other currencies, this would be 100. Defaults to '100'.

ADDED: Setting: Square: Default Square Location - The default location to use for Square payments. If a user has a Square location assigned via Extended User Information or Square Reader Settings, the app will use that location instead of this setting's location.

ADDED: Setting: Square: Include Authorizations When Calculating Default Amount - If set to 'True', the app will include existing authorizations when calculating the default amount for new Square transactions. Defaults to 'True'.

ADDED: Setting: Square: Soft Delete Captured Authorizations - If set to 'True', captured authorizations will stay in the database and be hidden from payment lists. This setting's value should generally match SalesPad's Enable Multiple Capture setting. Defaults to 'False'.

ADDED: Setting: Square: Square Credit Card Type Mappings - Mapping of Credit Card Types to Dynamics GP.

UPDATED: Security: Access Security: Available Payment Methods On Orders - Square Reader is now an option for this security.

UPDATED: Security: Access Security: Available Payment Methods On Invoices - Square Reader is now an option for this security.

iOS/Android

BREAKING CHANGE: Offline: There are a large number of changes around how offline databases work. They should generally not be noticeable, but it is recommended to not update the app while it is in offline mode as this may lose any changes which have not been synced to the server.

BREAKING CHANGE: ID Tech Shuttles: ID Tech Shuttle credit card readers are no longer supported.

UPDATED: App: Various error messages in the app around failing to communicate with the service are now slightly different.

UPDATED: Sales Documents: Payment Entry: When selecting Credit Card, Nodus PayFabric, or Square Reader as the payment method, the app will automatically select the transaction type if the user only has access to one transaction type for that payment method.

UPDATED: Sales Documents: Payments Tab: Authorizations now display in a different color than other credit card transactions.

UPDATED: Sales Documents: Payments Tab: When selecting a PayFabric or Square transaction, the prompt will mention the transaction's type and amount.

UPDATED: Sales Documents: Payments Tab: When selecting a PayFabric or Square transaction and selecting a follow-up transaction type such as Void, the app will ask to confirm the new transaction.

iOS

BREAKING CHANGE: App: The minimum iOS version is now 15.0. Devices running iOS versions prior to 15.0 can no longer install or run the app.

UPDATED: App: Increased the iOS SDK version in order to optimize compatibility for devices running iOS 17.

UPDATED: App: The app now uses Microsoft.iOS as its framework instead of Xamarin.iOS.

UPDATED: Infinite Peripherals: Infinite Peripherals scanners now use the Quantum SDK.

UPDATED: Socket Mobile: The Socket Mobile Capture iOS SDK is updated to version 1.2.3.15.

UPDATED: Zebra Printers: Zebra printers now use version 1.6.1130 of the iOS SDK instead of the Link-OS Xamarin SDK.

Android

BREAKING CHANGE: App: The minimum Android version is now 7.1. Devices running Android versions prior to 7.1 can no longer install or run the app.

UPDATED: App: Increased the target Android version to Android 14 in order to optimize compatibility for devices running Android 14.

UPDATED: App: The app now uses Microsoft.Android as its framework instead of Xamarin.Android.

UPDATED: Socket Mobile: The Socket Mobile Capture SDK is updated to version 1.3.77.946.

UPDATED: Zebra Printers: Zebra printers now use version 3.0.3271 of the Zebra Printer SDK instead of the Link-OS Xamarin SDK.

Server

BREAKING CHANGE: PayFabric: PayFabric is now licensed. The new license will only be enforced when updating the server. Note that versions 1.3.47.8 and 1.3.47.9 of the server had a bug where licenses it doesn't recognize such as the new PayFabric and Square licenses would cause an "Value cannot be null" error when logging in, so obtaining the PayFabric license will have to be handled as part of the server upgrade process.

ADDED: Access Token Maintenance: Added a screen which can be used for generating, revoking, and viewing information for access tokens. Currently this screen only manages access tokens from Square.

UPDATED: Sales Documents: Payments Tab: PayFabric transactions will now appear on the Payments tab even if PayFabric is not currently set up.

UPDATED: Extended User Information: Each user can now be assigned to a Square location.

UPDATED: Application: The ApplicationName that shows in a SQL trace will now use curly brackets “{}” around the username so that filtering on ApplicationName is possible. The previously-used left bracket “[“ is a SQL special character and could not be used for filtering.

UPDATED: SalesPad: The SalesPad DLLs, which the server uses for loading and saving various entities and running workflow plugins, have been updated to version 5.5.1.

UPDATED: DevExpress: DevExpress has been updated to version 24.1.5.

FIXED: Licensing: The SalesPad Concurrent license is now fully supported. Previously, having this license instead of an older concurrent user license would result in "Unknown subscription type" errors when trying to close or log out of the server.

FIXED: Licensing: Logging in will no longer give a "Value cannot be null" error when having a mobile license which the server does not explicitly recognize. (Introduced: 1.3.47.8)

FIXED: Smart Printing: Reports which reference SignaturePad will no longer give "Parameter is not valid" errors. (Introduced: 1.3.47.6)

FIXED: Extended User Information: Prompts stating "A user can only be associated with either a Dispatch Driver or a Dispatch Vehicle" will not appear when selecting system users.

FIXED: Extended User Information: User information will no longer silently fail to load or save in some situations.

Version 1.3.47.9

Release Date 5/7/24

Server

Fixed: Service: Trying to log in with the app while the service is running as a Windows service or an IIS service will no longer give an object reference error. (Introduced: 1.3.47.8)

Version 1.3.47.8

Release Date 4/2/24

BREAKING CHANGE: IIS: The Newtonsoft version has been updated to version 13, when using an old Web.Config file, it will need updated from 12 to 13 during an upgrade.  
Example: <bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="13.0.0.0" />

iOS/Android/Server

UPDATED: Security: Contacts: Available Customer Contact Columns For Edit - Web Site is now an editable column.

UPDATED: Security: Contacts: Viewable Contact Columns In Properties - Web Site is now a viewable column.

iOS/Android

UPDATED: Contacts: A contact's website can now be opened via selecting 'Go To Website' from the slide menu.

iOS

FIXED: Application: Tab bars and the home indicator bar will not overlap.

FIXED: Application: Longer tab names will properly truncate.

Android

UPDATED: Android 13: Increased the target Android version to Android 13 in order to optimize compatibility for devices running Android 13.

FIXED: Prospects: 'Go To Website' now works on devices running Android 11 and above. (Introduced: 1.3.47.1)

Server

UPDATED: SalesPad: The SalesPad DLLs, which the server uses for loading and saving various entities and running workflow plugins, have been updated to version 5.3.1.

UPDATED: DevExpress: DevExpress has been updated to version 22.2.5.

UPDATED: Licensing: Licenses now auto-update each day as part of the login process. This allows for new licenses and updated expiration dates to appear in the app without needing to manually click the Refresh Licenses button in the Security Editor.

UPDATED: Mobile License Manager: Licenses now auto-refresh as needed. This makes it so that when Cavallo adds or updates licenses, users can see the updates in the Mobile License Manager without needing to manually refresh or reset their licenses.

UPDATED: Extended User Information: This module now remembers its splitter position.

FIXED: Sales Documents: Reports: Reports will not display their line items twice in situations where multiple sales documents have the same Sales Doc Num.

FIXED: Sales Documents: Reports: Emailing, printing, or downloading a report will not display data from the wrong sales document in situations where multiple sales documents have the same Sales Doc Num.

Version 1.3.47.7

Release Date 5/1/23

iOS/Android/Server

ADDED: Setting: Item Image Quality - When loading an image for item grids and lists such as Add Multiple Items and Quick Pick, if the image's height or width is greater than this setting's value, the server will resize the image to have a height and width less than or equal to this setting's value. Note that after this server-side resizing, the image may be resized again to fit into the UI, so large values for this setting have diminishing returns. Lower values for this setting will make loading item images faster, but may lead to lower quality images. Set to '0' to disable server-side resizing. Defaults to '500'.

UPDATED: Sales Documents: A 'Locked by [username]' banner will now be displayed when opening a sales document that is locked by another user.

iOS/Android

FIXED: Create Customer: Creating a new customer with an existing customer name no longer displays an 'A customer with the value chosen for Customer Name already exists' error message.

FIXED: Sales Documents: Quick Pick: The setting 'Should Sync UDFs' being set to 'False' will no longer result in 'No such table: spxItemMaster' errors in offline mode.

iOS

UPDATED: iOS 16: Optimized compatibility for devices running iOS 16.

UPDATED: Item Card: Item Tab: Item description is now displayed exactly how it appears in Dynamics GP instead of being shown in uppercase.

UPDATED: Item Card: Item Tab: Item type is now displayed exactly how it appears in Dynamics GP instead of being shown in uppercase.

FIXED: Item Card: Item Tab: Full item description is now displayed instead of being truncated.

FIXED: Sales Documents: Item Scanning: When there is an unrecognized item on the list of scanned items, adding the items will return to the sales document screen instead of remaining on the scanned items screen. (Introduced: 1.3.46.1)

Android

UPDATED: Sales Documents: Item images now load quicker in the 'Add Multiple Items', 'Add Recent', 'Add Catalog Items', and 'Quick Pick' screens.

Server

UPDATED: Database Update: SQL commands will not time out until 120 seconds have elapsed. This limit can be modified by changing the DatabaseUpdateCommandTimeout setting in the exe.config file.

UPDATED: Settings: Several settings are now in different categories than before. For example, 'Sales Document Pre Save Script' is now in a 'Sales - Scripts' category instead of 'General'.

UPDATED: Settings: The setting 'Item Master Image UDF' was renamed to 'Quick Pick Item Master Image UDF' and now has a description which makes it clearer that the setting only applies to Quick Pick.

REMOVED: Settings: The settings 'Add Tax Correction Lines For Offline Docs' and 'Tax Correction Item Number' were removed because these settings did not actually do anything.

Version 1.3.47.6

Release Date 3/7/23

iOS

FIXED: Sales Documents: Manually forwarding a sales document several times without leaving the sales document will not bypass the 'Allowed Batches For Forwarding' security setting.

Android

UPDATED: Android 12: Optimized compatibility for devices running Android 12.

FIXED: Accessories: Socket Mobile: Socket Mobile cordless hand scanners now work on devices running Android 11 and above. (Introduced: 1.3.47.1)

Server

BREAKING CHANGE: User Email Accounts: Updating to this version will impede using User Email Accounts in older versions of the server unless certain SQL changes are rolled back.

BREAKING CHANGE: User Email Accounts: There are several new security settings which default to 'False' and control access to functionality which already existed on the screen. The purpose of this change is to make it so users can manage their own email accounts without having access to other users' email accounts or the global email account.

BREAKING CHANGE: Dispatch: Sales Document Dispatch Schedule By Route: SalesPad.Module.Dispatch is no longer automatically included in the main install. Most of Dispatch does not require this DLL, but triggering the Schedule By Route plugin via forwarding a sales document does. You may continue using this workflow plugin by manually DLL dropping SalesPad.Module.Dispatch version 5.2.35 x86 into the main install folder for the service.

ADDED: User Email Accounts: There is now a Protocols field for choosing the authentication and communication protocols used for sending email. The supported authentication protocols are Basic Authentication, Microsoft OAuth, and Google OAuth. The supported communication protocols are SMTP, Exchange Web Services, and Gmail API. Only the 4 valid combinations of those protocols are selectable.

ADDED: User Email Accounts: There is now a Sign In button for signing into Google or Microsoft. Signing in will save the resulting access token to the database and update the Email, Protocols, and Email User Name fields.

ADDED: User Email Accounts: There is now a SSL/TLS Startup Method field. If Use SSL/TLS is checked and MailKit is being used as the SMTP client, this field determines how the client starts encryption.

ADDED: Security Setting: User Email Accounts: Can View Global Email Account - If set to 'True', the global email account will be visible. Defaults to 'False'.

ADDED: Security Setting: User Email Accounts: Can Create Email Accounts For Other Users - If set to 'True', the New button will open a modal prompt for selecting a user name for the new mail account. Defaults to 'False'.

ADDED: Security Setting: User Email Accounts: Can View Other Users' Email Accounts - If set to 'True', the System User Email grid will have an 'Only My Email' checkbox which can be unchecked to show email accounts assigned to other users. Defaults to 'False'.

ADDED: Setting: Sending Email: Basic Authentication SMTP Client Implementation - The library to use when sending email using basic authentication and SMTP. When sending email with OAuth, MailKit will be used regardless of this setting's value. Defaults to 'SystemNetMail'.

ADDED: Setting: Sending Email: Email Timeout - Specifies the amount of time (in milliseconds) after which sending an email will timeout. This setting only applies to SMTP and Exchange Web Services. Defaults to '100000'.

ADDED: Setting: Reporting: Show Hidden Report Datasets - If set to 'True', datasets outside of the main dataset will be visible again. The main use case is to more easily make changes to reports that may have mapped to fields from these datasets. Defaults to 'False'.

ADDED: Setting: Sales: Allow Background Smart Printing - If set to 'True', smart printing will occur in the background and will not slow down forwarding sales documents through workflow. Disabling this setting may help avoid potential SQL deadlock issues, but may cause the app to report successful forwards as timeouts when printing to an actual printer. Defaults to 'True'.

UPDATED: SalesPad: The SalesPad DLLs, which the server uses for loading and saving various entities and running workflow plugins, have been updated to version 5.2.35.

UPDATED: Sales Documents: Smart Printing: SMTP configurations which use OAuth will now work when forwarding sales documents through smart printing queues. Note that initially obtaining an access token must be done in SalesPad.

UPDATED: DevExpress: DevExpress has been updated to version 21.2.7.

UPDATED: Sales Documents: Reports: Sales document reports can now load data from the custom stored procedure spgpm.smcpSalesDocumentReport. The first result set maps to cSalesDocument under SalesDocument, the second result set maps to cSalesLineItems under SalesDocument -> SalesLineItems, and further result sets map to datasets starting with 'Table'. This functionality is meant to emulate the dbo.spcpSalesDocumentReport custom stored procedure, and implementations of spgpm.smcpSalesDocumentReport may simply execute dbo.spcpSalesDocumentReport.

UPDATED: Reports: Most reports will no longer show the sub-datasets as outer datasets. Example: SalesLineItems will only show as nested under the SalesDocument, instead of showing outside of the SalesDocument dataset. NOTE: Any mappings that would use the outer datasets will still populate with data, but changing/updating mappings may need to be re-mapped, or enable the new setting to show the outer mappings.

UPDATED: User Email Accounts: The Send Test Email buttons are now next to their relevant email accounts instead of being at the top of the screen.

UPDATED: User Email Accounts: The Email field is now editable for existing email accounts.

UPDATED: User Email Accounts: Whether the server uses SMTP or Exchange Web Services is now determined by the Protocols field instead of being based on whether the Exchange Version field has a value.

FIXED: User Email Accounts: Editing one or more user email accounts and the global email account at the same time will not result in the global email account failing to save.

FIXED: Sales Documents: Smart Printing: Reports which use DevExpress controls introduced between versions 19.2.4 and 21.2.7 will no longer cause errors.

FIXED: Sales Documents: Add Multiple Items: System filters on the Item Master system item will not cause adding line items to fail with a 'Must declare the scalar variable "@Item_Number1"' message.

FIXED: Sales Documents: PayFabric: PayFabric payments originating from workflow plugins will not appear twice on the Payments tab.

Version 1.3.47.5

Release Date 7/29/22

iOS/Android/Server

ADDED: Setting: Enable Timestamp Comment Field: If set to TRUE, a new field will be added to the Sales Document Comments screen that will allow users to enter a comment with the timestamp prepended to it. Defaults to 'False'.
ADDED: Setting: Timestamp For Predefined Comments: If set to TRUE, timestamps will be prepended when adding predefined comments to a sales document. Defaults to 'False'.

iOS/Android

FIXED: Application: Setting the device's language to English and region to Ireland will not cause corrupted strings with incorrect accent marks and excessive exclamation points to appear in the app.

Server

FIXED: Sales Document: Transferring quotes to orders will no longer miss copying the line items in some scenarios.

Version 1.3.47.4

Release Date 4/25/22

iOS/Android

FIXED: Dispatch: When the setting "Forward Linked Docs on Route Stop Checkin" is enabled, and a dispatch checkin is performed when the app is in offline mode, any sales documents linked to that route stop will now be forwarded when the app next syncs to online; note that forwarding the same document multiple times while offline is not allowed, and the user will be informed if a document will need manual review after the next sync to online.

FIXED: Dispatch: When the setting "Forward Linked Docs on Route Stop Checkout" is enabled, and a dispatch checkout is performed when the app is in offline mode, any sales documents linked to that route stop will now be forwarded when the app next syncs to online; note that forwarding the same document multiple times while offline is not allowed, and the user will be informed if a document will need manual review after the next sync to online.

FIXED: PayFabric: Cards which do not have a card type can now be used without causing object reference errors. These cards can be mapped to GP credit cards via the Credit Card Type Mappings setting by entering an empty string on the GP side of a mapping. For example, "VISA:VI; :Test Gift Card" maps the Visa card type from PayFabric to a credit card named VI in GP, and blank card types from PayFabric to a credit card named Test Gift Card in GP.

Android

FIXED: Cards: The app will not crash when navigating away from a card which has many UDF tabs.

FIXED: Dispatch: The map button now opens a map application on devices running Android 12.

FIXED: Cards: Clicking on a Bill To or Ship To address while not editing a card now opens a map application on devices running Android 12.

Server

UPDATED: Application: The digital signature certificate for the app's files is now valid until May 13, 2025.

Version 1.3.47.3

Release Date 2/17/22

iOS/Android

FIXED: Sales Documents: Posted invoices which have canceled line items will not display incorrect document and line totals.

UPDATED: Accessories: Zebra Printer: The Zebra SDK is updated to the latest version.
UPDATED: Accessories: Zebra Printer: iMZ series, QLn series, RW series, P4T series, RP4T series, ZQ500 series, and ZQ300 series Zebra printers are now supported for printing ZPL receipts.

Server

FIXED: Prospects: Creating a prospect with a contact will not give a "Value cannot be null" error. (Introduced: 1.3.47.1)

UPDATED: Items: Item Shipping Weight is now a column on the Item Master system item.  It can be used for reports and filtering.
UPDATED: Sales Document Reports: Added the Item Master table to the sales document report data set.
UPDATED: Sales Document Reports: Added the Sales Fulfillment table to the sales document report data set.
UPDATED: IIS Installer: The Service Login field is now labeled Service System User.

Version 1.3.47.2

Release Date 12/9/21

iOS

FIXED: Sales Documents: Trying to save a sales document when no Sales Line Item UDF tabs have "Can View" selected in the Tab Manager will not fail with an "Object reference not set to an instance of an object" error. (Introduced: 1.3.47.1)
FIXED: Opportunities: Trying to save an opportunity when no Opportunity Line Item UDF tabs have "Can View" selected in the Tab Manager will not fail with an "Object reference not set to an instance of an object" error. (Introduced: 1.3.47.1)

Version 1.3.47.1

Release Date 12/6/21

iOS/Android/Server

ADDED: Interactions: Interactions now have tabs, which can be configured in the Tab Manager. When editing an Interaction, there are now tabs for Properties and Schedule, which allows for both sets of fields to be viewed and edited before saving.
ADDED: Interactions: Interaction UDFs can now be viewed and edited as configured in the Tab Manager.
ADDED: Security Setting: Access Security: Interactions: Can Create Interactions - If set to 'True', users can create interactions from Interaction tabs. Defaults to 'True'.
ADDED: Security Setting: Access Security: Interactions: Can Delete Interactions - If set to 'True', users can delete interactions. Defaults to 'True'.
ADDED: Security Setting: Access Security: Interactions: Can Edit Interactions - If set to 'True', users can edit interactions. Defaults to 'True'.
ADDED: Setting: Userfield Pre Save Script - A script that is run before saving UDFs for any business object. The parameters include Cancel Event Args, a mobile version of the business object, and any changed userfield values (existing userfield values are not included in the UDFs collection). If the script cancels the save, the UDF changes will not save to the database and the mobile user will see the script's returned message as an error message, but the business object itself will still be saved. When editing in offline mode, this script is not run until the next sync to online, and script cancellations will then be reported to the user for manual resolution. Defaults to nothing.
ADDED: Setting: Validate Sales Line UDFs Immediately - Enabling this setting will trigger a server call when accepting edits on an individual line item in order to run the Userfield Pre Save Script immediately for user feedback, instead of waiting until the full sales document save. Defaults to 'False'.
ADDED: Setting: Validate Opportunity Line UDFs Immediately - Enabling this setting will trigger a server call when accepting edits on an individual line item in order to run the Userfield Pre Save Script immediately for user feedback, instead of waiting until the full sales document save. Defaults to 'False'.

FIXED: Licensing: The "Workflow and Profit Engine Professional" license now grants access to modules that require the "Workflow and Profit Engine Essential" license.

Android

UPDATED: Android 11: Optimized compatibility for devices running Android 11.

Server

ADDED: Setting: Forward Linked Documents on Route Stop Checkin - If set to true, when a route stop is checked in, if it has one or more linked sales documents, those documents will be automatically forwarded in workflow. Defaults to 'False'.
ADDED: Setting: Forward Linked Documents on Route Stop Checkout - If set to true, when a route stop is checked out, if it has one or more linked sales documents, those documents will be automatically forwarded in workflow. Defaults to 'False'.

FIXED: IIS: The service will no longer give intermittent "The type initializer for 'Cols' threw an exception" errors.
FIXED: IIS: Emailing a sales document report will not fail due to TLS 1.2 related errors.
FIXED: Offline: When syncing data, there will not be a "There may be an issue with the following business objects: spUserField" or "table spUserField has no column named Description" error. (Introduced: SalesPad version 5.2.12)

UPDATED: Interactions: The security settings 'Available Interaction Columns For Edit', 'Can Select Contact Person For Interactions', 'Default Interaction Type', and 'Interaction Type List' are now in a new Interactions category instead of the CRM category.

Version 1.3.46.1

Release Date 10/4/21

iOS/Android/Server

ADDED: Security Setting: Access Security: Opportunities - Convert to Quote: Can Convert Opportunities To Quotes - If set to 'True', users can convert opportunities to quotes. Defaults to 'False'.
ADDED: Security Setting: Access Security: Opportunities - Convert to Quote: Convert Opportunity Status - Opportunities will be moved to this status when converted to a quote. If the status is a historical status then the opportunity will also be made historical. Defaults to nothing.
ADDED: Security Setting: Access Security: Opportunities - Convert to Quote: Opportunity Sales Doc ID - The sales doc ID assigned to quotes which are converted from opportunities. Defaults to nothing.
ADDED: Security Setting: Access Security: Opportuni