旺店通·企业奇门与金蝶云星空对接集成查询退货入库单打通[旺店通][销售退货单标准新增]-v1

旺店通·企业奇门与金蝶云星空对接集成查询退货入库单打通[旺店通][销售退货单标准新增]-v1

源系统:旺店通·企业奇门

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

对接目标平台:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

数据接口配置

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

旺店通·企业奇门接口明细

• API：wdt.stockin.order.query.refund
• NAME：查询退货入库单
• METHOD：POST

请求参数

接口字段字段名称预设值描述 start_time开始时间{{LAST_SYNC_TIME datetime}}增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss end_time结束时间{{CURRENT_TIME datetime}}增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss status状态80入库单状态 10已取消20编辑中30待审核60待结算80已完成（默认查询80已完成单据） shop_no店铺编号代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺单据数据信息 stockin_no入库单号RK2212310046,RK2212310047,RK2212310048,RK2212310049,RK2212310050,RK2212310051,RK2212310052,RK2212310054,RK2212310055,RK2212310056,RK2212310059,RK2212310060,RK2212310063,RK2212310064,RK2212310065,RK2212310066,RK2212310067,RK2212310068,RK2212310069,RK2212310071,RK2212310072,RK2212310073,RK2212310074,RK2212310075,RK2212310076,RK2212310077,RK2212310078,RK2212310080,RK2212310081,RK2212310082,RK2212310083,RK2212310084,RK2212310085,RK2212310086,RK2212310087,RK2212310088,RK2212310089,RK2212310090,RK2212310091,RK2212310092,RK2212310093,RK2212310094,RK2212310095,RK2212310096,RK2212310097,RK2212310099,RK2212310101,RK2212310102,RK2212310103,RK2212310104,RK2212310105,RK2212310106,RK2212310107,RK2212310108,RK2212310109,RK2212310110,RK2212310111,RK2212310112,RK2212310113,RK2212310114,RK2212310115,RK2212310116,RK2212310117,RK2212310118,RK2212310119,RK2212310120,RK2212310121,RK2212310122,RK2212310123,RK2212310124,RK2212310125,RK2212310126,RK2212310127,RK2212310128,RK2212310129,RK2212310130,RK2212310131,RK2212310132,RK2212310133,RK2212310134,RK2212310136,RK2212310137,RK2212310138,RK2212310140,RK2212310141,RK2212310142,RK2212310143,RK2212310144,RK2212310145,RK2212310146,RK2212310147,RK2212310148,RK2212310149,RK2212310150,RK2212310151,RK2212310152,RK2212310153,RK2212310154,RK2212310157,RK2212310158,RK2212310159,RK2212310161,RK2212310162,RK2212310164,RK2212310165,RK2212310166,RK2212310167,RK2212310168,RK2212310169,RK2212310170,RK2212310171,RK2212310172,RK2212310173,RK2212310174,RK2212310175,RK2212310176,RK2212310177,RK2212310178,RK2212310179,RK2212310180,RK2212310181,RK2212310182,RK2212310183,RK2212310184,RK2212310185,RK2212310186,RK2212310187,RK2212310188,RK2212310189,RK2212310190,RK2212310191,RK2212310192,RK2212310193,RK2212310194,RK2212310195,RK2212310196,RK2212310198,RK2212310199,RK2212310201,RK2212310202,RK2212310203,RK2212310204,RK2212310205,RK2212310206,RK2212310207,RK2212310208,RK2212310209,RK2212310210,RK2212310211,RK2212310212,RK2212310213,RK2212310214,RK2212310215,RK2212310216,RK2212310217,RK2212310218,RK2212310219,RK2212310221,RK2212310222,RK2212310223,RK2212310224,RK2212310225,RK2212310226,RK2212310227,RK2212310228,RK2212310229,RK2212310230,RK2212310231,RK2212310232,RK2212310233,RK2212310235,RK2212310236,RK2212310237,RK2212310238,RK2212310239,RK2212310240,RK2212310241,RK2212310242,RK2212310243,RK2212310244,RK2212310245,RK2212310246,RK2212310247,RK2212310248,RK2212310249,RK2212310250,RK2212310251,RK2212310253,RK2212310256,RK2212310257,RK2212310258,RK2212310259,RK2212310260,RK2212310261,RK2212310262,RK2212310264,RK2212310266,RK2212310267,RK2212310268,RK2212310269,RK2212310270,RK2212310271,RK2212310272,RK2212310273,RK2212310274,RK2212310275,RK2212310276,RK2212310277,RK2212310278,RK2212310280,RK2212310281,RK2212310282,RK2212310283,RK2212310284,RK2212310285,RK2212310286,RK2212310287,RK2212310288,RK2212310289,RK2212310290,RK2212310291,RK2212310292,RK2212310293,RK2212310294,RK2212310295,RK2212310297,RK2212310298,RK2212310299,RK2212310300,RK2212310302,RK2212310303,RK2212310306,RK2212310307,RK2212310308,RK2212310309,RK2212310310,RK2212310311,RK2212310312,RK2212310313,RK2212310315,RK2212310316,RK2212310317,RK2212310319,RK2212310320,RK2212310321,RK2212310322,RK2212310323,RK2212310324,RK2212310325,RK2212310326,RK2212310327,RK2212310328,RK2212310329,RK2212310330,RK2212310332,RK2212310333,RK2212310334,RK2212310335,RK2212310336,RK2212310337,RK2212310338,RK2212310339,RK2212310340,RK2212310341,RK2212310343,RK2212310344,RK2212310345,RK2212310346,RK2212310347,RK2212310348,RK2212310349,RK2212310350,RK2212310351,RK2212310352,RK2212310353,RK2212310354,RK2212310355,RK2212310356,RK2212310357,RK2212310358,RK2212310359,RK2212310360,RK2212310361,RK2212310362,RK2212310363,RK2212310364,RK2212310365,RK2212310366,RK2212310367,RK2212310368,RK2212310369,RK2212310370,RK2212310371,RK2212310372,RK2212310373,RK2212310374,RK2212310375,RK2212310376,RK2212310377,RK2212310378,RK2212310380,RK2212310381,RK2212310382,RK2212310384,RK2212310385,RK2212310386,RK2212310388 page_no页号1 page_size分页大小{{PAGINATION_PAGE_SIZE}}每页返回的数据条数，输入值范围1_{50，不传本参数，输入值默认为40，使用举例单击这里} page_no页号{{PAGINATION_START_PAGE}}不传值默认从0页开始

