旺店通·旗舰奇门对接打通金蝶云星空订单查询接口与销售出库新增接口|轻易云数据集成平台

旺店通·旗舰奇门对接打通金蝶云星空订单查询接口与销售出库新增接口

源系统:旺店通·旗舰奇门

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

写入目标:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

数据对接方案

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：旺店通·旗舰奇门接口：订单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：销售出库新增，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

旺店通·旗舰奇门接口明细

接口：wdt.sales.tradequery.querywithdetail
接口名称：订单查询
接口方法：POST

请求参数

字段	名称	类型	描述
pager	分页参数	object
pager.page_size	分页大小	string
pager.page_no	页号	string
pager.params	业务参数	object
pager.params.start_time	开始时间	string	修改起始时间，若无订单号，则为必填。示例：“ 2021-11-11 00:00:00”
pager.params.end_time	结束时间	string	修改结束时间，上同开始时间。示例：“ 2021-11-11 01:00:00”
pager.params.status	订单状态	string	若多个状态则以“，”隔开。
pager.params.trade_no	订单编号	string	订单编号
pager.params.shop_no	店铺编号	string	店铺编号
pager.params.warehouse_no	仓库编号	string	仓库编号
pager.params.logistics_no	物流单号	string	物流单号
pager.params.src_tid	原始单号	string	原始单号, 多个原始单号之间使用英文逗号分隔

响应参数

