金蝶云星辰V2销售退货单写入V3.0API接口文档

所属平台： 金蝶云星辰V2
类型： WebAPI
作用： EXECUTE
接口版本： 1.0
适配器： \Adapter\Kingdee\YxcV2ExecuteAdapter
帮助链接：
描述：
更新日期： 2023-06-02 18:09:06
销售退货单写入V3.0

接口地址：/jdy/v2/scm/sal_in_bound

请求方法： POST

加工厂： {"operation":{"method":"none"}}

接口请求参数
序号 字段 名称 类型 默认值 描述 是否必要
1 bill_date 出库日期 string 出库日期,格式：2019-01-01 否
2 customer_id 客户 string 客户 否
3 attachments_url 上传的附件 array 上传的附件url 否
4 bill_dis_amount 整单折扣额 int 整单折扣额 否
5 bill_dis_rate 整单折扣率 int 整单折扣率% 否
6 bill_no 单据编码 string 单据编码 否
7 contact_address 联系信息-详细地址 string 联系信息-详细地址 否
8 contact_city_id 联系信息-市ID string 联系信息-市ID 否
9 contact_country_id 联系信息-国家ID string 联系信息-国家ID 否
10 contact_district_id 联系信息-区ID string 联系信息-区ID 否
11 contact_linkman 联系信息-联系人 string 联系信息-联系人 否
12 contact_phone 联系信息-联系方式 string 联系信息-联系方式 否
13 contact_province_id 联系信息-省ID string 联系信息-省ID 否
14 currency_id 币别id string 币别id 否
15 custom_field 自定义字段使用指南 string 自定义字段使用指南 否
16 customer_number 客户编码 string 客户编码 否
17 diff_amount 退款抹零 int 退款抹零 否
18 emp_id 业务员 string 业务员 否
19 emp_number 业务员编码 string 业务员编码 否
20 id 单据ID string 单据ID，修改单据时必填 否
21 ignore_warn 是否忽略告警信息 bool 是否忽略告警信息(如：名称已存在)保存客户，true:忽略，默认false 否
22 material_entity 商品分录 array 商品分录 否
22.1 aux_qty 辅助单位数量 int 辅助单位数量 否
22.2 aux_unit_id 辅助单位id string 辅助单位id 否
22.3 is_free 是否赠品 bool 是否赠品 否
22.4 material_id 商品id string 商品id 否
22.5 price 单价 int 单价 否
22.6 qty 数量 int 数量 否
22.7 stock_id 仓库id string 仓库id 否
22.8 tax_price 含税单价 int 含税单价 否
22.9 unit_id 单位id string 单位id 否
22.10 act_non_tax_amount 实际不含税金额 int 实际不含税金额 否
22.11 act_tax_price 实际含税单价 int 实际含税单价 否
22.12 all_amount 价税合计 int 价税合计 否
22.13 amount 金额 int 金额 否
22.14 aux_coefficient 辅助换算率 int 辅助换算率 否
22.15 aux_id1 辅助属性1id string 辅助属性1id 否
22.16 aux_id2 辅助属性2id string 辅助属性2id 否
22.17 aux_id3 辅助属性3id string 辅助属性3id 否
22.18 aux_name1 辅助属性1名称 string 辅助属性1名称 否
22.19 aux_name2 辅助属性2名称 string 辅助属性2名称 否
22.20 aux_name3 辅助属性3名称 string 辅助属性3名称 否
22.21 aux_number1 辅助属性1编码 string 辅助属性1编码 否
22.22 aux_number2 辅助属性2编码 string 辅助属性2编码 否
22.23 aux_number3 辅助属性3编码 string 辅助属性3编码 否
22.24 aux_prop_id 辅助属性id string 辅助属性id 否
22.25 aux_prop_name 辅助属性名称 string 辅助属性名称 否
22.26 aux_prop_number 辅助属性编码 string 辅助属性编码 否
22.27 aux_unit_name 辅助单位名称 string 辅助单位名称 否
22.28 aux_unit_number 辅助单位编码 string 辅助单位编码 否
22.29 barcode 条形码 string 条形码 否
22.30 base_unit_id 基本单位id string 基本单位id 否
22.31 base_unit_name 基本单位名称 string 基本单位名称 否
22.32 base_unit_number 基本单位编码 string 基本单位编码 否
22.33 batch_no 批次号 string 批次号 否
22.34 bill_dis_distribution 整单折扣分配额 int 整单折扣分配额 否
22.35 cess 增值税率 int 增值税率 否
22.36 coefficient 换算率 int 换算率 否
22.37 comment 行备注 string 行备注 否
22.38 conversion_rate 换算公式 string 换算公式 否
22.39 cost 成本 int 成本 否
22.40 cur_settle_amount 本次核销金额 int 本次核销金额 否
22.41 custom_entity_field 自定义字段使用指南 Map <string> 自定义字段使用指南 否
22.42 dis_amount 折扣额 int 折扣额 否
22.43 dis_price 折扣单价 int 折扣单价 否
22.44 dis_rate 折算率 int 折算率 否
22.45 discount 折扣 int 折扣 否
22.46 divide_diff_amount 优惠分摊金额 int 优惠分摊金额 否
22.47 entry_settle_status 分录核销状态 string 分录核销状态，未收款：A，部分收款：B，全部收款：C 否
22.48 entry_status 分录状态 string 分录状态 否
22.49 fee 销售费用分摊 int 销售费用分摊 否
22.50 id 商品分录id string 商品分录id 否
22.51 inv_base_qty 基本库存数量 int 基本库存数量 否
22.52 inv_qty 库存数量 int 库存数量 否
22.53 kf_date 生产日期 string 生产日期 否
22.54 kf_period 保质期天数 integer 保质期天数 否
22.55 kf_type 保质期类型 string 保质期类型，1：天，2：月，3：年 否
22.56 material_help_code 商品助记码 string 商品助记码 否
22.57 material_is_asst_attr 商品是否启用辅助属性 bool 商品是否启用辅助属性 否
22.58 material_is_batch 商品是否开启批次 bool 商品是否开启批次 否
22.59 material_is_kf_period 商品是否开启保质期 bool 商品是否开启保质期 否
22.60 material_is_multi_unit 商品是否多单位 bool 商品是否多单位 否
22.61 material_is_serial 商品是否序列号 bool 商品是否序列号 否
22.62 material_model 商品规格 string 商品规格 否
22.63 material_name 商品名称 string 商品名称 否
22.64 material_number 商品编码 string 商品编码 否
22.65 picture 图片url string 图片url 否
22.66 pre_dis_amount 折前金额 int 折前金额 否
22.67 pro_license 生产许可证号 string 生产许可证号 否
22.68 pro_place 产地 string 产地 否
22.69 pro_reg_no 注册证号 string 注册证号 否
22.70 return_qty 退货基本数量 int 退货基本数量 否
22.71 return_qty_unit 退货数量 int 退货数量 否
22.72 seq 分录序号 integer 分录序号 否
22.73 sn_list 序列号 string 序列号 格式：001:备注1 否
22.74 sn_list_id 序列号流转ID string 序列号流转ID 否
22.75 sp_id 仓位id string 仓位id 否
22.76 sp_name 仓位名称 string 仓位名称 否
22.77 sp_number 仓位编码 string 仓位编码 否
22.78 src_bill_type_id 源单类型 string 源单类型：销售出库单sal_bill_outbound、销售退货申请单sal_inbound_request 否
22.79 src_entry_id 源单分录id string 源单分录id 否
22.80 src_inter_id 源单id string 源单id 否
22.81 stock_is_allow_freight 仓库启用仓位管理 bool 仓库启用仓位管理 否
22.82 stock_name 仓库名称 string 仓库名称 否
22.83 stock_number 仓库编码 string 仓库编码 否
22.84 tax_amount 税额 int 税额 否
22.85 unit_cost 单位成本 int 单位成本 否
22.86 unit_name 单位名称 string 单位名称 否
22.87 unit_number 单位编码 string 单位编码 否
22.88 valid_date 有效日期 string 有效日期 否
23 operation_key 操作类型 string 操作类型，审核audit、提交submit 否
24 payment_entry 退款账户 object 退款账户 否
24.1 paid_amount 收款金额 int 收款金额 否
24.2 pay_type_id 收款方式 string 收款方式 否
24.3 settle_account_id 收款账户 string 收款账户 否
24.4 pay_comment 备注 string 备注 否
25 remark 单据备注 string 单据备注 否
26 reverse_condition_calculate 是否从反算单价 bool 是否从反算单价（保存修改应保持一致传参），true:反算，默认false 否
27 total_amount 本次应退账款 int 本次应退账款 否
28 total_ins_amount 本次退款 int 本次退款 否
29 total_un_settle_amount 本单未退 int 本单未退 否
接口响应参数
序号 字段 名称 类型 默认值 描述 是否必要
金蝶云星辰V2的接口：销售退货单写入V3.0（/jdy/v2/scm/sal_in_bound），由轻易云数据集成平台API资产管理模块整理收纳，并且根据金蝶云星辰V2版本更新同步实时更新。通过API资产管理，企业能够实现API的集中监控和分析，及时发现并解决潜在的性能瓶颈和安全风险，保障业务的连续性和稳定性。
联系轻易云集成专家
联系系统对接开发人员黄宏棵

黄宏棵 加微信

13286997615

资深系统集成顾问，专长于ERP、电商OMS、钉钉及CRM系统。他能提供高效的集成方案，优化企业运营流程，提升业务效率和决策智能化。

数据集成平台运行原理
更多系统对接方案