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

Platform: 用友BIP
Type: WebAPI
Effect: EXECUTE
API Version: 0.1
Adapter: \Adapter\YYBIP\BIPExecuteAdapter
Auth Mode: OTHER
Updated At: 2022-06-18

销售退货单个保存_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	string	1	Optional	单据主表id 新增时无需填写，修改时必填示例：3123432154321
3	code	code	string	1	Optional	单据编码，以系统编码规则配置为准：系统设置为手工编号时必输，系统设置为自动编号时非必输；修改时必传示例："S0T5-0000000000-20210831-000000"
4	salesOrgId	salesOrgId	string	1	Optional	销售组织，传id或者code 示例：2163951720681984
5	transactionTypeId	transactionTypeId	string	1	Required	交易类型，传id或者code 示例：2155547426656517
6	agentId	agentId	string	1	Required	客户，传id或者code 示例：2251598175195392
7	retailInvestors	retailInvestors	string	1	Optional	是否散户, true:是、false:否、示例：false
8	saleDepartmentId	saleDepartmentId	string	1	Required	销售部门，传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	Optional	币种，传id或者code 示例："2155547424560384"
13	exchangeRateType	exchangeRateType	string	1	Optional	汇率类型，传id或者code 示例："csrka3z7"
14	natCurrency	natCurrency	string	1	Optional	本币，传id或者code 示例："2155547424560384"
15	retailAgentName	retailAgentName	string	1	Required	散户名称示例："散户2"
16	saleReturnMemo	saleReturnMemo	object	1	Optional	备注
17	remark	remark	string	1	Optional	备注示例："销售退货"
18	agentTaxItem	agentTaxItem	string	1	Optional	客户销项税率ID 示例："2155547427149061"
19	bizId	bizId	string	1	Optional	供应商id 示例：2155538208313600
20	agentRelationId	agentRelationId	string	1	Optional	客户交易关系id 示例：55555656565
21	refundStatus	refundStatus	string	1	Optional	退货单退款状态，由系统业务自动生成，接口无需传值。示例："NONE"
22	refundAmount	refundAmount	string	1	Optional	退款金额示例：1
23	isWfControlled	isWfControlled	string	1	Optional	是否受审批流控制示例：false
24	exchRate	exchRate	string	1	Required	汇率示例：1
25	taxInclusive	taxInclusive	string	1	Required	单价含税, true:是、false:否、示例：true
26	saleReturnStatus	saleReturnStatus	string	1	Optional	单据状态, 由系统业务自动生成，接口无需传值示例："SUBMITSALERETURN" 默认值：SUBMITSALERETURN
27	saleReturnSourceType	saleReturnSourceType	string	1	Required	退货类型, NONE:无来源、DELIVERYEND:销售出库单、ORDER:销售订单示例："DELIVERYEND"
28	bizFlow_name	bizFlow_name	string	1	Optional	流程名称示例："001"
29	bizFlow_version	bizFlow_version	string	1	Optional	版本信息示例："版本1"
30	logisticWayId	logisticWayId	string	1	Optional	物流公司id 示例：321321
31	invoiceAgentId	invoiceAgentId	string	1	Required	开票客户，传id或者code 示例：2216247878177024
32	realMoney	realMoney	string	1	Optional	应付金额，等于表头的退货金额示例：100
33	modifyInvoiceType	modifyInvoiceType	string	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	string	1	Optional	总金额示例：43214
53	payMoney	payMoney	string	1	Required	退货金额，需等于表体含税金额的合计示例：312
54	totalMoneyOrigTaxfree	totalMoneyOrigTaxfree	string	1	Optional	无税总金额示例：321
55	payMoneyOrigTaxfree	payMoneyOrigTaxfree	string	1	Optional	无税退货金额示例：321
56	totalOriTax	totalOriTax	string	1	Optional	税额示例：3
57	totalMoneyDomestic	totalMoneyDomestic	string	1	Optional	本币总金额示例：643256
58	payMoneyDomestic	payMoneyDomestic	string	1	Optional	本币退货金额示例：5432
59	totalMoneyDomesticTaxfree	totalMoneyDomesticTaxfree	string	1	Optional	本币无税总金额示例：5432
60	payMoneyDomesticTaxfree	payMoneyDomesticTaxfree	string	1	Optional	本币无税退货金额示例：5432
61	totalNatTax	totalNatTax	string	1	Optional	本币税额示例：5421
62	bizFlow	bizFlow	string	1	Optional	流程ID 示例：213
63	isFlowCoreBill	isFlowCoreBill	string	1	Optional	是否流程核心单据示例：true
64	_status	_status	string	1	Required	操作标识, Insert:新增、Update:更新示例："Insert"
65	saleReturnDetails	saleReturnDetails	array	1	Required	退货单详情[voucher.salereturn.SaleReturnDetail]
66	id	id	string	1	Optional	表体行ID 新增时无需填写，修改时必填示例：4312432
67	orderDetailId	orderDetailId	string	1	Optional	订单行id，有来源必填示例：2403153858154753
68	orderDetailIdKey	orderDetailIdKey	string	1	Optional	订单行idkey 示例："6425432"
69	sourceid	sourceid	string	1	Optional	来源单据ID，有来源必填示例：2403160486547968
70	sourceautoid	sourceautoid	string	1	Optional	来源单据子表ID，有来源必填示例：2403160486547970
71	source	source	string	1	Optional	来源单据类型（1.ustock.st_salesout销售出库 2.voucher_order 销售订单）有来源必填示例："ustock.st_salesout"
72	makeRuleCode	makeRuleCode	string	1	Optional	生单类型编码（1.salesoutTosalereturn 由销售出库生单，2.order_salereturn:由销售订单生单），有来源必填示例："salesoutTosalereturn"
73	productId	productId	string	1	Required	商品，传id或者code 示例：2320711092457728
74	skuId	skuId	string	1	Required	商品sku，传id或者code 示例：2313763385315584
75	projectId	projectId	string	1	Optional	项目，传id或者code 示例："123124312"
76	unitExchangeType	unitExchangeType	string	1	Required	浮动换算率（销售）示例：0
77	unitExchangeTypePrice	unitExchangeTypePrice	string	1	Required	浮动换算率（计价）示例：0
78	taxId	taxId	string	1	Required	税目税率，传id或者code 示例："2155547427149061"
79	stockId	stockId	string	1	Optional	仓库，传id或者code 示例：2192242573644032
80	stockOrgId	stockOrgId	string	1	Required	库存组织，传id或者code 示例："2163951720681984"
81	saleReturnDepartmentId	saleReturnDepartmentId	string	1	Optional	退货部门id 示例："14321"
82	iProductAuxUnitId	iProductAuxUnitId	string	1	Required	销售单位，传id或者code 示例：2263072523178240
83	iProductUnitId	iProductUnitId	string	1	Required	计价单位，传id或者code 示例：2312582309908736
84	masterUnitId	masterUnitId	string	1	Required	主计量单位，传id或者code 示例：2261943548399872
85	orderProductType	orderProductType	string	1	Optional	商品类型, SALE:销售品、GIFT:赠品、MARKUP:加价购、REBATE:返利商品、示例："SALE"
86	bizProductId	bizProductId	string	1	Optional	商家商品id 示例：31243141
87	salesOrgId	salesOrgId	string	1	Optional	销售组织，传id或者code 示例：6425432
88	enable	enable	string	1	Optional	是否有效状态示例：true
89	orderNo	orderNo	string	1	Optional	源头订单号，有来源必填示例："QbOJ-000000000-20210825-000017"
90	upcode	upcode	string	1	Optional	来源单据号示例："XSCK20210825000005"
91	modelDescription	modelDescription	string	1	Optional	规格示例："规格01"
92	model	model	string	1	Optional	型号示例："001"
93	specDescription	specDescription	string	1	Optional	规格描述示例："规格"
94	invExchRate	invExchRate	string	1	Required	销售换算率示例：1
95	subQty	subQty	string	1	Required	退货销售数量示例：100
96	invPriceExchRate	invPriceExchRate	string	1	Required	计价换算率示例：1
97	priceQty	priceQty	string	1	Required	退货计价数量示例：100
98	qty	qty	string	1	Required	退货数量示例：1
99	isBatchManage	isBatchManage	string	1	Optional	是否批次管理, true:是、false:否、示例：false
100	batchNo	batchNo	string	1	Optional	批次示例：2
101	isExpiryDateManage	isExpiryDateManage	string	1	Optional	是否有效期管理, true:是、false:否、示例：false
102	productDate	productDate	string	1	Optional	生产日期示例：2021-08-31 00:00:00
103	expireDateNo	expireDateNo	string	1	Optional	保质期示例：3
104	expireDateUnit	expireDateUnit	string	1	Optional	保质期单位, 1:年、2:月、6:天、示例：1
105	invalidDate	invalidDate	string	1	Optional	有效期至示例：2021-08-31 00:00:00
106	oriTaxUnitPrice	oriTaxUnitPrice	string	1	Required	含税成交价示例：500
107	oriUnitPrice	oriUnitPrice	string	1	Required	无税单价示例：500
108	oriSum	oriSum	string	1	Required	含税金额示例：500
109	oriMoney	oriMoney	string	1	Required	无税金额示例：500
110	oriTax	oriTax	string	1	Required	税额示例：0.0
111	natTaxUnitPrice	natTaxUnitPrice	string	1	Required	本币含税单价示例：500
112	natUnitPrice	natUnitPrice	string	1	Required	本币无税单价示例：500
113	natSum	natSum	string	1	Required	本币含税金额示例：500
114	natMoney	natMoney	string	1	Required	本币无税金额示例：500
115	natTax	natTax	string	1	Required	本币税额示例：500
116	retNotNeedInvoiceQty	retNotNeedInvoiceQty	string	1	Optional	退货不开票数量示例：100
117	bodyItem	bodyItem	string	1	Optional	表体自定义项ID(1-60)
118	bodyFreeItem	bodyFreeItem	string	1	Optional	表体自由自定义项(1-60)
119	firstsourceid	firstsourceid	string	1	Optional	源头单据id，有来源必填示例：2403063657222400
120	firstsourceautoid	firstsourceautoid	string	1	Optional	源头单据子表id，有来源必填示例：2403063657238784
121	firstsource	firstsource	string	1	Optional	源头单据类型（udinghuo.voucher_order），有来源必填示例：udinghuo.voucher_order
122	firstupcode	firstupcode	string	1	Optional	源头单据号，有来源必填示例：QbOJ-000000000-20210825-000014
123	orderId	orderId	string	1	Optional	销售订单id，有来源必填示例：QbOJ-000000000-20210825-000014
124	saleReturnAttachments	saleReturnAttachments	array	1	Optional	退货单附件[voucher.salereturn.SaleReturnAttachment]
125	id	id	string	1	Optional	主键ID 新增时无需填写，修改时必填新增时无需填写示例：1233414
126	folder	folder	string	1	Optional	附件路径示例：/attachments/orders/2009391957807360/
127	saleReturnId	saleReturnId	string	1	Optional	退货单ID 示例：3123432154321
128	type	type	string	1	Optional	附件类型示例：image/png
129	size	size	string	1	Optional	附件大小示例："183043"
130	_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.