响应参数

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

金蝶云星空接口明细

• API：batchSave
• NAME：[旺店通][销售退货单标准新增]-v1
• METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillTypeID单据类型 XSTHD01_SYS单据类型 FBillNo单据编号 {{stockin_no}}单据编号 FSaleOrgId销售组织 {{shop_no}}组织 FDate日期 {{check_time}}日期 FStockOrgId库存组织 100组织 FRetcustId退货客户 {{shop_no}}基础资料 FHeadNote备注多行文本 F_SWPA_Combo_LYXT来源系统2多行文本 F_SWPA_Assistant_dp店铺{{shop_no}}多行文本 FEntity明细信息details_list FEntity.FMaterialId物料编码 {{details_list.spec_no}}基础资料 FEntity.FRealQty实退数量 {{details_list.right_num}}数量 FEntity.FTaxPrice含税单价{{details_list.src_price}}单价 FEntity.FStockId仓库 {{warehouse_no}}基础资料 FEntity.FNote备注{{remark}}文本 FEntity.F_SWPA_PTDH平台单号{{details_list.tid}}文本 FEntity.SubHeadEntity财务信息 FEntity.SubHeadEntity.FChageCondition收款条件999组织 FEntity.SubHeadEntity.FormId业务对象表单IdSAL_RETURNSTOCK必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.SubHeadEntity.Operation执行的操作Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit提交并审核false FEntity.SubHeadEntity.IsVerifyBaseDataField验证基础资料true是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.SubHeadEntity.SubSystemId系统模块21

系统对接总览

基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接旺店通·企业奇门接口抽取数据后再自动分发到金蝶云星空， 解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。