用友BIP销售退货单个保存_v1接口

所属平台: 用友BIP
类型: WebAPI
作用: EXECUTE
接口版本: 0.1
适配器: \Adapter\YYBIP\BIPExecuteAdapter
授权方式: OTHER
更新日期: 2022-06-18

销售退货单个保存_v1

POST/yonbip/sd/vouchersalereturn/singleSave

加工厂

{
  "operation": {
    "method": "none"
  }
}

接口请求参数

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

接口响应参数

暂无参数说明

用友BIP的接口：销售退货单个保存_v1（/yonbip/sd/vouchersalereturn/singleSave），由轻易云数据集成平台 API 资产管理模块整理收纳，并随用友BIP版本更新同步更新。

需要对接这个接口？

轻易云已预置该接口的适配能力，联系我们即可开始配置数据集成。

联系我们