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

数据源平台:旺店通·企业奇门

慧策最先以旺店通ERP切入商家核心管理痛点——订单管理，之后围绕电商经营管理中的核心管理诉求，先后布局流量获取、会员管理、仓库管理等其他重要经营模块。慧策的产品线从旺店通ERP起步，向前向后延伸，全面布局零售企业经营，整体构建一体化智能零售解决方案，打破数据孤岛，AI植入系统，实现智能决策，助力零售企业智能化转型。当前旗下拥有店+小程序、数智门店POS、旺店通ERP、旺店通WMS、卡米全渠道、客优CRM、云筹大数据等多个PssS、SaaS产品，从前端吸引流量到后端集约化管理，助力企业智慧决策

对接系统：金蝶云星空

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

配置集成方案

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：旺店通·企业奇门，然后选择对应的连接器。选择对应的查询销售出库单作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的销售出库新增接口作为数据写入动作，既可以完成第一步的数据对接配置。

旺店通·企业奇门接口明细

API：wdt.stockout.order.query.trade
NAME：查询销售出库单
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
start_time	开始时间	{{LAST_SYNC_TIME datetime}}	增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
end_time	结束时间	{{CURRENT_TIME datetime}}	增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
status	状态	110	5已取消，55已审核，95已发货，105 部分打款，110已完成，113：异常发货
src_order_no	系统订单编号
src_tid	原始单号
stockout_no	出库单号
shop_no	店铺编号		代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺单据数据信息
warehouse_no	仓库编号		代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号)
page_size	分页大小	{{PAGINATION_PAGE_SIZE}}	每页返回的数据条数，输入值范围1_{100，不传本参数，输入值默认为40，使用举例单击这里}
page_no	页号	{{PAGINATION_START_PAGE}}	不传值默认从0页开始

响应参数