字段	名称	类型	描述
trade_id	订单唯一键	string	订单唯一键
trade_no	订单号	string	订单号
platform_id	平台ID	string	平台ID（请点击平台代码表查看对应关系）
warehouse_type	仓库类型	string	仓库类型:1、普通仓库,大于1为委外仓库(如京东仓储,物流宝等)
src_tids	原始单号	string	原始单号，如果有多个，以","分隔，且以增序排列,不重复,过长将被裁剪
pay_account	平台支付帐号	string	平台支付帐号, 淘系平台不返回
trade_status	订单状态	string	订单状态: 4 线下退款5已取消6 待确认订单, 导入放入这个状态待转预订单(待审核)7待确认订单,导入时先放到这个状态（此状态不占用库存,可删除,离开这个状态就不能删除了)10待付款12待尾款15等未付16延时审核19预订单前处理20前处理(赠品，合并，拆分)21委外前处理23 异常预订单24 换货预订单25待处理预订单26 待激活预订单27待分配预订单 30待客审35待财审55已审核95已发货96 成本确认（待录入计划成本，订单结算时有货品无计划成本）101 已过账110已完成
trade_type	订单类型	string	订单类型:1、网店销售2、线下订单3、售后换货4、批发业务7、现款销售8、分销101、自定义类型一102、自定义类型二103、自定义类型三104、自定义类型四105、自定义类型五106、自定义类型六
freeze_reason	冻结原因	string	冻结原因
fenxiao_type	分销类别	string	分销类别:0、非分销订单1、代销2、经销
fenxiao_nick	分销商名	string	分销商名
trade_time	下单时间	string	下单时间（毫秒级时间戳，例如：1631861379000）
pay_time	支付时间	string	支付时间，例如：2020-10-19 00:00:00
consign_time	发货时间	string	发货时间，订单未发货不返回该字段（毫秒级时间戳，例如：1631861379000）
buyer_nick	买家网名	string	买家网名, 淘系平台不返回
receiver_name	收货人姓名	string	收货人姓名, 淘系平台不返回
receiver_province	省份id	string	省份id
receiver_city	城市id	string	城市id
receiver_district	地区id	string	地区id
receiver_address	收件人地址	string	收件人地址, 淘系平台不返回
receiver_mobile	手机	string	手机, 淘系平台不返回
receiver_telno	固话	string	固话, 淘系平台不返回
receiver_zip	邮编	string	邮编
receiver_area	省市区空格分隔	string	省市区空格分隔
receiver_ring	京东几环	string	京东几环
receiver_dtb	大头笔	string	大头笔
to_deliver_time	配送时间	string	配送时间,例如：2020-10-19 00:00:00
bad_reason	异常订单原因	string	异常订单原因（位运算）:2、修改地址4、修改发票8、更换仓库16、修改备注32、更换货品128、拦截赠品 256、拦截换货512、买家留言变化1024、拦截平台已发货
logistics_no	物流单号	string	物流单号
buyer_message	客户备注	string	客户备注
cs_remark	客服备注	string	客服备注
remark_flag	客服备注旗子	string	客服备注旗子
print_remark	打印备注	string	打印备注
goods_type_count	货品种类数	string	货品种类数
goods_count	货品总数	string	货品总数
goods_amount	货品总额	string	货品总额
post_amount	邮费	string	邮费
other_amount	其他收费	string	其他收费
receivable	应收金额	string	应收金额
cod_amount	货到付款金额	string	货到付款金额
ext_cod_fee	买家COD费用	string	买家COD费用
goods_cost	货款预估成本	string	货款预估成本
post_cost	预估邮费成本	string	预估邮费成本
profit	预估利润	string	预估利润
tax	税额	string	税额
invoice_type	发票类别	string	发票类别:0、不需要1、普通发票2、普通增值税发票3、专用增值税发票
invoice_title	发票标题	string	发票标题
invoice_content	发票内容	string	发票内容
salesman_name	业务员	string	业务员
checker_name	审核员	string	审核员
fchecker_name	财审员	string	财审员
checkouter_name	签出员	string	签出员
stockout_no	出库单号	string	出库单号
flag_name	标记名称	string	标记名称
trade_from	订单来源	string	订单来源:1、API抓单2、手工建单3、导入4、复制订单5、接口推送6、补发订单7、PDA选货开单
single_spec_no	单一货品商家编码	string	单一货品商家编码,多种货品为空,组合装时为组合装编码
raw_goods_count	原货品数量	string	原货品数量
raw_goods_type_count	原货品种类数	string	原货品种类数
currency	币种	string	币种
invoice_id	发票ID	string	发票ID，目前只设0-1，1表示已开发票
version_id	版本号	string	版本号
id_card_type	证件类别	string	证件类别
id_card	证件号码	string	证件号码
shop_no	店铺编号	string	店铺编号
shop_name	店铺名称	string	店铺名称
shop_remark	店铺备注	string	店铺备注
warehouse_no	仓库编号	string	仓库编号
customer_name	买家姓名	string	买家姓名
customer_no	客户编码	string	客户编码
logistics_name	物流名称	string	物流名称
logistics_code	物流公司编号	string	物流公司编号
logistics_type_name	物流类型	string	物流类型名称
delay_to_time	预计发货时间	string	预计发货时间
trade_label	订单标签	string	订单标签
detail_list	订单明细	array	订单明细
detail_list.delivery_term	发货条件	string	发货条件:1、款到发货 2、货到付款(包含部分货到付款)3、分期付款
detail_list.refund_status	退款状态	string	退款状态:0、无退款1、已取消2、已申请退款3、待退款，平台已退款,系统未退款,但订单已审核,不能直接改成,除非驳回4、等待取消,平台上取消退款,系统已退款,但订单已审核,不能直接改成,除非驳回5、退款成功6、未付款关闭，未付款的取消了
detail_list.discount	总折扣金额	string	总折扣金额
detail_list.weight	子单预估总重量	string	子单预估总重量
detail_list.tax_rate	税率	string	税率
detail_list.commission	佣金	string	佣金
detail_list.modified	修改时间	string	修改时间（毫秒级时间戳，例如：1631861379000）
detail_list.created	创建时间	string	创建时间（毫秒级时间戳，例如：1631861379000）
detail_list. trade_id	订单唯一键	string	订单唯一键
detail_list. rec_id	订单明细唯一键	string	订单明细唯一键
detail_list. platform_id	平台ID	string	平台ID
detail_list.src_oid	原始子订单号	string	原始子订单号
detail_list.src_tid	原始订单号	string	原始订单号
detail_list.gift_type	是否是赠品	string	是否是赠品 0、非赠品1、自动赠送 2、手工赠送 4、周期购赠送 8、平台赠送
detail_list.guarantee_mode	退款模式	string	退款模式:1、担保2、非担保3、在线非担保
detail_list.platform_status	子单平台状态	string	如果没有对应的原始单明细,则返回0.平台状态:10、未确认20、待尾款30、待发货40、部分发货50、已发货60、已签收70、已完成80、已退款90、已关闭
detail_list.num	货品数量	string	货品数量
detail_list.price	销售单价	string	标价，手工新建时使用货品属性中的“零售价”
detail_list.refund_num	售后退款数量	string	售后退款数量
detail_list.order_price	成交价	string	成交价,原始单折扣及分摊之后的价格
detail_list.share_price	调整后价格	string	进入ERP后再次调整的价格，默认值与order_price一致
detail_list.adjust	手工调整价	string	手工调整价,正数为加价,负数为减价,暂未处理
detail_list.share_amount	分摊后合计应收	string	分摊后合计应收=share_price*num
detail_list.goods_name	货品名称	string	货品名称
detail_list.goods_no	货品编码	string	货品编码
detail_list.spec_name	规格名	string	规格名
detail_list.spec_no	商家编码	string	商家编码
detail_list.spec_code	规格码	string	规格码
detail_list.suite_no	组合装商家编码	string	组合装商家编码
detail_list.suite_name	组合装名称	string	如果是组合装拆分的，此为组合装名称
detail_list.suite_num	组合装数量	string	组合装数量,不受拆分合并影响
detail_list.suite_amount	组合装分摊后总价	string	组合装分摊后总价
detail_list.suite_discount	组合装优惠	string	组合装优惠
detail_list.api_goods_name	平台货品名称	string	平台货品名称
detail_list.api_spec_name	平台规格名	string	平台规格名
detail_list.api_goods_id	平台货品id	string	平台货品id
detail_list.api_spec_id	平台规格id	string	平台规格id
detail_list.goods_type	货品类型	string	货品类型1销售商品 2原材料3包装4周转材料5虚拟商品6固定资产 0其它
detail_list.from_mask	订单内部来源	string	订单内部来源: 1、手机2、聚划算
detail_list.remark	子单备注	string	子单备注
detail_list.prop2	自定义属性2	string	自定义属性2
detail_list.img_url	图片路径	string	图片路径

