API中心

  1. 销售管理
  2. 预订单
返回

预订单新增

接口所在U8C版本:U8 cloud3.1以及更高版本
详细描述:用于预订单新增
API视频讲解API详情补丁列表常见问题参考
接口地址
请求方式
请求参数header
请求参数body
返回类型参数
代码示例
请求参数示例
正确返回示例
错误返回示例
接口地址:http://ip:port/u8cloud/api/so/preorder/insert

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南
参数名必填描述默认值
Content-Type是请求体数据类型application/json
usercode是用户
password是密码
trantype是翻译类型，按编码为code，不需要翻译为pkcode
system是系统参数
uniquekey否幂等唯一key

请求参数(body):

全量参数自制最简全参数
参数名类型是否数组必填描述默认值示例值
preorder是是预订单信息
childrenvo是是预订单表体vo
blargessflagstring否否是否赠品
breturnprofitstring否否是否参与返利
bsafepricestring否否是否参与价保
carrangeidstring否否最后安排人
cbatchidstring否否批次
cbodywarehouseidstring否否发货仓库
ccalbodyidstring否否发货库存组织
ccurrencytypeidstring否否原币
cinventoryidstring否是存货
cordercorpidstring否否订单公司
cpackunitidstring否否辅单位
cporjectidstring否否价格项目ID
cpriceidstring否否价格政策ID
cpriceitemtablestring否否价目表
cpriceitemtableidstring否否价目表ID
cquoteunitidstring否否报价计量单位id
crecaddrnodeidstring否否地点ID
creceiptareaidstring否否收货地区
creceiptcorpidstring否否收货单位
crownostring否否行号
csinventoryidstring否否发货公司的存货管理ID
csourcebillbodyidstring否否来源单据行号
csourcebillidstring否否来源单据号
csourcebilltypestring否否来源单据类型
cunitidstring否否主计量单位
darrdatestring否否最后安排日期
dreceivedatestring否否到货日期
dreceivetimestring否否到货时间
dsenddatestring否否发货日期
dsendtimestring否否发货时间
frownotestring否否行备注
narrnumstring否否累计安排数量
ndiscountmnystring否否本币折扣额
ndiscountratestring否否整单折扣
nexchangeotobratestring否否折本汇率
nitemdiscountratestring否否单品折扣率
nmnystring否否本币无税金额
nnetpricestring否否本币无税净价
nnumberstring否是主数量
norgnlcurdiscntmnystring否否原币折扣额
norgnlcurmnystring否否原币无税金额
norgnlcurnetpricestring否否原币无税净价
norgnlcursummnystring否否原币价税合计
norgnlcurtaxmnystring否否原币税额
norgnlcurtaxnetprcstring否否原币含税净价
norgnlcurtaxpricestring否否原币含税单价
norgqtnetprcstring否否报价单位无税净价
norgqtprcstring否否报价单位无税单价
norgqttaxnetprcstring否否报价单位含税净价
norgqttaxprcstring否否报价单位含税单价
noriginalcurpricestring否是原币无税单价
npacknumberstring否否辅数量
npricestring否否本币无税单价
nqtnetprcstring否否报价单位本币无税净价
nqtorgprcstring否否询价原币无税单价
nqtorgtaxprcstring否否询价原币含税单价
nqtprcstring否否报价单位本币无税单价
nqttaxnetprcstring否否报价单位本币含税净价
nqttaxprcstring否否报价单位本币含税单价
nquoteunitnumstring否否报价单位数量
nquoteunitratestring否否报价计量单位换算率
nsummnystring否否本币价税合计
ntaxmnystring否否本币税额
ntaxnetpricestring否否本币含税净价
ntaxpricestring否否本币含税单价
ntaxratestring否否税率
pk_corpstring否否发货公司
pk_defdoc1string否否自定义项1（若为统计型，则传档案内容编码）
pk_defdoc10string否否自定义项10
pk_defdoc11string否否自定义项11
pk_defdoc12string否否自定义项12
pk_defdoc13string否否自定义项13
pk_defdoc14string否否自定义项14
pk_defdoc15string否否自定义项15
pk_defdoc16string否否自定义项16
pk_defdoc17string否否自定义项17
pk_defdoc18string否否自定义项18
pk_defdoc19string否否自定义项19
pk_defdoc2string否否自定义项2
pk_defdoc20string否否自定义项20
pk_defdoc3string否否自定义项3
pk_defdoc4string否否自定义项4
pk_defdoc5string否否自定义项5
pk_defdoc6string否否自定义项6
pk_defdoc7string否否自定义项7
pk_defdoc8string否否自定义项8
pk_defdoc9string否否自定义项9
pk_returnreasonstring否否退货原因主键
vdef1string否否自定义项1（若为备注型，则直接传内容）
vdef10string否否自定义项10
vdef11string否否自定义项11
vdef12string否否自定义项12
vdef13string否否自定义项13
vdef14string否否自定义项14
vdef15string否否自定义项15
vdef16string否否自定义项16
vdef17string否否自定义项17
vdef18string否否自定义项18
vdef19string否否自定义项19
vdef2string否否自定义项2
vdef20string否否自定义项20
vdef3string否否自定义项3
vdef4string否否自定义项4
vdef5string否否自定义项5
vdef6string否否自定义项6
vdef7string否否自定义项7
vdef8string否否自定义项8
vdef9string否否自定义项9
vpricecalprocstring否否询价计算过程
vreturnmodestring否否退货责任处理方式
parentvo否是预订单表头vo
ccustomeridstring否是客户
cdeptidstring否是销售部门
cemployeeidstring否否业务员
coperatoridstring否是制单人
csalecorpidstring否是销售组织
dabatedatestring否否失效日期（5.0sp添加）
dbilldatestring否否订货日期
dmakedatestring否否制单日期
pk_corpstring否是公司
pk_defdoc1string否否自定义项1（若为统计型，则传档案内容编码）
pk_defdoc10string否否自定义项10
pk_defdoc11string否否自定义项11
pk_defdoc12string否否自定义项12
pk_defdoc13string否否自定义项13
pk_defdoc14string否否自定义项14
pk_defdoc15string否否自定义项15
pk_defdoc16string否否自定义项16
pk_defdoc17string否否自定义项17
pk_defdoc18string否否自定义项18
pk_defdoc19string否否自定义项19
pk_defdoc2string否否自定义项2
pk_defdoc20string否否自定义项20
pk_defdoc3string否否自定义项3
pk_defdoc4string否否自定义项4
pk_defdoc5string否否自定义项5
pk_defdoc6string否否自定义项6
pk_defdoc7string否否自定义项7
pk_defdoc8string否否自定义项8
pk_defdoc9string否否自定义项9
vdef1string否否自定义项1（若为备注型，直接传内容）
vdef10string否否自定义项10
vdef11string否否自定义项11
vdef12string否否自定义项12
vdef13string否否自定义项13
vdef14string否否自定义项14
vdef15string否否自定义项15
vdef16string否否自定义项16
vdef17string否否自定义项17
vdef18string否否自定义项18
vdef19string否否自定义项19
vdef2string否否自定义项2
vdef20string否否自定义项20
vdef3string否否自定义项3
vdef4string否否自定义项4
vdef5string否否自定义项5
vdef6string否否自定义项6
vdef7string否否自定义项7
vdef8string否否自定义项8
vdef9string否否自定义项9
vnotestring否否备注
vreceiptcodestring否否单据号（不传则自动生成）

