金蝶云星辰V1与旺店通·企业奇门对接集成查询销售出库单连通新增或修改一张销售出库单(wdt(qm)_kd_旺店通(奇门)_金蝶_销售出库单)

金蝶云星辰V1与旺店通·企业奇门对接集成查询销售出库单连通新增或修改一张销售出库单(wdt(qm)kd旺店通(奇门)金蝶销售出库单)

对接系统：旺店通·企业奇门

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

接入系统：金蝶云星辰V1

金蝶云·星辰聚焦小微企业在线经营和数字化管理，以“新生产、新零售、新商贸、新财税、新生态”五大特性赋能企业，以财税智能化、门店数字化、供应链流程化、业财税一体化、订货在线化、营销社交化、需求个性化、决策实时化、办公移动化等九大价值赋能企业，助力企业实现数字化、智能化转型升级。

数据对接方案

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：旺店通·企业奇门，并且选择对应的连接器（关于旺店通·企业奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询销售出库单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星辰V1，并且选择对应连接器。选择对应的新增或修改一张销售出库单接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

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

• 接口：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状态string5已取消，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仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) is_by_modifiedis_by_modifiedstring page_size分页大小string每页返回的数据条数，输入值范围1_{100，不传本参数，输入值默认为40，使用举例单击这里} page_no页号string不传值默认从0页开始

响应参数

