管理平台

5005-下载发票xml文件

开发环境

http://192.168.51.174

POST

/openApi/apiPost/6

红字确认单

最后修改时间：2024-05-07 05:57:09

责任人：cyx123

E税云/其他外部系统可通过此接口获取数电发票xml文件。E税云管理平台接收到下载请求后，根据本地发票数据和税局数电发票票面样式生成xml版式文件，并返回下载地址。

请求参数

Header 参数

SID

string

对应接口方法编号

可选

示例值:

5005

Authorization

string

可选

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

示例值:

bearer d350b578-67b3-4f88-9ac3-c13fb37d4684

creditCode

string

可选

示例值:

915101000549157085

Body 参数application/json

invoiceSerialNumber

string <uuid>

发票请求流水号

必需

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

creditCode

string

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

必需

正则匹配:

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

示例

{
    "invoiceSerialNumber": "1777240052876410880"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://192.168.51.174/openApi/apiPost/6' \
--header 'SID: 5005' \
--header 'Authorization: bearer d350b578-67b3-4f88-9ac3-c13fb37d4684' \
--header 'creditCode: 915101000549157085' \
--header 'Content-Type: application/json' \
--data-raw '{
    "invoiceSerialNumber": "1777240052876410880"
}'

返回响应

🟢200成功

application/json

Body

invoiceSerialNumber

string <uuid>

发票请求流水号

必需

xmlUrl

string <uri>

xml下载url

可选

xml下载路径，数电发票xml格式的下载URL

errorMsg

string

异常信息

可选

异常信息

xmlDownLoadStatus

enum<string>

下载状态

必需

枚举值:

012-1-23

preXmlUrl

string

预下载地址

可选

示例

{
    "message": null,
    "value": {
        "invocieSerialNumber": "1563398f-df8f-428a-979a-5e231e5b4e6c",
        "pdfUrl": "http://example.com"
    },
    "success": true,
    "msgCode": 0
}

🟢200通用返回报文

5004-下载发票pdf版式文件

5006-开具数电红字发票