扫码开票订单查询

1、接口及场景描述

接口描述：为企业提供订单查询功能
是否支持数电及税控发票：全部支持

2、请求参数

字段名称	必选	类型	长度	字段含义及备注
method	是	string		请求方法名
object	是	object		请求数据
ddh	是	string	255	订单号

3、返回参数

字段名称	是否必返回	类型	长度	字段含义及备注
code	是	string		返回代码
data	是	object[]		返回数据
msg	是	string		返回消息
fpdm	否	string	12	发票代码
fphm	否	string	20	发票号码
kprq	否	string		开票日期格式：yyyyMMddHHmmss
fpzt	是	string	2	发票状态 00：已开具的正数发票、 01：已开具的负数发票、 02：未开具发票的作废发票、 03：已开具正数发票的作废发票、 04：已开具负数发票的作废发票 -1：正数发票，数据缺失若为待开数据对应状态为： 01:未开具正数发票 02：未开具负数发票 03：拆分所产生的发票数据
fplxdm	是	string	4	发票类型代码
tspz	否	string	2	特殊票种 00：不是 01：农产品销售 02：农产品收购 06：抵扣通行费 07：其它通行费 08：成品油销售 18：成品油红字专票
xhdwsbh	是	string	26	销货单位识别号
xhdwmc	是	string	300	销货单位名称
xhdwdzdh	否	string	300	销货单位地址电话
xhdwyhzh	否	string	200	销货银行银行账号
ghdwsbh	是	string	26	购货单位识别号
ghdwmc	是	string	300	购货单位名称
ghdwdzdh	是	string	300	购货单位地址电话
ghdwyhzh	是	string	200	购货单位银行帐号
zsfs	是	string	1	征税方式 0：普通征税 2：差额征税
kce	否	string	16	差额扣除额zsfs为2时此项必返回
hjje	是	string	16	合计金额
hjse	是	string	16	合计税额
jshj	是	string	16	价税合计
bz	否	string	460	备注
skr	是	string		收款人
fhr	是	string		复核人
kpr	是	string		开票人
ewm	否	string		二维码
url	否	string		电票返回
pdfurl	否	string		pdf地址（全电返回）
ofdurl	否	string		国税OFD地址（全电返回）
ewmurl	否	string		二维码url（全电返回）
xmlurl	否	string		xml数据下载地址（全电返回）
fyxm	是	object[]		费用项目详见：3.1、fyxm数据信息
sjh	否	string		手机号
yx	否	string		邮箱
taskId	否	string	32	任务id
ddh	是	string	255	订单号
ddrq	是	string		订单日期格式为：yyyy-MM-dd
dqr	是	string		订单到期日格式为：yyyy-MM-dd
ttlx	是	string	1	抬头类型（0企业、1个人）
ddzt	是	string	1	订单状态 0待开具、 1已开具、 2开具失败、 3已作废、 4开具中、 5已过期、 -1已开具(数据缺失)
cwxx	否	string		开具失败对应的错误信息

3.1、fyxm数据信息

字段名称	是否必返回	类型	长度	字段含义及备注
dj	否	string	16	单价
dw	否	string	300	单位
fphxz	是	string	1	发票行性质
ggxh	否	string	40	规格型号
hsbz	是	string	1	含税标志 0：不含税1：含税
je	是	string	16	金额
lslbs	否	string	1	零税率标识空代表无,1：出口免税和其他免税优惠政策,2：不征增值税,3：普通零税率
se	否	string	16	税额
sl	是	string	8	税率
spbm	是	string	19	商品编码
spmc	是	string	600	商品名称
spsl	否	string	16	商品数量
spsm	否	string	19	商品税目
yhzcbs	否	string	1	优惠政策标识，0：未使用1：使用
zxbm	否	string		自行编码
zzstsgl	否	string	50	增值税特殊管理如果yhzcbs为1时，此项必返回增值税特殊管理不征税、免税、按5%简易征收减按1.5%计征、按3%简易征收、按5%简易征收、简易征收、先征后退、100%先征后退、 50%先征后退、即征即退30%、即征即退50%、即征即退70%、即征即退100%、超税负3%即征即退、稀土产品、超税负8%即征即退、超税负12%即征即退、超税负6%即征即退

返回响应

🟢200成功

application/json

Body

code

integer

code码

必需

code码

msg

string

返回信息

必需

返回信息

data

object

返回数据

必需

返回数据

kprq

string

开票日期

可选

格式：yyyyMMddHHmmss

fplxdm

string

发票类型代码

必需

发票类型代码

tspz

string

特殊票种

必需

00：不是01：农产品销售02：农产品收购06：抵扣通行费07：其它通行费08：成品油销售18：成品油红字专票

xhdwsbh

string

销货单位识别号

必需

销货单位识别号

xhdwmc

string

销货单位名称

必需

销货单位名称

xhdwdzdh

string

销货单位地址电话