字段名称类型描述 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订单类型string1网店销售 2线下零售 3售后换货 4批发业务 5保修换新 6保修完成 7订单补发 .. 101自定义类型1 102自定义类型2 103自定义类型3 104自定义类型4 105自定义类型5 106自定义类型6 subtype出库子类型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大头笔 logistics_type物流公司类型string响应值为ERP定义的ID数值，数值对应的物流公司类型名称单击这里 logistics_code物流公司编号string代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置） logistics_name物流公司名称string物流公司名称 print_remark打印备注string打印备注 salesman_no业务员编号string业务员编号 salesman_name业务员名称string业务员名称 fullname业务员名称string业务员名称 warehouse_name仓库string仓库 created创建时间string创建时间  时间格式：yyyy-MM-dd HH:mm:ss 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发票IDstring发票ID，目前只设0-1，1表示已开发票 delivery_term发货条件string发货条件 1款到发货 2货到付款(包含部分货到付款) 3分期付款 4挂账单 fenxiao_type分销类别string0 非分销订单 1 转供销 2 代销 3经销 fenxiao_nick分销商IDstring分销订单的分销商id,或转供销时供应商id cod_amount货到付款金额string货到付款金额 id_card_type证件类别string1 身份证 receiver_area收件人地址string省市区空格分隔 shop_remark店铺备注string店铺备注 platform_id平台idstring平台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出库单号 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出库仓库idstring出库的仓库id customer_id客户idstring客户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_strMD5字符串值stringMD5字符串值,用于单据排序 custom_type其他出库自定义子类别string其他出库自定义子类别0，1，2，3，4 receiver_ring京东三环内string京东三环内 to_deliver_time配送时间string配送时间，如周末 pre_charge_time配送中心string配送中心 logistics_id物流公司IDstring物流公司ID unknown_goods_amount未知成本销售总额string未知成本销售总额 calc_post_cost预估邮费成本string预估邮费成本 post_cost邮费成本string邮费成本 calc_weight预估重量string预估重量 post_weight快递重量string快递给的重量 package_id包装idstring包装id package_cost包装成本string包装成本 has_invoice是否包含发票string是否包含发票 printer_id打单员string打单员 pick_error_count拣货出错次数string拣货出错次数 picker_id拣货员idstring拣货操作员ID sorter_id分拣员idstring包裹分拣员id examiner_id验货员idstring验货操作员id consigner_id发货人idstring发货人id packager_id打包员idstring打包id pack_score打包积分string打包积分 pick_score拣货积分string拣货积分 checkouter_id签出员工idstring签出员工id watcher_id监视员idstring监视员 picklist_no分拣单编号string分拣单编号 picklist_seq分拣序号string订单在分拣单中序号 invoice_print_status发票打印状态string发票打印状态 flag_id颜色string颜色 logistics_template_id物流单模板idstring物流单模板id sendbill_template_id发货单模板idstring发货单模板id pos_allocate_mode货位分配方式string货位分配方式：0系统自动分配, 1手动指定货位分配 2手动指定有效期批次货位 3其它出库优化使用出库货位 4按批次出库 note_count便签条数string便签条数 reason_id其他出库原因string其他出库原因 lock_id锁定策略idstring锁定策略id reserve保留string保留 src_tids原始单号string原始单号，平台订单号 tax税额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打印批次stringERP中的单据的打印批次信息，如需该字段，请升级至2.4.0.8版本及以上 sendbill_print_status发货单打印状态string0未打印 1打印中 2已打印 3无需打印 logistics_print_status物流单打印状态string0未打印 1打印中 2已打印 3无需打印 picklist_print_status分拣单打印状态string0未打印 1打印中 2已打印 3无需打印 details_list货品列表节点array货品列表节点 details_list.stockout_id出库单主键idstring出库单主键id details_list.goods_count货品数量string货品数量 details_list.weight估重string估重 details_list.paid已支付金额string已支付金额 details_list.refund_status退款状态string退款状态 details_list.remark备注string备注 details_list.src_order_type源单据类别string源单据类别 以主单为准 details_list.discount总折扣金额string总折扣金额 details_list.tax_rate税率string税率 details_list.spec_no商家编码string代表单品(sku)所有属性的编码，SKU概念介绍,单击这里 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.total_amount总货款string总货款,sell_price * goods_count=total_amount details_list.goods_id货品idstring货品id details_list.spec_id商品主键string商品主键 details_list.market_price零售价string零售价 details_list.share_amount分摊后合计应收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单据内部来源string1手机订单 2聚划算 4服务子订单 8家装 16二次付款 32开具电子发票 1024库存不足 2048当日达 4096次日达 8192预约时效 details_list.src_order_detail_idsales_trade_order表的主键stringsales_trade_order表的主键 details_list.base_unit_id基本单位string基本单位 details_list.unit_id辅助单位string辅助单位 details_list.unit_ratio单位换算string单位换算 details_list.num2辅助数量string辅助数量 details_list.price最终价格string最终价格，share_price删掉，取代share_price details_list.is_examined是否验货string是否验货，用于挂起，已标记为验货的不需要再验货 details_list.is_package是否包装string是否包装 details_list.is_zero_cost是否允许0成本string是否允许0成本 details_list.scan_type扫描方式string0未验货,1扫描验货,2手工验货,3快速验货,4无需验货 details_list.good_prop1货品档案自定义属性1string货品档案自定义属性1 details_list.good_prop2货品档案自定义属性2string货品档案自定义属性2 details_list.good_prop3货品档案自定义属性3string货品档案自定义属性3 details_list.good_prop4货品档案自定义属性4string货品档案自定义属性4 details_list.good_prop5货品档案自定义属性5string货品档案自定义属性5 details_list.good_prop6货品档案自定义属性6string货品档案自定义属性6 details_list.prop1单品列表自定义属性1string单品列表自定义属性1 details_list.prop2单品列表自定义属性2string单品列表自定义属性2 details_list.prop3单品列表自定义属性3string单品列表自定义属性3 details_list.prop4单品列表自定义属性4string单品列表自定义属性4 details_list.prop5单品列表自定义属性5string单品列表自定义属性5 details_list.prop6单品列表自定义属性6string单品列表自定义属性6 details_list.batch_remark批次备注string批次备注 details_list.expire_date有效期string有效期，时间格式：yyyy-MM-dd HH:mm:ss details_list.position_list货位节点列表array货位节点列表 details_list.position_list.modified最后更新时间string最后更新时间 details_list.position_list.batch_no批次号string批次号 details_list.position_list.rec_id货位主键idstring货位主键id details_list.position_list.cost_price成本价string成本价 details_list.position_list.num货品数量string货品数量 details_list.position_list.batch_id批次idstring批次id details_list.position_list.position_id货位IDstring货位ID details_list.position_list.position_no货位编号string货位编号 details_list.position_list.stockout_order_detail_id出库单明细idstring出库单明细id details_list.position_list.stockin_detail_id入库单明细idstring入库单明细id details_list.position_list.stock_spec_detail_id入库单号明细idstring入库单号明细id details_list.position_list.position_goods_count货位出库数量string货位出库数量

