Data Capture Settings (InStore/APIs)

Billing Configuration

Billing configuration lets you configure rules or conditions related to billing types, bill data syncing, outlier bills, currency conversion, and more at the organization level.

To configure billing details, navigate to InTouch Profile > Organization Settings >Systems & Deployment > !ntouch POS Configuration > Billing.

OPTIONDESCRIPTION
CONF_CLIENT_AUTO_BILLING_ENABLEDEnable to capture bill details from the POS automatically. Else, you need to enter bill details manually
CONF_CLIENT_BACKGROUND_NETWORK_BILL_SUBMIT- This feature is not in use/deprecated -
CONF_CLIENT_ONE_STEP_BILLING_ENABLED- This feature is not in use/deprecated -
CONF_CLIENT_BILL_NO_REGEXA regular expression for the bill number. A transaction submitted on the Transaction screen should match with the regex configured here.
CONF_CLIENT_IS_BILL_AMOUNT_ZEROEnable to accept transactions with 0 transaction amounts.
CONF_CLIENT_DISABLE_CANCEL_BILL- This feature is not in use/deprecated -
CONF_ALLOW_LOYALTY_BILL_SUBMITION_WITH_PARTIAL_DETAILSOther than the primary identifier, if any custom field is mandatory, you can submit a bill even without the
CONF_RETRO_TRANSACTION_ENABLECheck to enable retro transaction - save not-interested transactions and tag customers once registered.
These bills are saved up to the number of days set in CONF CLIENT RETRO MAX ALLOWED AGE DAYS
CONF_RETRO_TRANSACTION_CASHIEREnable to allow a cashier to convert a not-interested transaction to a regular (loyalty) transaction.
CONF_RETRO_TRANSACTION_STORE_ASSOCIATEEnable to allow a store associate to convert a not-interested transaction to a regular (loyalty) transaction.
CONF_CLIENT_BILLING_CUSTOMER_REPORT_ENABLED- This feature is not in use/deprecated -
CONF_CLIENT_AUTOSAVE_BILL_HOOK_KEYHotkey for capturing bill details from bill picker. Example: Alt+Ctrl+z
CONF_CLIENT_BILL_NOTES_READONLYEnable to not allow a cashier to enter bill notes. In this case, notes will be captured only through bill pick or integration.
ENHANCE BILL CAPTURECheck this option not to save loyalty transactions with missing or invalid identifiers as not-interested transactions.
Note: If this is unchecked, the system does not capture loyalty transactions with invalid or missing identifiers.
CONF_LOYALTY_IS_BILL_NUMBER_REQUIREDEnable to make bill number mandatory to submit a transaction or capture bill details.
CONF_LOYALTY_BILL_NUMBER_UNIQUE_IN_DAYSSet the number of days for which the bill number has to be unique. For example, if you set 30, then a transaction number cannot be repeated for 30 days. Again, you can set uniqueness at the org level, store level, or Till level using the configs mentioned below.
CONF_LOYALTY_IS_BILL_NUMBER_UNIQUEEnable this option to set bill numbers unique across the organization. You also need to set the number of days in which you want the bill number unique.
CONF_LOYALTY_BILL_NUMBER_UNIQUE_ONLY_STOREEnable this option to set bill numbers unique at the store level. You also need to set the number of days in which you want the bill number unique.
CONF_LOYALTY_BILL_NUMBER_UNIQUE_ONLY_TILLEnable this option to set bill number unique at the Till level. You also need to set the number of days in which you want the bill number unique.
IS_RETURN_BILL_UNIQUEEnable to make return bill number unique for the org.
CONF_MARK_ZERO_BILL_AS_OUTLIEREnable this option to mark transactions with bill amount 0 as outlier transactions.
CONF_LOYALTY_MAX_BILL_AMOUNTSet the minimum bill amount to be accepted across the organization. Any bill amount beyond the minimum and maximum limit set will not be accepted.
CONF_LOYALTY_MIN_BILL_AMOUNTSet the maximum bill amount to be accepted across the organization. Any bill amount beyond the minimum and maximum limit set will not be accepted.
BILL_NUMBER_WISE_IGNORE_POINTSCheck this to stop allocating points for transaction numbers that start with a specific keyword you mention in IGNORE BILLS FOR BILL NUMBER STARTS WITH.
IGNORE_POINTS_FOR_BILL_NUMBER_STARTS_WITHEnter the starting keyword of transaction numbers that need to be ignored from issuing points.
MARK_BILLS_OUTLIER_STARTING_WITHBills that start with the keyword you specify here will be considered outlier bills.
CONF_OUTLIER_ITEM_SKUEnter SKUs (comma separated) that you want to consider as outliers.
CONF_LOYALTY_MAX_BILL_LINEITEM_AMOUNTSet the maximum line-item amount that is acceptable. Any line-item amount not in the range of the minimum and maximum value will be accepted by the Capillary system.
CONF_LOYALTY_MIN_BILL_LINEITEM_AMOUNTSet the minimum line-item amount that is acceptable. Any line-item amount not in the range of the minimum and maximum value will be accepted by the Capillary system.
MARK_BILLS_OUTLIER_FROM_STOREThese stores are used for testing purposes and the bills generated in these stores will be ignored.
Select each store and click Add. The stores that you add will be considered outlier stores.
CONF_MIN_BILLING_DATESet the minimum date acceptable for billing. Any bill date (especially, while import) less than the date that you set here will be ignored automatically.
CONF_LOYALTY_IS_RETURN_BILL_NUMBER_REQUIREDEnable to make the transaction number mandatory for return bills.
CONF_LOYALTY_IS_RETURN_BILL_MANUAL_HANDLING_ENABLEDCheck to enable manual deduction of points on return transactions.
CONF_CLIENT_ENTER_LATER_SHORTCUTSet hotkey for enter-later transactions. Example: Ctrl+Alt+E.
CONF_CLIENT_NOT_INTR_SHORTCUTSet hotkey for not-interested transactions. Example: Ctrl+Alt+N.
CONF_CLIENT_CLIENT_GROSS_DISCOUNT_ENABLEDEnable to show the gross discount amount of a transaction in the invoice.
CONF_LOYALTY_TRANSACTION_AMOUNT_MARGIN
CONF_CLIENT_RETRO_DELAY_SINCE_REGISTRATION_HOURS
CONF_CLIENT_RETRO_MAX_ALLOWED_AGE_DAYSThe maximum number of days allowed for a not-interested transaction to tag it to a loyalty customer once registered.
For example, if you set 7, once a customer is registered, you can tag bills that are made by the customer in the last 7 days.
There is no limit on the number of days.
CONF_CURRENCY_CONVERSION_ENABLECheck this to enable currency conversion
BILL_OUTLIER_BASKET_SIZE_LIMITAn outlier is an observation (or configuration) to identify abnormal behavior in bills.
This option lets you set the basket size limit for a bill. Any number beyond this will be considered as an outlier bill.
For example, if you set BILL_OUTLIER_BASKET_SIZE_LIMIT as 20, any bill with basket size more than 20 is considered as an outlier bill. Set -1 if the outlier is not applicable to your organization.

