金蝶云星辰V1、旺店通·企业版通过接口配置数据对接
对接系统：旺店通·企业版
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
对接目标平台:金蝶云星辰V1
金蝶云·星辰基于金蝶云·苍穹云原生PaaS平台构建，聚焦小型企业在线经营和数字化管理，提供财务云、税务云、进销存云、零售云、订货商城等SaaS服务，支持企业拓客开源、智能管理、实时决策；金蝶云·星辰还提供轻量级PaaS平台和全面的API接口，广泛连接生态伙伴，为小微企业提供一站式服务，助力企业快速成长
系统对接接口配置
使用系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：旺店通·企业版，然后选择对应的连接器。选择对应的查询采购退货单作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星辰V1,并且选择对应连接器（关于金蝶云星辰V1的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的新增或者修改一张销售退货单接口作为数据写入动作，既可以完成第一步的数据对接配置。
旺店通·企业版接口明细
- 接口：purchase_return_query
- 接口名称：查询采购退货单
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| page_no | 页号 | string |
| end_time | 结束时间 | datetime |
| start_time | 开始时间 | datetime |
| page_size | 分页大小 | string |
| warehouse_no | 仓库编号 | string |
| status | 状态 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| 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
请求参数
| 字段 | 名称 | 类型 |
|---|
| payment_entry.material_entity.comment | 商品行备注 | string |
| payment_entry.material_entity.stockid_id | 仓库 | string |
| payment_entry.material_entity.unit_id | 单位 | string |
| payment_entry.material_entity.price | 单价 | string |
| billdate | 出库日期,格式：2019-01-01 | string |
| contact_province_id | 联系信息-省ID | string |
| payment_entry.material_entity.auxqty | 辅助数量 | string |
| payment_entry.paid_amount | 收款金额 | string |
| payment_entry.paytypeid_id | 收款方式 | string |
| payment_entry.pay_comment | 备注 | string |
| customerid_id | 客户 | string |
| payment_entry.material_entity.qty | 数量 | string |
| id | 单据ID，修改单据时必填 | string |
| contact_phone | 联系信息-联系方式 | string |
| contact_linkman | 联系信息-联系人 | string |
| payment_entry.material_entity.disamount | 折扣额 | string |
| billsource | 单据来源，固定传入 APP | string |
| payment_entry.material_entity.snlistid | 序列号 | string |
| contact_city_id | 联系信息-市ID | string |
| payment_entry.material_entity.materialid_id | 商品 | string |
| payment_entry.material_entity.kfperiod | 保质期 | string |
| payment_entry.material_entity.discount | 折扣（折） | string |
| payment_entry.material_entity.validdate | 到期日；格式：20190101，保质期商品必填 | string |
| remark | 单据备注 | string |
| bill_dis_rate | 整单折扣率% | string |
| payment_entry.material_entity.disrate | 折扣率（%） | string |
| totalunsettleamount | 本单未退 | string |
| totalamount | 本次应退账款 | string |
| payment_entry.material_entity.auxpropid_id | 辅助属性 | string |
| payment_entry.material_entity.spid_id | 仓位 | string |
| payment_entry.material_entity.batchno | 批次 | string |
| payment_entry.settleaccountid_id | 收款账户 | string |
| payment_entry.material_entity.kfdate | 生产日期；格式：20190101，保质期商品必填 | string |
| payment_entry.material_entity.taxprice | 含税单价 | string |
| contact_address | 联系信息-详细地址 | string |
| bill_dis_amount | 整单折扣额 | string |
| diffamount | 退款抹零 | string |
| contact_country_id | 联系信息-国家ID | string |
| payment_entry.material_entity | 商品分录 | array |
| totalinsamount | 本次退款 | string |
| payment_entry | 退款账户 | array |
| contact_district_id | 联系信息-区ID | string |
| payment_entry.material_entity.auxunitid_id | 辅助单位id | string |
| payment_entry.material_entity.is_free | 是否赠品；true-是，false-否（默认） | string |
| empid_id | 业务员 | string |
| payment_entry.material_entity.kftype | 保质期单位 | string |
系统数据对接
通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。