金蝶云星辰V1接口明细

• API：jdy/sal/sal_outbound_save
• NAME：新增或修改一张销售出库单
• METHOD：POST

请求参数

接口字段字段名称预设值描述 billsource单据来源，固定传入APPAPP单据来源，固定传入APP billdate出库日期,格式：2019-01-01{{consign_time date}}出库日期,格式：2019-01-01 billno单据编号{{order_no}}单据编号 customerid_id客户信息findCollection find id from a179791c-2fdf-30be-bf55-201f3b85bd6e where name={{shop_name}}客户信息 empid_id业务员信息业务员信息 remark单据备注{{cs_remark}}单据备注 contact_phone联系信息-联系方式联系信息-联系方式 contact_country_id联系信息-国家ID联系信息-国家ID contact_province_id联系信息-省ID联系信息-省ID contact_city_id联系信息-市ID联系信息-市ID contact_district_id联系信息-区ID联系信息-区ID material_entity商品分录details_list material_entity.materialid_id商品_findCollection find id from 3d4d739d-5826-3090-a582-d17a10a43790 where number={{details_list.spec_no}}商品 material_entity.stockid_id仓库findCollection find id from 35c82f7f-bdef-3bc1-86e6-4654e14ff702 where name={{warehouse_name}}仓库 material_entity.spid_id仓位仓位，启用了仓位管理则必填 material_entity.qty数量{{details_list.goods_count}}数量 material_entity.unit_id单位2单位（只能填商品关联的单位，来源于商品单位查询接口或商品详情中的baseunitid_id、fixunit1_id等） material_entity.price单价_function ({{details_list.total_amount}}+{{details_list.share_post}})/{{details_list.goods_count}}单价（如果在“系统参数”的“基础资料参数”中勾选了“商品价格为含税单价”，则price指示含税单价） material_entity.cess税率{{details_list.tax_rate}}税率(例：13%的税率填13) material_entity.disamount折扣额折扣额 material_entity.disrate折扣率（%）折扣率（%） material_entity.discount折扣（折）折扣（折） material_entity.is_free是否赠品function CASE WHEN {{details_list.sell_price}}>0 THEN 'false' ELSE 'true' END是否赠品；true-是，false-否（默认） material_entity.comment商品行备注商品行备注 material_entity.auxpropid_id辅助属性辅助属性；辅助属性商品必填(从商品详情中auxentity的id字段取值) material_entity.batchno批次{{batch_no}}批次；批次商品必填 material_entity.snlistid序列号流转id序列号流转id；单据新增后会在单据详情中带回这个字段信息，序列号商品修改时必填 material_entity.sn_list序列号序列号格式如:001:备注1;002:备注2（序列号:序列号备注多个序列号以英文分号字符;分隔）,*序列号商品必填 material_entity.kfdate生产日期生产日期；格式：20190101，保质期商品必填 material_entity.validdate到期日到期日；格式：20190101，保质期商品必填 material_entity.kfperiod保质期保质期；保质期商品必填 material_entity.kftype保质期单位保质期单位；保质期商品必填：1-天，2-月，3-年 material_entity.srcbillno源单编号 material_entity.custom_field128l7dyhux0m0pxie销售订单号{{trade_no}} material_entity.custom_field12b977if3xvje订单类型{{trade_type}} material_entity.custom_field12b98xfm4mz2o发货条件_function case '{{delivery_term}}' when '1' then '款到发货' when '2' then '货到付款(包含部分货到付款)' when '3' then '分期付款' when '4' then '挂账单' end material_entity.deptid_id销售部门_findCollection find id from 05b3a603-808e-37a6-a7da-fb949aaca1e2 where name={{shop_name}} material_entity.custom_field12gbdyhnz5o37s4原始单号{{src_trade_no}}

系统对接概况

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