接口字段	字段名称	描述
order_no	出库单号	出库单号,唯一单号
src_order_no	源单号	源单号，旺店通系统单号（多默认为JY开头）
warehouse_no	仓库编号	仓库编号
consign_time	发货时间	销售出库单发货时间时间格式：yyyy-MM-dd HH:mm:ss
order_type	出库单类型	出库单类型
trade_status	订单状态	订单状态 5已取消 10待付款 12待尾款 13待选仓 15等未付16延时审核 19预订单前处理 20前处理(赠品，合并，拆分)21委外前处理22抢单前处理 25预订单 27待抢单 30待客审 35待财审 40待递交仓库 45递交仓库中 50已递交仓库 53未确认 55已确认 95已发货 105部分打款 110已完成 113异常发货
order_type_name	出库单类型名称	固定名称“销售出库”
trade_type	订单类型	1网店销售 2线下零售 3售后换货 4批发业务 5保修换新 6保修完成 7订单补发 .. 101自定义类型1 102自定义类型2 103自定义类型3 104自定义类型4 105自定义类型5 106自定义类型6
subtype	出库子类型	出库子类型
goods_total_amount	货品总售价	货品总售价
goods_total_cost	货品总成本	货品总成本
post_fee	邮资成本	邮资成本
logistics_no	物流单号	物流单号
package_fee	包装费	包装费
receiver_name	收件人	收件人
receiver_country	国家	国家
receiver_province	省份	省份
receiver_city	城市	城市
receiver_district	地区	地区
receiver_address	详细地址	详细地址
receiver_mobile	收件人移动电话	收件人移动电话
receiver_telno	收件人固定电话	收件人固定电话
receiver_zip	邮编	邮编
receiver_dtb	大头笔	大头笔
logistics_type	物流公司类型	响应值为ERP定义的ID数值，数值对应的物流公司类型名称单击这里
logistics_code	物流公司编号	代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
logistics_name	物流公司名称	物流公司名称
print_remark	打印备注	打印备注
salesman_no	业务员编号	业务员编号
salesman_name	业务员名称	业务员名称
fullname	业务员名称	业务员名称
warehouse_name	仓库	仓库
created	创建时间	创建时间时间格式：yyyy-MM-dd HH:mm:ss
stockout_reason	出库原因	出库原因
outer_no	外部单号	外部单号
trade_no	订单编号	系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置）
src_trade_no	原始单号	商城或电商平台的订单编号,合并订单的多个订单编号有逗号隔开
nick_name	网名	网名
customer_name	客户名称	客户名称（客户真实姓名，取自receiver_name）
customer_no	客户编号	客户编号
trade_time	交易时间	交易时间时间格式：yyyy-MM-dd HH:mm:ss
pay_time	付款时间	付款时间时间格式：yyyy-MM-dd HH:mm:ss
status	出库单状态	出库单状态 5 已取消 48未确认 50待审核 52待推送 53同步失败 55已审核 95 已发货 105部分打款 110已完成 113 异常发货 115回传失败 120回传成功
shop_name	店铺名称	店铺名称
shop_no	店铺编号	代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置）
buyer_message	买家留言	买家留言
cs_remark	客服备注	客服备注
flag_name	订单标记	订单标记
post_amount	邮费	从平台获取的销售订单的邮费
block_reason	截停原因	截停原因：1申请退款2已退款4地址被修改8发票被修改16物流被修改32仓库变化64备注修改128更换货品256添加货品512放弃抢单1024其他 2048 拦截赠品 4096 拦截天猫换货 8192 买家留言变更 16384 该换货订单存在退货/退款
invoice_type	发票类别	发票类别0 不需要，1普通发票，2普通增值税发票，3专用增值税发票
invoice_title	发票抬头	发票抬头
invoice_content	发票内容	发票内容
invoice_id	发票ID	发票ID，目前只设0-1，1表示已开发票
delivery_term	发货条件	发货条件 1款到发货 2货到付款(包含部分货到付款) 3分期付款 4挂账单
fenxiao_type	分销类别	0 非分销订单 1 转供销 2 代销 3经销
fenxiao_nick	分销商ID	分销订单的分销商id,或转供销时供应商id
cod_amount	货到付款金额	货到付款金额
id_card_type	证件类别	1 身份证
receiver_area	收件人地址	省市区空格分隔
shop_remark	店铺备注	店铺备注
platform_id	平台id	平台id
trade_id	订单表主键	订单表主键
checker_name	审单员编号	审单员编号
employee_no	审单员编号	审单员编号
operator_name	审核员	审核员
packager_no	打包员编号	打包员编号
packager_name	打包员	打包员
picker_no	拣货员编号	拣货员编号
picker_name	拣货员	拣货员
printer_no	打单员编号	打单员编号
printer_name	打单员	打单员
examiner_no	验货员编号	验货员编号
examiner_name	验货员	验货员
stockout_no	出库单号	出库单号
wms_status	处理状态	处理状态 0 待处理 1 推送失败 2 推送成功 3 接口取消成功系统驳回失败 4 服务器正在处理 5 WMS返回发货信息 6 异步标记,推送申请成功'
error_info	接口处理错误信息	接口处理错误信息
warehouse_type	仓库类别	仓库类别 0不限 1普通仓库 2自动流转外部 3京东仓储 4科捷 5百世物流 6 SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 127其他
warehouse_id	出库仓库id	出库的仓库id
customer_id	客户id	客户id
freeze_reason	冻结原因	冻结原因
is_allocated	是否分配	是否分配stockout_order_detail_position
consign_status	出库状态	出库状态 1验货 2称重 4出库 8物流同步 16分拣 32档口, 64拣货 1073741824原始单已完成
ebill_status	电子面单状态	电子面单,获取状态（0 还未获取单号或获取单号和打印信息完毕；1 手动获取物流单号中；100-105 获取打印数据中）
operator_id	制单人	制单人
goods_type_count	货品种类数量	货品种类数量
md5_str	MD5字符串值	MD5字符串值,用于单据排序
custom_type	其他出库自定义子类别	其他出库自定义子类别0，1，2，3，4
receiver_ring	京东三环内	京东三环内
to_deliver_time	配送时间	配送时间，如周末
pre_charge_time	配送中心	配送中心
logistics_id	物流公司ID	物流公司ID
unknown_goods_amount	未知成本销售总额	未知成本销售总额
calc_post_cost	预估邮费成本	预估邮费成本
post_cost	邮费成本	邮费成本
calc_weight	预估重量	预估重量
post_weight	快递重量	快递给的重量
package_id	包装id	包装id
package_cost	包装成本	包装成本
has_invoice	是否包含发票	是否包含发票
printer_id	打单员	打单员
pick_error_count	拣货出错次数	拣货出错次数
picker_id	拣货员id	拣货操作员ID
sorter_id	分拣员id	包裹分拣员id
examiner_id	验货员id	验货操作员id
consigner_id	发货人id	发货人id
packager_id	打包员id	打包id
pack_score	打包积分	打包积分
pick_score	拣货积分	拣货积分
checkouter_id	签出员工id	签出员工id
watcher_id	监视员id	监视员
picklist_no	分拣单编号	分拣单编号
picklist_seq	分拣序号	订单在分拣单中序号
invoice_print_status	发票打印状态	发票打印状态
flag_id	颜色	颜色
logistics_template_id	物流单模板id	物流单模板id
sendbill_template_id	发货单模板id	发货单模板id
pos_allocate_mode	货位分配方式	货位分配方式：0系统自动分配, 1手动指定货位分配 2手动指定有效期批次货位 3其它出库优化使用出库货位 4按批次出库
note_count	便签条数	便签条数
reason_id	其他出库原因	其他出库原因
lock_id	锁定策略id	锁定策略id
reserve	保留	保留
src_tids	原始单号	原始单号，平台订单号
tax	税额	税额
currency	币种	币种
id_card	证件号码	证件号码
stock_check_time	出库单审核时间	出库单审核时间时间格式：yyyy-MM-dd HH:mm:ss
bad_reason	异常状态	需要通过异或的方式判断，异常订单(bit位)，1无库存记录 2地址发生变化 4发票变化 8仓库变化16备注变化32平台更换货品64退款…512抢单异常
print_batch_no	打印批次	ERP中的单据的打印批次信息，如需该字段，请升级至2.4.0.8版本及以上
sendbill_print_status	发货单打印状态	0未打印 1打印中 2已打印 3无需打印
logistics_print_status	物流单打印状态	0未打印 1打印中 2已打印 3无需打印
picklist_print_status	分拣单打印状态	0未打印 1打印中 2已打印 3无需打印
details_list	货品列表节点	货品列表节点
details_list.stockout_id	出库单主键id	出库单主键id
details_list.goods_count	货品数量	货品数量
details_list.weight	估重	估重
details_list.paid	已支付金额	已支付金额
details_list.refund_status	退款状态	退款状态
details_list.remark	备注	备注
details_list.src_order_type	源单据类别	源单据类别以主单为准
details_list.discount	总折扣金额	总折扣金额
details_list.tax_rate	税率	税率
details_list.spec_no	商家编码	代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
details_list.sell_price	销售价	销售价,最终交易价格,扣除优惠
details_list.brand_no	品牌编号	品牌编号
details_list.brand_name	品牌名称	品牌名称
details_list.goods_type	货品类型	货品类型： 1销售商品 2原材料 3包装 4周转材料5虚拟商品6固定资产 0其它
details_list.gift_type	是否是赠品	是否是赠品 0非赠品 1自动赠送 2手工赠送
details_list.goods_name	货品名称	货品名称
details_list.goods_no	货品编号	代表货品(spu)所有属性的编号，SPU概念介绍,单击这里
details_list.spec_name	规格名称	规格名称
details_list.spec_code	规格码	规格码
details_list.suite_no	来源组合装编码	来源组合装编码
details_list.total_amount	总货款	总货款,sell_price * goods_count=total_amount
details_list.goods_id	货品id	货品id
details_list.spec_id	商品主键	商品主键
details_list.market_price	零售价	零售价
details_list.share_amount	分摊后合计应收	分摊后合计应收
details_list.barcode	条码	条码
details_list.unit_name	基本单位	基本单位
details_list.sale_order_id	订单详情表主键	订单详情表主键
details_list.share_post	邮费分摊	邮费分摊
details_list.src_oid	原始子订单号	原始子订单号
details_list.src_tid	原始订单号	原始订单号
details_list.from_mask	单据内部来源	1手机订单 2聚划算 4服务子订单 8家装 16二次付款 32开具电子发票 1024库存不足 2048当日达 4096次日达 8192预约时效
details_list.src_order_detail_id	sales_trade_order表的主键	sales_trade_order表的主键
details_list.base_unit_id	基本单位	基本单位
details_list.unit_id	辅助单位	辅助单位
details_list.unit_ratio	单位换算	单位换算
details_list.num2	辅助数量	辅助数量
details_list.price	最终价格	最终价格，share_price删掉，取代share_price
details_list.is_examined	是否验货	是否验货，用于挂起，已标记为验货的不需要再验货
details_list.is_package	是否包装	是否包装
details_list.is_zero_cost	是否允许0成本	是否允许0成本
details_list.scan_type	扫描方式	0未验货,1扫描验货,2手工验货,3快速验货,4无需验货
details_list.good_prop1	货品档案自定义属性1	货品档案自定义属性1
details_list.good_prop2	货品档案自定义属性2	货品档案自定义属性2
details_list.good_prop3	货品档案自定义属性3	货品档案自定义属性3
details_list.good_prop4	货品档案自定义属性4	货品档案自定义属性4
details_list.good_prop5	货品档案自定义属性5	货品档案自定义属性5
details_list.good_prop6	货品档案自定义属性6	货品档案自定义属性6
details_list.prop1	单品列表自定义属性1	单品列表自定义属性1
details_list.prop2	单品列表自定义属性2	单品列表自定义属性2
details_list.prop3	单品列表自定义属性3	单品列表自定义属性3
details_list.prop4	单品列表自定义属性4	单品列表自定义属性4
details_list.prop5	单品列表自定义属性5	单品列表自定义属性5
details_list.prop6	单品列表自定义属性6	单品列表自定义属性6
details_list.batch_remark	批次备注	批次备注
details_list.expire_date	有效期	有效期，时间格式：yyyy-MM-dd HH:mm:ss
details_list.position_list	货位节点列表	货位节点列表
details_list.position_list.modified	最后更新时间	最后更新时间
details_list.position_list.batch_no	批次号	批次号
details_list.position_list.rec_id	货位主键id	货位主键id
details_list.position_list.cost_price	成本价	成本价
details_list.position_list.num	货品数量	货品数量
details_list.position_list.batch_id	批次id	批次id
details_list.position_list.position_id	货位ID	货位ID
details_list.position_list.position_no	货位编号	货位编号
details_list.position_list.stockout_order_detail_id	出库单明细id	出库单明细id
details_list.position_list.stockin_detail_id	入库单明细id	入库单明细id
details_list.position_list.stock_spec_detail_id	入库单号明细id	入库单号明细id
details_list.position_list.position_goods_count	货位出库数量	货位出库数量

