旺店通·企业奇门和金蝶云星空接口打通对接实战

82 阅读17分钟

旺店通·企业奇门和金蝶云星空接口打通对接实战

打通系统数据

接入系统:旺店通·企业奇门

旺店通是北京掌上先机网络科技有限公司旗下品牌,国内的零售云服务提供商,基于云计算SaaS服务模式,以体系化解决方案,助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案,致力于帮助企业实现数字化转型,企业规模化发展

目标系统:金蝶云星空

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

数据接口配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下,这两个系统都是分别独立部署和运行的,各自拥有不同的技术栈和编程模型,甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则,例如取数就要根据查询接口获取旺店通·企业奇门的数据,并且根据对应的条件进行取数,目标系统就必须根据目标系统的格式,以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。 T+系统对接电商

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

  • API:wdt.stockout.order.query.trade
  • NAME:查询退货入库单
  • METHOD:POST

请求参数

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

响应参数

接口字段字段名称预设值描述
stockout_id出库单主键id出库单主键id
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_count数量货品数量
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大头笔大头笔
weight实际重量ERP系统称重功能记录的重量,如果没有使用称重功能默认使用货品档案维护的预估重量
logistics_type物流公司类型响应值为ERP定义的ID数值,数值对应的物流公司类型名称单击这里
logistics_code物流公司编号代表物流所有属性的唯一编码,用于物流区分,ERP内支持自定义(ERP物流界面设置)
logistics_name物流公司名称物流公司名称
print_remark打印备注打印备注
paid已付金额已付金额
refund_status退款状态退款状态: 0无退款,1取消退款,2已申请退款,3等待退货,4等待收货,5退款成功
salesman_no业务员编号业务员编号
salesman_name业务员名称业务员名称
fullname业务员名称业务员名称
warehouse_name仓库仓库
created创建时间创建时间  时间格式:yyyy-MM-dd HH:mm:ss
remark备注备注
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店铺备注店铺备注
modified最后修改时间最后修改时间   时间格式:yyyy-MM-dd HH:mm:ss
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出库单号出库单号
src_order_type源单据类别源单据类别,1 销售订单
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_strMD5字符串值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保留保留
batch_no打印批次打印批次
discount优惠金额优惠金额
src_tids原始单号原始单号,平台订单号
tax税额税额
tax_rate税率税率
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.rec_id出库明细主键出库明细主键
details_list.stockout_id出库单主键id出库单主键id
details_list.spec_no商家编码代表单品(sku)所有属性的编码,SKU概念介绍,单击这里
details_list.goods_count货品数量货品数量
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.cost_price成本价成本价
details_list.total_amount总货款总货款,sell_price * goods_count=total_amount
details_list.goods_id货品id货品id
details_list.spec_id商品主键商品主键
details_list.weight估重估重
details_list.remark备注备注
details_list.paid已支付金额已支付金额
details_list.refund_status退款状态退款状态
details_list.market_price零售价零售价
details_list.discount总折扣金额总折扣金额
details_list.share_amount分摊后合计应收分摊后合计应收
details_list.tax_rate税率税率
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_type源单据类别源单据类别 以主单为准
details_list.src_order_detail_idsales_trade_order表的主键sales_trade_order表的主键
details_list.base_unit_id基本单位基本单位
details_list.unit_id辅助单位辅助单位
details_list.unit_ratio单位换算单位换算
details_list.num货品数量货品数量
details_list.num2辅助数量辅助数量
details_list.price最终价格最终价格,share_price删掉,取代share_price
details_list.batch_id指定出库批次指定出库批次
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_no批次号批次号
details_list.batch_remark批次备注批次备注
details_list.expire_date有效期有效期,时间格式:yyyy-MM-dd HH:mm:ss
details_list.position_list货位节点列表货位节点列表
details_list.position_id货位ID货位ID
details_list.position_no货位编号货位编号
details_list.stockout_order_detail_id出库单明细id出库单明细id
details_list.rec_id货位主键id货位主键id
details_list.stockin_detail_id入库单明细id入库单明细id
details_list.num货品数量货品数量
details_list.stock_spec_detail_id入库单号明细id入库单号明细id
details_list.batch_id批次id批次id
details_list.batch_no批次号批次号
details_list.modified最后更新时间最后更新时间
details_list.cost_price成本价成本价
details_list.position_goods_count货位出库数量货位出库数量

