开票管理

发票下载（金四）

开发中

POST

https://skynjweb.com:7443/hx/api/fp/h5.js.invoice.download

请求参数

Header 参数

nsrsbh

string

接口调用方税号

可选

access_token

string

可选

通过“获取access_token”接口获取，除“获取access_token”接口外，其余接口访问均需携带此参数

Body 参数application/json

fp_hm

string

发票号码

必需

20 位的数电发票号码

<= 20 字符

kprq

string

开票日期

必需

yyyymmddhhmmss

<= 14 字符

isurl_flag

string

是否返回短链接

可选

不定否传字符串 true 时返回短链接（需要保证当前账号在已登录已认证状态未登录会返回空字符串）

xzlx

string

下载类型

必需

0:下载 PDF1:下载 OFD2:下载 XML

<= 1 字符

online

string

是否获取离线版式文件

可选

online 为 0 或空为获取税局版式文件；为 1时获取离线版式生成；为 2 时离线下载税局文件

<= 1 字符

return_type

string

返回类型

可选

不填默认按原逻辑返回，传1返回税局下载地址

<= 1 字符

dqbm

string

地区编码

可选

登录地区地区编码，如果返回类型为 1，地区编码不可为空online 为 2 时必填

<= 4 字符

xsfnsrsbh

string

销售方纳税人识别号

可选

online 为 2 时必填

<= 20 字符

nsrsbh

string

纳税人识别号

可选

online 为 2 时必填

<= 20 字符

jshj

string

价税合计

可选

<= 16 字符

示例

{
    "fp_hm": "string",
    "kprq": "string",
    "isurl_flag": "string",
    "xzlx": "s",
    "online": "s",
    "return_type": "s",
    "dqbm": "stri",
    "xsfnsrsbh": "string",
    "nsrsbh": "string",
    "jshj": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://skynjweb.com:7443/hx/api/fp/h5.js.invoice.download' \
--header 'nsrsbh;' \
--header 'access_token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fp_hm": "string",
    "kprq": "string",
    "isurl_flag": "string",
    "xzlx": "s",
    "online": "s",
    "return_type": "s",
    "dqbm": "stri",
    "xsfnsrsbh": "string",
    "nsrsbh": "string",
    "jshj": "string"
}'

返回响应

🟢200成功

application/json

Body

wjl

string

文件流

可选

jfdljUrl

string

交付短链接

可选

不定长否 isurl_flag 为 true 时返回值

pdfUrl

string

pdf下载地址

可选

ofdUrl

string

ofd下载地址

可选

xmlUrl

string

xml下载地址

可选

示例

{
    "wjl": "Base64文件流",
    "jfdljUrl": "交付短链接",
    "pdfUrl": "pdf下载地址",
    "ofdUrl": "ofd下载地址",
    "xmlUrl": "xml 下载地址"
}

修改于 2025-05-30 10:56:29

单张发票查询（蓝\红票）（金四）

红字确认单开具接口（金三+金四）