Customer Registration Configuration

This article covers all settings related to customer registration and profile update.

To configure customer registration, follow these steps.

  1. On the InTouch home page, navigate to Profile > Organization Settings > Miscellaneous > Registration Configuration.
  2. Configure the required fields based on the description provided in the following table.
OPTIONDESCRIPTION
CONF_REGISTRATION_PRIMARY_KEYChoose the primary identifier of the customer. This is the unique identifier of the customer required for registration.
CONF_USERS_IS_EMAIL_REQUIREDCheck if email id is a mandatory parameter to register a customer.
CONF_USERS_IS_EMAIL_UNIQUECheck this to make the email ID a unique identifier. If any registered email ID is registered the accounts will be merged automatically.
CONF_USERS_USE_EXTERNAL_IDCheck this to capture the external ID of customers while registering.
CONF_USERS_IS_EXTERNAL_ID_REQUIREDCheck this to make the external ID mandatory to register a customer. Not applicable if the external ID is the primary identifier.
CONF_USERS_IS_MOBILE_REQUIREDCheck this to make the mobile number mandatory to register a customer. Not applicable if mobile is the primary identifier.
CONF_ALLOW_MOBILE_UPDATECheck this to allow updating the registered mobile numbers of customers.
CONF_ALLOW_EMAIL_UPDATECheck this to allow updating registered email IDs of customers.
CONF_LOYALTY_ALLOW_EXTERNAL_ID_UPDATECheck this to allow updating registered external IDs of customers.
CONF_PRIMARY_IDENTIFIER_STRICT_CHECKCheck this to verify if the primary identifier is already registered in a different account.
* An error message will be displayed that the secondary identifier match is found in a different account but not the primary identifier.
CONF_SKIP_SECONDARY_ID_ON_PRIMARY_MISMATCHCheck this to skip account merging if only secondary identifiers match but primary identifiers are different.
A new customer will be created with the provided primary identifier. The secondary identifier will be ignored automatically.
USE_CRM_REGISTRATION_INFO_FROM_BASE_STORENA
CONF_GIFT_CARD_ENABLEDCheck this to enable gift card
CONF_ORG_CURRENCY_CODESet the ISO currency code of the org.
CONF_ORG_CURRENCY_SYMBOLSet the currency symbol of the org as per the currency code.
CONF_MIN_REGISTRATION_DATESet the minimum date and time from which the registration is valid. Registration fails if the registration date and time are prior to the value set herein ( especially through API or Data Import).
SERVER_VALIDATION_PIN_SMSConfigure the verification SMS that will be sent to customers to validate the registered mobile numbers. Use the tag {{pin}} to insert the verification PIN in the message.
For example, Please use the code {{pin}} to verify your mobile number.
SERVER_VALIDATION_PIN_EMAILConfigure the verification email that will be sent to customers to validate the registered email ID. Use the tag {{pin}} to insert the verification PIN in the message.
For example, Please use the code {{pin}} to verify your email ID.
CONF_LOYALTY_REGISTER_CUSTOMER_GENDERChoose the custom field for gender from the drop-down.
CONF_LOYALTY_REGISTER_CUSTOMER_AGEChoose the custom field forage from the drop-down.
CONF_CLIENT_V2_API_ENABLEDCheck this if sources other than InStore are supported for the org.
CONF_CARD_NUMBER_SUFFIXCheck this to enable generating card numbers automatically from the Capillary end.
CONF_CARD_NUMBER_SUFFIXSpecify the suffix you want to have for the external card (supports alphanumeric value).
CONF_CARD_NUMBER_PREFIXSpecify the prefix for the external card (supports alphanumeric value). For example, BRAND20.
CONF_CARD_NUMBER_LENGTHSpecify the length of the external card. You can have up to 50 characters.
CONF_CARD_NUMBER_OFFSETSpecify the card sequence numbers that you want to ignore from the top. For example, if you set 10, the first 10 cards will be considered invalid.