saleorder/get
目录 |
1.接口说明
1.1接口描述
获取单张销售订单
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
销售应用
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/saleorder/get |
| 格式 | JSON |
| https请求方式 | GET |
| 编码类型 | UTF-8 |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | string | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号(默认取应用的第一个数据源) |
| id | 是 | string | 订单编号 |
3.3请求示例
GET https://api.yonyouup.com/api/saleorder/get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&id=0000000017&ds_sequence=1
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码,0 为正常。 | |
| errmsg | string | 错误信息。 | |
| code | string | 订单号 | |
| date | date | 日期 | |
| businesstype | string | 业务类型 | |
| typecode | string | 销售类型编码 | |
| typename | string | 销售类型 | |
| state | string | 单据状态 | |
| custcode | string | 客户编码 | |
| cusname | string | 客户名称 | |
| cusabbname | string | 客户简称 | |
| deptcode | string | 部门编码 | |
| deptname | string | 部门名称 | |
| personcode | string | 人员编码 | |
| personname | string | 人员 | |
| dpremodatebt | date | 预完工日期 | |
| dpredatebt | date | 预发货日期 | |
| ccontactname | string | 收货联系人 | |
| cofficephone | string | 收货联系电话 | |
| typename | string | 销售类型 | |
| typecode | string | 销售类型编码 | |
| sendaddress | string | 发货地址 | |
| ccusperson | string | 联系人 | |
| ccuspersoncode | string | 联系人编码 | |
| caddcode | string | 收货地址编码 | |
| cebprovince | string | 收货人省 | |
| define1 | string | 单据头自定义项1 | |
| define2 | string | 单据头自定义项2 | |
| define3 | string | 单据头自定义项3 | |
| define4 | date | 单据头自定义项4 | |
| define5 | number | 单据头自定义项5 | |
| define6 | date | 单据头自定义项6 | |
| define7 | number | 单据头自定义项7 | |
| define8 | string | 单据头自定义项8 | |
| define9 | string | 单据头自定义项9 | |
| define10 | string | 单据头自定义项10 | |
| define11 | string | 单据头自定义项11 | |
| define12 | string | 单据头自定义项12 | |
| define13 | string | 单据头自定义项13 | |
| define14 | string | 单据头自定义项14 | |
| define15 | number | 单据头自定义项15 | |
| define16 | number | 单据头自定义项16 | |
| memo | string | 备注 | |
| maker | string | 制单人 | |
| verifier | string | 审核人 | |
| closer | string | 关闭人 | |
| timestamp | number | 时间戳 | |
| inventorycode | string | entry | 存货编码 |
| inventoryname | string | entry | 存货 |
| invstd | string | entry | 规格型号 |
| unitcode | string | entry | 销售单位编码 |
| unitname | string | entry | 销售单位 |
| unitrate | number | entry | 换算率 |
| quantity | number | entry | 数量 |
| num | number | entry | 件数 |
| unitprice | number | entry | 单价 |
| quotedprice | number | entry | 报价 |
| taxunitprice | number | entry | 含税单价 |
| money | number | entry | 无税金额 |
| taxrate | number | entry | 税率,默认17 |
| sum | number | entry | 价税合计 |
| discount | number | entry | 折扣额 |
| natdiscount | number | entry | 本币折扣额 |
| discountrate | number | entry | 扣率(%) |
| discountrate2 | number | entry | 扣率2(%) |
| natmoney | number | entry | 本币金额 |
| natunitprice | number | entry | 本币单价 |
| tax | number | entry | 税额 |
| nattax | number | entry | 本币税额 |
| natsum | number | entry | 本币价税合计 |
| ccontractid | string | entry | 合同编码 |
| free1 | string | entry | 自由项1 |
| free2 | string | entry | 自由项2 |
| free3 | string | entry | 自由项3 |
| free4 | string | entry | 自由项4 |
| free5 | string | entry | 自由项5 |
| free6 | string | entry | 自由项6 |
| free7 | string | entry | 自由项7 |
| free8 | string | entry | 自由项8 |
| free9 | string | entry | 自由项9 |
| free10 | string | entry | 自由项10 |
| define22 | string | entry | 单据体自定义项1 |
| define23 | string | entry | 单据体自定义项2 |
| define24 | string | entry | 单据体自定义项3 |
| define25 | string | entry | 单据体自定义项4 |
| define26 | number | entry | 单据体自定义项5 |
| define27 | number | entry | 单据体自定义项6 |
| define28 | string | entry | 单据体自定义项7 |
| define29 | string | entry | 单据体自定义项8 |
| define30 | string | entry | 单据体自定义项9 |
| define31 | string | entry | 单据体自定义项10 |
| define32 | string | entry | 单据体自定义项11 |
| define33 | string | entry | 单据体自定义项12 |
| define34 | number | entry | 单据体自定义项13 |
| define35 | number | entry | 单据体自定义项14 |
| define36 | date | entry | 单据体自定义项15 |
| define37 | date | entry | 单据体自定义项16 |
| bgift | number | entry | 是否赠品(0=非赠品;1=赠品) |
| rowno | number | entry | 行号 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"errmsg":"",
"errcode":"0",
"saleorder":{
"typecode":"01",
"memo":"OPENAPI测试",
"define1":"崔可",
"define2":null,
"state":"Opening",
"define3":null,
"define4":null,
"define5":null,
"define6":null,
"define16":null,
"date":"2015-09-14",
"define7":"0.0",
"define8":null,
"define9":null,
"dpredatebt":"2015-09-30",
"deptcode":"0302",
"deptname":"销售部",
"businesstype":"普通销售",
"dpremodatebt":"2015-09-14",
"code":"0000000234",
"cusabbname":"淘宝",
"define15":null,
"define14":null,
"define13":null,
"define12":null,
"define11":null,
"define10":null,
"personcode":"00040",
"cusname":"淘宝网",
"custcode":"0901",
"maker":"demo",
"verifier":"demo",
"closer":"demo",
"entry":[
{
"quotedprice":"100.0000000000",
"unitrate":null,
"unitname":"PCS",
"free1":null,
"free3":null,
"rowno":"1",
"free2":null,
"free5":null,
"sum":"2300.0000",
"free4":null,
"free7":null,
"free6":null,
"free9":null,
"free10":null,
"free8":null,
"define24":null,
"define23":null,
"define26":null,
"unitprice":"85.4700000000",
"define25":null,
"define22":null,
"inventoryname":"服务器-ATO",
"money":"1965.8100",
"quantity":"230.0000000000",
"inventorycode":"F010-80100001",
"unitcode":null,
"define29":null,
"define27":null,
"define28":null,
"taxunitprice":"100.0000000000",
"define33":null,
"define32":null,
"define31":null,
"num":null,
"invstd":"PR2510N(OEM)",
"define30":null,
"define37":null,
"define36":null,
"define35":null,
"define34":null
},
{
"quotedprice":"200.0000000000",
"unitrate":"50.000000",
"unitname":"个",
"free1":null,
"free3":null,
"rowno":"2",
"free2":null,
"free5":null,
"sum":"8400.0000",
"free4":null,
"free7":null,
"free6":null,
"free9":"白色",
"free10":null,
"free8":null,
"define24":null,
"define23":null,
"define26":null,
"unitprice":"170.9400000000",
"define25":null,
"define22":null,
"inventoryname":"智能手机",
"money":"7179.4900",
"quantity":"42.0000000000",
"inventorycode":"F010-S002",
"unitcode":"0502",
"define29":null,
"define27":null,
"define28":null,
"taxunitprice":"200.0000000000",
"define33":null,
"define32":null,
"define31":null,
"num":"0.840000000",
"invstd":null,
"define30":null,
"define37":null,
"define36":null,
"define35":null,
"define34":null
}
],
"typename":"普通销售",
"personname":"崔可"
}
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode" : "30021",
"errmsg" : "此应用未上线"
}