发票勾选
接口描述
企业当前属期,如有需要抵扣认证的进项发票,可以通过该接口将需要勾选认证的发票发送认证。
请求方式
POST
请求地址
URL 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| Action | String | 是 | 操作的接口名称,本接口取值:Tax.Input.CheckInvoices |
Header 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| Timestamp | String | 是 | 公共参数。 |
| SecretId | String | 是 | 公共参数。 |
| Signature | String | 是 | 公共参数。 |
| Algorithm | String | 否 | 公共参数。 |
| Content-Type | String | 是 | 取值:application/json |
Body 请求参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| taxpayerNumber | String | 是 | 纳税人识别号 |
| period | String | 是 | 税款所属期,YYYYMM |
| invoiceType | Integer | 否 | 0:增值税发票 1:海关缴款书,默认 0 |
| deductibleMode | Integer | 否 | 1:抵扣勾选;(默认为1);-1:取消抵扣勾选;4:不抵扣勾选;-4:取消不抵扣勾选; |
| deductibleStep | Integer | 否 | 退税认证使用,其他不用传该字段。 1:退税勾选 -1:取消退税勾选 2:查询确认汇总信息 3:确认退税勾选 不传则默认自动退税勾选并确认 |
| invoices | [] | 是 | 票据列表,最多100张发票 |
| + invoiceNum | String | 是 | 发票号码 |
| + invoiceCode | String | 否 | 发票代码,增值税发票时,不为空; |
| + electronicNum | String | 否 | 数电票号码,数电纸质发票,不为空; |
| + invoiceDate | String | 否 | 开票日期;yyyy-MM-dd格式 (不进行数据同步直接勾选必传) |
| + validTax | String | 否 | 有效税额 ,默认整张发票税额(不超过该发票税额)如果本次只认证部分税额,之后该票剩余税额将不能继续认证。 |
| + notDeductibleType | String | 否 | 认证模式=4时(不抵扣勾选时需要)需要传。不传则默认5 1:用于非应税项目 2:用于免税项目 3:用于集体福利或者个人消费 4:遭受非正常损失 5:其他 |
返回参数
公共返回参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| code | Integer | 200 表示请求成功 |
| message | String | 错误提示信息 |
| startTime | long | 开始时间 |
| endTime | long | 结束时间 |
| callId | long | 调用记录标识 |
| data | {} | 返回数据 |
data 内容说明
| 参数名称 | 类型 | 说明 |
|---|---|---|
| success | boolean | 是否成功,true:成功;false:失败 |
| checkResult | [] | 勾选结果信息 |
| + invoiceNum | String | 发票号码 |
| + invoiceCode | String | 发票代码 |
| + checkResult | boolean | 是否勾选成功,true:勾选成功/取消勾选成功;false:勾选失败/取消勾选失败 |
| + checkErrorMsg | String | 失败原因 |