金蝶云星空接口明细

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

请求参数

字段	字段名称	类型	配置值
FBillTypeID	单据类型	string	XSCKD01_SYS
FBillNo	单据编号	string	{{order_no}}
FDate	日期	string	{{consign_time}}
FSaleOrgId	销售组织	string	{{shop_no}}
FCustomerID	客户	string
FBranchId	销售门店	string
FSaleDeptID	销售部门	string
FCorrespondOrgId	对应组织	string
FCarrierID	承运商	string
FCarriageNO	运输单号	string
FSalesGroupID	销售组	string
FSalesManID	销售员	string
FStockOrgId	发货组织	string
FDeliveryDeptID	发货部门	string
FLinkPhone	联系电话	string
FLinkMan	收货人姓名	string
FStockerID	仓管员	string
FNote	备注	string
FReceiverID	收货方	string
FReceiveAddress	收货方地址	string
FSettleID	结算方	string
FReceiverContactID	收货方联系人	string
FPayerID	付款方	string
FOwnerTypeIdHead	货主类型	string
FSHOPNUMBER	网店编码	string
FSALECHANNEL	销售渠道	string
FOwnerIdHead	货主	string
SubHeadEntity	财务信息	object
SubHeadEntity.FSettleOrgID	结算组织	string
SubHeadEntity.FSettleTypeID	结算方式	string
SubHeadEntity.FReceiptConditionID	收款条件	string
SubHeadEntity.FBuyerNick	会员名称	string
SubHeadEntity.FReceiverAddress	收货人地址	string
SubHeadEntity.FReceiverName	收货人	string
SubHeadEntity.FReceiverMobile	收货人手机	string
SubHeadEntity.FReceiverCountry	收货人国家	string
SubHeadEntity.FReceiverState	收货人省份	string
SubHeadEntity.FReceiverCity	收货人城市	string
SubHeadEntity.FReceiverDistrict	收货人地区	string
SubHeadEntity.FReceiverPhone	收货人电话	string
SubHeadEntity.FVIPCODE	会员编码	string
SubHeadEntity.FEntity	明细信息	array
SubHeadEntity.FEntity.FCustMatID	客户物料编码	string
SubHeadEntity.FEntity.FMaterialID	物料编码	string
SubHeadEntity.FEntity.FBarcode	零售条形码	string
SubHeadEntity.FEntity.FRealQty	实发数量	string
SubHeadEntity.FEntity.FPrice	单价	string
SubHeadEntity.FEntity.FTaxPrice	含税单价	string
SubHeadEntity.FEntity.FIsFree	是否赠品	string
SubHeadEntity.FEntity.FLot	批号	string
SubHeadEntity.FEntity.FProduceDate	生产日期	string
SubHeadEntity.FEntity.FExpiryDate	有效期至	string
SubHeadEntity.FEntity.FEntryTaxRate	税率%	string
SubHeadEntity.FEntity.FEntryTaxAmount	税额	string
SubHeadEntity.FEntity.FAmount	金额	string
SubHeadEntity.FEntity.FAllAmount	价税合计	string
SubHeadEntity.FEntity.FStockID	仓库	string
SubHeadEntity.FEntity.FStockLocID	仓位	string
SubHeadEntity.FEntity.FStockStatusID	库存状态	string
SubHeadEntity.FEntity.FMtoNo	计划跟踪号	string
SubHeadEntity.FEntity.FEntrynote	备注	string
SubHeadEntity.FEntity.FSoorDerno	订单单号	string
SubHeadEntity.FEntity.FDiscountRate	折扣率%	string
SubHeadEntity.FEntity.FEntity_Link	关联关系表	array
SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FRuleId	转换规则	string
SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FSTableName	源单表	string
SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FSBillId	源单内码	string
SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FSId	源单分录内码	string
SubHeadEntity.FEntity.FormId	业务对象表单Id	string	SAL_OUTSTOCK
SubHeadEntity.FEntity.Operation	执行的操作	string	Save
SubHeadEntity.FEntity.IsAutoSubmitAndAudit	提交并审核	bool	true
SubHeadEntity.FEntity.IsVerifyBaseDataField	验证基础资料	bool	false
SubHeadEntity.FEntity.SubSystemId	系统模块	string	21

系统集成总览

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。