旺店通·企业奇门和金蝶云星辰V1单据接口对接

旺店通·企业奇门和金蝶云星辰V1单据接口对接

对接源平台:金蝶云星辰V1

金蝶云·星辰基于金蝶云·苍穹云原生PaaS平台构建，聚焦小型企业在线经营和数字化管理，提供财务云、税务云、进销存云、零售云、订货商城等SaaS服务，支持企业拓客开源、智能管理、实时决策；金蝶云·星辰还提供轻量级PaaS平台和全面的API接口，广泛连接生态伙伴，为小微企业提供一站式服务，助力企业快速成长

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

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

数据对接方案

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

金蝶云星辰V1接口明细

• 接口：jdy/sal/sal_outbound_list
• 接口名称：销售出库单（列表+详情）
• 接口方法：POST

请求参数

字段名称类型描述 deptid部门IDarray部门ID empid职员IDarray职员ID billstatus单据状态（所有：“”，已审核：“C”，未审核：“Z”）string单据状态（所有：“”，已审核：“C”，未审核：“Z”） settlestatus付款状态（所有：“”，全部收款：“C”，部分收款：“B”，未收款：“A”，待收款（=部分收款+未收款）：“M”）string付款状态（所有：“”，全部收款：“C”，部分收款：“B”，未收款：“A”，待收款（=部分收款+未收款）：“M”） deliverystatus配送状态（所有：“”，全部配送：“A”，部分配送：“P”，未配送：“N”，无需配送：“C”,待配送（=部分配送+未配送）：“M”）string配送状态（所有：“”，全部配送：“A”，部分配送：“P”，未配送：“N”，无需配送：“C”,待配送（=部分配送+未配送）：“M”） delivery_type交货方式编码（所有：“”，物流发货：“JHFS01”，车辆配送：“JHFS03”，客户自提：“JHFS04”）string交货方式编码（所有：“”，物流发货：“JHFS01”，车辆配送：“JHFS03”，客户自提：“JHFS04”） currencyid币别array币别 customerid客户array客户 startbilldate开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），单据日期string开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），单据日期 endbilldate结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），单据日期string结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），单据日期 startdate开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期string开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期 enddate结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期string结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期 begindate开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期string开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期 expiredate结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期string结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期 starttime开始时间（格式：“时间戳”，-1表示不过滤），创建时间number开始时间（格式：“时间戳”，-1表示不过滤），创建时间 endtime结束时间（格式：“时间戳”，-1表示不过滤），创建时间number结束时间（格式：“时间戳”，-1表示不过滤），创建时间 begintime开始时间（格式：“时间戳”，-1表示不过滤），修改时间number开始时间（格式：“时间戳”，-1表示不过滤），修改时间 expiretime结束时间（格式：“时间戳”，-1表示不过滤），修改时间number结束时间（格式：“时间戳”，-1表示不过滤），修改时间 creatorid制单人，格式：[制单人id,制单人id]array制单人，格式：[制单人id,制单人id] search模糊搜索，支持客户名称、职员名称、商品名称、单据编码string模糊搜索，支持客户名称、职员名称、商品名称、单据编码 filterzero过滤字段值为0记录：目前仅支持totalunsettleamountstring过滤字段值为0记录：目前仅支持totalunsettleamount payment_flag是否同单收款（全部：-1，1：是，0：否）number是否同单收款（全部：-1，1：是，0：否） page当前页（默认1）number当前页（默认1） pagesize每页显示条数，（默认10，最大值100）number每页显示条数，（默认10，最大值100） selectfields自定义返回字段（除默认字段外），多个字段用英文逗号隔开，支持的字段见下面解析string自定义返回字段（除默认字段外），多个字段用英文逗号隔开，支持的字段见下面解析 totalfields合计值字段，多个字段用英文逗号隔开，支持的字段：total（默认：价税合计）、totalunsettleamount（未收金额）、totalinsamount（收款合计）、totalamount（本次应收账款）string合计值字段，多个字段用英文逗号隔开，支持的字段：total（默认：价税合计）、totalunsettleamount（未收金额）、totalinsamount（收款合计）、totalamount（本次应收账款） orderby排序说明下面解析string排序说明下面解析 top截取单据前top个商品数据返回number截取单据前top个商品数据返回 showmaterialtotal是否统计商品种类和数量到单据，默认falsebool是否统计商品种类和数量到单据，默认false out_side_pks外部标识集合查询array外部标识集合查询 bindSupplier详情是否需要返回外部商品相关信息，需要传true即可string详情是否需要返回外部商品相关信息，需要传true即可 detailAPIdetailAPI-详情APIstring

