2、发票归集
## 1.申请发票归集(发起任务)
#### 接口地址:
/open/ct/api/v1/invoice/gj
#### 请求方式:POST
>d 该接口用于申请企业指定开票月份、发票类型、进销项发票归集任务,或者获取发票归集任务的状态。(仅支持托管模式)
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|eno|办税人员编码|String|是|托管模式下,用办税小号登录时返回的办税人员编码|
|kpyfq|开票月份起|String|是|必填,202011,格式yyyyMM|
|kpyfz|开票月份止|String|是|必填,202011,格式yyyyMM|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
| taskId |任务id|String|是|用于主动查询结果|
## 2.获取发票归集数据
>d 该接口用于归集企业指定开票月份的进销项发票,需要在发票归集任务处理成功之后调用
#### 接口地址:
/open/ct/api/v1/invoice/gj/query
#### 请求方式:POST
解密结果示例如下:
```json
{
"page": {
// 分页信息,当分页信息参数没有传时不返回
"pageSize": 20,
"currentPage": 1,
"totalPage": 1, // 总页数
"totalCount": 18 // 总记录数
},
"list": [
{
// 发票信息列表
"fpdm": "******2130", // 发票代码
"fphm": "****7366", // 发票号码
"kprq": "2020-10-09 14:58:24", // 开票日期
"jym": "************16055866", // 校验码
"xfsbh": "************73086B", // 销售方识别号
"xfmc": "东莞市XX有限公司", // 销售方名称
"xsfdzdh": "******居民社区", // 销售方地址电话
"xsfyhzh": "************公司常平支行", // 销售方银行账号
"gfsbh": "************752601", // 购买方识别号
"gfmc": "XX(惠州)有限公司", // 购买方名称
"gmfdzdh": "******罗阳镇", // 购买方地址电话
"gmfyhzh": "******博罗县支行", // 购买方银行账号
"skm": "", // 税控码/密码区
"je": 792.92, // 金额
"se": 103.08, // 税额
"jshj": 896.0, // 价税合计
"bz": "", // 备注
"kpr": "**霞", // 开票人
"skr": "**娟", // 收款人
"fhr": "**如", // 复核人
"tspzDm": "", // 特殊票种代码,02农产品收购发票
"fpztDm": "0", // 发票状态代码
"hwxx": [
{
// 货物信息列表
"mxxh": 1, // 明细序号
"spbm": "1099900000000000000", // 税局编码/税收分类编码
"mc": "*其他机械设备*触控式拉力试验机(步进电机)", // 货物劳务名称
"ggxh": "", // 规格型号
"sl": "1", // 数量
"jldw": "台", // 计量单位
"dj": "792.920353982300885", // 单价
"slv": 0.13, // 税率
"se": 103.08, // 税额
"je": 792.92, // 金额
"qdbz": "00", // 清单标识
"hsdj": "1.23", //-含税单价(卷票的字段)
"hsje": "30.35" ////含税金额(卷票的字段)
}
],
"xhqdBz": "N", // 销货清单标识
"kjlx": "1",
"kpjh": "499911561971",
"tslsh": "4400202010091500214345202117", // 推送流水号
"kpyf": 202010, // 开票月份
"xfDsswjgDm": "144190000", // 销方地市税务机关代码
"xfQxswjgDm": "144192100", // 销方区县税务机关代码
"xfSjswjgDm": "144000000" // 销方省级税务机关代码
}
]
}
```
#### 请求参数说明:
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
| taskId |任务id|String|是|用于主动查询结果|
#### 接口响应参数data字段解密后的参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|page|分页信息|object {4}| 是||
|pageSize|分页大小|string| 是||
|currentPage| 当前页|string| 是||
|totalPage|总页数|string| 是||
|totalCount|总记录数|string| 是||
|list|发票信息列表|string| 是||
|fpdm|发票代码|string| 是||
|fphm|发票号码|string| 是||
|sdphm|数电票号码|string| 是||
|kprq|开票日期|string| 是||
|jym|校验码|string| 是||
|xfsbh|销方识别号|string| 是||
|xfmc|销方名称|string| 是||
|xsfdzdh|销售方地址电话|string| 是||
|xsfyhzh|销售方银行账号|string| 是||
|gfsbh|购方识别号|string| 是||
|gfmc|购方名称|string| 是||
|gmfdzdh|购买方地址电话|string| 是||
|gmfyhzh|购买方银行账号|string| 是||
|skm|密码区|string| 是||
|je|金额|string| 是||
|se|税额|string| 是||
|jshj|价税合计|string| 是||
|bz|备注|string| 是||
|kpr|开票人|string| 是||
|skr|收款人|string| 是||
|fhr|复核人|string| 是||
|tspzDm|特殊票种代码|string| 是||
|fpztDm|发票状态代码|string| 是||
|hwxx|货物信息|array [object {14}]| 是||
|mxxh|明细序号|string| 是||
|spbm|税局编码/税收分类编码|string| 是||
|mc|货物劳务名称|string| 是||
|ggxh|规格型号|string| 是||
|sl|数量|string| 是||
|jldw|计量单位string| 是||
|dj|单价|string| 是||
|slv|税率|string| 是||
|se|税额|string| 是||
|je|金额|string| 是||
|qdbz|清单标志|string| 是||
|hsdj|含税单价|string| 是||
|hsje|含税金额|string| 是||
|lslbs|零税率标识|string| 是|空:非零税率,0:出口零税,1:免税,2:不征税,3 普通零税率|
|xhqdBz|销户清单标志|string| 是||
|kjlx|开具类型|string| 是|1.自开 2.代开 3.代办退税|
|kpjh|盘号|string| 是||
|tslsh|推送流水号|string| 是||
|kpyf|开票月份|string| 是||
|xfDsswjgDm|销方地市税务机关代码|string| 是||
|xfQxswjgDm|销方区县税务机关代码|string| 是||
|xfSjswjgDm|销方省级税务机关代码|string| 是||
|fply|发票来源|string| 是|增值税发票管理系统,电子发票服务平台|
|fpfxdj|发票风险等级|string| 是||
|tdywlx|特定业务类型|string| 是|特定业务类型("01":"成品油发票","02":"稀土发票","03":"建筑服务发票","04":"货物运输服务发票","05":"不动产销售服务发票","06":"不动产经营租赁服务", "07": "代收车船税","08":"通行费","09":"旅客运输服务发票","10":"医疗服务(住院)发票","11":"医疗服务(门诊)发票","12":"自产农产品销售发票", "13":"拖拉机和联合收割机发票","14":"机动车","15":"二手车","16":"农产品收购发票","17":"光伏收购发票","18":"卷烟发票","19":"出口发票","20":"农产品")|