Integration Specifications

This article will help you learn about how Daasity replicates data from KWI, limitations to the data we can extract and where the data is stored in the KWI schema

Integration Overview

KWI helps retailers maximize sales through their omni-channel platform, mobile POS, and inventory management system.

This document provides context on what kind of data is being gathered through this extractor, which endpoints that data is coming from, and how the extracted tables relate to each other.

Integration Availability

This integration is available for:

  • Enterprise

SFTP Export

The Daasity KWI extractor is built based on an export from the SFTP server. Once an SFTP connection with KWI is set up, Daasity can retrieve the CSV files to load data into the KWI schema.

In order for Daasity to load data from KWI, you must make a request to your KWI representative to setup an SFTP export.

Entity Relationship Diagram (ERD)

Click here to view the ERD for the Daasity KWI integration illustrating the different tables and keys to join across tables.

KWI Schema

The Daasity KWI extractor creates these tables using the SFTP export. The data is mapped from the SFTP Server to the table based on the mapping logic outlined in each table.

Customers

  • Endpoint: Customer

  • Update Method: UPSERT

  • Table Name: [kwi.customers]

CSV Header
Database Column

"Cust Num"

customer_id

"Email"

email

"First Name"

first_name

"Last Name"

last_name

"Address"

address

"Address 2", nullable: TRUE

address_2

"City"

city

"State"

state

"Zip"

zip

"Phone"

phone

"Home Store"

home_store_id

"Store Purchased"

purchased_store_id

"Sales Associate #"

sales_associate_id

"Sales Associate Name"

sales_associate_name

"Add Date", "%m/%d/%y"

added_date

"Last Purchase Date", "%m/%d/%y"

last_purchase_date

"Total Net Sales"

total_net_sales

"Email Opt-In"

email_opt_in

"Mail Opt-In"

mail_opt_in

Daasity: account_id

_account_id

Daasity: timestamp when loaded into DB

__synced_at

Order Customers

  • Endpoint: Order

  • Update Method: UPSERT

  • Table Name: [kwi.order_customers]

CSV Header
Database Column

"Customer #"

customer_id

"Customer Email"

customer_email

Daasity: account_id

_account_id

Daasity: timestamp when loaded into DB

__synced_at

Orders

  • Endpoint: Order

  • Update Method: UPSERT

  • Table Name: [kwi.orders]

CSV Header
Database Column

MD5("Transaction #" + "Store #" + "Terminal #" + "Employee Name")

order_id

"Date"

order_date

"Transaction #"

transaction_id

"Customer #"

customer_id

"Store #"

store_number

"Terminal #"

terminal_number

Daasity: account_id

_account_id

Daasity: timestamp when loaded into DB

__synced_at

Order Items

  • Endpoint: Order

  • Update Method: UPSERT

  • Table Name: [kwi.order_items]

CSV Header
Database Column

MD5("Transaction #" + "Store #" + "Terminal #" + "Employee Name")

order_id

MD5("Transaction #" + "Store #" + "Terminal #" + "Employee Name" + "Sku" + "Qty Purch")

order_item_id

"Sku"

sku

"Style #"

style_number

"Department"

department

"Class"

class

"Description"

description

"Color Code"

color_code

"Color"

color

"Size"

size

"Qty Purch"

quantity

"Cost"

cost

"Original Price"

original_price

"Retail/Markdown Price"

retail_markdown

"Sale Price"

sale_price

"Tot Cost"

total_cost

"Tot Ret/Markdown Price"

total_retail_markdown_price

"Tot Price"

total_price

"GM %"

gross_margin_pct

"Tot Tax"

total_tax

"Tax Rate"

tax_rate

"Tot Transaction"

total_transaction_amount

"Tot Discount"

total_discount_amount

"Discount %"

discount_pct

"Employee #"

employee_number

"Employee Name"

employee_name

"Sales Type"

sales_type

"Transaction Type"

transaction_type

"Pay Type"

pay_type

"Time"

transaction_time

"Discount Code"

discount_code

"Discount Description"

discount_description

"Discount Comment"

discount_comment

"Cashier Number"

cashier_number

"POS Promo"

pos_promo

"Origin of Product"

origin_of_product

"Return Reason Code"

return_reason

"Trans Code", gsub('='.''), gsub('"','')

trans_code

"Sub-Class Code", gsub('="',''), gsub('"','')

sub_class_code

"Sub-Dept", gsub('="',''), gsub('"','')

sub_department

"Original Store #"

original_store_number

"Original Terminal #"

original_terminal_number

"Original Trans #"

original_transaction_id

"Original Sales Date", "%m/%d/%y"

original_sales_date

Daasity: account_id

_account_id

Daasity: timestamp when loaded into DB

__synced_at

Last updated