拉卡拉銀聯二維碼國補 - 江蘇信息上報

好拓客 3個月前 ( 11-14 ) 182

注意:包含敏感字段需要全報文加密

調用地址

URL(測試環境外網):https://test.wsmsd.cn/sit/api/v3/saas_m/product/get_gsp

URL(生產環境):https://s2.lakala.com/api/v3/saas_m/product/get_gsp

江蘇國補家電核銷數據同步

字段名中文名稱是否必填類型說明
biz_method接口類型MString(64)soluGsp.gsp.jiangsu.clearance
txn_time交易發送時間MString(14)yyyyMMddHHmmss;報文請求時間
trans_type交易類型CString(20)線下收單必送
settle_dt清算日期CString(8)線下收單必送
mchnt_cd商戶號MString(15)
term_cd終端號CString(8)線下收單必送
sys_ref_no系統參考號CString(12)線下收單必送
mchnt_cn_nm銷售主體,開票主體,商戶名稱MString(100)
mchnt_order_id線上平臺訂單編號MString(64)
mchnt_pay_order_id線上平臺支付交易編號MString(64)
refund_order_id線上平臺退款交易編號CString(64)如果是核銷支付訂單,則可以為空
pay_type支付方式MString(10)支付寶支付,微信支付,銀行卡支付等,文字形式
cate_code品類編碼MString(10)詳見附錄品類編碼
eng_grade能耗等級MString(2)01: 1級能效02: 2級能效
oper_tp品類狀態MString(2)01:已核銷02:已退回
txn_amt銷售金額MString(12)銷售金額,即訂單金額(當狀態為已退回,銷售金額應為負數),單位:元
discount_amt補貼金額MString(12)補貼金額(當狀態為已退回,補貼金額應為負數), 四舍五入保留2位小數,單位:元。 品類編碼A開頭補貼金額計算標準:1級能效商品按照優惠后成交價格20%補貼; 2級能效商品按照優惠后成交價格15%補貼; 品類編碼 A開頭補貼限制:單件商品最多補貼 2000 元;
trans_tm交易完成時間MString(17)yyyyMMddHHmmssSSS
recv_region_cd收貨地區編碼MString(6)收貨地區編碼(例如:110101)6 位數字(參照中華人民共和國民政部 2023 年中華人 民共和國縣以上行政區劃代碼https://www.mca.gov.cn/mzsj/xzqh/2023/202301xzqh.html )
encrypt_data用戶敏感信息MString(512)用戶信息查詢返回
addr收貨地址MString(256)收貨地址
sales_model銷售方式MString(1)0:線上1:線下
corp_cn_nm銷售企業名稱MString(100)銷售企業名稱(不超過100位,與營業執照保持一致)
unisc_id統一社會信息代碼MString(18)統一社會信息代碼(18位,與營業執照保持一致)
barcode商品條碼MString(14)商品條碼(最大14位)
item_name商品名稱MString(100)商品名稱(不超過100位)
brand_nm家電品牌MString(256)
spec_model規格型號MString(100)規格型號(不超過100位)
sn_codeS/N碼MString(30)S/N 碼必填,建議按實采集反饋S/N 碼,如采集不到此值,則必須傳 0
imei1IMEI1碼OString(256)
imei2IMEI2碼OString(256)
logistics_no物流單號OString(100)物流單號(不超過 100 位)
delivery_time簽收時間OString(17)yyyyMMddHHmmssSSS
invoice_no發票號MString(100)發票號(不超過 100 位)
isAI_product是否屬于AI產品MString(1)是否屬于 AI 產品(0-是/1-否)
pc_type電腦類型CString(10)類型(臺式、筆記本), 當品類為電腦時必填
invoice_date開票日期MString(10)格式:yyyy-MM-dd
purchaser_name購買方名稱MString(100)
tax_authority_code稅務機關代碼MString(11)
invoice_address_code發票開具地MString(6)發票開具地(地址編碼)-6 位數字(參照中華人民共和國民政部2023年中華人民共和國縣以上行 政區劃代https://www.mca.gov.cn/mzsj/xzqh/2023/202301xzqh.html

江蘇國補電腦及3C核銷數據同步

字段名中文名稱是否必填類型說明
biz_method接口類型MString(64)soluGsp.gsp.jiangsu.3cclearance
txn_time交易發送時間MString(14)yyyyMMddHHmmss報文請求時間
trans_type交易類型CString(20)線下收單必送
settle_dt清算日期CString(8)線下收單必送
mchnt_cd商戶號MString(15)
term_cd終端號CString(8)線下收單必送
sys_ref_no系統參考號CString(12)線下收單必送
mchnt_cn_nm銷售主體,開票主體,商戶名稱MString(100)
mchnt_order_id線上平臺訂單編號MString(64)需鎖定 SN 的品類,要和SN鎖定接口送的銷售訂單號一致
mchnt_pay_order_id線上平臺支付交易編號MString(64)
refund_order_id線上平臺退款交易編號CString(64)如果是核銷支付訂單,則可以為空
pay_type支付方式MString(10)支付寶支付,微信支付,銀行卡支付等,文字形式
cate_code品類編碼MString(10)詳見附錄品類編碼
eng_grade能耗等級MString(2)A05 電腦必填01: 1級能效02: 2級能效其他品類傳00: 無能效等級
oper_tp品類狀態MString(2)01:已核銷02:已退回
txn_amt銷售金額MString(12)以元為單位
discount_amt補貼金額MString(12)以元為單位品類編碼 A 開頭補貼金額計算標準:1 級能效商品按照優惠后成交價格20%補貼; 2級能效商品按照優惠后成交價格15%補貼; 品類編碼 A 開頭補貼限制: 單件商品最多補貼 2000 元; 購買國家補貼家電商品(12 個品 類,空調可領 3 個資格),補貼資格已領取未使用,商品購買數量為1品類編碼 B 開頭補貼金額計算標準:商品按照優惠后成交價格 15%補貼 品類編碼 B 開頭補貼限制: 單件商品最多補貼 500 元; 購買國家補貼數碼商品(3 個品類),補貼資格已領取未使用,商品購買數量為 1
trans_tm交易完成時間MString(17)yyyyMMddHHmmssSSS
recv_region_cd收貨地區編碼MString(6)收貨地區編碼(例如:110101) 6 位數字(參照中華人民共 和國民政部 2023 年中華人 民共和國縣以上行政區劃 代碼 https://www.mca.gov.cn/mzsj/xzqh/2023/202301xz qh.html )
encrypt_data用戶敏感信息MString(512)用戶信息查詢返回
addr收貨地址MString(256)收貨地址
sales_model銷售方式MString(1)0:線上1:線下
corp_cn_nm銷售企業名稱MString(100)銷售企業名稱(不超過100位,與營業執照保持一致)
unisc_id統一社會信息代碼MString(18)統一社會信息代碼(18位,與營業執照保持一致)
barcode商品條碼MString(14)商品條碼(最大14位)
item_name商品名稱MString(100)商品名稱(不超過100位)
brand_nm家電品牌MString(256)
spec_model規格型號MString(100)規格型號(不超過100位)
sn_codeS/N碼MString(30)S/N 碼必填,建議按實采集反饋 S/N 碼
imei1IMEI1碼OString(256)
imei2IMEI2碼OString(256)
logistics_no物流單號OString(100)物流單號(不超過 100 位)
delivery_time簽收時間OString(17)yyyyMMddHHmmssSSS
invoice_no發票號MString(100)發票號(不超過 100 位)
isAI_product是否屬于AI產品MString(1)是否屬于 AI 產品(0-是/1-否)
pc_type電腦類型CString(10)類型(臺式、筆記本),當品類為電腦時必填
invoice_date開票日期MString(10)格式:yyyy-MM-dd
purchaser_name購買方名稱MString(100)
tax_authority_code稅務機關代碼MString(11)
invoice_address_code發票開具地MString(6)發票開具地(地址編碼)-6 位數字(參照中華人民共和國民政部2023年中華人民共和國縣以上行政區劃代碼 https://www.mca.gov.cn/mzsj/xzqh/2023/202301xzqh.html)

江蘇N品類核銷數據同步

字段名中文名稱是否必填類型說明
biz_method接口類型MString(64)soluGsp.gsp.jiangsu.other.clearance
txn_time交易發送時間MString(14)yyyyMMddHHmmss報文請求時間
mchnt_cd商戶號MString(15)
mchnt_cn_nm銷售主體,開票主體,商戶名稱MString(100)
mchnt_order_id線上平臺訂單編號MString(64)
mchnt_pay_order_id線上平臺支付交易編號MString(64)
refund_order_id線上平臺退款交易編號CString(64)如果是核銷支付訂單,則可以為空
pay_type支付方式MString(10)支付寶支付,微信支付,銀行卡支付等,文字形式
cate_code品類編碼MString(10)詳見附錄品類編碼
eng_grade能耗等級MString(2)01: 1級能效02: 2級能效00: 無能效等級
oper_tp品類狀態MString(2)01:已核銷02:已退回
txn_amt銷售金額MString(12)以元為單位
discount_amt補貼金額MString(12)以元為單位
trans_tm交易完成時間MString(17)yyyyMMddHHmmssSSS
recv_region_cd收貨地區編碼MString(6)收貨地區編碼(例如:110101) 6 位數字(參照中華人民共 和國民政部 2023 年中華人 民共和國縣以上行政區劃代碼 https://www.mca.gov.cn/mzsj/xzqh/2023/202301xzqh.html )
encrypt_data用戶敏感信息MString(512)用戶信息查詢返回
addr收貨地址MString(256)收貨地址
sales_model銷售方式MString(1)0:線上1:線下
corp_cn_nm銷售企業名稱MString(100)銷售企業名稱(不超過100位,與營業執照保持一致)
unisc_id統一社會信息代碼MString(8)統一社會信息代碼(18位,與營業執照保持一致)
brand_nm家電品牌MString(256)
logistics_no物流單號OString(100)物流單號(不超過 100 位)
delivery_time簽收時間OString(17)yyyyMMddHHmmssSSS
invoice_no發票號MString(100)發票號(不超過 100 位)
isAI_product是否屬于AI產品MString(1)是否屬于 AI 產品(0-是/1-否)
invoice_date開票日期MString(10)格式:yyyy-MM-dd
purchaser_name購買方名稱MString(100)
tax_authority_code稅務機關代碼MString(11)
invoice_address_code發票開具地MString(6)發票開具地(地址編碼)-6 位數字(參照中華人民共和國民政部2023年中華人民共和國縣以上行政區劃代碼https://www.mca.gov.cn/mzsj/xzqh/2023/202301xzqh.html)

江蘇交易信息D0回傳

字段名中文名稱是否必填類型說明
biz_method接口類型MString(64)soluGsp.gsp.jiangsu.trans.sync
txn_time交易發送時間MString(14)yyyyMMddHHmmss報文請求時間
trans_type交易類型CString(20)線下收單必送
settle_dt清算日期CString(8)線下收單必送
mchnt_cd商戶號CString(15)線下收單必送
term_cd終端號CString(8)線下收單必送
sys_ref_no系統參考號CString(12)線下收單必送
mchnt_cn_nm銷售主體,開票主體,商戶名稱MString(100)
mchnt_order_id線上平臺訂單編號MString(64)
mchnt_pay_order_id線上平臺支付交易編號MString(64)
refund_order_id線上平臺退款交易編號CString(64)如果是核銷支付訂單,則可以為空
pay_type支付方式MString(10)支付寶支付,微信支付,銀行卡支付等,文字形式
cate_code品類編碼MString(10)詳見附錄品類編碼
eng_grade能耗等級CString(2)01: 1級能效02: 2級能效
oper_tp品類狀態MString(2)01:已核銷02:已退回
txn_amt銷售金額MString(12)以元為單位
discount_amt補貼金額MString(12)以元為單位
trans_tm交易完成時間MString(17)yyyyMMddHHmmssSSS
recv_region_cd收貨地區編碼MString(6)收貨地區編碼(例如:110101) 6 位數字(參照中華人民共 和國民政部 2023 年中華人 民共和國縣以上行政區劃 代碼 https://www.mca.gov.cn/mzsj/xzqh/2023/202301xzqh.html )
encrypt_data用戶敏感信息MString(512)用戶信息查詢返回
addr收貨地址MString(256)收貨地址
sales_model銷售方式MString(1)0:線上1:線下
brand_nm家電品牌MString(256)
corp_cn_nm銷售企業名稱MString(100)銷售企業名稱(不超過100位,與營業執照保持一致)
unisc_id統一社會信息代碼MString(18)統一社會信息代碼(18位,與營業執照保持一致)

交易信息查詢用戶信息

字段名中文名稱是否必填類型說明
biz_method接口類型MString(64)soluGsp.gsp.info.receive
txn_time請求發送時間MString(14)yyyyMMddHHmmss-報文請求時間
query_type查詢類型MString(2)01:根據交易4要素查詢
mchnt_cd商戶號MString(15)
mchnt_order_id線上平臺訂單編號MString(64)
post_tmn終端號MString(8)
txn_amt銷售金額MString(12)以元為單位
region_cd地區碼MString(6)

商品信息上傳

字段名中文名稱是否必填類型說明
biz_method接口類型MString(64)soluGsp.gsp.item.create
mchnt_cd商戶號MString(15)
region_cd地區碼MString(6)
corp_name銷售企業名稱MString(100)銷售企業名稱(不超過100位,與營業執照保持一致)
unisc_id統一社會信息代碼MString(18)統一社會信息代碼(18位,與營業執照保持一致)
barcode商品條碼MString(14)
product_name商品名稱MString(100)
brand_name具體品牌MString(200)
eng_grade能耗等級MString(2)00: 無能效等級01: 1級能效02: 2級能效
cate_code品類編碼MString(2,10)詳見附錄品類編碼
base_price基準價格MString(20)基準價格(不超過兩位小數)單位:元
product_model商品型號OString(255)
product_type商品類型MString(200)
average_trading_price近1個月平均交易價格MString(20)近1個月平均交易價(不超過兩位小數)

商品信息查詢接口

字段名中文名稱是否必填類型說明
biz_method接口類型MString(64)soluGsp.gsp.item.query
region_cd地區碼MString(6)yyyyMMddHHmmss-報文請求時間
mchnt_cd商戶號MString(15)
barcode商品條碼MString(14)01:根據交易4要素查詢
req_reserved請求方保留域OString(2048)

示例

請求報文
商品信息查詢接口

{
    "req_time": "202501132020",
    "version": "1.0.0",
    "req_data": {
        "biz_method": "soluGsp.gsp.item.query",
        "txn_time": "20240202123020123",
        "mchnt_cd":"8222900701105HK",
        "region_cd": "320000",
        "barcode": "00614141999996"
    }
}復制

響應報文

{
    "respCode": "BBS00000",
    "respMsg": "成功",
    "data": {
        "sub_code": "20000",
        "sub_msg": "succeed",
        "encrypt_data": null,
        "item_info": "{\"corpName\":\"測試企業名稱\",\"uniscid\":\"123456789012345679\",\"barcode\":\"00614141999996\",\"productName\":\"洗衣機\",\"brandName\":\"海爾\",\"cateCode\":\"A0401\",\"basePrice\":\"125.00\",\"subsidyType\":\"0\",\"averageTradingPrice\":\"100000.00\",\"collectState\":\"1\",\"createTime\":\"2025-04-15 10:44:31\",\"engGrade\":\"01\"}"
    }
}復制



The End