旺店通·企业版和金蝶云星辰V1接口打通对接实战

对接系统旺店通·企业版

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

写入目标:金蝶云星辰V1

金蝶云星辰是金蝶集团公司为小微型工商贸企业定制的一款集财务、进销存、订货商城和税务管理为一体的SAAS云平台，有标准版和专业版两个版本，标准版适用于小型企业(10-50人)业财一体化管理，专业版面向小型(10-100人)企业管理需求。金蝶云星辰聚焦小型企业在线经营和数字化管理，赋能小型企业拓客开源、智能管理和实时决策。

接口方案配置

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

旺店通·企业版接口明细

接口：purchase_return_query
接口名称：查询采购退货单
接口方法：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采购退货单状态：10,已取消,20,编辑中,30,待审核,40,已审核,42,待推送,44,推送失败,46,委外待出库,50,部分出库,60,已完成 warehouse_no仓库编号string代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) page_size分页大小string每页返回的数据条数，输入值范围1_{100，不传本参数，输入值默认为40，使用举例单击这里} page_no页号string不传值默认从0页开始

响应参数

字段名称类型描述 return_no退货单号string退货单号 provider_name供应商string供应商 status采购单状态string采购退货单状态：10,已取消,20,编辑中,30,待审核,40,已审核,42,待推送,44,推送失败,46,委外待出库,50,部分出库,60,已完成 warehouse_no仓库编号string代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置） warehouse_name仓库string系统仓库名称 purchaser_id采购员idstring采购员id purchaser_name采购员名称string采购员名称 logistics_type物流类型string物流方式，详情介绍，单击这里 other_fee其它费用string其它费用 post_fee邮费string邮费 goods_fee总货款string总货款 goods_count退货开单量string退货开单量 goods_type_count货品种类数string货品种类数 goods_out_count退货出库量string退货出库量 api_outer_no外部接口单号string外部接口单号 outer_no外部单号string外部单号 prop1自定义属性1string自定义属性1 prop2自定义属性2string自定义属性2 provider_no供应商编号string供应商编号 purchase_no引用采购单号string引用采购单号 creator_id制单员idstring制单员id creator_name制单员姓名string制单员姓名 type类型string默认为'1'，1退货 flag_id颜色标记string默认为'0'，颜色标记 warehouse_id出库idstring出库id provider_id供应商idstring默认为'0'，供应商id contact联系人姓名string供商商联系人姓名 telno联系电话string供应商联系电话 receive_address退货地址string退货地址 check_operator_id审核人string默认为'0'，审核人 check_time审核时间string默认'0000-00-00 00:00:00'，审核时间 note_count便签条数string默认为'0'，便签条数 province省份string默认为''，省份 city城市string默认为''，城市 district地区string默认为''，地区 wms_outer_no外部仓库的单号string默认为''，对应外部仓库的单号 wms_status处理状态string默认为'0'，处理状态 error_info错误信息string默认为''，接口调用错误信息 version_id版本号string默认为'0'，版本号 last_load_purchase_id最后一次引用的采购单idstring默认为'0'，最后一次引用的采购单id detail_list采购退货单货品列表节点array响应参数的2级数据节点，包含采购退货单货货品明细所有属性信息，节点下数据字段详见下述“detail_list” detail_list.return_id采购退货单idstring默认为'0'，标记 detail_list.remark备注string总成本 detail_list.created创建时间string货品名称 detail_list.modified最后修改时间string品牌名称 detail_list.provider_goods_no供应商货品编号string最后修改时间 detail_list.spec_no商家编码string响应参数的2级数据节点，包含采购入库货品明细属性信息,节点下数据字段详见下述“details_list” detail_list.goods_no货品编码string入库单主键id detail_list.goods_name货品名称string入库明细主键 detail_list.spec_name规格名称string上层单据明细主键 detail_list.spec_code规格码string代表单品(sku)所有属性的编码，SKU概念介绍,单击这里 detail_list.num退货数量string货品数量 detail_list.num2辅助退货量string优惠金额 detail_list.unit_id出库单位string单价 detail_list.unit_ratio单位变换率string生产日期，格式：yyyy-MM-dd HH:mm:ss detail_list.base_unit_id基本单位string有效期天数 detail_list.price单价string有效期，格式：yyyy-MM-dd HH:mm:ss detail_list.discount折扣string原价 detail_list.amount税前金额string税后价 detail_list.unit_name出库单位名称string税后金额 detail_list.base_unit_name基本单位名称string税率 detail_list.tax税率string备注 detail_list.tax_amount税后金额string调整量，正数或者负数 detail_list.rec_id明细idstring纠错金额 detail_list.spec_id规格idstring调整后数量 detail_list.out_num退货出库数量string调整后单价 detail_list.out_amount退货出库金额string调整后总金额 detail_list.tax_price税后单价string品牌编号

