1.17发票数据保存

POST

https://api2.htjs.net/csxxh/skgxfw-api-master-api-saas/fpsb/save/cjxx

接口说明：用于第三方系统对接，根据发票文件自动识别发票信息，查验及保存。查验不通过数据不保存。
Content-Type：application/json

请求参数

Header 参数

Content-Type

string

必需

默认值:

application/json

Date

string

必需

默认值:

host

string

必需

默认值:

x-htjs-nonce

string

必需

默认值:

x-htjs-ua

string

必需

默认值:

Authorization

string

必需

默认值:

Body 参数application/json

invoiceType

string

发票类型代码

必需

10000 其他
10100 增值税专用发票
10101 增值税普通发票
10102 增值税电子普通发票
10103 增值税普通发票（卷票）
10104 机动车销售统一发票
10105 二手车销售统一发票
10106 增值税发票销货清单
10107 增值税电子专用发票
10108 区块链发票
1010901 电子发票（增值税专用发票）
1010902 电子发票（普通发票）
1010903 电子发票（铁路电子客票）
1010904 电子发票（航空运输电子客票行程单）
10200 火车票
10201 出租车票
10202 飞机行程单
10203 客运票
10204 通行费发票
10300 定额票
10400 通用机打发票
10500 购物小票
10600 通用手工发票
10601 政府非税收入
10602 知识产权收费收据
10603 景区门票
10604 完税证明

invoiceTypeName

string

发票种类名称

必需

invoiceCode

string

发票代码

必需

invoiceNo

string

发票号码

必需

invoiceDate

string

开票时间

必需

checkCode

string

校验码

必需

sellerTaxId

string

销方税号

可选

sellerName

string

销方名称

可选

sellerAddress

string

销方地址电话

可选

sellerBankInfo

string

销方开户行及账号

可选

buyerTaxId

string

购方税号

可选

buyerName

string

购方名称

可选

buyerAddress

string

购方地址电话

必需

buyerBankInfo

string

购方开户行及账号

必需

amountLittle

number

价税合计

必需

保留两位小数

pretaxAmount

number

合计金额

必需

不含税金额，保留两位小数

taxAmount

number

合计税额

必需

保留两位小数

number

税率

必需

单税率则传，多税率不传，保留两位小数，示例0.13

string

备注

必需

发票备注信息

nsrsbh

string

纳税人识别号

必需

sfcyfg

string

是否查验替换

必需

detilList

array [object {10}]

商品服务明细

必需

serialnumber

string

商品明细序号

必需

有值，从1开始，且有序

goodsname

string

货物或应税劳务、服务名称

可选

spbm

string

货物或应税劳务、服务编码

可选

specifications

string

规格型号

可选

measureunits

string

单位

可选

numbers

string

数量

可选

notaxprice

string

不含税单价

可选

goodsamount

string

合计金额

可选

taxrate

string

税率

可选

goodstaxamount

string

税额

可选

示例

{
  "invoiceType": "1010901",
  "invoiceCode": "",
  "invoiceNo": "23122000000004239643",
  "invoiceDate": "2023-07-12",
  "checkCode": "",
  "sellerTaxId": "9112011668188834X4",
  "sellerName": "易生支付有限公司",
  "sellerAddress": "",
  "sellerBankInfo": "",
  "buyerTaxId": "91310000MABUR1QW1R",
  "buyerName": "上海盛高物业服务有限公司桐乡分公司",
  "buyerAddress": "",
  "buyerBankInfo": "",
  "amountLittle": 577.74,
  "pretaxAmount": 545.04,
  "taxAmount": 32.7,
  "sl": 0.06,
  "bz": "2023年6月",
  "nsrsbh": "91310000MABUR1QW1R",
  "sfcyfg": "0",
  "detilList": [
    {
      "goodsname": "*信息技术服务*技术服务费",
      "spbm": "",
      "specifications": "",
      "measureunits": "位",
      "numbers": "0.000000",
      "notaxprice": "545.037736",
      "goodsamount": "545.04",
      "taxrate": "0.06",
      "goodstaxamount": "32.70"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api2.htjs.net/csxxh/skgxfw-api-master-api-saas/fpsb/save/cjxx' \
--header 'Date;' \
--header 'host;' \
--header 'x-htjs-nonce;' \
--header 'x-htjs-ua;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "invoiceType": "1010901",
    "invoiceCode": "",
    "invoiceNo": "23122000000004239643",
    "invoiceDate": "2023-07-12",
    "checkCode": "",
    "sellerTaxId": "9112011668188834X4",
    "sellerName": "易生支付有限公司",
    "sellerAddress": "",
    "sellerBankInfo": "",
    "buyerTaxId": "91310000MABUR1QW1R",
    "buyerName": "上海盛高物业服务有限公司桐乡分公司",
    "buyerAddress": "",
    "buyerBankInfo": "",
    "amountLittle": 577.74,
    "pretaxAmount": 545.04,
    "taxAmount": 32.7,
    "sl": 0.06,
    "bz": "2023年6月",
    "nsrsbh": "91310000MABUR1QW1R",
    "sfcyfg": "0",
    "detilList": [
        {
            "goodsname": "*信息技术服务*技术服务费",
            "spbm": "",
            "specifications": "",
            "measureunits": "位",
            "numbers": "0.000000",
            "notaxprice": "545.037736",
            "goodsamount": "545.04",
            "taxrate": "0.06",
            "goodstaxamount": "32.70"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

string

返回代码

必需

1 成功 -1异常-2 参数异常

data

object

返回结果对象

必需

invoiceId

string

发票id

必需

uuid

msg

string

提示信息

必需

示例

{
  "code": "0/-1/-2",
  "data": {
    "invoiceId": ""
  },
  "msg": "结果说明"
}

修改于 2025-03-25 02:35:53

1.16发票文件识别保存

1.18单张发票版式获取