saleinvoice/get
目录 |
1.接口说明
1.1接口描述
获取单个单张销售发票
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
销售应用
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/saleinvoice/get |
| 格式 | JSON |
| https请求方式 | GET |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | sting | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| id | 是 | string | 销售发票ID |
3.3请求示例
GET https://api.yonyouup.com/api/saleinvoice/get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=26d2fc4a06844448957a7f8260f3d08b&id=xxxxx
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| invoiceno | string | 发票号 | |
| vouchertype | string | 单据类型 | |
| saletypecode | string | 销售类型编号 | |
| date | date | 日期 | |
| departmentcode | string | 部门编号 | |
| personcode | string | 职员编号 | |
| customercode | string | 客商编号 | |
| payconditioncode | string | 付款条件编码 | |
| foreigncurrency | string | 外币名称 | |
| memory | string | 备注 | |
| currencyrate | number | 汇率 | |
| taxrate | number | 税率 | |
| isnegative | number | 负发票-正发票 | |
| bankcode | string | 本单位开户银行编号 | |
| invoiceversion | string | 发票版别 | |
| maker | string | 制单人 | |
| businesstype | string | 业务类型 | |
| isfirst | boolean | 是否期初 | |
| itemclasscode | string | 项目大类编号 | |
| itemcode | 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 | |
| ispayedfirst | number | 1先发货；0先开票 | |
| customername | string | 综合开票客户名称 | |
| ccusaccount | string | 客户账号 | |
| cbaccount | string | 本单位账号 | |
| cdeliverunit | string | 收货单位名称 | |
| cdeliveradd | string | 收货地址 | |
| ccontactname | string | 收货联系人 | |
| cofficephone | string | 收货联系电话 | |
| cmobilephone | string | 收货联系手机 | |
| caddcode | string | 收获地址编码 | |
| cgatheringplan | string | 收付款协议编码 | |
| dcreditstart | date | 立账日 | |
| icreditdays | number | 账期 | |
| dgatheringdate | date | 到期日 | |
| bcredit | string | 是否立账单据 | |
| csource | string | 来源 | |
| ccusbank | string | 客户开户银行 | |
| csaleout | string | 出库单号 | |
| cdlcode | string | 发货单号 | |
| csocode | string | 销售单号 | |
| cstname | string | 销售类型编号 | |
| ccusabbname | string | 客户简称 | |
| cdepname | string | 部门编号 | |
| cpersonname | string | 职员名称 | |
| warehousecode | string | entry | 仓库编码 |
| inventorycode | string | entry | 存货编码 |
| quantity | number | entry | 数量 |
| number | number | entry | 件数 |
| quotedprice | number | entry | 报价 |
| originalprice | number | entry | 无税单价 |
| originaltaxedprice | number | entry | 含税单价 |
| originalmoney | number | entry | 无税金额 |
| originaltax | number | entry | 税额 |
| originalsum | number | entry | 价税合计 |
| originaldiscount | number | entry | 折扣额 |
| price | number | entry | 本币单价 |
| money | number | entry | 本币金额 |
| tax | number | entry | 本币税额 |
| sum | number | entry | 本币价税合计 |
| assistantunit | string | entry | 销售单位编码 |
| discount | number | entry | 本币折扣额 |
| memory | string | entry | 备注 |
| serial | string | entry | 批号 |
| amend | string | entry | 退补标志 |
| invaliddate | string | entry | 失效日期 |
| amendquantity | number | entry | 数量 |
| amendnumber | number | entry | 件数 |
| accountrate1 | number | entry | 扣率（%） |
| accountrate2 | number | entry | 扣率2（%） |
| inventoryname | string | entry | 存货名称 |
| taxrate | number | entry | 税率（%） |
| define22 | string | entry | 表体自定义项1 |
| define23 | string | entry | 表体自定义项2 |
| define24 | string | entry | 表体自定义项3 |
| define25 | string | entry | 表体自定义项4 |
| define26 | number | entry | 表体自定义项5 |
| define27 | number | entry | 表体自定义项6 |
| retailprice | number | entry | 零售单价 |
| retailmoney | number | entry | 零售金额 |
| itemclasscode | string | entry | 项目大类编码 |
| itemcode | string | entry | 项目编码 |
| itemname | string | entry | 项目名称 |
| itemclassname | 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 |
| 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 | string | entry | 表体自定义项15 |
| define37 | string | entry | 表体自定义项16 |
| batchproperty1 | number | entry | 批次属性1 |
| batchproperty2 | number | entry | 批次属性2 |
| batchproperty3 | number | entry | 批次属性3 |
| batchproperty4 | number | entry | 批次属性4 |
| batchproperty5 | number | entry | 批次属性5 |
| batchproperty6 | string | entry | 批次属性6 |
| batchproperty7 | string | entry | 批次属性7 |
| batchproperty8 | string | entry | 批次属性8 |
| batchproperty9 | string | entry | 批次属性9 |
| batchproperty10 | date | entry | 批次属性10 |
| exchangerate | number | entry | 换算率 |
| unitid | string | entry | 销售单位编码 |
| cmassunit | string | entry | 保质期单位 |
| imassdate | number | entry | 保质期 |
| dmdate | string | entry | 生产日期 |
| cordercode | string | entry | 订单号 |
| iorderrowno | number | entry | 订单行号 |
| cvmivencode | string | entry | 供货商编码 |
| irowno | number | entry | 行号 |
| expirationdate | string | entry | 有效期至 |
| expiratdatecalcu | number | entry | 有效期推算方式 |
| expirationitem | date | entry | 有效期计算项 |
| reasoncode | string | entry | 退货原因编码 |
| bsaleprice | number | entry | 报价含税 |
| bgift | number | entry | 赠品 |
| fcusminprice | number | entry | 最低售价 |
| cparentcode | string | entry | 父节点编码 |
| cchildcode | string | entry | 子节点编码 |
| icalctype | number | entry | 发货模式 |
| fchildqty | number | entry | 使用数量 |
| fchildrate | number | entry | 权重比例 |
| isaleoutid | number | entry | 出库单子表id |
| isosid | number | entry | 订单子表ID |
| idlsid | number | entry | 发货单子表id |
| cbsaleout | string | entry | 出库单号 |
| csocode | string | entry | 订单号 |
| cbdlcode | string | entry | 发货单号 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"saleinvoice":{
"isfirst":"0",
"bcredit":"否",
"csource":"销售",
"itemcode":"",
"foreigncurrency":"人民币",
"ccusabbname":"泰山数码",
"ispayedfirst":"1",
"departmentcode":"0302",
"cdepname":"销售部",
"currencyrate":"1.0",
"businesstype":"普通销售",
"ccontactname":"",
"dcreditstart":"",
"cmobilephone":"",
"saletypecode":"01",
"cdeliveradd":"北京市西城区杨柳胡同76号",
"invoiceno":"0000000001",
"cstname":"普通销售",
"cdlcode":"0000000001",
"cofficephone":"",
"customercode":"3011",
"define1":"崔可",
"define2":"",
"define3":"",
"cbaccount":"9800031344000",
"cpersonname":"崔可",
"define4":"",
"define5":"",
"define6":"",
"date":"2014-12-0100:00:00.0",
"define7":"",
"define16":"",
"define8":"",
"define9":"",
"icreditdays":"",
"taxrate":"17.0",
"bankcode":"001",
"cdeliverunit":"",
"itemclasscode":"",
"caddcode":"001",
"ccusaccount":"",
"customername":"泰山数码科技公司",
"dgatheringdate":"",
"invoiceversion":"",
"maker":"demo9",
"cgatheringplan":"",
"csocode":"0000000006",
"memory":"",
"define15":"",
"define14":"",
"define13":"",
"define12":"",
"isnegative":"0",
"define11":"",
"define10":"",
"personcode":"00040",
"entry":[
{
"expiratdatecalcu":"0",
"originalsum":"26400.0000",
"dmdate":"",
"exchangerate":"",
"inventoryname":"硬盘-1000G",
"quantity":"30.0000000000",
"originalprice":"752.1400000000",
"originaltax":"3835.9000",
"icalctype":"",
"define29":"",
"number":"",
"define27":"",
"define28":"",
"discount":"0.0000",
"define33":"",
"define32":"",
"define31":"",
"price":"752.1400000000",
"define30":"",
"tax":"3835.9000",
"define37":"",
"define36":"",
"batchproperty9":"",
"batchproperty8":"",
"define35":"",
"batchproperty7":"",
"define34":"",
"batchproperty6":"",
"batchproperty5":"",
"batchproperty4":"",
"batchproperty3":"",
"batchproperty2":"",
"batchproperty1":"",
"originalmoney":"22564.1000",
"free1":"",
"free3":"",
"free2":"",
"free5":"",
"free4":"",
"free7":"",
"free6":"",
"free9":"",
"free10":"",
"free8":"",
"cparentcode":"",
"isosid":"1000000067",
"define24":"",
"define23":"",
"define26":"",
"define25":"",
"iorderrowno":"1",
"itemname":"",
"fchildrate":"",
"define22":"",
"money":"22564.1000",
"itemclasscode":"",
"reasoncode":"",
"inventorycode":"01019002065",
"cbdlcode":"0000000003",
"csocode":"0000000024",
"imassdate":"",
"originaldiscount":"0.0000",
"cchildcode":"",
"warehousecode":"30",
"amendquantity":"30.0000000000",
"expirationdate":"",
"cvmivencode":"",
"itemcode":"",
"irowno":"1",
"cbsaleout":"",
"originaltaxedprice":"880.0000000000",
"assistantunit":"",
"itemclassname":"",
"batchproperty10":"",
"bsaleprice":"1",
"expirationitem":"",
"quotedprice":"880.0000000000",
"sum":"26400.0000",
"accountrate2":"100.0000000000",
"accountrate1":"100.0000000000",
"taxrate":"17.0000000000",
"idlsid":"1000000008",
"unitid":"",
"amendnumber":"",
"invaliddate":"",
"fchildqty":"",
"bgift":"0",
"retailprice":"0E-10",
"cmassunit":"",
"memory":"",
"isaleoutid":"",
"cordercode":"0000000024",
"fcusminprice":"0E-9",
"retailmoney":"0E-10",
"amend":"正常",
"serial":""
},
{
"expiratdatecalcu":"0",
"originalsum":"800000.0000",
"dmdate":"",
"exchangerate":"",
"inventoryname":"硬盘-1000G",
"quantity":"1000.0000000000",
"originalprice":"800.0000000000",
"originaltax":"0.0000",
"icalctype":"",
"define29":"",
"number":"",
"define27":"",
"define28":"",
"discount":"0.0000",
"define33":"",
"define32":"",
"define31":"",
"price":"800.0000000000",
"define30":"",
"tax":"0.0000",
"define37":"",
"define36":"",
"batchproperty9":"",
"batchproperty8":"",
"define35":"",
"batchproperty7":"",
"define34":"",
"batchproperty6":"",
"batchproperty5":"",
"batchproperty4":"",
"batchproperty3":"",
"batchproperty2":"",
"batchproperty1":"",
"originalmoney":"800000.0000",
"free1":"",
"free3":"",
"free2":"",
"free5":"",
"free4":"",
"free7":"",
"free6":"",
"free9":"",
"free10":"",
"free8":"",
"cparentcode":"",
"isosid":"",
"define24":"",
"define23":"",
"define26":"",
"define25":"",
"iorderrowno":"",
"itemname":"",
"fchildrate":"",
"define22":"",
"money":"800000.0000",
"itemclasscode":"",
"reasoncode":"",
"inventorycode":"01019002065",
"cbdlcode":"0000000005",
"csocode":"",
"imassdate":"",
"originaldiscount":"0.0000",
"cchildcode":"",
"warehousecode":"30",
"amendquantity":"1000.0000000000",
"expirationdate":"",
"cvmivencode":"",
"itemcode":"",
"irowno":"1",
"cbsaleout":"",
"originaltaxedprice":"800.0000000000",
"assistantunit":"",
"itemclassname":"",
"batchproperty10":"",
"bsaleprice":"1",
"expirationitem":"",
"quotedprice":"800.0000000000",
"sum":"800000.0000",
"accountrate2":"100.0000000000",
"accountrate1":"100.0000000000",
"taxrate":"0E-10",
"idlsid":"1000000010",
"unitid":"",
"amendnumber":"",
"invaliddate":"",
"fchildqty":"",
"bgift":"0",
"retailprice":"0E-10",
"cmassunit":"",
"memory":"",
"isaleoutid":"",
"cordercode":"",
"fcusminprice":"0E-9",
"retailmoney":"0E-10",
"amend":"正常",
"serial":""
}
],
"ccusbank":"",
"csaleout":"",
"payconditioncode":"",
"vouchertype":"27"
},
"errmsg":"",
"errcode":"0"
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode":"30021",
"errmsg":"此应用未上线"
}