4.05 发票勾选/撤销勾选

POST/kapi/app/rim/deduction

注意：若在星瀚基础资料-企业信息-收票通道设置为“新电子发票服务平台”，即RPA通道进行勾选，需要减少勾选的频率，尽量合并多张发票一起提交勾选，否则有可能触发税局安全机制，导致勾选失败

请求参数

Query 参数

access_token

string

必需

access_token

businessSystemCode

string

必需

对接业务系统来源编码，用于区分不同业务系统的回调接口

interfaceCode

enum<string>

必需

接口编码，固定值：invoiceSelect

枚举值:

invoiceSelect

requestId

string

可选

当前13位毫秒级时间戳加3位随机数字(总共16位)

data

object

必需

需要把data的值加密成字符串，默认为base64

authenticateFlag

number

必需

勾选标志，1：勾选，0：撤销勾选

taxNo

string

企业税号

必需

deductionPurpose

enum<string>

必需

抵扣用途，1：抵扣，2：不抵扣，3：退税

枚举值:

123

billType

enum<string>

必需

发票单据类型（增值税发票和海关缴款书分开调接口）

枚举值:

默认值:

asyncFlag

string

可选

异步标志:0-同步（默认），1-异步

invoices

array [object {11}]

发票数组

必需

{
  "businessSystemCode": "string",
  "interfaceCode": "invoiceSelect",
  "requestId": "string",
  "data": {
    "authenticateFlag": 0,
    "taxNo": "string",
    "deductionPurpose": "1",
    "billType": "0",
    "asyncFlag": "string",
    "invoices": [
      {
        "invoiceType": "4",
        "invoiceCode": "string",
        "invoiceNo": "string",
        "etaxInvoiceNo": "string",
        "invoiceDate": "2022-06-11",
        "invoiceAmount": "string",
        "effectiveTaxAmount": "string",
        "totalTaxAmount": "string",
        "notDeductibleType": "1",
        "salerName": "string",
        "salerTaxNo": "string"
      }
    ]
  }
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

errorCode

string

必需

响应码，0000-成功

message

string

响应描述

必需

success

boolean

请求是否成功

必需

data

object

必需

返回内容data，需要解密，默认为base64

asyncFlag

string

可选

异步标志:0-同步（默认），1-异步

taskNo

string

可选

异步任务号（asyncFlag=1时返回）

success

array [object {9}]

成功发票数组

必需

fail

array [object {5}]

失败发票数组

必需

未设置

最后修改时间： 24 天前