拉卡拉银联二维码国补 - 江苏信息上报

好拓客 5天前 ( 11-14 20:07 ) 34

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

调用地址

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