旺店通·企业奇门与用友BIP退换货生成销售退货(线下)-v

系统接口数据集成
源数据平台 旺店通·企业奇门数据对接
调用请求API 查询退换管理
请求定时 1-59/10 * * * *
将企业的所有应用及数据链接起来
目标平台 用友BIP写入数据接口
调用执行API 销售退货单个保存
执行定时 5-59/10 * * * *

接口数据对接字段明细

序号 旺店通·企业奇门字段 旺店通·企业奇门字段名 用友BIP字段 用友BIP字段名 描述
1 refund_no erp退换单号 resubmitCheckKey 保证请求的幂等性 保证请求的幂等性,该值由客户端生成,并且必须是全局唯一的，长度不能超过32位。更多信息,请参见«MDD幂等性»
2 refund_no erp退换单号 code 单据编码 单据编码，以系统编码规则配置为准：系统设置为手工编号时必输，系统设置为自动编号时非必输；修改时必传    示例："S0T5-0000000000-20210831-000000"
3 _findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no=shop_no 关联查询函数 salesOrgId 销售组织 销售组织，传id或者code    示例：2163951720681984
4 1480261131563434158 固定值 transactionTypeId 交易类型 交易类型，传id或者code    示例：2155547426656517
5 _findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no=shop_no 关联查询函数 agentId 客户 客户，传id或者code    示例：2251598175195392
6 固定值 retailInvestors 是否散户 是否散户, true:是、false:否、    示例：false
7 remark 退款说明 headFreeItem!define2 销售类型
8 固定值 saleDepartmentId 销售部门 销售部门，传id或者code    示例："2163953113665792"
9 modified 最后修改时间 vouchdate 单据日期  单据日期    示例："2021-08-31 00:00:00"
10 固定值 corpContact 销售业务员   销售业务员    示例："2163960865427712"
11 _findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no=shop_no 关联查询函数 settlementOrgId 开票组织 开票组织，传id或者code    示例："2163951720681984"
12 CNY 固定值 currency 币种 币种，传id或者code    示例："2155547424560384"
13 01 固定值 exchangeRateType 汇率类型 汇率类型，传id或者code    示例："csrka3z7"
14 CNY 固定值 natCurrency 本币 本币，传id或者code 示例："2155547424560384"
15 _findCollection find shop_name from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no=shop_no 关联查询函数 retailAgentName 散户名称  散户名称    示例："散户2"
16 固定值 saleReturnMemo 备注 备注
17 固定值 saleReturnMemo.remark 备注 备注    示例："销售退货"
18 NONE 固定值 refundStatus 退货单退款状态 退货单退款状态，由系统业务自动生成，接口无需传值。    示例："NONE"
19 固定值 refundAmount 退款金额  退款金额    示例：1
20 false 固定值 isWfControlled 是否受审批流控制  是否受审批流控制    示例：false
21 1 固定值 exchRate 汇率   汇率    示例：1
22 true 固定值 taxInclusive 单价含税 单价含税, true:是、false:否、    示例：true
23 NONE 固定值 saleReturnSourceType 退货类型 退货类型, NONE:无来源、DELIVERYEND:销售出库单、ORDER:销售订单    示例："DELIVERYEND"
24 销售退货 固定值 bizFlow_name 流程名称 流程名称    示例："001"
25 V1.0 固定值 bizFlow_version 版本信息  版本信息    示例："版本1"
26 固定值 logisticWayId 物流公司id  物流公司id    示例：321321
27 _findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no=shop_no 关联查询函数 invoiceAgentId 开票客户 开票客户，传id或者code    示例：2216247878177024
28 固定值 realMoney 应付金额 应付金额，等于表头的退货金额    示例：100
29 固定值 modifyInvoiceType 发票类型是否可改 发票类型是否可改, true:是、false:否、    示例：true
30 固定值 logisticsBillNo 物流单号 物流单号    示例："4321"
31 固定值 logisticsUserName 司机姓名  司机姓名    示例："王一"
32 固定值 logisticsUserPhone 司机电话  司机电话    示例："18888888888"
33 固定值 logisticsCarNum 车牌号  车牌号    示例："京A-ax245"
34 固定值 receiver 收货人  收货人    示例："王二"
35 固定值 receiveMobile 收货人移动电话   收货人移动电话    示例："010-12345678"
36 固定值 receiveTelePhone 收货人固定电话  收货人固定电话    示例："1555555555"
37 固定值 receiveAddress 收货地址  收货地址    示例："北京市海淀区"
38 固定值 receiveZipCode 收货人邮编  收货人邮编    示例："011"
39 0 固定值 bdInvoiceTypeId 发票类型 0:收据,1:增值税电子普通发票,2:增值税电子专用发票,3:增值税普通发票,4:增值税专用发票,5:机动车销售统一发票,8:增值税电子普通发票（成品油）,10:增值税普通发票（成品油）,11:增值税专用发票（成品油）,e0:电子收购发票 示例：0
40 固定值 invoiceUpcType 发票类型 发票类型, 0:收据、1:增值税专用发票、2:增值税普通发票、3:增值税电子普通发票、4:机动车销售销售统一发票、    示例：0
41 0 固定值 invoiceTitleType 抬头类型 抬头类型, 0:企业、1:个人、2:非营利组织、    示例：0
42 1 固定值 invoiceTitle 发票抬头  发票抬头    示例："中央大客户工信部"
43 1 固定值 taxNum 纳税识别号  纳税识别号    示例："SH999000999"
44 银行 固定值 bankName 开户银行  开户银行    示例："中国工商银行"
45 银行支行 固定值 subBankName 开户支行   开户支行    示例："中国工商银行股份有限公司天津中北支行"
46 1 固定值 bankAccount 账号  账号    示例："888888888888888"
47 1 固定值 invoiceTelephone 营业电话   营业电话    示例："012-9998893"
48 地址 固定值 invoiceAddress 营业地址  营业地址    示例："北京市海淀区"
49 固定值 totalMoney 总金额  总金额    示例：43214
50 actual_refund_amount 实际退款/收款金额 payMoney 退货金额 退货金额，需等于表体含税金额的合计    示例：312
51 固定值 totalMoneyOrigTaxfree 无税总金额   无税总金额    示例：321
52 固定值 payMoneyOrigTaxfree 无税退货金额  无税退货金额    示例：321
53 固定值 totalOriTax 税额   税额    示例：3
54 固定值 totalMoneyDomestic 本币总金额  本币总金额    示例：643256
55 固定值 payMoneyDomestic 本币退货金额   本币退货金额    示例：5432
56 固定值 totalMoneyDomesticTaxfree 本币无税总金额   本币无税总金额    示例：5432
57 固定值 payMoneyDomesticTaxfree 本币无税退货金额  本币无税退货金额    示例：5432
58 固定值 totalNatTax 本币税额  本币税额    示例：5421
59 e88e9d81-f134-11ec-9896-6c92bf477043 固定值 bizFlow 流程ID   流程ID    示例：213
60 固定值 isFlowCoreBill 是否流程核心单据  是否流程核心单据    示例：true
61 tid 订单的原始单号 headFreeItem!define5 原始单号 原始单号
62 Insert 固定值 _status 操作标识 操作标识, Insert:新增、Update:更新    示例："Insert"
63 refund_order_list 退款子订单信息 saleReturnDetails 退货单详情 退货单详情[voucher.salereturn.SaleReturnDetail]
64 固定值 saleReturnDetails.id 表体行ID 表体行ID 新增时无需填写，修改时必填    示例：4312432
65 固定值 saleReturnDetails.orderDetailId 订单行id 订单行id，有来源必填    示例：2403153858154753
66 固定值 saleReturnDetails.orderDetailIdKey 订单行idkey  订单行idkey    示例："6425432"
67 固定值 saleReturnDetails.sourceid 来源单据ID 来源单据ID，有来源必填    示例：2403160486547968
68 固定值 saleReturnDetails.sourceautoid 来源单据子表ID 来源单据子表ID，有来源必填    示例：2403160486547970
69 固定值 saleReturnDetails.source 来源单据类型 来源单据类型（1.ustock.st_salesout销售出库 2.voucher_order 销售订单）有来源必填    示例："ustock.st_salesout"
70 固定值 saleReturnDetails.makeRuleCode 生单类型编码 生单类型编码（1.salesoutTosalereturn 由销售出库生单，2.order_salereturn:由销售订单生单），有来源必填    示例："salesoutTosalereturn"
71 refund_order_list.refund_order_list_spec_no 固定值 saleReturnDetails.productId 商品 商品，传id或者code    示例：2320711092457728
72 refund_order_list.refund_order_list_spec_no 固定值 saleReturnDetails.skuId 商品sku 商品sku，传id或者code    示例：2313763385315584
73 固定值 saleReturnDetails.projectId 项目 项目，传id或者code    示例："123124312"
74 0 固定值 saleReturnDetails.unitExchangeType 浮动换算率（销售）   浮动换算率（销售）    示例：0
75 0 固定值 saleReturnDetails.unitExchangeTypePrice 浮动换算率（计价） 浮动换算率（计价）    示例：0
76 refund_order_list.refund_order_list_wdttax_rate 固定值 saleReturnDetails.taxId 税目税率 税目税率，传id或者code    示例："2155547427149061"
77 _findCollection find ysOutWarehouse from fa193860-6aa8-37a8-b996-a856e9a8a96f where omsOutWarehouse=warehouse_no shopNo=shop_no mappingType=2 关联查询函数 saleReturnDetails.stockId 仓库 仓库，传id或者code    示例：2192242573644032
78 _findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no=shop_no 关联查询函数 saleReturnDetails.stockOrgId 库存组织 库存组织，传id或者code    示例："2163951720681984"
79 固定值 saleReturnDetails.saleReturnDepartmentId 退货部门id   退货部门id    示例："14321"
80 _findCollection find unit_new from 3aa72332-8d19-3a4e-aa5a-f02376b766e7 where number=refund_order_list.refund_order_list_spec_no 关联查询函数 saleReturnDetails.iProductAuxUnitId 销售单位 销售单位，传id或者code    示例：2263072523178240
81 _findCollection find unit_new from 3aa72332-8d19-3a4e-aa5a-f02376b766e7 where number=refund_order_list.refund_order_list_spec_no 关联查询函数 saleReturnDetails.iProductUnitId 计价单位 计价单位，传id或者code    示例：2312582309908736
82 _findCollection find unit_new from 3aa72332-8d19-3a4e-aa5a-f02376b766e7 where number=refund_order_list.refund_order_list_spec_no 关联查询函数 saleReturnDetails.masterUnitId 主计量单位 主计量单位，传id或者code    示例：2261943548399872
83 SALE 固定值 saleReturnDetails.orderProductType 商品类型 商品类型, SALE:销售品、GIFT:赠品、MARKUP:加价购、REBATE:返利商品、    示例："SALE"
84 固定值 saleReturnDetails.bizProductId 商家商品id 商家商品id    示例：31243141
85 _findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no=shop_no 关联查询函数 saleReturnDetails.salesOrgId 销售组织 销售组织，传id或者code    示例：6425432
86 固定值 saleReturnDetails.enable 是否有效状态  是否有效状态    示例：true
87 固定值 saleReturnDetails.orderNo 源头订单号 源头订单号，有来源必填    示例："QbOJ-000000000-20210825-000017"
88 固定值 saleReturnDetails.upcode 来源单据号 来源单据号    示例："XSCK20210825000005"
89 固定值 saleReturnDetails.modelDescription 规格  规格    示例："规格01"
90 固定值 saleReturnDetails.model 型号  型号    示例："001"
91 固定值 saleReturnDetails.specDescription 规格描述    规格描述    示例："规格"
92 1 固定值 saleReturnDetails.invExchRate 销售换算率  销售换算率    示例：1
93 refund_order_list.refund_order_list_refund_num 固定值 saleReturnDetails.subQty 退货销售数量  退货销售数量    示例：100
94 1 固定值 saleReturnDetails.invPriceExchRate 计价换算率   计价换算率    示例：1
95 refund_order_list.refund_order_list_refund_num 固定值 saleReturnDetails.priceQty 退货计价数量  退货计价数量    示例：100
96 refund_order_list.refund_order_list_refund_num 固定值 saleReturnDetails.qty 退货数量  退货数量    示例：1
97 固定值 saleReturnDetails.batchNo 批次  批次    示例：2
98 固定值 saleReturnDetails.isExpiryDateManage 是否有效期管理 是否有效期管理, true:是、false:否、    示例：false
99 固定值 saleReturnDetails.productDate 生产日期   生产日期    示例：2021-08-31 00:00:00
100 固定值 saleReturnDetails.expireDateNo 保质期   保质期    示例：3
101 固定值 saleReturnDetails.expireDateUnit 保质期单位 保质期单位, 1:年、2:月、6:天、    示例：1
102 固定值 saleReturnDetails.invalidDate 有效期至   有效期至    示例：2021-08-31 00:00:00
103 _function round((round(refund_order_list.refund_order_list_refund_order_amount,2)/refund_order_list.refund_order_list_refund_num),2) 计算函数 saleReturnDetails.oriTaxUnitPrice 含税成交价   含税成交价    示例：500
104 _function round((round(refund_order_list.refund_order_list_refund_order_amount,2)/refund_order_list.refund_order_list_refund_num)/(1+refund_order_list.refund_order_list_wdttax_rate),2) 计算函数 saleReturnDetails.oriUnitPrice 无税单价  无税单价    示例：500
105 _function round(refund_order_list.refund_order_list_refund_order_amount,2) 计算函数 saleReturnDetails.oriSum 含税金额  含税金额    示例：500
106 _function round(round(refund_order_list.refund_order_list_refund_order_amount,2)/(1+refund_order_list.refund_order_list_wdttax_rate),2) 计算函数 saleReturnDetails.oriMoney 无税金额    无税金额    示例：500
107 _function abs(round(round(refund_order_list.refund_order_list_refund_order_amount,2)/(1+refund_order_list.refund_order_list_wdttax_rate),2)-round(refund_order_list.refund_order_list_refund_order_amount,2)) 计算函数 saleReturnDetails.oriTax 税额  税额    示例：0.0
108 _function round((round(refund_order_list.refund_order_list_refund_order_amount,2)/refund_order_list.refund_order_list_refund_num),2) 计算函数 saleReturnDetails.natTaxUnitPrice 本币含税单价   本币含税单价    示例：500
109 _function round((round(refund_order_list.refund_order_list_refund_order_amount,2)/refund_order_list.refund_order_list_refund_num)/(1+refund_order_list.refund_order_list_wdttax_rate),2) 计算函数 saleReturnDetails.natUnitPrice 本币无税单价    本币无税单价    示例：500
110 _function round(refund_order_list.refund_order_list_refund_order_amount,2) 计算函数 saleReturnDetails.natSum 本币含税金额   本币含税金额    示例：500
111 _function round(round(refund_order_list.refund_order_list_refund_order_amount,2)/(1+refund_order_list.refund_order_list_wdttax_rate),2) 计算函数 saleReturnDetails.natMoney 本币无税金额   本币无税金额    示例：500
112 _function round(round(refund_order_list.refund_order_list_refund_order_amount,2)/(1+refund_order_list.refund_order_list_wdttax_rate)*refund_order_list.refund_order_list_wdttax_rate,2) 计算函数 saleReturnDetails.natTax 本币税额     本币税额    示例：500
113 固定值 saleReturnDetails.retNotNeedInvoiceQty 退货不开票数量  退货不开票数量    示例：100
114 固定值 saleReturnDetails.firstsourceid 源头单据id 源头单据id，有来源必填    示例：2403063657222400
115 固定值 saleReturnDetails.firstsourceautoid 源头单据子表id 源头单据子表id，有来源必填    示例：2403063657238784
116 固定值 saleReturnDetails.firstsource 源头单据类型 源头单据类型（udinghuo.voucher_order），有来源必填    示例：udinghuo.voucher_order
117 refund_no erp退换单号 saleReturnDetails.firstupcode 源头单据号 源头单据号，有来源必填    示例：QbOJ-000000000-20210825-000014
118 固定值 saleReturnDetails.orderId 销售订单id 销售订单id，有来源必填    示例：QbOJ-000000000-20210825-000014
119 refund_order_list.refund_order_list_remark 固定值 saleReturnDetails.bodyFreeItem!define1 表体备注 销售订单id，有来源必填    示例：QbOJ-000000000-20210825-000014
120 refund_order_list.refund_order_list_oid 固定值 saleReturnDetails.bodyFreeItem!define3 子订单号 销售订单id，有来源必填    示例：QbOJ-000000000-20210825-000014
121 refund_order_list.refund_order_list_tid 固定值 saleReturnDetails.bodyFreeItem!define4 原始订单 销售订单id，有来源必填    示例：QbOJ-000000000-20210825-000014
122 refund_order_list.refund_order_list_order_id 固定值 saleReturnDetails.bodyFreeItem!define5 旺店通行内码 销售订单id，有来源必填    示例：QbOJ-000000000-20210825-000014
123 Insert 固定值 saleReturnDetails._status 操作标识, Insert:新增、Update:更新 示例：Insert 操作标识, Insert:新增、Update:更新 示例：Insert
124 固定值 saleReturnDetails.saleReturnDetailDefineCharacter 表体自由自定义项
125 固定值 salereturnDefineCharacter 表头自有自定义项
126 remark 退款说明 salereturnDefineCharacter.attrext8 销售退货类型
127 tid 订单的原始单号 salereturnDefineCharacter.attrext23 原始单号

