Common Errors & Issues
NetSuite Script Error: SPOS Sale: Warning on silent delete of Sales Order (used for tax calculations) - Please remove SPOS-DELETE-ME. Transaction TRAN_IN_USE
This is specific to the Sales Order Module and when Avatax is Enabled. In order to determine the Tax before checkout, the system has to temporarily write a Sales Order and then remove it. Sometimes it may not be removed due to other issues such as ...
Apple Error: Untrusted Enterprise Developer
When you first install the SuitePOS app on to the device you may get this error. It is an Apple requirement that all enterprise apps must be explicitly trusted. On the device, navigate to Settings/General/Profiles and tap on the Trust Button for ...
NetSuite Script Error: SSS_METHOD_IS_ONLY_ALLOWED_FOR_MATRIX_FIELD
This is generally triggered by SuitePOS Optimize Diff Syncs not handling a use case properly. Turn off Optimize Diff Syncs if enabled on POS Settings and re-sync the SuitePOS app. Report the issue to https://www.suiteretail.com/support. The Optimize ...
NetSuite Script Error: PSWD_REQD when editing a customer record in SuitePOS
Sometimes this error message is displayed when editing a customer record in SuitePOS and changing the email address of a customer who has Customer Center access to NetSuite. NetSuite is telling you this because of their tight security. This is a ...
Avatax Calculations Are Slow (> 45 secs) in SuitePOS. Disable Avatax.
The Avatax Module ( because of Avatax) may experience degradation of performance during peak times. This has the effect of slowing sales down since SuitePOS relies on Avatax to calculate the tax. Severe delays are very rare and very temporary, ...
Standard Apple Keyboard Covers User Input in SuitePOS
Certain versions of iOS have an issue where the standard apple keyboard may cover user input in SuitePOS. This will make it difficult/impossible to enter information in to certain fields. To resolve, on the iOS device, go to Settings/General/Keyboard ...
SuitePOS: Cannot validate license
This occurs when SuitePOS cannot validate the license because it cannot access the License Server. This occurs during POS login and is caused by either the internet or our License Server not being available. It is temporary in nature and this warning ...
NetSuite Script Error: Missing required field for index 0: custbody_spos_s4token
This is a somewhat misleading (and very rare) error that primarily occurs in the SPOS_Sale script. It occurs when the integration to NetSuite has something wrong with the format that it is expecting. This is around field validation for required ...
NetSuite Script Error: When Voiding Transactions: RCRD_DSNT_EXIST or INVALID_RCRD_TYPE
When voiding a Sale in SuitePOS you may get an error. The most common errors are when you are trying to void a sale that has not been written to NetSuite yet or if there is a NetSuite configuration issue. Solution(s): RCRD_DSNT_EXIST To resolve this ...
SuitePOS App will not install or run properly and/or there is no app icon
Sometimes the SuitePOS App will not install properly and/or there is no app icon. This, for the most part, means that there is an issue with the Apple Provisioning Profile for the app. This can be caused by: Expired Provisioning Profile. Apple ...
NetSuite Script Error: 'You must enter at least one line item for this transaction'
In the context of SuitePOS, this (somewhat misleading) error can can experienced when a return (or sale) is made and the script SPOS Return (or SPOS Sale) is executed. This occurs because the "Customer (or Anonymous Customer)" for which the ...
Square Error: Square Reader Connection Error - reader_settings_sdk_not_authorized
All SuitePOS terminals have to be authorized once (on a fresh install or when you change Square accounts) Before you can connect a Square Reader. This is so the Square Reader SDK (which accesses your Square Reader) can authenticate correctly. Failure ...
NetSuite Script Error: Error getting the transaction - UNEXPECTED_ERROR null
This happens when you try to retrieve a transaction (server side) and the transaction has not been written to the server yet. This can happen when retrieving a sales order or when you are trying to do an "on-demand" search. Please wait a while and ...
SuitePOS Issue: Discounts or categories do not appear/are missing in SuitePOS
Syncs will always try to retrieve all discounts and categories that are active. The maximum currently allowed is 1500 (active and inactive). If this maximum is reached, any additional discounts or categories may not appear. This maximum exists for ...
NetSuite Script Error: SPOS Return Script Error: TypeError: Cannot read property "promotions" from undefined (INVOCATION_WRAPPER#3)
This error may also be reported as: You entered "(null)" into a field where a numeric value was expected. Please go back and change this value to a number. This may occur when you have "SuitePromotions" in NetSuite enabled and have processed sales ...
NetSuite Script Error: "Please configure the inventory detail for this line"
Similar Related Messages: PLEASE_CONFIGURE_THE_INVENTORY_DETAIL_FOR_1 Solution(s) Identify the items and fix the underlaying cause/inventory issue. The re-sync the terminal. This will re-write the failed transaction.
NetSuite Script Error: INVALID_KEY_OR_REF - Invalid entity reference key nnnnnnnn
When a Sale or Return is written to NetSuite you may get this error thrown and the transaction appears on the Fail Queue of the device. eg. Request failed: bad request (400) {"error" : {"code" : "INVALID_KEY_OR_REF", "message" : "Invalid entity ...
Apple Error: Unable to Install SuitePOS
Once you have downloaded the SuitePOS App on to your device, you may get an error message that says "Unable to Install SuitePOS". This stops you from opening up the App. The most likely reason for this is that you are not up to date with your iOS ...
NetSuite Issue: Selected Items in SuitePOS not picking up large Item Level Promotions (180+ Items) immediately after a sync.
There are times when Item multi-select updates to an Item Level Promotion (containing a large number of items) does not propagate to SuitePOS (even after an immediate sync). This means, for example, some items may not apply the promotion. Within a ...
NetSuite Issue: NetSuite not calculating sales tax correctly. Results in open invoices and unapplied payments of 0.01 on SuitePOS transactions
UPDATE According to NetSuite, fixes will be released on a case by case basis to accounts that experience the issue. Please log a case directly with NetSuite and reference defect 580567 (and 563147). This is confined to accounts that use NetSuite's ...
Missing Transactions in NetSuite or Salesforce OR duplicate transactions in the merchant account
From time to time credit card payments have been processed but the underlaying transaction has failed to write to NetSuite or Salesforce; or it is simply missing. The solution will depend on the underlaying cause. This may include: The transaction(s) ...
NetSuite Script Error: NetSuite Data Center Error During a Sync
Once in a while, during a sync, a "NetSuite Data Center" error message may pop up. This is thrown by design and is as a result of SuitePOS not being able to obtain the data center endpoint NetSuite uses for the REST API's for your account. This is ...
NetSuite Script Error: TRANS_UNBLANCD
When a Sale or Return is written to NetSuite you may get this error thrown. For the most part, this means there is something wrong with the configuration of NetSuite and how it related to the configuration of SuitePOS. The most common issue is where ...
NetSuite Issue: Whole Order Discounts not appearing in SuitePOS when searching and retrieving Sales Orders
Whole order discounts may not appear when searching for Sales Orders or Invoices created from Sales Orders. This may be caused by the field "POS Transaction Discount" missing from the SuitePOS Sales Order (or linked Invoice) form(s). Show the field ...
NetSuite Script Error: SSS_INVALID_SCRIPTLET_ID
Throughout various points in the App you may receive this error if one or more SuitePOS Scripts have been removed, de-activated or un-deployed. To resolve this issue you need to re-activate or re-deploy the scripts.
SuiteTax: Customer Sync - Taxes are always calculating to 0.00 (zero) for sales and returns
SuiteTax (and SuitePOS) uses the Location record on Terminal Settings to determine the nexus. If this address is not set for the retail store, it will always calculate taxes to zero. Set up an address on the NetSuite Location Record for the store ...
NetSuite Script Error: Customer Sync - SSS_INVALID_SEARCH_COLUMN - taxable
This can be caused when SuiteTax is enabled in a NetSuite Account but is not enabled on POS Setting. It can also be caused by SuiteTax being enabled on POS Settings and SuiteTax installed in a NetSuite account but not provisioned correctly. In the ...
Apple Error: SuitePOS will not open or it is invalid or it is no longer available
All of a sudden the App may not open on your device or says it is invalid. This can be caused by several issues. Two of which include: Provisioning Profile Expiration Apple's distribution mechanism that we use means that the Provisioning Profile we ...
Square Error: Square Authorization Failed - invalid value for parameter "location_id"
This can occur for a variety of reasons. Most typically it is when the current Location Id on POS Settings is not authorized for the last Square Authorization that was performed. Try re-authorizing Square, after checking you have internet and your ...
Square Error: checkout_location_permission_denied_or_restricted
This error happens if the iOS "Location Access" is not granted to SuitePOS following a fresh install or upgrade. Access can be manually granted to SuitePOS on the Apple Device: Go to Settings (on the Apple iOS device) > Privacy > Location Services. ...
SuitePOS Error: Incorrectly asking for "Strong Password" when logging into SuitePOS
When signing up for services on website or apps, you can let your Apple device create "Strong Passwords" The device, can store these passwords in the iCloud Keychain and fills them in automatically if "Autofill Passwords" is set to "On". The can ...
NetSuite Script Error: Item Sync - Unexpected Error
"Unexpected Error" can have many causes. It is important that you log with "bug" with NetSuite so they can tell you exactly what it is. One thing to look at is the number of items you are syncing. We suspect that some of these errors could be due to ...
NetSuite Error: "Invalid Login Attempt" or INVALID_LOGIN_ATTEMPT
This can occur when Token Based Authentication (TBA) is not set up properly for your subscription. Generally indicates an issue with Access Tokens, the Integration Record or the NetSuite User. It could mean Tokens were revoked, the Integration Record ...
Square Warning: Location Id Mismatch
This can be displayed during a sync when the Square Authorized Location in SuitePOS does not match the Square Location in POS Settings. This normally occurs when you update the Square Location in POS Settings but have not re-authorized Square. This ...
NetSuite Script Error: SSS_REQUEST_LIMIT_EXCEEDED
This happens when the NetSuite concurrency limit (set by NetSuite) for your account is exceeded. Typically this occurs when you are simultaneously syncing many terminals at the same time. for example, if you have a concurrency limit of 5 and you try ...
Last 4 of Credit Cards Write as "0000" for Square Transactions
When you process a sale in SuitePOS using Square Payments the last 4 digits is not written to the backend platform (NetSuite or Salesforce). This is by design and caused by not authorizing the Square properly. In SuitePOS settings, you need to check ...
Socket Mobile scanner does not work correctly after pairing
Even though the socket scanner may show as paired in bluetooth settings for the Apple iOS device, it may not properly scan in the POS. The scanner may read text and put data into the search bar of the POS, but, will not scan items directly into the ...