saleinvoicelist/batch_get
目录 |
1.接口说明
1.1接口描述
获取销售发票列表
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
销售应用
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/saleinvoicelist/batch_get |
| 格式 | JSON |
| https请求方式 | GET |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | sting | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| invoiceno_begin | 否 | string | 起始销售发票号 |
| invoiceno_end | 否 | string | 结束销售发票号 |
| ccusname | 否 | string | 客户名称关键字 |
| cstname | 否 | string | 销售类型 |
| csocode | 否 | string | 销售单号 |
| cdlcode | 否 | string | 发货单号 |
| vouchertype | 否 | string | 单据类型 |
| saletypecode | 否 | string | 销售类型编号 |
| date_begin | 否 | date | 起始日期 |
| date_end | 否 | date | 结束日期 |
| departmentcode | 否 | string | 部门编号 |
| personcode | 否 | string | 职员编号 |
| customercode | 否 | string | 客商编号 |
| isnegative | 否 | number | 负发票-正发票 |
| 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 |
| csource | 否 | string | 来源 |
| csaleout | 否 | string | 出库单号 |
| ccusabbname | 否 | string | 客户简称关键字 |
| cdepname | 否 | string | 部门关键字 |
| cpersonname | 否 | string | 职员名称关键字 |
3.3请求示例
GET https://api.yonyouup.com/api/saleinvoicelist/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=26d2fc4a06844448957a7f8260f3d08b&invoiceno_begin=xxxxx&invoiceno_end=xxxxx&ccusname=xxxxx&cstname=xxxxx&csocode=xxxxx&cdlcode=xxxxx&vouchertype=xxxxx&saletypecode=xxxxx&date_begin=xxxxx&date_end=xxxxx&departmentcode=xxxxx&personcode=xxxxx&customercode=xxxxx&isnegative=xxxxx&maker=xxxxx&businesstype=xxxxx&isfirst=xxxxx&itemclasscode=xxxxx&itemcode=xxxxx&define1=xxxxx&define2=xxxxx&define3=xxxxx&define4=xxxxx&define5=xxxxx&define6=xxxxx&define7=xxxxx&define8=xxxxx&define9=xxxxx&define10=xxxxx&define11=xxxxx&define12=xxxxx&define13=xxxxx&define14=xxxxx&define15=xxxxx&define16=xxxxx&csource=xxxxx&csaleout=xxxxx&ccusabbname=xxxxx&cdepname=xxxxx&cpersonname=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 | 职员名称 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"page_index":"1",
"rows_per_page":"20",
"row_count":"86",
"errmsg":"",
"errcode":"0",
"page_count":"5",
"consignmentlist":[
{
"csbvcode":"0000000052",
"ddate":"2014-12-2700:00:00.000",
"cbustype":"普通销售",
"cstname":"电子商务",
"breturnflag":"0",
"cstcode":"0010",
"csocode":"0000000087",
"cdlcode":"0000000054",
"ccusabbname":"京东商城",
"cdepname":"电子商务",
"cpersoncode":"030401",
"cpersonname":"何彤",
"cexch_name":"人民币",
"iexchrate":"1",
"money":"255.5600",
"tax":"43.4400",
"sum":"299.0000"
},
{
"csbvcode":"0000000052",
"ddate":"2014-12-2700:00:00.000",
"cbustype":"普通销售",
"breturnflag":"0",
"cstcode":"0010",
"cstname":"电子商务",
"csocode":"0000000087",
"cdlcode":"0000000054",
"ccusabbname":"京东商城",
"cdepname":"电子商务",
"cpersoncode":"030401",
"cpersonname":"何彤",
"cexch_name":"人民币",
"iexchrate":"1",
"money":"255.5600",
"tax":"43.4400",
"sum":"299.0000"
}
]
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode":"30021",
"errmsg":"此应用未上线"
}