旺店通·企业版和金蝶云星辰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接口明细 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接口打通对接实战

关一帆qeasy

旺店通·企业版和金蝶云星辰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接口明细

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