1.1进项底账库发票查询（共享本地缓存）

POST

https://api2.htjs.net/csxxh/skgxfw-api-master-api-saas/api/jxgl/v2/jxfp.do

接口说明：查询底账库发票数据
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

appid

string

企业授权应用标识

必需

全局唯一

serviceid

string

接口类型编号

必需

区分业务类型，JX1080

signType

string

签名方式 (0-HmacSHA256,1-MD5 3, 不加密)

必需

0：HmacSHA256
1：MD5
3：不签名

signature

string

签名值

可选

signType为0和1时必填

content

object

报文主体

必需

Base64编码

qsrq

string

开始日期 (开票日期或者勾选日期), 格式 yyyy-MM-dd (可选)

可选

zzrq

string

截止日期 (开票日期或者勾选日期), 格式 yyyy-MM-dd (可选)

可选

rqlx

string

日期类型；0, 开票日期 1，勾选日期 (可选)

可选

fpdm

string

发票代码 (可选)

可选

fphm

string

发票号码 (可选)

可选

fplxdm

string

发票类型代码 (31, 全电发票 (专用发票，32 全电发票 (普通发票))

可选

004-增值税专用发票；
005-机动车销售统一发票；
006-二手车销售统一发票;
007-增值税普通发票;
025-增值税普通发票(卷票);
026-增值税电子普通发票;
028-电子专票;
092-通行费发票,
31-电子发票(增值税专用发票）
32-电子发票(普通发票)
51-电子发票（铁路电子客票）
61-电子发票（航空运输客票电子行程单）
17-海关缴款书
85-纸质发票（增值税专用发票）
86-纸质发票（普通发票）

gfsh

string

购方税号 (必传)

必需

xfsh

string

销方税号 (可选)

可选

xfmc

string

销方名称 (可选)

可选

gxzt

string

勾选状态

可选

0,未勾选，1 已勾选

sssq

string

所属税期 (可选) 格式 yyyyMM

可选

page

string

分页页码 (必传)，排序规则以开票日期降序排列

必需

limit

string

1000，最大每页 1000 条数据

可选

示例

{
	"appid": "企业应用标识", //企业授权应用标识
	"serviceid": "JX1080", //接口编号
	"signType": "签名方式(0-HmacSHA256,1-MD5 3,不加密)",
	"signature": "签名值", 
	"content": {
		"qsrq":"开始日期(开票日期或者勾选日期),格式yyyy-MM-dd(可选)",
    	"zzrq":"截止日期(开票日期或者勾选日期),格式yyyy-MM-dd(可选)",
    	"rqlx":"日期类型; 0,开票日期 1，勾fpsbCySaveByFile.do选日期(可选)",
    	"fpdm":"发票代码(可选)",
    	"fphm":"发票号码(可选)",
    	"fplxdm":"发票类型代码 (31,全电发票(专用发票，32 全电发票(普通发票))",
    	"gfsh":"购方税号(必传)",
    	"xfsh":"销方税号(可选)",
    	"xfmc":"销方名称(可选)",
    	"gxzt":"勾选状态(可选)",
    	"sssq":"所属税期(可选)格式yyyyMM",
    	"page":"分页页码(必传)，排序规则以开票日期降序排列",
    	"limit":"1000，最大每页1000条数据"
	}
}

示例代码

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/api/jxgl/v2/jxfp.do' \
--header 'Date;' \
--header 'host;' \
--header 'x-htjs-nonce;' \
--header 'x-htjs-ua;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
	"appid": "企业应用标识", //企业授权应用标识
	"serviceid": "JX1080", //接口编号
	"signType": "签名方式(0-HmacSHA256,1-MD5 3,不加密)",
	"signature": "签名值", 
	"content": {
		"qsrq":"开始日期(开票日期或者勾选日期),格式yyyy-MM-dd(可选)",
    	"zzrq":"截止日期(开票日期或者勾选日期),格式yyyy-MM-dd(可选)",
    	"rqlx":"日期类型; 0,开票日期 1，勾fpsbCySaveByFile.do选日期(可选)",
    	"fpdm":"发票代码(可选)",
    	"fphm":"发票号码(可选)",
    	"fplxdm":"发票类型代码 (31,全电发票(专用发票，32 全电发票(普通发票))",
    	"gfsh":"购方税号(必传)",
    	"xfsh":"销方税号(可选)",
    	"xfmc":"销方名称(可选)",
    	"gxzt":"勾选状态(可选)",
    	"sssq":"所属税期(可选)格式yyyyMM",
    	"page":"分页页码(必传)，排序规则以开票日期降序排列",
    	"limit":"1000，最大每页1000条数据"
	}
}'

返回响应

🟢200成功

application/json

Body

code

string

操作状态代码，0 代表成功

必需

0成功，其它失败

msg

string

操作结果描述

必需

成功/失败

content

object

必需

pageNum

integer

当前页码

必需

total

integer

数据总条数

必需

pages

integer

总页数

必需

list

array [object {14}]

必需

示例

{
  "code": "0",
  "msg": "成功",
  "content": {
    "pageNum": 1,
    "total ": 1556,
    "pages": 2,
    "list": [
      {
        "gfmc": "购方名称",
        "gfsh": "购方税号",
        "xfmc": "销方名称",
        "xfsh": "销方税号",
        "kprq": "开票日期(yyyy-MM-dd)",
        "fpdm": "发票代码",
        "fphm": "发票号码",
        "fplxdm": "发票类型代码",
        "hjje": "不含税金额",
        "sssq": "所属税期",
        "se": "税额",
        "hsje": "含税金额",
        "gxzt": "勾选状态",
        "gxrq": "勾选日期"
      }
    ]
  }
}

修改于 2025-03-25 02:34:11

公共参数说明

1.2 发票勾选/撤销勾选