金蝶云星辰V2销售订单写入V3.0API接口文档
销售订单写入V3.0
接口地址:/jdy/v2/scm/sal_order
请求方法: POST
加工厂: {"operation":{"method":"none"}}
接口请求参数
序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
---|---|---|---|---|---|---|
1 | bill_date | 出库日期 | string | 出库日期,格式:2019-01-01 | 否 | |
2 | customer_id | 客户信息 | string | 客户信息 | 否 | |
3 | allocate_rule | 销售费用分摊规则 | string | 销售费用分摊规则;1: 按价税合计分摊(默认); 2:按数量分摊 | 否 | |
4 | attachments_url | 附件地址 | array | 附件地址 | 否 | |
5 | bill_dis_amount | 整单折扣额 | int | 整单折扣额 | 否 | |
6 | bill_dis_rate | 整单折扣率 | int | 整单折扣率% | 否 | |
7 | bill_no | 单据编码 | string | 单据编码 | 否 | |
8 | contact_address | 联系信息-详细地址 | string | 联系信息-详细地址 | 否 | |
9 | contact_city_id | 联系信息-市ID | string | 联系信息-市ID | 否 | |
10 | contact_country_id | 联系信息-国家ID | string | 联系信息-国家ID | 否 | |
11 | contact_district_id | 联系信息-区ID | string | 联系信息-区ID | 否 | |
12 | contact_linkman | 联系信息-联系人 | string | 联系信息-联系人 | 否 | |
13 | contact_phone | 联系信息-联系方式 | string | 联系信息-联系方式 | 否 | |
14 | contact_province_id | 联系信息-省ID | string | 联系信息-省ID | 否 | |
15 | cost_fee | 销售费用 | int | 销售费用 | 否 | |
16 | cost_fee_entity | 销售费用明细 | string | 销售费用明细,没有则传null或不传该字段 | 否 | |
17 | currency_id | 币别id | string | 币别id | 否 | |
18 | cus_bear_fee_entry | 客户承担费用单据体 | List | 客户承担费用单据体 | 否 | |
19 | cus_bear_fee_status | 客户承担费用 | string | 客户承担费用参数状态;B:计入应收账款,O:计入其他收入 | 否 | |
20 | cus_currency_id | 客户承担费用币别id | string | 客户承担费用币别id | 否 | |
21 | cus_exchange_rate | 客户承担费用汇率 | string | 客户承担费用汇率 | 否 | |
22 | custom_field | 自定义字段使用指南 | object | 自定义字段使用指南 | 否 | |
23 | customer_number | 客户编码 | string | 客户编码 | 否 | |
24 | delivery_type_id | 交货方式id | string | 交货方式id | 否 | |
25 | dispatcher_address | 发货地址-详细地址 | string | 发货地址-详细地址 | 否 | |
26 | dispatcher_city_id | 发货地址-市ID | string | 发货地址-市ID | 否 | |
27 | dispatcher_country_id | 发货国家id | string | 发货国家id | 否 | |
28 | dispatcher_district_id | 发货地址-区ID | string | 发货地址-区ID | 否 | |
29 | dispatcher_linkman | 发货人 | string | 发货人 | 否 | |
30 | dispatcher_phone | 发货联系电话 | string | 发货联系电话 | 否 | |
31 | dispatcher_province_id | 发货地址-省ID | string | 发货地址-省ID | 否 | |
32 | emp_id | 业务员信息 | string | 业务员信息 | 否 | |
33 | emp_number | 业务员编码 | string | 业务员编码 | 否 | |
34 | enable_directional | 是否定向抵扣 | bool | 是否定向抵扣 | 否 | |
35 | id | 单据ID,修改单据时必填 | string | 单据ID,修改单据时必填 | 否 | |
36 | ignore_warn | 是否忽略告警信息 | bool | 是否忽略告警信息(如:单价为0),保存订单,true:忽略,默认false | 否 | |
37 | material_entity | 商品分录 | array | 商品分录 | 否 | |
37.1 | is_free | 是否赠品 | bool | 是否赠品 | 否 | |
37.2 | all_amount | 价税合计 | int | 价税合计 | 否 | |
37.3 | amount | 金额 | int | 金额 | 否 | |
37.4 | aux_prop_id | 辅助属性 | string | 辅助属性;辅助属性商品必填 | 否 | |
37.5 | aux_unit_id | 辅助单位id | string | 辅助单位id | 否 | |
37.6 | aux_unit_name | 辅助单位名称 | string | 辅助单位名称 | 否 | |
37.7 | aux_unit_number | 辅助单位编码 | string | 辅助单位编码 | 否 | |
37.8 | bill_dis_before_amount | 整单折前价税合计 | int | 整单折前价税合计 | 否 | |
37.9 | cess | 商品增值税税率 | string | 商品增值税税率;不传后端自取,传入则以传入为准 | 否 | |
37.10 | comment | 商品行备注 | string | 商品行备注 | 否 | |
37.11 | custom_entity_field | 自定义字段使用指南 | object | 自定义字段使用指南 | 否 | |
37.12 | delivery_date | 预计交货日期 | string | 预计交货日期 | 否 | |
37.13 | dis_amount | 折扣额 | int | 折扣额 | 否 | |
37.14 | discount | 折扣(折) | int | 折扣(折) | 否 | |
37.15 | id | 商品分录id | string | 商品分录id,新增不传该字段,修改必传 | 否 | |
37.16 | material_id | 商品 | string | 商品 | 否 | |
37.17 | material_number | 商品编码 | string | 商品编码 | 否 | |
37.18 | pre_dis_amount | 折前金额 | int | 折前金额 | 否 | |
37.19 | price | 单价 | int | 单价 | 否 | |
37.20 | qty | 数量 | int | 数量 | 否 | |
37.21 | regain_price | 修改数量是否重新取价 | bool | true | 修改数量是否重新取价;默认为:true | 否 |
37.22 | sp_id | 仓位 | string | 仓位,启用了仓位管理则必填 | 否 | |
37.23 | stock_id | 仓库 | string | 仓库 | 否 | |
37.24 | tax_amount | 商品税额 | string | 商品税额 | 否 | |
37.25 | tax_price | 含税单价 | int | 含税单价(根据设置与price二选一) | 否 | |
37.26 | unit_id | 单位 | string | 单位 | 否 | |
38 | operation_key | 操作类型 | string | 操作类型,审核audit、提交submit | 否 | |
39 | payment_entry | 收款账户 | array | 收款账户 | 否 | |
39.1 | paid_amount | 收款金额 | int | 收款金额 | 否 | |
39.2 | pay_comment | 备注 | string | 备注 | 否 | |
39.3 | pay_type_id | 收款方式 | string | 收款方式 | 否 | |
39.4 | settle_account_id | 收款账户 | string | 收款账户 | 否 | |
40 | remark | 单据备注 | string | 单据备注 | 否 | |
41 | required_invoice | 是否需要开票 | bool | 是否需要开票 | 否 | |
42 | reverse_condition_calculate | 是否从反算单价 | bool | 是否从反算单价(保存修改应保持一致传参),true:反算,默认false | 否 | |
43 | total_amount | 本次应收账款 | int | 本次应收账款 | 否 | |
44 | total_ins_amount | 本次收款 | int | 本次收款 | 否 |
接口响应参数
序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
---|
金蝶云星辰V2的接口:销售订单写入V3.0(/jdy/v2/scm/sal_order),由轻易云数据集成平台API资产管理模块整理收纳,并且根据金蝶云星辰V2版本更新同步实时更新。API资产管理平台支持API的版本控制和回滚,确保API的稳定性和可靠性,减少因API变更导致的业务中断和数据不一致问题。