2.02.电子发票信息查询(czlx-113) - 发票云(标准版)API文档

请求参数

Query 参数

name

string

必需

clientsecret+税盘号

reqid

string

必需

当前13位毫秒级时间戳加3位随机数字(总共16位)

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

czlx

enum<string>

113

必需

枚举值:

113

sfrz

object

认证信息

必需

signature

string

必需

签名(由client_id + client_secret + timestamp的值通过MD5算法生成)

client_id

string

应用id

必需

timestamp

string

必需

sjd

object

请求信息

必需

fpqqlsh

string

待查询的发票流水号

必需

示例

{
  "czlx": "113",
  "sfrz": {
    "signature": "string",
    "client_id": "string",
    "timestamp": "string"
  },
  "sjd": {
    "fpqqlsh": "string"
  }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api-dev.piaozone.com/test/?name=&reqid=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "czlx": "113",
    "sfrz": {
        "signature": "string",
        "client_id": "string",
        "timestamp": "string"
    },
    "sjd": {
        "fpqqlsh": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

errcode

string

必需

0000：成功其他：失败

description

string

描述

必需

invoice

object

发票信息

必需

xhf_mc

string

销方名称

必需

xhf_nsrsbh

string

销方税号

必需

xhf_dzdh

string

销方地址电话

必需

xhf_yhzh

string

销方银行账号

必需

fpqqlsh

string

流水号

必需

ddh

string

订单号

必需

yfphm

string

原发票代码

必需

yfpdm

string

原发票号码

必需

kprq

string

开票日期

必需

hjbhsje

number

不含税金额

必需

kphjse

number

合计税额

必需

jshjje

number

价税合计金额

必需

fpdm

string

发票代码

必需

fphm

string

发票号码

必需

ghf_mc

string

购方名称

必需

ghf_nsrsbh

string

购方税号

必需

ghf_yhzh

string

购方银行账号

必需

ghf_dzdh

string

购方地址电话

必需

ghf_sj

string

购方手机号

必需

fhr

string

复核人

必需

kpy

string

开票人

必需

sky

string

收款人

必需

pdf_url

string

pdf链接地址

必需

checkcode

string

校验码

必需

kabao_url

string

卡包地址

必需

bz

string

备注

必需

kplx

number

必需

开票类型 0->正常发票 1->红冲发票

zfbz

string

必需

fwm

string

必需

items

array [object {9}]

明细信息

必需

示例

{
  "description": "查询成功",
  "errcode": "0000",
  "invoice": {
    "bz": "仅供培训使用",
    "checkcode": "47945468141205968313",
    "fhr": "fdr",
    "fpdm": "044031611112",
    "fphm": "13513956",
    "fpqqlsh": "2d3aa29c12f847ef936fed6c0826deaf",
    "fwm": "",
    "ghf_dzdh": "南山区 075544512569",
    "ghf_mc": "深圳证券信息有限公司",
    "ghf_nsrsbh": "440300618884098",
    "ghf_sj": "13255556666",
    "ghf_yhzh": "高新园支行 6220252166542352",
    "hjbhsje": "100.00",
    "items": [
      {
        "ggxh": "10",
        "hsbz": "0",
        "se": "9.000000",
        "sl": "0.09",
        "xmdj": "50.000000",
        "xmdw": "kg",
        "xmje": "100.000000",
        "xmmc": "*农副产品*ccccc",
        "xmsl": "2.000000"
      }
    ],
    "jshjje": "109.00",
    "kabao_url": "",
    "kphjse": "9.00",
    "kplx": "0",
    "kprq": "2021-08-10 10:13:58",
    "kpy": "sam_lee",
    "kpzl": "51",
    "pdf_url": "https://api-dev.piaozone.com/test/public/pdf/26a36453dc8f9dc0e0bbc9835298e144",
    "sky": "sdr",
    "xhf_dzdh": "北京市西城区北礼士路135号 18681537039",
    "xhf_mc": "航信培训企业",
    "xhf_nsrsbh": "440301999999030",
    "xhf_yhzh": "中国银行 5218666611118888",
    "yfpdm": "",
    "yfphm": "00000000",
    "zfbz": "0"
  }
}

🟢200失败