SCIS Settings for Orders

This topic applies to

Applies to

SuiteCommerce InStore

The SCIS Settings record includes settings for orders submitted using SuiteCommerce InStore (SCIS).

To define settings for SCIS orders:

  1. Go to Customization > Lists, Records, & Fields.

  2. Scroll to SCIS Settings, and then click List in that row.

  3. Click Edit next to an existing SCIS Settings record to make changes.

  4. Click the Order subtab to define the following:

    • Submit on Update – Check this box to submit a transaction on each update. When the box is checked, AvaTax capabilities are triggered with each transaction. When the box is cleared, SCIS saves transactions in memory as orders are being created, and then commits each transaction into the system only when you click Submit.

      • If you do not use AvaTax, leave this box cleared.

      • If you are using the latest version of AvaTax, and you plan to use the Execute Client Scripts setting, leave this box cleared.

      Note

      Checking this box can slow the performance of SCIS.


    • Charge Payments – Check this box to ensure that credit card payments are charged. You can clear the box while you are testing your SCIS implementation on Sandbox, or while troubleshooting.

    • Signature Folder – Enter the name of the folder in which you want to store signature images. If you have not created a folder for credit card signatures, then the folder is automatically created with the first credit card transaction that requires a signature.

    • Signature File Type – Enter the file type you use for signature images. In most cases, enter .png.

    • Voided Item – Select the item record you use to represent voided line data. This item must be a non-taxable, non-inventory item with a price of zero (0).

    • Rounding Item – (Required if you use multiple currencies) Select the item record used to represent the rounding amount for Payment Methods that use rounding. SCIS already provides this item by default. Ensure the rounding item is selected here. For more information, read Setting up Currency Rounding for SCIS.

    • Search Transaction by Serial Number – Check this box to enable the search of transactions by serial number or lot number. If this box is checked, you can find a transaction using the serial number or the lot number of an item on the transaction.

      Note

      Using this setting may impact performance. For more information, read SCIS Settings for Improved Performance.


    • Execute Client Scripts – Enables the system to execute AvaTax integration code as Client Scripts. This setting can help improve performance in SCIS, but it can affect transactions. Leave this box cleared if you do not use AvaTax, or you use AvaTax and your account does not experience any slowness when entering or working with orders.

      Warning

      SCIS only supports client scripts for use with AvaTax integrations. You are responsible for testing and maintaining the client scripts that you create. Ensure your scripts work properly with each managed bundle update. For more information, read Recommendations for Using the Execute Client Scripts Setting.


    • Enable Split Tender Refund s - Check this box to enable paying refunds to customers using two or more payment methods on the same transaction.

    • Search Transaction Using Exact Match - When the box is cleared, SCIS search returns a list of transactions based on the first characters of the transaction identifier. When the box is checked, SCIS search returns transactions based on exact match.

    • Optimize EMV – Check this box to enable a performance enhancement. When this box is checked, SCIS submits a customer payment and invoice during the EMV device priming process. Because customer payments do not calculate taxes, or typically run several user event scripts, this optimization speeds up the process of submitting a sales transaction. When the box is cleared, a cash sale is created during the EMV device priming process.

      This check box affects specific types of sales transactions:

      • Sales transactions where the entire amount is processed using an EMV payment method.

      • Sales transactions where an EMV payment method is the first one used in a split payment of more than one payment method.

      Important

      Check this box, only if you use the accounting preference, Invoice in Advance of Fulfillment. Optimize EMV is not supported if you do not use Invoice in Advance of Fulfillment.

      This setting changes the payment process. If you enable this setting, you should use your sandbox account to test sales and return transactions in SCIS.


  5. Click Save.

Deprecation of Submit on Update

The Submit on Update checkbox will be deprecated in an upcoming release. The Execute Client Scripts check box was implemented to enable the system to execute AvaTax integration code as Client Scripts. Starting with SCIS 2019.1, best practice is to use the Execute Client Scripts setting with AvaTax integrations.

Tip

If you are currently using AvaTax, it is recommended that you test the Execute Client Scripts setting on your Sandbox account to ensure that it works properly with your configuration of SCIS.


To test Execute Client Scripts on Sandbox:

  1. Log into your Sandbox account.

  2. Go to Customization > Lists, Records, & Fields > Record Types.

  3. Find SCIS Settings. Click List.

  4. Click Edit next to each SCIS Settings record in your account

  5. Clear the Submit on Update box.

    1. Click the Order subtab. Ensure the Submit on Update box is cleared.

    2. If you use AvaTax, check the Execute Client Scripts box.

  6. Click Save.

  7. Launch an instance of SCIS that is linked to your Sandbox account.

  8. Enter sales transactions that will trigger a tax calculation with AvaTax.