已开发票明细查询 - 云南百望云开放平台

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

请求参数

Header 参数

Content-Type

string

可选

示例值:

application/json

access_token

string

必需

通过调用access_token接口返回的access_token值

示例值:

req_date

string

必需

当前时间转为的毫秒数

示例值:

req_sign

string

签名算法得到的签名

必需

示例值:

Body 参数application/json

action

string | null

操作类型

可选

本接口传入：fpmx

nsrsbh

string

税号

必需

data

object

必需

kprq

string

开票日期

必需

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

zz_fphm

string

纸质发票号码

可选

zzz_fpdm

string

纸质发票代码

可选

fphm

string

发票号码

可选

20位数电发票号码

ly_ddbh

string

来源单编号

可选

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

dataScope

string

获取的数据范围字段

可选

0 或者空默认值只获取发票预览的数据 1 获取勾选状态 2.获取入账状态 3 获取入账，勾选，预览数据

示例

{
    "action": "string",
    "nsrsbh": "string",
    "data": {
        "kprq": "string",
        "zz_fphm": "string",
        "zzz_fpdm": "string",
        "fphm": "string",
        "ly_ddbh": "string"
    },
    "dataScope": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

fphm

string

发票号码

必需

数电为20位数电号码

zz_fpdm

string

纸质发票代码

可选

zz_fphm

string

纸质发票号码

可选

kprq

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

string

开票类型

必需

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

kpr

string

开票人

必需

string | null

备注

必需

hjje

number

合计金额

必需

hjse

number

合计税额

必需

jshj

number

价税合计

必需

kce

number

扣除额

必需

jshj_chn

string

价税合计（中文大写）

必需

xmmx

array [object {17}]

项目明细

必需

integer

行序号

必需

fphxz

string

发票行性质

必需

0：正常行 1：折扣行 2：被折扣行

spbm

string

商品税收编码

必需

19位税收分类代码

spmc

string

商品税收名称

必需

yhzcbs

string

优惠政策标识

必需

N-未享受, Y-享受

yhzclxDm

string | null

优惠政策类型代码（"03":"免税","04":"不征税", "08":"按3%简易征收","09":"按5%简易征收"）

必需

yhzcbs=‘Y'时有值

xmmc2

string

项目名称全称

必需

带税收名称和星号

xmmc

string

项目名称

必需

不带税收名称

string | null

单位

必需

ggxh

string | null

规格型号

必需

spsl

string | null

商品数量

必需

string | null

商品单价

必需

number

金额

必需

string

税率

必需

例如0.06

number

税额

必需

kce

number

扣除额

必需

lzMxxh

integer

对应蓝字明细序

必需

仅负数发票有值

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

发票入账状态名称

可选

示例

{
    "fphm": "string",
    "zz_fpdm": "string",
    "zz_fphm": "string",
    "kprq": "string",
    "fplxdm": "string",
    "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": "string",
    "kpr": "string",
    "bz": "string",
    "hjje": 0,
    "hjse": 0,
    "jshj": 0,
    "kce": 0,
    "jshj_chn": "string",
    "xmmx": [
        {
            "xh": 0,
            "fphxz": "string",
            "spbm": "string",
            "spmc": "string",
            "yhzcbs": "string",
            "yhzclxDm": "string",
            "xmmc2": "string",
            "xmmc": "string",
            "dw": "string",
            "ggxh": "string",
            "spsl": "string",
            "dj": "string",
            "je": 0,
            "sl": "string",
            "se": 0,
            "kce": 0,
            "lzMxxh": 0
        }
    ],
    "zzsytdm": "string",
    "zzsytmc": "string",
    "xfsytdm": "string",
    "xfsytmc": "string",
    "fprzztdm": "string",
    "fprzztmc": "string"
}