发票勾选
接口描述
企业当前属期,如有需要抵扣认证的进项发票,可以通过该接口将需要勾选认证的发票发送认证。
请求方式
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 | 否 | 发票代码,增值税发票时,不为空; |
+ 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 | 失败原因 |