可选

销货单位地址电话

xhdwyhzh

string

销货银行银行账号

可选

销货银行银行账号

ghdwsbh

string

购货单位识别号

必需

购货单位识别号

ghdwmc

string

购货单位名称

必需

购货单位名称

ghdwdzdh

string

购货单位地址电话

可选

购货单位地址电话

ghdwyhzh

string

购货单位银行帐号

可选

购货单位银行帐号

hjje

string

合计金额

必需

合计金额

hjse

string

合计税额

必需

合计税额

jshj

string

价税合计

必需

价税合计

string

备注

可选

备注

skr

string

收款人

可选

收款人

fhr

string

复核人

可选

复核人

kpr

string

开票人

可选

开票人

ewm

string

二维码

可选

二维码

url

string

电票返回

可选

电票返回

sjh

string

手机号

可选

手机号

string

邮箱

可选

邮箱

taskId

string

任务id

可选

任务id

cwxx

string

开具失败对应的错误信息

可选

开具失败对应的错误信息

fpdm

string

发票代码

可选

发票代码

fphm

string

发票号码

可选

发票号码

pdfurl

string

pdf地址

可选

（全电返回）

ewmurl

string

二维码url

可选

（全电返回）

xmlurl

string

xml数据下载地址

可选

（全电返回）

ofdurl

string

国税OFD地址

可选

（全电返回）

ddrq

string

订单日期

必需

格式yyyy-MM-dd

dqr

string

订单到期日

必需

格式yyyy-MM-dd

ttlx

string

抬头类型（0企业、1个人）

可选

抬头类型（0企业、1个人）

ddzt

string

订单状态

必需

0待开具、1已开具、2开具失败、3已作废、4开具中、5已过期、-1已开具(数据缺失)

ddh

string

订单号

必需

订单号

fyxm

array [object {15}]

fyxm

必需

商品数据

示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "kprq": "20230816181824",
    "fplxdm": "81",
    "tspz": "00",
    "xhdwsbh": "91120104MAC7RYT0XQ",
    "xhdwmc": "天津铉科科技有限公司",
    "xhdwdzdh": "天津武清开发区泉州路19号~022-82125068",
    "xhdwyhzh": "汇丰银行(中国)有限公司天津分行~625032354011",
    "ghdwsbh": "91120104MA07BL4E0H",
    "ghdwmc": "天津百望税财科技有限公司",
    "ghdwdzdh": "",
    "ghdwyhzh": "",
    "hjje": "1.00",
    "hjse": "0.01",
    "jshj": "1.01",
    "bz": "11",
    "skr": "33",
    "fhr": "22",
    "kpr": "peter",
    "qdbz": "0",
    "ewm": "",
    "url": "",
    "sjh": "",
    "yx": "",
    "taskId": "",
    "zrrbs": "N",
    "cwxx": "",
    "fpdm": "",
    "fphm": "23122000000006529157",
    "pdfurl": "https://dppt.tianjin.chinatax.gov.cn:18443/kpfw/fpjfzz/v1/exportDzfpwjEwm?Wjgs=PDF&Jym=362A&Fphm=23122000000006529157&Kprq=20230816181824&Czsj=1692181106011",
    "ewmurl": "https://dppt.tianjin.chinatax.gov.cn:8443/v/2_23122000000006529157_20230816181824010XQ362A",
    "xmlurl": "https://dppt.tianjin.chinatax.gov.cn:28443/kpfw/fpjfzz/v1/exportDzfpwjEwm?Wjgs=XML&Jym=362A&Fphm=23122000000006529157&Kprq=20230816181824&Czsj=1692181106011",
    "ofdurl": "https://dppt.tianjin.chinatax.gov.cn:38443/kpfw/fpjfzz/v1/exportDzfpwjEwm?Wjgs=OFD&Jym=362A&Fphm=23122000000006529157&Kprq=20230816181824&Czsj=1692181106011",
    "ddrq": "2023-08-12",
    "dqr": "2023-08-20",
    "ttlx": "0",
    "ddzt": "1",
    "ddh": "bcfad",
    "fyxm": [
      {
        "xh": "1",
        "fphxz": "0",
        "spmc": "*纺织产品*测试商品1",
        "spbc": "",
        "spsm": "",
        "ggxh": "wsx11234324111",
        "dw": "升",
        "spsl": "1",
        "dj": "1",
        "je": "1.00",
        "sl": "0.01",
        "se": "0.01",
        "hsbz": "0",
        "spbm": "1040105990000000000",
        "zxbm": "",
        "yhzcbs": "0",
        "lslbs": "",
        "zzstsgl": "不使用优惠政策"
      }
    ]
  }
}

1、接口及场景描述#

2、请求参数#

3、返回参数#

3.1、fyxm数据信息#

请求参数

返回响应

1、接口及场景描述

2、请求参数

3、返回参数

3.1、fyxm数据信息