5004-下载发票版式文件

请求参数

Header 参数

SID

string

对应接口方法编号

可选

示例值:

5004

Authorization

string

可选

获取token接口返回token类型加token

示例值:

bearer token

Body 参数application/json

invoiceSerialNumber

string <uuid>

invoiceSerialNumber（发票请求流水号）和invoiceNum（发票号码）二选一必填

可选

发票唯一标识。长度不能超过64个字符，且不能为中文。

invoiceNum

string

invoiceSerialNumber（发票请求流水号）和invoiceNum（发票号码）二选一必填

可选

creditCode

string

纳税人识别号/统一社会信用代码

必需

正则匹配:

^[^_IOZSVa-z\W]{2}\d{6}[^_IOZSVa-z\W]{10}$

pdfFile

string

pdf文件

可选

1-下载，0-不下载。不传时，默认1-下载。

ofdFile

string

ofd文件

可选

1-下载，0-不下载。不传时，默认0-不下载。

xmlFile

string

xml文件

可选

1-下载，0-不下载。不传时，默认0-不下载。

示例

{
    "invoiceSerialNumber": "4f76fBfc-c9CD-AF0b-57bD-CB4cDAcF16Fb",
    "creditCode": "RG209268DUCP27N3AL",
    "pdfFile": "tempor",
    "ofdFile": "consectetur magna",
    "xmlFile": "aliqua fugiat eiusmod culpa non"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://192.168.51.174/eTaxManage/openApi/apiPost' \
--header 'SID: 5004' \
--header 'Authorization: bearer token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "invoiceSerialNumber": "4f76fBfc-c9CD-AF0b-57bD-CB4cDAcF16Fb",
    "creditCode": "RG209268DUCP27N3AL",
    "pdfFile": "tempor",
    "ofdFile": "consectetur magna",
    "xmlFile": "aliqua fugiat eiusmod culpa non"
}'

返回响应

🟢200成功

application/json

Body

invoiceSerialNumber

string <uuid>

发票请求流水号 invoiceNum（发票号码）为空时，必填。

可选

invoiceNum

string

发票号码 invoiceSerialNumber（发票请求流水号）为空时，必填。

可选

pdfUrl

string <uri>

pdf下载url

可选

下载状态为下载成功时返回

pdfErrorMsg

string

pdf异常信息

可选

下载状态为下载失败时返回

pdfDownLoadStatus

enum<string>

pdf下载状态

可选

0-未下载；1-下载成功；2-下载失败；3-下载中

枚举值:

0123

prePdfUrl

string

pdf预下载地址

可选

无论本地是否有文件都会返回，后续处理下载成功后可直接使用此地址下载文件

ofdUrl

string <uri>

ofd下载url

可选

下载状态为下载成功时返回

ofdErrorMsg

string

ofd异常信息

可选

下载状态为下载失败时返回

ofdDownLoadStatus

enum<string>

ofd下载状态

可选

0-未下载；1-下载成功；2-下载失败；3-下载中

枚举值:

0123

preOfdUrl

string

ofd预下载地址

可选

无论本地是否有文件都会返回，后续处理下载成功后可直接使用此地址下载文件

xmlUrl

string <uri>

xml下载url地址

可选

下载状态为下载成功时返回

xmlErrorMsg

string

xml异常信息

可选

下载状态为下载失败时返回

xmlDownLoadStatus

enum<string>

xml下载状态

可选

0-未下载；1-下载成功；2-下载失败；3-下载中

枚举值:

0123

preXmlUrl

string

xml预下载地址

可选

无论本地是否有文件都会返回，后续处理下载成功后可直接使用此地址下载文件

示例

{
    "invoiceSerialNumber": "e1D06d48-B9d4-07cC-f4a5-cc827AC984bB",
    "pdfUrl": "http://dummyimage.com/120x60",
    "pdfErrorMsg": "nostrud aliquip",
    "pdfDownLoadStatus": "0",
    "prePdfUrl": "aliquip ullamco proident reprehenderit nulla",
    "ofdUrl": "http://dummyimage.com/120x240",
    "ofdErrorMsg": "in",
    "ofdDownLoadStatus": "dolore quis cillum pariatur",
    "preOfdUrl": "eu",
    "xmlUrl": "http://dummyimage.com/250x250",
    "xmlErrorMsg": "aute proident laboris",
    "xmlDownLoadStatus": "sint amet deserunt sit",
    "preXmlUrl": "ut fugiat exercitation aliqua velit"
}

🟢200通用返回报文