Add Transaction

Add Transaction

Lets you add transactions of loyalty, non-loyalty, or not-interested customers. You can add batch transactions by passing each transaction details in a separate transaction attribute.

Rate Limit

Currently, there is no validation that bill amount should match with sum of line items as the data is accepted as it is from POS or integration

Following are the key functionalities of the transaction/add API.

• Registers customers automatically when a new identifier is passed with the transaction details.
• If any identifier matches with another accounts, customer accounts will be merged if the config mentioned below is not enabled.
• If CONFIG_SKIP_SECONDARY_ID_ON_PRIMARY_MISMATCH is enabled, if the primary identifier is different but any of the secondary identifiers exist, a new customer is registered with the primary identifier ignoring the secondary identifier. The config is available on the Registration Page of InTouch Profile > Organization Settings > Miscellaneous.
• Also, this config overrides CONF_PRIMARY_IDENTIFIER_STRICT_CHECK.
• Updates customer details if a registered identifier is passed with different customer details (other than customer identifiers).
• Supports transactions with Product Variant and Product Bundle details.
• Adds product variant to the database when a new variant product is passed with an existing base product.
• Adds base product to the database when a new base product/variant product is passed. However, if a new base product is passed with variant details, it adds only base product and ignores variant.
• For Multi Loyalty Programs, points can be grouped by their respective program IDs and correctly reflected in the side effects section of the response. To enable this, raise a JIRA ticket with the Sustenance team to activate the configuration CONF_ENABLE_GROUP_POINTS_BY_PROGRAM for your org.

Request Body Parameters

Return Transaction

Lets you submit a return transaction of any transaction type.

The following are different return types supported for a transaction.

Full Return: To return an entire transaction and exchange with different items
Line-item Return: To return line-item(s) of a transaction and exchange with other items
Mixed Return: To exchange one or more line items of a transaction (line-items)
Amount Return: To return the entire transaction amount

📘

For return transactions, it is required to pass return item’s purchased transaction number and purchasetime. Purchase time: The date and time of the actual transaction _ Billing time: The date and time of the return transaction

Before using this API, you need to know the configurations set of the Return Transactions page of InTouch Settings > Systems & Deployment > InTouch POS Configuration.

Request Body Parameters

Parameters marked with * are mandatory.

Response Parameters