旺店通·企业版对接打通金蝶云星辰V1查询退货入库单接口与新增或者修改一张销售退货单接口

旺店通·企业版对接打通金蝶云星辰V1查询退货入库单接口与新增或者修改一张销售退货单接口

对接系统：旺店通·企业版

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

目标系统:金蝶云星辰V1

金蝶云·星辰聚焦小微企业在线经营和数字化管理，以“新生产、新零售、新商贸、新财税、新生态”五大特性赋能企业，以财税智能化、门店数字化、供应链流程化、业财税一体化、订货在线化、营销社交化、需求个性化、决策实时化、办公移动化等九大价值赋能企业，助力企业实现数字化、智能化转型升级。

接口方案配置

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：旺店通·企业版的接口参数设置，以及设定好目标平台：金蝶云星辰V1的映射，即可启动方案进行测试

旺店通·企业版接口明细

• 接口：stockin_order_query_refund
• 接口名称：查询退货入库单
• 接口方法：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待审核60待结算80已完成（默认查询80已完成单据） shop_no店铺编号string代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺单据数据信息 page_size分页大小string每页返回的数据条数，输入值范围1_{100，不传本参数，输入值默认为40，使用举例单击这里} page_no页号string不传值默认从0页开始

响应参数

字段名称类型描述 order_no入库单号string入库单号 warehouse_no仓库编号string代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置） warehouse_name仓库名称string仓库名称 shop_no店铺编号string代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺数据信息 shop_remark店铺备注string店铺备注 src_order_no上层单据（退换单）编号string process_status退换单状态string10已取消,20待审核,30已同意,40已拒绝,50待财审,60待收货,63待推送,64推送失败,65委外待收货,69待收货(已结算),70部分到货,71部分到货(已结算),80待结算 ,90已完成。ERP版本V2.3.8.4及以上才可返回 status退货入库单状态string入库单状态 10已取消20编辑中30待审核60待结算80已完成 stockin_time更新时间string更新时间 格式：yyyy-MM-dd HH:mm:ss created_time创建时间string创建时间 格式：yyyy-MM-dd HH:mm:ss trade_no订单编号string系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置） trade_type系统订单类别string系统订单类别（1网店销售,2线下零售,3售后换货,4批发业务,5保修换新,6保修完成,7订单补发 .. 101自定义类型1,102自定义类型2,103自定义类型3,104自定义类型4 ,105自定义类型5,106自定义类型6） order_type单据类别string单据类别，默认返回3 order_type_name单据类别名称string单据类别名称，默认为“退货入库” goods_amount货款总额string退回货款收入 actual_refund_amount实际退款金额string实际退款金额 total_price扣除优惠后货款总额string退回货品成本 post_fee邮费string退货入库单的“邮资” other_fee其他费用string退货入库单的“其它金额” logistics_type物流类型string响应值为代表物流类型的数字，数字对应的物流类型名称单击这里 logistics_no物流编号string代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置） logistics_name物流名称stringERP设置的物流公司名称 logistics_code物流单号string物流单单号 refund_no退换单编号string退换单编号 check_time入库审核时间string customer_no客户编号string客户编号 customer_name客户名称string退货人的姓名 nick_name客户网名string客户网名 shop_name店铺名称string店铺名称 stockin_reason入库原因string入库原因 flag_name退货单标记string退换单界面的标记 platform_id平台idstring平台id stockin_operator_name入库操作人姓名string默认为''，入库操作人姓名 check_operator_name审核人姓名string默认为''，审核人姓名 refund_remark退换备注string默认为''，退换备注 refund_operator_name退货员姓名string默认为''，退货员姓名 stockin_no入库单号string入库单号 wms_outer_no外部仓库单号string默认为''，对应外部仓库的单号 wms_status外部仓库状态string默认为'0'，外部状态,与wms对接使用 0初始化 1失败 2成功' wms_result结果string默认为''，错误信息 warehouse_id仓库idstring默认为'0'，仓库id src_order_id业务单据idstring默认为'0'，业务单据id reason_id原因string原因 fa_status财务同步状态string默认为'0'，财务同步状态 logistics_id物流公司dstring默认为'0'，物流公司id post_share_type邮资分摊类型string默认为'0'，邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊' operator_id操作员idstring操作员id check_operator_id审核员idstring goods_type_count货品种类数string默认为'0'，货品种类数 note_count便签条数string默认为'0'，便签条数 flag_id标记idstring默认为'0'，标记id details_list货品列表节点array退回货品列表节点 details_list.stockin_id入库单主键idstring入库单主键id details_list.remark备注string备注 details_list.goods_count货品数量string货品数量 details_list.discount优惠金额string优惠金额 details_list.tax_amount税后金额string税后金额 details_list.adjust_price纠错金额string纠错金额 details_list.right_price调整后单价string调整后单价 details_list.tid原订单原始单号string原订单原始单号 details_list.src_order_type订单类型string1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库  details_list.adjust_num纠错数量string纠错数量 details_list.modified最后修改时间string最后修改时间 details_list.rec_id明细表主键idstring明细表主键id details_list.src_order_detail_id上层单据（退换单）退回货品明细主键string上层单据（退换单）退回货品明细主键，ERP版本V2.3.8.3及以上才可返回 details_list.spec_no商家编码string代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍,单击这里 details_list.cost_price成本价string成本价 details_list.production_date生产日期string生产日期，格式：yyyy-MM-dd HH:mm:ss details_list.validity_days有效期天数string有效期天数 details_list.expire_date有效期string有效期，格式：yyyy-MM-dd HH:mm:ss details_list.src_price原价string原价 details_list.tax_price税后单价string税后单价 details_list.tax税率string税率 details_list.total_cost总成本string总成本 details_list.right_num调整后数量string调整后数量 details_list.num入库数量string入库数量 details_list.num2辅助数量string辅助数量 details_list.right_cost调整后总金额string调整后总金额 details_list.brand_no品牌编号string品牌编号 details_list.brand_name品牌名称string品牌名称 details_list.goods_name货品名称string货品名称 details_list.prop2单品自定义属性2string单品自定义属性2 details_list.goods_no货品编号string代表货品(spu)所有属性的唯一编号，用于系统货品区分，，SPU概念介绍,单击这里 details_list.spec_name规格名称string规格名称 details_list.spec_code规格编号string规格编号 details_list.goods_unit基本单位string基本单位 details_list.batch_no入库批次string入库批次 details_list.batch_remark批次备注string批次备注 details_list.position_no货位编号string货位编号 details_list.oid原订单原始子单号string原订单原始子单号 details_list.org_stockin_detail_id原始入库单明细string默认为'0'，原始入库单明细 details_list.spec_iderp商品主键stringerp内商品主键 details_list.batch_id批次string默认为'0'，批次 details_list.position_id货位idstring默认为'0'，货位ID，入库时默认ID details_list.unit_id辅助单位string默认为'0'，辅助单位 details_list.base_unit_id基本单位string默认为'0'，基本单位 details_list.unit_ratio单位比率string默认为'1.0000'，单位换算关系 details_list.expect_num期望数量string默认为'0.0000'，预期入库数量（基本单位数量，显示可自动转换成辅助单位） details_list.cost_price2辅助价格string默认为'0.0000'，辅助成本价 details_list.share_post_cost邮资分摊成本string默认为'0.0000'，邮资分摊成本 details_list.share_post_total邮资分摊总成本string默认为'0.0000'，邮资分摊总成本 details_list.created创建时间string创建时间

金蝶云星辰V1接口明细

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

请求参数

字段名称类型描述 billsource单据来源，固定传入 APPstring单据来源，固定传入 APP id单据ID，修改单据时必填string单据ID，修改单据时必填 billdate出库日期,格式：2019-01-01string出库日期,格式：2019-01-01 customerid_id客户string客户 empid_id业务员string业务员 remark单据备注string单据备注 contact_linkman联系信息-联系人string联系信息-联系人 contact_phone联系信息-联系方式string联系信息-联系方式 contact_country_id联系信息-国家IDstring联系信息-国家ID contact_province_id联系信息-省IDstring联系信息-省ID contact_city_id联系信息-市IDstring联系信息-市ID contact_district_id联系信息-区IDstring联系信息-区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辅助单位idstring辅助单位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-年

数据对接价值

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