管理平台

5103-发票主体查询请求

开发中

开发环境

http://192.168.51.174

POST

http://etax-sanbox.szhtxx.com/eTaxManage/openApi/apiPost/13

红字确认单

最后修改时间：2024-05-07 02:31:02

责任人：luohan

E税云/外部系统调管理平台“全票面批量查询”接口，进行全票面数据批量查询采集。

请求参数

Header 参数

SID

string

对应接口方法编号

可选

示例值:

5103

Authorization

string

可选

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

示例值:

bearer token

creditCode

string

税号必传

可选

userName

string

可选

电子税局登录账号用户名，当管理平台-进项配置-平台类型为“电子税局”时，必传

Body 参数application/json

invoiceType

array[string]

发票类型

必需

本批次请求的发票类型： "0":"增值税专用发票" "12":"机动车销售统一发票" "2":"增值税普通发票" "52":"增值税电子专用发票" "51":"增值税电子普通发票" "41": 增值税普通发票(卷式) "14":"通行费电子发票" "15":"二手车销售统一发票" "17":"海关缴款书" "61":"数电发票(普通发票) " "62":"数电发票(增值税专用发票) " "63":"数电发票(铁路电子客票) " "64":"数电发票(航空运输客票电子行单)" "65":"二手车销售电子统一发票" "66":"数电纸质发票(增值税专用发票) "67":"数电纸质发票(普通发票) " "68":"纸质发票(二手车销售统一发票) " "69 机动车销售电子统一发票" "70 数电纸质发票（机动车销售统一发票）"

>= 1 items<= 20 items

枚举值:

025251416162666765686970

dataType

enum<string>

数据类型

必需

1-进项票 2-销项票 (查询类型为2、3、4时，只能传1)

枚举值:

invoiceDateBegin

string

开票日期起

可选

格式： yyyyMMdd(与开票日期止成对请求)

invoiceDateEnd

string

开票日期止

可选

格式： yyyyMMdd(与开票日期起成对请求)

taxPeriods

array[string]

可选

格式：YYYYMM 当勾选状态传1-已勾选时，所属期必填；（3）仅全票通通道，数据类型为1-进项票时传入有效。

pageNo

integer

页码

可选

默认1，若返回报文中“是否存在下一页”返回 true，则需增加页码再次请求，直至“是否存在下一页”返回false。

checkStatus

enum<string>

可选

勾选状态 0-未勾选 1- 已勾选 2-全部不传默认查询全部

枚举值:

queryCurrent

enum<string>

必需

查询类型 1-全量发票 2-抵扣勾选发票 3-不抵扣勾选发票 4-全量勾选发票（包含抵扣、不抵扣、未到勾选日期发票）；（2）数据类型为2-销项票时，只能传1。

枚举值:

1234

taxPeriod

string

勾选税款所属期

可选

此项有值时，开票日期起止均可为空；（2）仅数据类型为1-进项票时，传入有效。

batchNo

string

采集批次号

可选

全票通通道不能为空；（2）数据类型为2-销项票时，传入无效。

示例

{
    "invoiceType": [
        "magna aliquip est laborum amet",
        "in",
        "quis in eiusmod adipisicing",
        "proident exercitation quis",
        "ad quis Duis ex exercitation",
        "est culpa",
        "et est ex ad",
        "officia dolore",
        "pariatur laborum dolore",
        "culpa dolor sit cupidatat voluptate",
        "pariatur deserunt officia mollit proident",
        "sint culpa ullamco nostrud",
        "mollit Ut qui labore",
        "officia dolor in ipsum",
        "in",
        "sed aute Lorem"
    ],
    "dataType": "1",
    "queryCurrent": "0",
    "pageNo": -34028767,
    "invoiceDateEnd": "1971-09-17 12:47:30",
    "invoiceDateBegin": "1986-02-12 09:28:38",
    "checkStatus": "1"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://etax-sanbox.szhtxx.com/eTaxManage/openApi/apiPost/13' \
--header 'SID: 5103' \
--header 'Authorization: bearer token' \
--header 'creditCode;' \
--header 'userName;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "invoiceType": [
        "magna aliquip est laborum amet",
        "in",
        "quis in eiusmod adipisicing",
        "proident exercitation quis",
        "ad quis Duis ex exercitation",
        "est culpa",
        "et est ex ad",
        "officia dolore",
        "pariatur laborum dolore",
        "culpa dolor sit cupidatat voluptate",
        "pariatur deserunt officia mollit proident",
        "sint culpa ullamco nostrud",
        "mollit Ut qui labore",
        "officia dolor in ipsum",
        "in",
        "sed aute Lorem"
    ],
    "dataType": "1",
    "queryCurrent": "0",
    "pageNo": -34028767,
    "invoiceDateEnd": "1971-09-17 12:47:30",
    "invoiceDateBegin": "1986-02-12 09:28:38",
    "checkStatus": "1"
}'

返回响应

🟢200响应报文

application/json

Body

batchNo

string

必需

批次号执行发票信息查询为异步执行，调用方需要保存此批次号，需要再根据此批次号查询发票信息查询的结果。

示例

{
    "batchNo": "Excepteur exercitation laboris proident et"
}

🟢200通用返回报文

🟢200开票

5102-单张发票实时查验（全票通和乐企都支持）

5116-发票详情查询