响应参数

字段名称类型描述 id单据IDstring单据ID number单据编码（id与number二选一）string单据编码（*id与number二选一） bindSupplier详情是否需要返回外部商品相关信息，需要传true即可string详情是否需要返回外部商品相关信息，需要传true即可

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

• 接口：wdt.trade.push
• 接口名称：创建原始订单
• 接口方法：POST

请求参数

字段名称类型描述 shop_no店铺编号string代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置，查看路径ERP→设置→基本设置→店铺→店铺列表），用于创建指定店铺单据信息，测试环境店铺编号信息同接口账号。ERP内shop_no对应的“店铺平台”必须为“自有”。正式环境店铺创建成功后ERP会自动授权，如果自动授权失败，在ERP店铺界面（路径ERP→设置→基本设置→店铺→店铺列表）选中授权失败的店铺，点击店铺界面提供的店铺授权按钮重新授权。 switch模式string0:非严格模式,1:严格模式,默认1。 trade_list订单列表节点array请求参数的1级数据节点，包含销售订单所有属性信息的数据节点，节点下数据字段详见下述“trade_list” trade_list.tid原始单号string指商城、官网等平台的订单编号，ERP称之为原始单号，同一个sid下通过本接口新增订单的tid保证唯一。 trade_list.trade_status平台状态string平台订单状态较多且涉及变更，详情介绍单击这里 trade_list.pay_status支付状态string平台订单付款状态:0:未付款,1:部分付款,2:已付款 trade_list.delivery_term发货条件string1:款到发货,2:货到付款(包含部分货到付款),3:分期付款,4:挂账 trade_list.trade_time下单时间string平台订单创建时间,时间格式：yyyy-MM-dd HH:mm:ss trade_list.pay_time支付时间string平台订单付款时间,时间格式：yyyy-MM-dd HH:mm:ss，未付款订单为:0000-00-00 00:00:00 trade_list.fenxiao_type分销类别string0非分销订单 1转供销 2代销 3经销 trade_list.purchase_id采购单IDstring转供销情况下，采购单ID trade_list.fenxiao_nick分销商idstring分销订单的分销商id,或转供销时供应商id trade_list.buyer_nick客户网名string平台买家昵称，注意：一次推送网名相同的订单不能超过30 trade_list.buyer_email买家emailstring买家email trade_list.pay_id支付单号string支付单号 trade_list.pay_account支付账号string支付账号 trade_list.receiver_name收件人string收件人姓名 trade_list.receiver_province省份string收件人省份，需与旺店通地址库匹配，点击查看，如果不传省市区，则会尝试从详细地址解析省市区，必须是空格分隔的才能解析成功，需要注意直辖市的地址格式，举例“北京 北京市 海淀区 花园路xxxx” trade_list.receiver_city城市string收件人城市，需与旺店通地址库匹配，点击查看 trade_list.receiver_district区县string收件人区县，需与旺店通地址库匹配，点击查看 trade_list.receiver_address地址详情string收件人地址详情 trade_list.receiver_mobile手机string手机号码 trade_list.receiver_telno电话string电话号码 trade_list.receiver_zip邮编string收件人邮编 trade_list.logistics_type物流方式string不传本参数，输入值默认-1，表示由ERP系统策略选择。平台指定订单发货物流可选输入值单击这里 trade_list.invoice_kind发票类别string0:不需要,1:普通发票,2:增值税普通发票电子,3:增值税普通发票纸质,4:增值税专用发票 trade_list.invoice_title发票抬头string发票抬头 trade_list.invoice_content发票内容string常见内容：纳税人识别号、地址、电话、开户银行、银行账户，按照以下格式推送，系统开发票时可解析。 trade_list.remark_flag客户备注标旗string客户备注标旗，取值0至5对应的标旗颜色依次为灰（无标旗）、红、黄、绿、蓝、紫，不传默认0 trade_list.buyer_message买家备注string买家下单时填写的订单备注 trade_list.seller_memo客服备注string商家客服对订单进行的备注内容 trade_list.seller_flag标旗string客服标旗，取值0至5对应的标旗颜色依次为灰（无标旗）、红、黄、绿、蓝、紫，不传默认0 trade_list.post_amount邮费string商家收取买家的物流或者快递费用 trade_list.cod_amount货到付款金额string货到付款金额 trade_list.ext_cod_fee货到付款买家费用string货到付款买家费用，扣除货到付款订单金额后，卖家仍需支付的货到付款其他金额。这个钱卖家收不回来，是快递公司直接收走，但在快递单里是要打印出来，否则快递收款就错了 trade_list.other_amount其它收费string其它应从买家收取的服务费，其他费用 trade_list.paid已付string订单已付金额，paid计算公式：paid = Σ(price * num + adjust_amount -discount – share_discount）+ post_amount+other_amount，所有金额相关字段推送处理办法，单击这里 trade_list.id_card_type证件类型string1:身份证 trade_list.id_card证件号码string证件号码 trade_list.is_auto_wms自动流转模式string是否为自动流转模式（1：是 0：不是 不传默认0），非自动流转模式一定不要传值。自动流转模式处理办法，”自动流转模式处理办法详解”)单击这里 trade_list.wms_type仓库类型string非自动流转模式一定不要传值 trade_list.warehouse_no仓库编号stringERP内自定义的仓库编号，查看路径ERP→设置→基本设置→仓库→仓库列表，测试环境仓库编号查看测试环境分配邮件。平台订单需指定ERP内仓库时，传哪个仓库的编号，ERP将为订单选择哪个仓库。 trade_list.order_list订单货品明细节点array货品明细列表（子订单列表）节点 trade_list.order_list.oid子订单编号string平台订单货品表主键,子订单唯一标识,同一个sid下通过本接口新增订单的oid（子订单编号）要保证唯一；如果oid重复,ERP生成系统单（递交）时会提示“订单货品数量不一致xxxxxx” trade_list.order_list.num数量string货品数量，订单推送成功以后本字段值不能更改 trade_list.order_list.price单价string标价,折扣前的价格,可以推送价格为0的商品。订单推送成功以后本字段值不能更改 trade_list.order_list.status状态string平台子订单状态，子订单状态可以和主订单不一样，比如其中一个子订单退款完成，其状态是80，但主订单仍然是待发货，可选值同trade_status trade_list.order_list.refund_status退款状态string0:无退款,1:取消退款,2:已申请退款,3:等待退货,4:等待收货,5:退款成功。本字段在售前退款的时候，根据不同的场景填写不同的值，eg：申请退款值为2，取消退款值为1…… trade_list.order_list.goods_id平台货品IDstring平台系统货品（SPU）的唯一标识。goods_id不能为空，SPU和SKU概念介绍，单击这里 trade_list.order_list.spec_id平台规格IDstring平台系统单品（SKU）的的唯一标识，尽量不为空，SPU和SKU概念介绍，单击这里 trade_list.order_list.goods_no货品编码string平台货品SPU编码，对应ERP货品编号，尽量不为空 trade_list.order_list.spec_no规格编码string平台货品SKU唯一码，对应ERP商家编码，goods_no和spec_no不能同时为空 trade_list.order_list.goods_name货品名称string平台货品名称 trade_list.order_list.spec_name规格名称string平台货品规格名称 trade_list.order_list.adjust_amount调整string客服调整总金额(大于0加价，小于0减价，是折扣来源的一部分,没有传0) trade_list.order_list.discount优惠string下单总折扣，客户下单时折扣(比如促销打折，不包含客服调整、分摊折扣，没有传0) trade_list.order_list.share_discount分摊优惠string分摊总折扣，由总订单分摊而来，一般是付款时产生，如使用优惠券，没有传0。分摊优惠传值注意：例如三个商品，优惠10，分摊优惠可以是：3/3/4，或者3.33/3.33/3.34.即最后一个商品的分摊优惠使用减法计算 trade_list.order_list.remark备注string货品明细备注推送此字段ERP客户端需升级至V2.3.9.2及以上 trade_list.order_list.cid类目string平台货品所属类目

系统数据集成价值

将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。