金蝶云星辰V1接口明细

API：jdy/sal/sal_inbound_save
NAME：新增或者修改一张销售退货单
METHOD：POST

请求参数

接口字段字段名称预设值描述 billsource单据来源，固定传入 APP单据来源，固定传入 APP id单据ID，修改单据时必填单据ID，修改单据时必填 billdate出库日期,格式：2019-01-01出库日期,格式：2019-01-01 customerid_id客户客户 empid_id业务员业务员 remark单据备注单据备注 contact_linkman联系信息-联系人联系信息-联系人 contact_phone联系信息-联系方式联系信息-联系方式 contact_country_id联系信息-国家ID联系信息-国家ID contact_province_id联系信息-省ID联系信息-省ID contact_city_id联系信息-市ID联系信息-市ID contact_district_id联系信息-区ID联系信息-区ID contact_address联系信息-详细地址联系信息-详细地址 bill_dis_amount整单折扣额整单折扣额 bill_dis_rate整单折扣率%整单折扣率% totalinsamount本次退款本次退款 totalamount本次应退账款本次应退账款 diffamount退款抹零退款抹零 totalunsettleamount本单未退本单未退 payment_entry退款账户退款账户 payment_entry.settleaccountid_id收款账户收款账户 payment_entry.paytypeid_id收款方式收款方式 payment_entry.paid_amount收款金额收款金额 payment_entry.pay_comment备注备注 payment_entry.material_entity商品分录商品分录 payment_entry.material_entity.materialid_id商品商品 payment_entry.material_entity.stockid_id仓库仓库 payment_entry.material_entity.spid_id仓位仓位，启用了仓位管理则必填 payment_entry.material_entity.qty数量数量 payment_entry.material_entity.unit_id单位单位（只能填商品关联的单位，来源于商品单位查询接口或商品详情中的baseunitid_id、fixunit1_id等） payment_entry.material_entity.auxqty辅助数量辅助数量 payment_entry.material_entity.auxunitid_id辅助单位id辅助单位id payment_entry.material_entity.price单价单价 payment_entry.material_entity.taxprice含税单价含税单价（根据设置与price二选一） payment_entry.material_entity.disamount折扣额折扣额 payment_entry.material_entity.disrate折扣率（%）折扣率（%） payment_entry.material_entity.discount折扣（折）折扣（折） payment_entry.material_entity.is_free是否赠品；true-是，false-否（默认）是否赠品；true-是，false-否（默认） payment_entry.material_entity.comment商品行备注商品行备注 payment_entry.material_entity.auxpropid_id辅助属性辅助属性；辅助属性商品必填 payment_entry.material_entity.batchno批次批次；批次商品必填 payment_entry.material_entity.snlistid序列号序列号；序列号商品必填 payment_entry.material_entity.kfdate生产日期；格式：20190101，保质期商品必填生产日期；格式：20190101，保质期商品必填 payment_entry.material_entity.validdate到期日；格式：20190101，保质期商品必填到期日；格式：20190101，保质期商品必填 payment_entry.material_entity.kfperiod保质期保质期；保质期商品必填 payment_entry.material_entity.kftype保质期单位保质期单位；保质期商品必填：1-天，2-月，3-年

系统数据对接

通过数据集成平台可视化的快速配置调用接口打通旺店通·企业版与金蝶云星辰V1之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。

旺店通·企业版和金蝶云星辰V1接口打通对接实战