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

Platform: 用友BIP
Type: WebAPI
Effect: EXECUTE
API Version: 0.1
Adapter: \Adapter\YYBIP\BIPExecuteAdapter
Auth Mode: OTHER
Help Link: https://open.diwork.com/#/doc-center/docDes/api?code=yonbip&section=4a36ae2fc0da4e81a3384d7e0861459c
Doc Link: https://open.diwork.com/#/doc-center/docDes/api?code=yonbip&section=4a36ae2fc0da4e81a3384d7e0861459c
Updated At: 2022-04-17

销售退货单个保存_v1

POST/yonbip/sd/vouchersalereturn/singleSave

Factory

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

Request Parameters

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

Response Parameters

No parameter reference available

The 销售退货单个保存_v1 API (/yonbip/sd/vouchersalereturn/singleSave) of 用友BIP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 用友BIP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.