金蝶云星空接口明细

  • API:batchSave
  • NAME:销售退货新增
  • METHOD:POST

请求参数

接口字段字段名称预设值描述
FBillTypeID单据类型XSCKD01_SYS单据类型
FBillNo单据编号{{order_no}}单据编号
FDate日期{{consign_time}}日期
FStockOrgId发货组织100组织
FSaleOrgId销售组织100组织
FCustomerID客户{{shop_no}}基础资料
FCarriageNO运输单号{{logistics_no}}文本
FLinkPhone联系电话{{receiver_mobile}}文本
FLinkMan收货人姓名{{receiver_name}}文本
FNote备注{{cs_remark}}原始订单号:{{src_trade_no}}多行文本
F_ZZZZ_DDBH订单编号{{src_order_no}}多行文本
F_ZZZZ_YSDH原始单号{{src_tids}}多行文本
F_ZZZZ_DDDLX订单类型{{trade_type}}多行文本
F_ZZZZ_WLDH物流单号{{logistics_no}}多行文本
F_ZZZZ_WLGS物流公司{{logistics_name}}多行文本
F_zzzz_SJZL实际重量{{weight}}多行文本
SubHeadEntity财务信息
SubHeadEntity.FSettleOrgID结算组织100组织
SubHeadEntity.FBuyerNick会员名称{{receiver_name}}文本
SubHeadEntity.FReceiverAddress收货人地址{{receiver_address}}文本
SubHeadEntity.FReceiverName收货人{{receiver_name}}文本
SubHeadEntity.FReceiverMobile收货人手机{{receiver_mobile}}文本
SubHeadEntity.FReceiverCountry收货人国家文本
SubHeadEntity.FReceiverState收货人省份文本
SubHeadEntity.FReceiverCity收货人城市文本
SubHeadEntity.FReceiverDistrict收货人地区文本
SubHeadEntity.FReceiverPhone收货人电话文本
SubHeadEntity.FVIPCODE会员编码{{customer_no}}文本
SubHeadEntity.FEntity明细信息details_list
SubHeadEntity.FEntity.FMaterialID物料编码{{details_list.goods_no}}基础资料
SubHeadEntity.FEntity.FRealQty实发数量{{details_list.goods_count}}数量
SubHeadEntity.FEntity.FTaxPrice含税单价{{details_list.price}}单价
SubHeadEntity.FEntity.FAllAmount价税合计金额
SubHeadEntity.FEntity.FStockID仓库007基础资料
SubHeadEntity.FEntity.FEntrynote备注{{details_list.remark}}文本
SubHeadEntity.FEntity.FSELLERNOTE卖家备注{{cs_remark}}文本
SubHeadEntity.FEntity.F_ZZZZ_GZ估重{{details_list.weight}}文本
SubHeadEntity.FEntity.F_ZZZZ_ZHZBM组合装编码{{sdetails_list.uite_no}}文本
SubHeadEntity.FEntity.FormId业务对象表单IdSAL_OUTSTOCK必须填写金蝶的表单ID如:PUR_PurchaseOrder
SubHeadEntity.FEntity.Operation执行的操作Save
SubHeadEntity.FEntity.IsAutoSubmitAndAudit提交并审核false
SubHeadEntity.FEntity.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性,布尔类,默认false(非必录)
SubHeadEntity.FEntity.SubSystemId系统模块21默认仓库模块

数据对接价值

大部分的企业都可能只用一套系统组织架构复杂,业务流程繁琐,内部同时有OA系统、BI系统、ERP系统......且各个系统都需要独立登陆,造成IT部门数据监管困难!如何在同一套中台系统上关联多管理系统呢?系统集成平台,就可以无缝集成各个业务系统,主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合:打破企业内部数据孤岛,无需繁琐的处理工序,与数据集成服务完美结合,让数据真正通起来。 资源互补:汇集各种行业解决方案,资源互补,企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。 系统接口对接