已开发票明细查询 - 平台Api对接

从局端查询符合指定条件的发票详细明细信息。

请求参数

Body 参数application/json

kprq

string

开票日期

可选

包含时间 yyyy-MM-dd HH:mm:ss

默认值:

fphm

string

发票号码

可选

默认值:

ly_ddbh

string

来源单编号

可选

同开具接口来源订单编号，通过订单号查询已开明细，如果传此参数，fphm和kprq可不传

默认值:

zz_fpdm

string

纸质增值税发票代码

可选

默认值:

zz_fphm

string

纸质增值税发票号码

可选

默认值:

accountId

string

多账号下的账号唯一标识

可选

示例

{
    "kprq": "",
    "fphm": "",
    "ly_ddbh": "",
    "zz_fpdm": "",
    "zz_fphm": "",
    "accountId": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

业务代码

必需

0:成功，非0:失败

message

string

业务消息

必需

默认值:

requestID

string

业务流水号

必需

默认值:

timestamp

integer

业务提交时间戳

必需

token

string

登陆Token

必需

只有登陆接口有返回数据

默认值:

codeType

integer

业务返回编码格式

必需

data数据内容编码格式，0：明文，2：AES，3：Base64

iszip

integer

业务返回数据压缩标记

必需

data数据是否压缩，1：zip压缩

data

object

业务返回数据

必需

fphm

string

发票号码

必需

默认值:

zz_fpdm

string

纸质发票代码

必需

默认值:

zz_fphm

string

纸质发票号码

必需

默认值:

kprq

string

开票日期时间

必需

默认值:

lzKprq

string

蓝字开票日期

必需

如果是红字发票该字段有值

默认值:

lzFphm

string

蓝字发票号码

必需

如果是红字发票该字段有值

默认值:

fplxdm

string

发票类型代码

必需

增值税纸质专用发票： "004";
增值税纸质普通发票："007";
增值税纸质普通发票（卷式发票）："025";
增值税电子普通发票："026";
增值税电子专用发票："028";
全面数字化电子普通发票："030";
全面数字化电子专用发票："032";
机动车发票："005";

默认值:

kpf_nsrsbh

string

开票方纳税人识别号

必需

默认值:

xsf_nsrmc

string

销方纳税人名称

必需

默认值:

xsf_nsrsbh

string

销方纳税人识别号

必需

默认值:

xsf_yhmc

string

销方开户银行

必需

默认值:

xsf_yhzh

string

销方银行账号

必需

默认值:

xsf_dz

string

销方地址

必需

默认值:

xsf_dh

string

销方电话

必需

默认值:

gmf_nsrsbh

string

购方纳税人识别号

必需

默认值:

gmf_nsrmc

string

购方名称

必需

默认值:

gmf_dz

string

购方地址

必需

默认值:

gmf_dh

string

购方电话

必需

默认值:

gmf_yhmc

string

购方开户银行

必需

默认值:

gmf_yhzh

string

购方银行账号

必需

默认值:

ewm

string

发票二维码

必需

默认值:

kplx

integer

开票类型

必需

开票类型 0：正常票，1：红冲票

kpr

string

开票人

必需

默认值:

string

备注

可选

默认值:

hjje

number

合计金额

必需

hjse

number

合计税额

必需

jshj

number

价税合计

必需

kce

number

扣除额

可选

jshj_chn

string

价税合计（中文大写）

必需

默认值:

xmmx

array [object {17}]

项目明细

必需

zzsytdm

string

增值税用途代码

可选

("ZZ00", "未使用"), ("ZZ01", "已勾选(抵扣)"), ("ZZ02", "不抵扣不退税不代办退税"), ("ZZ03", "已勾选(退税)"), ("ZZ04", "已勾选(代办退税)"), ("ZZ05", "待抵扣"), ("ZZ06", "待退税"), ("ZZ07", "已抵扣"), ("ZZ08", "已抵扣(改退)"), ("ZZ09", "已退税"), ("ZZ10", "已代办退税"), ("ZZ11", "不予退税且不予抵扣")

默认值:

zzsytmc

string

增值税用途名称

可选

默认值:

xfsytdm

string

消费税用途代码

可选

("XF00", "未使用"), ("XF01", "已勾选 (外购)"), ("XF02", "已勾选 (用于生产乙烯、芳烃类化工产品的石脑油燃料油消费税退税)"), ("XF03", "待外购"), ("XF04", "待用于生产乙烯、芳烃类化工产品的石脑油燃料油消费税退税"), ("XF05", "已外购"), ("XF06", "已用于生产乙烯、芳烃类化工产品的石脑油燃料油消费税退税"), ("XF07", "未勾选库存"), ("XF08", "已勾选库存"),

默认值:

xfsytmc

string

消费税用途名称

可选

默认值:

fprzztdm

string

发票入账状态代码

可选

("00", "未入账"), ("01", "已入账")

默认值:

fprzztmc

string

发票入账状态名称

可选

默认值:

fjysxxList

array [object {3}]

附加要素信息

必需

tdywlxDm

string

特定业务类型

必需

("01":"成品油发票","02":"稀土发票","03":"建筑服务发票","04":"货物运输服务发票","05":"不动产销售服务发票","06":"不动产经营租赁服务", "07": "代收车船税","08":"通行费","09":"旅客运输服务发票","10":"医疗服务（住院）发票","11":"医疗服务（门诊）发票","12":"自产农产品销售发票", "13":"拖拉机和联合收割机发票","14":"机动车","15":"二手车","16":"农产品收购发票","17":"光伏收购发票","18":"卷烟发票","19":"出口发票","20":"农产品")

默认值:

jzfwfpmxList

array [object {7}]

特定要素信息-建筑服务

可选

hwysfwdzfpmxbList

array [object {6}]

特定要素信息-货物运输

可选

bdcTdysfpList

array [object {8}]

特定要素信息-不动产信息

可选

lkysfwTdysList

array [object {9}]

必需

txfList

array [object {12}]

通信费信息

必需

示例

{
    "code": 0,
    "message": "",
    "requestID": "",
    "timestamp": 0,
    "token": "",
    "codeType": 0,
    "iszip": 0,
    "data": {
        "fphm": "",
        "zz_fpdm": "",
        "zz_fphm": "",
        "kprq": "",
        "lzKprq": "",
        "lzFphm": "",
        "fplxdm": "",
        "kpf_nsrsbh": "",
        "xsf_nsrmc": "",
        "xsf_nsrsbh": "",
        "xsf_yhmc": "",
        "xsf_yhzh": "",
        "xsf_dz": "",
        "xsf_dh": "",
        "gmf_nsrsbh": "",
        "gmf_nsrmc": "",
        "gmf_dz": "",
        "gmf_dh": "",
        "gmf_yhmc": "",
        "gmf_yhzh": "",
        "ewm": "",
        "kplx": 0,
        "kpr": "",
        "bz": "",
        "hjje": 0,
        "hjse": 0,
        "jshj": 0,
        "kce": 0,
        "jshj_chn": "",
        "xmmx": [
            {
                "xh": 0,
                "fphxz": 0,
                "spbm": "",
                "spmc": "",
                "yhzcbs": "",
                "yhzclxDm": "",
                "xmmc2": "",
                "xmmc": "",
                "jldw": "",
                "ggxh": "",
                "spsl": "string",
                "dj": "string",
                "je": 0,
                "slv": "",
                "se": 0,
                "kce": 0,
                "lzMxxh": "string"
            }
        ],
        "zzsytdm": "",
        "zzsytmc": "",
        "xfsytdm": "",
        "xfsytmc": "",
        "fprzztdm": "",
        "fprzztmc": "",
        "fjysxxList": [
            {
                "fjxxmc": "",
                "fjxxnr": "",
                "sjlx": ""
            }
        ],
        "tdywlxDm": "",
        "jzfwfpmxList": [
            {
                "xh": "",
                "xzqhszDm": "",
                "xmmc": "",
                "jzxmmc": "",
                "jzfwfsd": "",
                "kdsbz": "",
                "tdzzsxmbh": ""
            }
        ],
        "hwysfwdzfpmxbList": [
            {
                "xh": "",
                "ysgjph": "",
                "ddd": "",
                "ysgjzl": "",
                "yshwmc": "",
                "qyd": ""
            }
        ],
        "bdcTdysfpList": [
            {
                "xh": "",
                "zlqz": "",
                "kdsbz": "",
                "cqzsh": "",
                "bdcdz": "",
                "zlqq": "",
                "xzqhszDm": "",
                "zlqqz": ""
            }
        ],
        "lkysfwTdysList": [
            {
                "cxr": "string",
                "sfzjhm": "string",
                "cxrzjlxDm": "string",
                "chuxrq": "string",
                "ddd": "string",
                "cfd": "string",
                "jtgjlx": "string",
                "xh": "string",
                "dj": "string"
            }
        ],
        "txfList": [
            {
                "mxxh": "string",
                "kprq": "string",
                "spbm": "string",
                "xmmc": "string",
                "je": "string",
                "slv": "string",
                "se": "string",
                "yhzcbs": "string",
                "cllxDm": "string",
                "cphm": "string",
                "txrqz": "string",
                "txrqq": "string"
            }
        ]
    }
}