源平台配置元数据

目标平台配置元数据

系统数据集成方案明细

查看更多26500套系统数据对接方案

轻易云数据集成平台助力金蝶云星辰V2数据落地
轻易云数据集成平台的ETL转换与数据写入方法
从数据获取到高效写入：领星ERP与金蝶云星空系统对接实例
ETL转换与金蝶云星空API数据写入详解
ETL转换：从金蝶云星空到轻易云平台的数据写入优化
ETL转换实践：旺店通到金蝶云星空的高效数据同步
轻易云数据集成平台ETL转换与写入金蝶云星辰V2
从畅捷通存货档案到云平台的数据ETL流程
使用轻易云平台进行数据ETL与写入金蝶云星空的实战技巧
使用轻易云进行班牛数据的ETL转换与批量写入
如何通过轻易云平台实现聚水潭·奇门到MySQL的数据集成
吉客云库存与MySQL数据无缝对接的解决方案
实现每刻平台与金蝶云星空的无缝数据对接
实现金蝶与钉钉系统间的高效数据集成技术方案
轻易云平台助力报销单数据无缝对接
轻易云平台解决聚水潭销售订单分页与限流问题
企业信息化：从金蝶云星空到MySQL的数据处理详解
克服分页与限流挑战：实现旺店通与金蝶的高效数据传输
通过轻易云平台优化金蝶与聚水潭的供应商数据流
数据集成中的挑战与解决方案：案例分析