旺店通·企业版和金蝶云星辰V1接口打通对接实战|轻易云数据集成平台

旺店通·企业版和金蝶云星辰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	采购员id	string	采购员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	自定义属性1	string	自定义属性1
prop2	自定义属性2	string	自定义属性2
provider_no	供应商编号	string	供应商编号
purchase_no	引用采购单号	string	引用采购单号
creator_id	制单员id	string	制单员id
creator_name	制单员姓名	string	制单员姓名
type	类型	string	默认为'1'，1退货
flag_id	颜色标记	string	默认为'0'，颜色标记
warehouse_id	出库id	string	出库id
provider_id	供应商id	string	默认为'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	最后一次引用的采购单id	string	默认为'0'，最后一次引用的采购单id
detail_list	采购退货单货品列表节点	array	响应参数的2级数据节点，包含采购退货单货货品明细所有属性信息，节点下数据字段详见下述“detail_list”
detail_list.return_id	采购退货单id	string	默认为'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	明细id	string	纠错金额
detail_list.spec_id	规格id	string	调整后数量
detail_list.out_num	退货出库数量	string	调整后单价
detail_list.out_amount	退货出库金额	string	调整后总金额
detail_list.tax_price	税后单价	string	品牌编号

金蝶云星辰V1接口明细

接口：jdy/sal/sal_inbound_save
接口名称：新增或者修改一张销售退货单
接口方法：POST

请求参数

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

系统数据对接

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