旺店通·企业奇门与金蝶云星空对接集成查询销售出库单打通销售出库新增
对接系统:旺店通·企业奇门
慧策(原旺店通)是一家技术驱动型智能零售服务商,基于云计算PaaS、SaaS模式,以一体化智能零售解决方案,帮助零售企业数字化智能化升级,实现企业规模化发展。
目标系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据接口配置
数据集成平台对应的配置旺店通·企业奇门与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据旺店通·企业奇门的接口参数要求记录在轻易云集成平台。第二步配置旺店通·企业奇门与金蝶云星空之间的字段对应关系(更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息)第三步完成方案的检查参数设置:传递时间、重试次数、是否启动、前置条件等上线运行。
旺店通·企业奇门接口明细
- 接口:wdt.stockout.order.query.trade
- 接口名称:查询销售出库单
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
---|---|---|---|
start_time | 开始时间 | datetime | 增量获取数据,start_time作为开始时间,格式:yyyy-MM-dd HH:mm:ss |
end_time | 结束时间 | datetime | 增量获取数据,end_time作为结束时间,格式:yyyy-MM-dd HH:mm:ss |
status | 状态 | string | 5已取消,55已审核,95已发货,105 部分打款,110已完成,113:异常发货 |
src_order_no | 系统订单编号 | string | |
src_tid | 原始单号 | string | |
stockout_no | 出库单号 | string | |
shop_no | 店铺编号 | string | 代表店铺所有属性的唯一编码,用于店铺区分,ERP内支持自定义(ERP店铺界面设置),用于获取指定店铺单据数据信息 |
warehouse_no | 仓库编号 | string | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) |
page_size | 分页大小 | string | 每页返回的数据条数,输入值范围1100,不传本参数,输入值默认为40,使用举例单击这里 |
page_no | 页号 | string | 不传值默认从0页开始 |
响应参数
字段 | 名称 | 类型 | 描述 |
---|---|---|---|
stockout_id | 出库单主键id | string | 出库单主键id |
order_no | 出库单号 | string | 出库单号,唯一单号 |
src_order_no | 源单号 | string | 源单号,旺店通系统单号(多默认为JY开头) |
warehouse_no | 仓库编号 | string | 仓库编号 |
consign_time | 发货时间 | string | 销售出库单发货时间 时间格式:yyyy-MM-dd HH:mm:ss |
order_type | 出库单类型 | string | 出库单类型 |
trade_status | 订单状态 | string | 订单状态 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 | 出库单类型名称 | string | 固定名称“销售出库” |
trade_type | 订单类型 | string | 1网店销售 2线下零售 3售后换货 4批发业务 5保修换新 6保修完成 7订单补发 .. 101自定义类型1 102自定义类型2 103自定义类型3 104自定义类型4 105自定义类型5 106自定义类型6 |
subtype | 出库子类型 | string | 出库子类型 |
goods_count | 数量 | string | 货品数量 |
goods_total_amount | 货品总售价 | string | 货品总售价 |
goods_total_cost | 货品总成本 | string | 货品总成本 |
post_fee | 邮资成本 | string | 邮资成本 |
logistics_no | 物流单号 | string | 物流单号 |
package_fee | 包装费 | string | 包装费 |
receiver_name | 收件人 | string | 收件人 |
receiver_country | 国家 | string | 国家 |
receiver_province | 省份 | string | 省份 |
receiver_city | 城市 | string | 城市 |
receiver_district | 地区 | string | 地区 |
receiver_address | 详细地址 | string | 详细地址 |
receiver_mobile | 收件人移动电话 | string | 收件人移动电话 |
receiver_telno | 收件人固定电话 | string | 收件人固定电话 |
receiver_zip | 邮编 | string | 邮编 |
receiver_dtb | 大头笔 | string | 大头笔 |
weight | 实际重量 | string | ERP系统称重功能记录的重量,如果没有使用称重功能默认使用货品档案维护的预估重量 |
logistics_type | 物流公司类型 | string | 响应值为ERP定义的ID数值,数值对应的物流公司类型名称单击这里 |
logistics_code | 物流公司编号 | string | 代表物流所有属性的唯一编码,用于物流区分,ERP内支持自定义(ERP物流界面设置) |
logistics_name | 物流公司名称 | string | 物流公司名称 |
print_remark | 打印备注 | string | 打印备注 |
paid | 已付金额 | string | 已付金额 |
refund_status | 退款状态 | string | 退款状态: 0无退款,1取消退款,2已申请退款,3等待退货,4等待收货,5退款成功 |
salesman_no | 业务员编号 | string | 业务员编号 |
salesman_name | 业务员名称 | string | 业务员名称 |
fullname | 业务员名称 | string | 业务员名称 |
warehouse_name | 仓库 | string | 仓库 |
created | 创建时间 | string | 创建时间 时间格式:yyyy-MM-dd HH:mm:ss |
remark | 备注 | string | 备注 |
stockout_reason | 出库原因 | string | 出库原因 |
outer_no | 外部单号 | string | 外部单号 |
trade_no | 订单编号 | string | 系统订单编号,默认单号为JY开头,ERP内支持自定义(设置路径:设置——编码设置) |
src_trade_no | 原始单号 | string | 商城或电商平台的订单编号,合并订单的多个订单编号有逗号隔开 |
nick_name | 网名 | string | 网名 |
customer_name | 客户名称 | string | 客户名称(客户真实姓名,取自receiver_name) |
customer_no | 客户编号 | string | 客户编号 |
trade_time | 交易时间 | string | 交易时间 时间格式:yyyy-MM-dd HH:mm:ss |
pay_time | 付款时间 | string | 付款时间 时间格式:yyyy-MM-dd HH:mm:ss |
status | 出库单状态 | string | 出库单状态 5 已取消 48未确认 50待审核 52待推送 53同步失败 55已审核 95 已发货 105部分打款 110已完成 113 异常发货 115回传失败 120回传成功 |
shop_name | 店铺名称 | string | 店铺名称 |
shop_no | 店铺编号 | string | 代表店铺所有属性的唯一编码,用于店铺区分,ERP内支持自定义(ERP店铺界面设置) |
buyer_message | 买家留言 | string | 买家留言 |
cs_remark | 客服备注 | string | 客服备注 |
flag_name | 订单标记 | string | 订单标记 |
post_amount | 邮费 | string | 从平台获取的销售订单的邮费 |
block_reason | 截停原因 | string | 截停原因:1申请退款2已退款4地址被修改8发票被修改16物流被修改32仓库变化64备注修改128更换货品256添加货品512放弃抢单1024其他 2048 拦截赠品 4096 拦截天猫换货 8192 买家留言变更 16384 该换货订单存在退货/退款 |
invoice_type | 发票类别 | string | 发票类别0 不需要,1普通发票,2普通增值税发票,3专用增值税发票 |
invoice_title | 发票抬头 | string | 发票抬头 |
invoice_content | 发票内容 | string | 发票内容 |
invoice_id | 发票ID | string | 发票ID,目前只设0-1,1表示已开发票 |
delivery_term | 发货条件 | string | 发货条件 1款到发货 2货到付款(包含部分货到付款) 3分期付款 4挂账单 |
fenxiao_type | 分销类别 | string | 0 非分销订单 1 转供销 2 代销 3经销 |
fenxiao_nick | 分销商ID | string | 分销订单的分销商id,或转供销时供应商id |
cod_amount | 货到付款金额 | string | 货到付款金额 |
id_card_type | 证件类别 | string | 1 身份证 |
receiver_area | 收件人地址 | string | 省市区空格分隔 |
shop_remark | 店铺备注 | string | 店铺备注 |
modified | 最后修改时间 | string | 最后修改时间 时间格式:yyyy-MM-dd HH:mm:ss |
platform_id | 平台id | string | 平台id |
trade_id | 订单表主键 | string | 订单表主键 |
checker_name | 审单员编号 | string | 审单员编号 |
employee_no | 审单员编号 | string | 审单员编号 |
operator_name | 审核员 | string | 审核员 |
packager_no | 打包员编号 | string | 打包员编号 |
packager_name | 打包员 | string | 打包员 |
picker_no | 拣货员编号 | string | 拣货员编号 |
picker_name | 拣货员 | string | 拣货员 |
printer_no | 打单员编号 | string | 打单员编号 |
printer_name | 打单员 | string | 打单员 |
examiner_no | 验货员编号 | string | 验货员编号 |
examiner_name | 验货员 | string | 验货员 |
stockout_no | 出库单号 | string | 出库单号 |
src_order_type | 源单据类别 | string | 源单据类别,1 销售订单 |
wms_status | 处理状态 | string | 处理状态 0 待处理 1 推送失败 2 推送成功 3 接口取消成功系统驳回失败 4 服务器正在处理 5 WMS返回发货信息 6 异步标记,推送申请成功' |
error_info | 接口处理错误信息 | string | 接口处理错误信息 |
warehouse_type | 仓库类别 | string | 仓库类别 0不限 1普通仓库 2自动流转外部 3京东仓储 4科捷 5百世物流 6 SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 127其他 |
warehouse_id | 出库仓库id | string | 出库的仓库id |
customer_id | 客户id | string | 客户id |
freeze_reason | 冻结原因 | string | 冻结原因 |
is_allocated | 是否分配 | string | 是否分配stockout_order_detail_position |
consign_status | 出库状态 | string | 出库状态 1验货 2称重 4出库 8物流同步 16分拣 32档口, 64拣货 1073741824原始单已完成 |
ebill_status | 电子面单状态 | string | 电子面单,获取状态(0 还未获取单号或获取单号和打印信息完毕;1 手动获取物流单号中;100-105 获取打印数据中) |
operator_id | 制单人 | string | 制单人 |
goods_type_count | 货品种类数量 | string | 货品种类数量 |
md5_str | MD5字符串值 | string | MD5字符串值,用于单据排序 |
custom_type | 其他出库自定义子类别 | string | 其他出库自定义子类别0,1,2,3,4 |
receiver_ring | 京东三环内 | string | 京东三环内 |
to_deliver_time | 配送时间 | string | 配送时间,如周末 |
pre_charge_time | 配送中心 | string | 配送中心 |
logistics_id | 物流公司ID | string | 物流公司ID |
unknown_goods_amount | 未知成本销售总额 | string | 未知成本销售总额 |
calc_post_cost | 预估邮费成本 | string | 预估邮费成本 |
post_cost | 邮费成本 | string | 邮费成本 |
calc_weight | 预估重量 | string | 预估重量 |
post_weight | 快递重量 | string | 快递给的重量 |
package_id | 包装id | string | 包装id |
package_cost | 包装成本 | string | 包装成本 |
has_invoice | 是否包含发票 | string | 是否包含发票 |
printer_id | 打单员 | string | 打单员 |
pick_error_count | 拣货出错次数 | string | 拣货出错次数 |
picker_id | 拣货员id | string | 拣货操作员ID |
sorter_id | 分拣员id | string | 包裹分拣员id |
examiner_id | 验货员id | string | 验货操作员id |
consigner_id | 发货人id | string | 发货人id |
packager_id | 打包员id | string | 打包id |
pack_score | 打包积分 | string | 打包积分 |
pick_score | 拣货积分 | string | 拣货积分 |
checkouter_id | 签出员工id | string | 签出员工id |
watcher_id | 监视员id | string | 监视员 |
picklist_no | 分拣单编号 | string | 分拣单编号 |
picklist_seq | 分拣序号 | string | 订单在分拣单中序号 |
invoice_print_status | 发票打印状态 | string | 发票打印状态 |
flag_id | 颜色 | string | 颜色 |
logistics_template_id | 物流单模板id | string | 物流单模板id |
sendbill_template_id | 发货单模板id | string | 发货单模板id |
pos_allocate_mode | 货位分配方式 | string | 货位分配方式:0系统自动分配, 1手动指定货位分配 2手动指定有效期批次货位 3其它出库优化使用出库货位 4按批次出库 |
note_count | 便签条数 | string | 便签条数 |
reason_id | 其他出库原因 | string | 其他出库原因 |
lock_id | 锁定策略id | string | 锁定策略id |
reserve | 保留 | string | 保留 |
batch_no | 打印批次 | string | 打印批次 |
discount | 优惠金额 | string | 优惠金额 |
src_tids | 原始单号 | string | 原始单号,平台订单号 |
tax | 税额 | string | 税额 |
tax_rate | 税率 | string | 税率 |
currency | 币种 | string | 币种 |
id_card | 证件号码 | string | 证件号码 |
stock_check_time | 出库单审核时间 | string | 出库单审核时间 时间格式:yyyy-MM-dd HH:mm:ss |
bad_reason | 异常状态 | string | 需要通过异或的方式判断,异常订单(bit位),1无库存记录 2地址发生变化 4发票变化 8仓库变化16备注变化32平台更换货品64退款…512抢单异常 |
print_batch_no | 打印批次 | string | ERP中的单据的打印批次信息,如需该字段,请升级至2.4.0.8版本及以上 |
sendbill_print_status | 发货单打印状态 | string | 0未打印 1打印中 2已打印 3无需打印 |
logistics_print_status | 物流单打印状态 | string | 0未打印 1打印中 2已打印 3无需打印 |
picklist_print_status | 分拣单打印状态 | string | 0未打印 1打印中 2已打印 3无需打印 |
details_list | 货品列表节点 | array | 货品列表节点 |
details_list.rec_id | 出库明细主键 | string | 出库明细主键 |
details_list.stockout_id | 出库单主键id | string | 出库单主键id |
details_list.spec_no | 商家编码 | string | 代表单品(sku)所有属性的编码,SKU概念介绍,单击这里 |
details_list.goods_count | 货品数量 | string | 货品数量 |
details_list.sell_price | 销售价 | string | 销售价,最终交易价格,扣除优惠 |
details_list.brand_no | 品牌编号 | string | 品牌编号 |
details_list.brand_name | 品牌名称 | string | 品牌名称 |
details_list.goods_type | 货品类型 | string | 货品类型: 1销售商品 2原材料 3包装 4周转材料5虚拟商品6固定资产 0其它 |
details_list.gift_type | 是否是赠品 | string | 是否是赠品 0非赠品 1自动赠送 2手工赠送 |
details_list.goods_name | 货品名称 | string | 货品名称 |
details_list.goods_no | 货品编号 | string | 代表货品(spu)所有属性的编号,SPU概念介绍,单击这里 |
details_list.spec_name | 规格名称 | string | 规格名称 |
details_list.spec_code | 规格码 | string | 规格码 |
details_list.suite_no | 来源组合装编码 | string | 来源组合装编码 |
details_list.cost_price | 成本价 | string | 成本价 |
details_list.total_amount | 总货款 | string | 总货款,sell_price * goods_count=total_amount |
details_list.goods_id | 货品id | string | 货品id |
details_list.spec_id | 商品主键 | string | 商品主键 |
details_list.weight | 估重 | string | 估重 |
details_list.remark | 备注 | string | 备注 |
details_list.paid | 已支付金额 | string | 已支付金额 |
details_list.refund_status | 退款状态 | string | 退款状态 |
details_list.market_price | 零售价 | string | 零售价 |
details_list.discount | 总折扣金额 | string | 总折扣金额 |
details_list.share_amount | 分摊后合计应收 | string | 分摊后合计应收 |
details_list.tax_rate | 税率 | string | 税率 |
details_list.barcode | 条码 | string | 条码 |
details_list.unit_name | 基本单位 | string | 基本单位 |
details_list.sale_order_id | 订单详情表主键 | string | 订单详情表主键 |
details_list.share_post | 邮费分摊 | string | 邮费分摊 |
details_list.src_oid | 原始子订单号 | string | 原始子订单号 |
details_list.src_tid | 原始订单号 | string | 原始订单号 |
details_list.from_mask | 单据内部来源 | string | 1手机订单 2聚划算 4服务子订单 8家装 16二次付款 32开具电子发票 1024库存不足 2048当日达 4096次日达 8192预约时效 |
details_list.src_order_type | 源单据类别 | string | 源单据类别 以主单为准 |
details_list.src_order_detail_id | sales_trade_order表的主键 | string | sales_trade_order表的主键 |
details_list.base_unit_id | 基本单位 | string | 基本单位 |
details_list.unit_id | 辅助单位 | string | 辅助单位 |
details_list.unit_ratio | 单位换算 | string | 单位换算 |
details_list.num | 货品数量 | string | 货品数量 |
details_list.num2 | 辅助数量 | string | 辅助数量 |
details_list.price | 最终价格 | string | 最终价格,share_price删掉,取代share_price |
details_list.batch_id | 指定出库批次 | string | 指定出库批次 |
details_list.is_examined | 是否验货 | string | 是否验货,用于挂起,已标记为验货的不需要再验货 |
details_list.is_package | 是否包装 | string | 是否包装 |
details_list.is_zero_cost | 是否允许0成本 | string | 是否允许0成本 |
details_list.scan_type | 扫描方式 | string | 0未验货,1扫描验货,2手工验货,3快速验货,4无需验货 |
details_list.good_prop1 | 货品档案自定义属性1 | string | 货品档案自定义属性1 |
details_list.good_prop2 | 货品档案自定义属性2 | string | 货品档案自定义属性2 |
details_list.good_prop3 | 货品档案自定义属性3 | string | 货品档案自定义属性3 |
details_list.good_prop4 | 货品档案自定义属性4 | string | 货品档案自定义属性4 |
details_list.good_prop5 | 货品档案自定义属性5 | string | 货品档案自定义属性5 |
details_list.good_prop6 | 货品档案自定义属性6 | string | 货品档案自定义属性6 |
details_list.prop1 | 单品列表自定义属性1 | string | 单品列表自定义属性1 |
details_list.prop2 | 单品列表自定义属性2 | string | 单品列表自定义属性2 |
details_list.prop3 | 单品列表自定义属性3 | string | 单品列表自定义属性3 |
details_list.prop4 | 单品列表自定义属性4 | string | 单品列表自定义属性4 |
details_list.prop5 | 单品列表自定义属性5 | string | 单品列表自定义属性5 |
details_list.prop6 | 单品列表自定义属性6 | string | 单品列表自定义属性6 |
details_list.batch_no | 批次号 | string | 批次号 |
details_list.batch_remark | 批次备注 | string | 批次备注 |
details_list.expire_date | 有效期 | string | 有效期,时间格式:yyyy-MM-dd HH:mm:ss |
details_list.position_list | 货位节点列表 | array | 货位节点列表 |
details_list.position_id | 货位ID | string | 货位ID |
details_list.position_no | 货位编号 | string | 货位编号 |
details_list.stockout_order_detail_id | 出库单明细id | string | 出库单明细id |
details_list.rec_id | 货位主键id | string | 货位主键id |
details_list.stockin_detail_id | 入库单明细id | string | 入库单明细id |
details_list.num | 货品数量 | string | 货品数量 |
details_list.stock_spec_detail_id | 入库单号明细id | string | 入库单号明细id |
details_list.batch_id | 批次id | string | 批次id |
details_list.batch_no | 批次号 | string | 批次号 |
details_list.modified | 最后更新时间 | string | 最后更新时间 |
details_list.cost_price | 成本价 | string | 成本价 |
details_list.position_goods_count | 货位出库数量 | string | 货位出库数量 |
金蝶云星空接口明细
- 接口:batchSave
- 接口名称:销售出库新增
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
---|---|---|---|
FBillTypeID | 单据类型 | string | 单据类型 |
FBillNo | 单据编号 | string | 单据编号 |
FDate | 日期 | string | 日期 |
FStockOrgId | 发货组织 | string | 组织 |
FSaleOrgId | 销售组织 | string | 组织 |
FCustomerID | 客户 | string | 基础资料 |
FSaleDeptID | 销售部门 | string | 基础资料 |
F_wyg_Remarks | 订单编号 | string | 多行文本 |
F_wyg_Remarks1 | 原始单号 | string | 多行文本 |
F_wyg_Amount | 邮费 | string | 多行文本 |
FNote | 备注 | string | 多行文本 |
FOwnerTypeIdHead | 货主类型 | string | 多类别基础资料列表 |
FOwnerIdHead | 货主 | string | 多类别基础资料 |
SubHeadEntity | 财务信息 | object | |
SubHeadEntity.FSettleOrgID | 结算组织 | string | 组织 |
SubHeadEntity.FEntity | 明细信息 | array | |
SubHeadEntity.FEntity.FMaterialID | 物料编码 | string | 基础资料 |
SubHeadEntity.FEntity.FRealQty | 实发数量 | string | 数量 |
SubHeadEntity.FEntity.FPrice | 单价 | string | 单价 |
SubHeadEntity.FEntity.FTaxPrice | 含税单价 | string | 单价 |
SubHeadEntity.FEntity.FEntryTaxRate | 税率% | string | 小数 |
SubHeadEntity.FEntity.FEntryTaxAmount | 税额 | string | 金额 |
SubHeadEntity.FEntity.FAmount | 金额 | string | 金额 |
SubHeadEntity.FEntity.FAllAmount | 价税合计 | string | 金额 |
SubHeadEntity.FEntity.FStockID | 仓库 | string | 基础资料 |
SubHeadEntity.FEntity.FStockStatusID | 库存状态 | string | 基础资料 |
SubHeadEntity.FEntity.FEntrynote | 备注 | string | 文本 |
SubHeadEntity.FEntity.FDiscountRate | 折扣率% | string | 小数 |
SubHeadEntity.FEntity.FIsFree | 是否赠品 | string | 复选框 |
SubHeadEntity.FEntity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如 |
SubHeadEntity.FEntity.Operation | 执行的操作 | string | |
SubHeadEntity.FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
SubHeadEntity.FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
SubHeadEntity.FEntity.SubSystemId | 系统模块 | string | 默认仓库模块 |
系统对接概况
大部分的企业都可能只用一套系统组织架构复杂,业务流程繁琐,内部同时有OA系统、BI系统、ERP系统......且各个系统都需要独立登陆,造成IT部门数据监管困难!如何在同一套中台系统上关联多管理系统呢?系统集成平台,就可以无缝集成各个业务系统,主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合:打破企业内部数据孤岛,无需繁琐的处理工序,与数据集成服务完美结合,让数据真正通起来。 资源互补:汇集各种行业解决方案,资源互补,企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。