金蝶云星空接口明细

接口：batchSave
接口名称：销售出库新增
接口方法：POST

请求参数

字段	名称	类型	描述
FBillTypeID	单据类型	string	单据类型
FBillNo	单据编号	string	单据编号
FDate	日期	string	日期
FSaleOrgId	销售组织	string	组织
FCustomerID	客户	string	基础资料
FSaleDeptID	销售部门	string	基础资料
FCorrespondOrgId	对应组织	string	组织
FSalesManID	销售员	string	基础资料
FStockOrgId	发货组织	string	组织
FDeliveryDeptID	发货部门	string	基础资料
FNote	备注	string	多行文本
FOwnerTypeIdHead	货主类型	string	多类别基础资料列表
FOwnerIdHead	货主	string	多类别基础资料
F_UBGN_Text	原始单号	string
F_TPRO_Decimal1	预估货品成本	string
FEntity	明细信息	array
FEntity.FMaterialID	物料编码	string	基础资料
FEntity.FRealQty	实发数量	string	数量
FEntity.FPrice	单价	string	单价
FEntity.FTaxPrice	含税单价	string	单价
FEntity.FIsFree	是否赠品	string	复选框
FEntity.FLot	批号	string	批次
FEntity.FProduceDate	生产日期	string	日期
FEntity.FExpiryDate	有效期至	string	日期
FEntity.FEntryTaxRate	税率%	string	小数
FEntity.FEntryTaxAmount	税额	string	金额
FEntity.FAmount	金额	string	金额
FEntity.FAllAmount	价税合计	string	金额
FEntity.FStockID	仓库	string	基础资料
FEntity.FStockLocID	仓位	string	维度关联字段
FEntity.FStockStatusID	库存状态	string	基础资料
FEntity.FMtoNo	计划跟踪号	string	文本
FEntity.FEntrynote	备注	string	文本
FEntity.FSoorDerno	订单单号	string	文本
FEntity.FDiscountRate	折扣率%	string	小数
FEntity.F_UBGN_Decimal	成本价（旺店通）	string
FEntity.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FEntity.Operation	执行的操作	string
FEntity.IsAutoSubmitAndAudit	提交并审核	bool
FEntity.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.SubSystemId	系统模块	string	默认仓库模块

数据对接价值

通过数据集成平台可视化的快速配置调用接口打通旺店通·旗舰奇门与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。