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" : "此应用未上线" }