返回类型参数:

参数名类型是否数组必填描述默认值
preorder预订单聚合实体_返回
childrenvostring是否预订单表体vo_返回
parentvostring是否预订单表头vo_返回

代码示例:

Java模板示例下载C#模板示例下载

请求参数示例:

自制最简全参数

复制代码

{"preorder":[{"parentvo":{"pk_corp":"3101","coperatorid":"apicyc","ccustomerid":"2101123","csalecorpid":"1","cdeptid":"3101-_-2001"},"childrenvo":[{"cinventoryid":"IN0007","nnumber":"10","noriginalcurprice":"3.5"}]}]}

正确返回示例:

复制代码

{"status":"success","data":"[{\"parentvo\":{\"vreceiptcode\":\"c08161527\",\"dbilldate\":\"2023-08-16\",\"pk_corp\":\"1012\",\"corp_code\":\"3101\",\"corp_name\":\"cyc交通建设集团有限公司\",\"csalecorpid\":\"0001A21000000000YC08\",\"csalecorpid_code\":\"1\",\"csalecorpid_name\":\"1\",\"ccustomerid\":\"0001A11000000003GAH5\",\"customer_code\":\"2101123\",\"customer_name\":\"徐老板信息技术有限公司\",\"cdeptid\":\"1012A2100000000001LA\",\"dept_code\":\"3101-_-2001\",\"dept_name\":\"A销售-省内\",\"cemployeeid\":\"0001F410000000041G4V\",\"employee_code\":\"HI2308160105\",\"employee_name\":\"cyc1\",\"coperatorid\":\"0001A2100000000000YV\",\"operator_code\":\"apicyc\",\"operator_neme\":\"cyc\",\"dmakedate\":\"2023-08-17\",\"vnote\":\"c表头备注\",\"pk_defdoc1\":\"0001A11000000003GAH5\",\"vdef1\":\"徐老板信息技术有限公司\",\"vdef2\":\"cszdyxnr\",\"dabatedate\":\"2023-08-19\"},\"childrenvo\":[{\"cordercorpid\":\"1012\",\"cordercorpid_code\":\"3101\",\"cordercorpid_name\":\"cyc交通建设集团有限公司\",\"pk_corp\":\"1012\",\"corp_code\":\"3101\",\"corp_name\":\"cyc交通建设集团有限公司\",\"cinventoryid\":\"IN0007\",\"cinventoryid_name\":\"TEST11111\",\"creceiptcorpid\":\"0001A11000000003GAH5\",\"ccalbodyid\":\"1012A2100000000001LI\",\"ccalbodyid_code\":\"3101-_-K1001\",\"ccalbodyid_name\":\"A总-管\",\"cbodywarehouseid\":\"1012A2100000000001LQ\",\"cbodywarehouseid_code\":\"3101^C01\",\"cbodywarehouseid_name\":\"C总仓\",\"cunitid\":\"0001A2100000000003DG\",\"cunitid_code\":\"1\",\"cunitid_name\":\"件1\",\"nnumber\":\"10\",\"noriginalcurprice\":\"3.5\",\"norgnlcurtaxprice\":\"3.95500000\",\"nexchangeotobrate\":\"1.00000000\",\"ntaxrate\":\"13.00000000\",\"ndiscountrate\":\"100\",\"nitemdiscountrate\":\"100\",\"norgnlcurtaxnetprc\":\"3.95500000\",\"norgnlcurmny\":\"35.00000000\",\"norgnlcurtaxmny\":\"4.55000000\",\"norgnlcursummny\":\"39.55000000\",\"ccurrencytypeid\":\"00010000000000000001\",\"norgnlcurnetprice\":\"3.50000000\",\"norgnlcurdiscntmny\":\"0.00000000\",\"nprice\":\"3.5\",\"ntaxprice\":\"3.95500000\",\"nnetprice\":\"3.50000000\",\"ntaxnetprice\":\"3.95500000\",\"ntaxmny\":\"4.55000000\",\"nmny\":\"35.00000000\",\"nsummny\":\"39.55000000\",\"ndiscountmny\":\"0.00000000\",\"blargessflag\":false,\"crowno\":\"5\",\"frownote\":\"c表体备注\",\"dsendtime\":\"\",\"dsenddate\":\"2023-08-16\",\"dreceivedate\":\"2023-08-16\",\"dreceivetime\":\"\",\"narrnum\":\"0.00000000\",\"cquoteunitid\":\"0001A2100000000003DG\",\"nquoteunitnum\":\"10\",\"bsafeprice\":false,\"breturnprofit\":false,\"csinventoryid\":\"0001A210000000001H35\",\"pk_defdoc1\":\"0001A11000000003GAH5\",\"vdef1\":\"徐老板信息技术有限公司\",\"vdef2\":\"cszdyxnr\"}]}]","taskNumber":"202308170037"}

错误返回示例:

复制代码

{
    "status": "falied",
    "errorcode": "-32000",
    "errormsg": "传入数据有的字段为空！第1条数据：第1行表体：[存货编码]",
    "taskNumber": "202010170010"
}