票据查验

  • url:/common/invoiceCheck/check
  • method:post
  • 数据格式:json

请求参数

字段名称 字段类型 字段描述 是否必填 长度限制 说明
bizId String 业务唯一识别码 true 36
timestamp Long 当前次接口同步时间对应的时间戳 true 13
invoice_code String 发票代码 false NA
invoice_num String 发票号码 true NA
receipt_date String 发票日期 true NA yyyyMMdd
check_code String 校验码 false NA
amount BigDecimal 金额 false NA
force Boolean 是否强制查验 false NA Y/N

返回参数

字段名称 字段类型 字段描述
resCode Integer 响应状态码(见附录)
resMsg String 返回信息描述
data.result Integer 请求状态. 1:成功
data.error String 错误码
data.message String 信息说明
data.check_date Date 最后查验日期
data.invoice_type String 发票类型
data.invoice_code String 发票号码
data.receipt_date Date 发票日期
data.check_code String 校验码
data.total_amount BigDecimal 价税合计
data.amount BigDecimal 金额
data.tax_amount BigDecimal 税额
data.remark String 备注
data.buyer_name String 购方名称
data.buyer_tax_code String 购方税号
data.buyer_address_phone String 购方地址、电话
data.buyer_account String 购方开户行及账号
data.seller_name String 销方名称
data.seller_tax_code String 销方税号
data.seller_address_phone String 销方地址、电话
data.seller_account String 销方开户行及账号
data.cancellation_mark String 作废标识
data.repeat_flag String 是否已查验
data.log_id Long 日志表id
data.detailList List 明细行

上表中detailList

字段名称 字段类型 字段描述
name String 货物名称
specification String 规格型号
unit String 单位
total_amount BigDecimal 价税合计
amount BigDecimal 金额
tax_amount BigDecimal 税额
price BigDecimal 不含税单价
quantity String 数量
tax_rate BigDecimal 税率

请求示例

{
  "bizId": "xx",
  "timestamp": 123,
  "data": {
    "invoice_code": "",
    "invoice_num": "xx",
    "receipt_date": "20230201",
    "amount": 10
  }
}

返回示例

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "xx",
  "data": {
      "result": 1,
      "invoiceType": "10",
      "invoiceCode": "xx",
      "invoiceNum": "xx",
      "receiptDate": 1712707200000,
      "checkCode": "xx",
      "totalAmount": 996.00,
      "amount": 913.76,
      "taxAmount": 82.24,
      "remark": "",
      "buyerName": "xx",
      "buyerTaxCode": "xx",
      "buyerAddressPhone": "xx 0518-83096666",
      "buyerAccount": "xx",
      "sellerName": "xx",
      "sellerTaxCode": "xx",
      "sellerAddressPhone": "xx",
      "sellerAccount": "xx",
      "cancellationMark": "N",
      "detailList": [
        {
          "name": "xx",
          "specification": "xx",
          "unit": "xx",
          "amount": 913.76,
          "price": 152.293333,
          "quantity": 6
        }
      ],
      "logId": 0
    }
}

results matching ""

    No results matching ""