票單云

票單云|發(fā)票單據(jù)管理平臺(tái)：得心應(yīng)手如影隨形

推薦訪問(wèn)票單云開(kāi)放API站: http://open.piaodanyun.com/

Base URLs:

測(cè)試環(huán)境: https://api.piaodanyun.com/test/v1

Authentication

數(shù)電票接口V1-基礎(chǔ)版/獲取訪問(wèn)令牌

POST 獲取訪問(wèn)令牌

POST /obtainToken

Body 請(qǐng)求參數(shù)

{
  "phone_email": "135xxxxxxxx",
  "pass": "xxxxxx"
}

請(qǐng)求參數(shù)

名稱(chēng)	位置	類(lèi)型	必選	中文名	說(shuō)明
body	body	object	否		none
? phone	body	string	是	用戶名	使用手機(jī)號(hào)作為用戶名
? pass	body	string	是	用戶密碼	none
? tenant_id	body	integer	是	企業(yè)租戶ID	none
? token_type	body	string	是	令牌類(lèi)型	數(shù)電票接口填寫(xiě) TaxApi

返回示例

失敗

{
  "code": 40000,
  "msg": "用戶名或密碼錯(cuò)誤",
  "data": null
}

{
  "code": 20000,
  "msg": "參數(shù)不能為空",
  "data": null
}

返回結(jié)果

狀態(tài)碼	狀態(tài)碼含義	說(shuō)明	數(shù)據(jù)模型
200	OK	失敗	Inline

返回?cái)?shù)據(jù)結(jié)構(gòu)

狀態(tài)碼 200

名稱(chēng)	類(lèi)型	必選	約束	說(shuō)明
? code	integer	true	none	none
? msg	string	true	none	none
? data	null	true	none	none

數(shù)電票接口V1-基礎(chǔ)版/數(shù)電票接口

GET 獲取人臉二維碼

GET /qdjk/fullExteriorInvoke/getFaceImg

用于獲取授權(quán)認(rèn)證人臉識(shí)別二維碼

Body 請(qǐng)求參數(shù)

{}

請(qǐng)求參數(shù)

名稱(chēng)	位置	類(lèi)型	必選	說(shuō)明
nsrsbh	query	string	是	納稅人識(shí)別號(hào)
type	query	string	否	值為1或不傳時(shí)使用電子稅務(wù)局app掃二維碼，值為2時(shí)使用個(gè)人所得所掃二維碼
username	query	string	是	局端賬號(hào)
Authorization	header	string	否	none
body	body	object	否	none

返回示例

成功

{
  "code": 200,
  "msg": "成功",
  "data": {
    "rzid": "5246703dc22842b5a3d7826f375e6c7d",
    "nsrsbh": "9151123123122031211",
    "ewm": "qrcode_id=gYyixYMScMK4GQc2LfzqvKVnk33kJHs7p5wnpig3QdYFAdAvmDp7i7Yobk7zzkNM&areaPrefix=5100&int erfaceCode=0004",
    "slzt": null,
    "emwly": "swj"
  },
  "total": 0
}

返回結(jié)果

狀態(tài)碼	狀態(tài)碼含義	說(shuō)明	數(shù)據(jù)模型
200	OK	成功	Inline

返回?cái)?shù)據(jù)結(jié)構(gòu)

狀態(tài)碼 200

名稱(chēng)	類(lèi)型	必選	約束	中文名	說(shuō)明
? code	integer	true	none		none
? msg	string	true	none		none
? data	object	true	none		none
?? rzid	string	true	none	認(rèn)證ID	none
?? nsrsbh	string	true	none	稅號(hào)	none
?? ewm	string	true	none	二維碼	需用工具將字符串轉(zhuǎn)化為二維碼圖片，在用稅務(wù)app掃碼認(rèn)證
?? slzt	null	true	none		none
?? emwly	string	true	none		二維碼類(lèi)型，取決于你的傳參，默認(rèn)為 swj 為電子稅務(wù)局
? total	integer	true	none		none

POST 藍(lán)字發(fā)票開(kāi)具

POST /qdjk/fullExteriorInvoke/blueTicket

用于開(kāi)具藍(lán)字發(fā)票

Body 請(qǐng)求參數(shù)

username: "{{username}}"
fpqqlsh: 111_111
fplxdm: "82"
tdyslxDm: string
kplx: "0"
qdbz: string
xhdwsbh: "{{nsrsbh}}"
xhdwmc: 北京民諾科技有限公司
xhdwdzdh: 北京市***
xhdwyhzh: 111***
ghdwsbh: string
ghdwmc: 上海市****科技有限公司
ghdwdzdh: string
ghdwyhzh: string
zsfs: string
"fyxm[0][fphxz]": "0"
"fyxm[0][spmc]": "*軟件*票單云財(cái)稅管理系統(tǒng)"
"fyxm[0][ggxh]": V1
"fyxm[0][dw]": 年
"fyxm[0][spsl]": "1"
"fyxm[0][dj]": "1"
"fyxm[0][je]": "1"
"fyxm[0][sl]": "0.01"
"fyxm[0][se]": "0.01"
"fyxm[0][hsbz]": "1"
"fyxm[0][spbm]": "1060301020100000000"
"fyxm[0][yhzcbs]": string
"fyxm[0][lslbs]": string
"fyxm[0][zzstsgl]": string
hjje: "0.99"
hjse: "0.01"
jshj: "1"
kce: 0
kpr: string
skr: string
fhr: string
gfkhdh: string
gfkhyx: string
slsm: string
bz: string
gfzrrbs: string
xfzrrbs: string
gfxxConfirm: string
spflxConfirm: string
sfzsgmfyhzh: string
sfzsxsfyhzh: string

請(qǐng)求參數(shù)

名稱(chēng)	位置	類(lèi)型	必選	說(shuō)明
Authorization	header	string	否	none
body	body	object	否	none
? username	body	string	是	局端賬號(hào)
? fpqqlsh	body	string	是	發(fā)票請(qǐng)求流水號(hào)，唯一值，格式為： “稅號(hào)_自定義編號(hào)”，總計(jì)40個(gè)字符以?xún)?nèi)
? fplxdm	body	string	是	發(fā)票類(lèi)型代碼，82：增值稅普通發(fā)票，81：增值稅專(zhuān)用發(fā)票；51：鐵路子電子客票，61：航空運(yùn)輸電子客票行程單
? tdyslxDm	body	string	否	特定要素類(lèi)型代碼，“”空字符串，非特殊票種。其他特殊票種，單獨(dú)咨詢(xún)技術(shù)人員
? kplx	body	string	是	開(kāi)票類(lèi)型：0正數(shù)發(fā)票，1負(fù)數(shù)發(fā)票
? qdbz	body	string	否	清單標(biāo)志，開(kāi)具紙質(zhì)數(shù)電發(fā)票時(shí)，上命名系大于8行傳1,代表是清單發(fā)票
? xhdwsbh	body	string	是	銷(xiāo)方識(shí)別號(hào)
? xhdwmc	body	string	是	銷(xiāo)方名稱(chēng)
? xhdwdzdh	body	string	是	銷(xiāo)方地址電話
? xhdwyhzh	body	string	是	銷(xiāo)方銀行賬戶
? ghdwsbh	body	string	否	購(gòu)方稅號(hào)
? ghdwmc	body	string	是	購(gòu)方名稱(chēng)
? ghdwdzdh	body	string	否	購(gòu)方地址電話
? ghdwyhzh	body	string	否	購(gòu)方銀行賬號(hào)
? zsfs	body	string	否	征收方式，0：普通征稅1：減按計(jì)征2：差額征稅全額開(kāi)具3：差額征稅差額開(kāi)具默認(rèn)為0
? fyxm[0][fphxz]	body	string	是	發(fā)票行性質(zhì)，0:正常行1:折扣行2:被折扣行
? fyxm[0][spmc]	body	string	是	商品名稱(chēng)
? fyxm[0][ggxh]	body	string	否	規(guī)格型號(hào)
? fyxm[0][dw]	body	string	否	單位
? fyxm[0][spsl]	body	number	否	商品數(shù)量
? fyxm[0][dj]	body	number	否	單價(jià)
? fyxm[0][je]	body	number	是	金額
? fyxm[0][sl]	body	string	是	稅率
? fyxm[0][se]	body	number	是	稅額
? fyxm[0][hsbz]	body	string	是	含稅標(biāo)志：0不含稅1含稅
? fyxm[0][spbm]	body	string	是	商品編碼
? fyxm[0][yhzcbs]	body	string	否	優(yōu)惠政策標(biāo)識(shí)：0未使用，1使用
? fyxm[0][lslbs]	body	string	否	零稅率標(biāo)識(shí)：0代表正常稅率1出口免稅和其他免稅優(yōu)惠政策（免稅）2不征增值稅（不征稅）3普通零稅率（0%）
? fyxm[0][zzstsgl]	body	string	否	增值稅特殊管理（咨詢(xún)技術(shù)人員）
? hjje	body	string	是	合計(jì)金額
? hjse	body	string	是	合計(jì)稅額
? jshj	body	string	是	加稅合計(jì)
? kce	body	number	否	扣除額
? kpr	body	string	否	開(kāi)票人
? skr	body	string	否	收款人
? fhr	body	string	否	復(fù)核人
? gfkhdh	body	string	否	購(gòu)方電話
? gfkhyx	body	string	否	購(gòu)方郵箱
? slsm	body	string	否	稅率說(shuō)明（小規(guī)模納稅人開(kāi)具3稅率使用）前期已開(kāi)具發(fā)票，發(fā)生銷(xiāo)售折讓、中止或者退回等情形需要開(kāi)具紅字發(fā)票，或者開(kāi)票有誤需要重新開(kāi)具傳2，因?yàn)閷?shí)際經(jīng)營(yíng)業(yè)務(wù)需要，放棄享受減按1%征收率征收增值稅政策傳3
? bz	body	string	否	備注 255個(gè)字符以?xún)?nèi)
? gfzrrbs	body	string	否	購(gòu)方自然人標(biāo)識(shí)，N：企業(yè)Y：個(gè)人不傳默認(rèn)為N
? xfzrrbs	body	string	否	銷(xiāo)方自然人標(biāo)識(shí)，可用值N，Y（不傳值為N）
? gfxxConfirm	body	string	否	確認(rèn)購(gòu)方信息是否存在，值為1是不確認(rèn)。購(gòu)方信息可能會(huì)報(bào)（當(dāng)前未查詢(xún)到購(gòu)買(mǎi)方納稅人信息，請(qǐng)確認(rèn)是否繼續(xù)開(kāi)具），默認(rèn)是確認(rèn)，意思是不管購(gòu)方信息是否真實(shí)存在都進(jìn)行開(kāi)具
? spflxConfirm	body	string	否	是否開(kāi)啟自然人校驗(yàn)，1：開(kāi)啟，空：不開(kāi)啟/繼續(xù)開(kāi)票
? sfzsgmfyhzh	body	string	否	是否展示購(gòu)方銀行賬號(hào)到備注里面y/Y展示，其他否
? sfzsxsfyhzh	body	string	否	是否展示銷(xiāo)方銀行賬號(hào)到備注里面y/Y展示，其他否

返回示例

成功

{
  "code": 200,
  "msg": "成功",
  "data": {
    "Fphm": "22111111111111111180",
    "Kprq": "2022-11-28 15:28:11",
    "Gmfyx": null,
    "GmfSsjswjgdm": null
  },
  "total": 0
}

返回結(jié)果

狀態(tài)碼	狀態(tài)碼含義	說(shuō)明	數(shù)據(jù)模型
200	OK	成功	Inline

返回?cái)?shù)據(jù)結(jié)構(gòu)

狀態(tài)碼 200

名稱(chēng)	類(lèi)型	必選	約束	說(shuō)明
? code	integer	true	none	none
? msg	string	true	none	none
? data	object	true	none	none
?? Fphm	string	true	none	none
?? Kprq	string	true	none	none
?? Gmfyx	null	true	none	none
?? GmfSsjswjgdm	null	true	none	none
? total	integer	true	none	none

POST 獲取版式文件

POST /qdjk/fullExteriorInvoke/getInvoicePdfOfd

用于獲取pdf、odf、xml等版式的發(fā)票文件

Body 請(qǐng)求參數(shù)

username: "{{username}}"
downflag: "1"
nsrsbh: "{{nsrsbh}}"
fphm: "22512000000000007325"
kprq: "20230201120326"
addSeal: "1"

請(qǐng)求參數(shù)

名稱(chēng)	位置	類(lèi)型	必選	說(shuō)明
Authorization	header	string	否	none
body	body	object	否	none
? username	body	string	否	局端賬號(hào)
? downflag	body	string	是	獲取版式類(lèi)型1：PDF2：OFD3：XML4：下載地址
? nsrsbh	body	string	是	納稅人識(shí)別號(hào)納稅人識(shí)別號(hào)
? fphm	body	string	是	發(fā)票號(hào)碼發(fā)票號(hào)碼
? kprq	body	string	否	開(kāi)票日期格式：yyyyMMddHHmmss
? addSeal	body	string	否	是否添加簽章默認(rèn)不添加，1-添加，其余任意值-不添加

返回示例

成功

{
  "code": 200,
  "msg": "成功",
  "message": "成功",
  "data": {
    "pdfUrl": "https://dppt.beijing.chinatax.gov.cn:8443/kpfw/fpjfzz/v1/exportDzfpwjEwm?Wjgs=PDF&Jym=5C91&Fphm=24112000000064654320&Kprq=20240619193407&Czsj=1718797610288",
    "ofdUrl": "https://dppt.beijing.chinatax.gov.cn:8443/kpfw/fpjfzz/v1/exportDzfpwjEwm?Wjgs=OFD&Jym=5C91&Fphm=24112000000064654320&Kprq=20240619193407&Czsj=1718797610288",
    "xmlUrl": "https://dppt.beijing.chinatax.gov.cn:8443/kpfw/fpjfzz/v1/exportDzfpwjEwm?Wjgs=XML&Jym=5C91&Fphm=24112000000064654320&Kprq=20240619193407&Czsj=1718797610288"
  },
  "total": 0
}

{
  "code": 200,
  "msg": "成功",
  "data": "base64 加密字符串",
  "total": 0
}

返回結(jié)果

狀態(tài)碼	狀態(tài)碼含義	說(shuō)明	數(shù)據(jù)模型
200	OK	成功	Inline

返回?cái)?shù)據(jù)結(jié)構(gòu)

狀態(tài)碼 200

名稱(chēng)	類(lèi)型	必選	約束	說(shuō)明
? code	integer	true	none	none
? msg	string	true	none	none
? data	string	true	none	none
? total	integer	true	none	none

POST 登錄電票平臺(tái)

POST /qdjk/fullExteriorInvoke/loginDppt

用于接入電子稅局

第一次調(diào)用獲取短信驗(yàn)證碼，第二次調(diào)用傳入短信驗(yàn)證碼后接入電子稅局

Body 請(qǐng)求參數(shù)

nsrsbh: "{{nsrsbh}}"
sms: string
cert: string
ewmlx: string
ewmid: string
username: "{{username}}"
password: string

請(qǐng)求參數(shù)

名稱(chēng)	位置	類(lèi)型	必選	說(shuō)明
Authorization	header	string	否	none
body	body	object	否	none
? nsrsbh	body	string	是	納稅人識(shí)別號(hào)
? sms	body	string	否	驗(yàn)證碼（第一次調(diào)用不傳驗(yàn)證碼，會(huì)發(fā)送驗(yàn)證碼，第二次調(diào)用傳驗(yàn)證碼登錄，會(huì)返回uuid）
? cert	body	string	否	值為1使用證書(shū)登錄，證書(shū)登錄不需要驗(yàn)證碼，直接返回登錄成功或失敗原因值為2使用軟證書(shū)登錄，證書(shū)登錄不需要驗(yàn)證碼，直接返回登錄成功或失敗原因
? ewmlx	body	string	否	1人臉二維碼登錄，10稅務(wù)app掃碼登錄
? ewmid	body	string	否	第一次調(diào)用只傳二維碼類(lèi)型，會(huì)返回ewmid和二維碼的base64，第二次調(diào)用二維碼類(lèi)型跟第一次調(diào)用值必須一樣，ewmid使用第一次返回pinString否軟證書(shū)口令，cert為2時(shí)如果有就傳
? username	body	string	是	none
? password	body	string	是	none

返回示例

成功

{
  "code": 200,
  "msg": "成功",
  "message": "成功",
  "data": "88a5cfc741ff48eeb11d9d30b6b32a81",
  "total": 0
}

{
  "code": 999,
  "msg": "可信錯(cuò)誤：該用戶未注冊(cè)，請(qǐng)?jiān)谧匀蝗藰I(yè)務(wù)入口進(jìn)行用戶注冊(cè)",
  "message": "可信錯(cuò)誤：該用戶未注冊(cè)，請(qǐng)?jiān)谧匀蝗藰I(yè)務(wù)入口進(jìn)行用戶注冊(cè)",
  "data": null,
  "total": 0
}

返回結(jié)果

狀態(tài)碼	狀態(tài)碼含義	說(shuō)明	數(shù)據(jù)模型
200	OK	成功	Inline

返回?cái)?shù)據(jù)結(jié)構(gòu)

狀態(tài)碼 200

名稱(chēng)	類(lèi)型	必選	約束	說(shuō)明
? code	integer	true	none	none
? msg	string	true	none	none
? message	string	true	none	none
? data	string	true	none	none
? total	integer	true	none	none

POST 發(fā)票詳細(xì)查詢(xún)

POST /qdjk/fullExteriorInvoke/invoiceQueryMx

用于查詢(xún)發(fā)票的詳細(xì)信息

Body 請(qǐng)求參數(shù)

username: "{{username}}"
nsrsbh: "{{nsrsbh}}"
fphm: 2XXXXXXXXXXXXXXXXXXX
fpqqlsh: "123678907523112"

請(qǐng)求參數(shù)

名稱(chēng)	位置	類(lèi)型	必選	說(shuō)明
Authorization	header	string	否	none
body	body	object	否	none
? username	body	string	是	局端賬號(hào)
? nsrsbh	body	string	是	納稅人識(shí)別號(hào) 納稅人識(shí)別號(hào)
? fphm	body	string	否	發(fā)票號(hào)碼全電票發(fā)票號(hào)碼，跟發(fā)票請(qǐng)求流水號(hào)兩者必填其一
? fpqqlsh	body	string	是	發(fā)票請(qǐng)求流水號(hào) 發(fā)票請(qǐng)求流水號(hào)，跟全電票發(fā)票號(hào)碼兩者必填其一

返回示例

成功

{
  "code": 200,
  "msg": "成功",
  "message": "成功",
  "data": {
    "kdsbz": null,
    "zlqqz": null,
    "gmfjbr": "",
    "kce": "0",
    "swjgmc": null,
    "fpcbh": null,
    "swjgdm": null,
    "fwfsd": null,
    "skm": "",
    "yfpdm": "",
    "ghdwdm": "",
    "id": "b2952853-b739-4ae9-89c2-db0a3d4b6678",
    "skr": "",
    "mxzb": null,
    "dfgtgmbq": "",
    "GFKHDH": "",
    "ip": null,
    "zfrdm": "",
    "bbh": "",
    "zfdqsj": null,
    "dphgzbh": null,
    "spbmjc": "",
    "fullAddress": null,
    "bmbbbh": "",
    "ghdwyhzh": " ",
    "jshj": "1",
    "jbrzrrnsrsbh": "",
    "zhsl": null,
    "qmbz": "",
    "spsm": "",
    "hczt": null,
    "slsm": "",
    "tdyslxDm": "",
    "czydm": "bjmn",
    "yqbz": "",
    "hssign": "",
    "jzxmmc": null,
    "ghdwdzdh": " ",
    "fpqqlsh": "9111011457319202X9_01",
    "kpjh": "",
    "se": "0.01",
    "tdzzsxmbh": null,
    "zfrq": "",
    "kprq": "20240619193407",
    "bz": "",
    "ssyf": "",
    "ghdwmc": "個(gè)人",
    "scbsbz": "",
    "hdjsjg": null,
    "jbrsfzjlx": "",
    "kpddm": "",
    "zkbz": "",
    "sfyytljdj": null,
    "sfsdts": "0",
    "zfyy": "",
    "ncpsgzjlx": null,
    "zyspmc": "*軟件*票單云財(cái)稅管理系統(tǒng)",
    "fphm": "24112000000064654320",
    "wqhtbabh": null,
    "ceburl": "",
    "tscbz": "0",
    "bchcbz": null,
    "dqsj": "2024-06-19 19:34:07",
    "hjje": "0.99",
    "tqm": "",
    "yfphm": "",
    "zzfphm": "",
    "scbz": "",
    "qdbz": "",
    "hjzkje": null,
    "kpr": "",
    "kpdwdm": "9111011457319202X9",
    "fplxdm": "82",
    "fpzt": "00",
    "rzzt": null,
    "qmcs": "",
    "DZDH": "",
    "tzdh": "",
    "tdys": [],
    "fdjhm": null,
    "GFKHYX": "",
    "zffs": "",
    "hjzkse": null,
    "zfr": "",
    "sfwzzfp": "0",
    "sccgsj": "",
    "dxtsbz": "0",
    "qmz": "",
    "jbrsfzjhm": "",
    "xhdwdm": "9111011457319202X9",
    "fpdm": "",
    "hcFphm": null,
    "xhdwdzdh": "北京市昌平區(qū)東小口鎮(zhèn)天通中苑二區(qū)21號(hào)樓2層1428 135819133199",
    "zbmx": [
      {
        "id": "848d9a9a-398c-4e14-b3fb-968aa8bf61ba",
        "mxid": "b2952853-b739-4ae9-89c2-db0a3d4b6678",
        "fpdm": "",
        "fphm": "24112000000064654320",
        "fpmxxh": "1",
        "xsdjbh": "",
        "fphxz": "0",
        "je": "0.990000000000000000",
        "sl": "0.01",
        "se": "0.01",
        "spmc": "*軟件*票單云財(cái)稅管理系統(tǒng)",
        "spsm": "",
        "ggxh": "V1",
        "dw": "年",
        "spsl": 1,
        "spdj": 0.990099009901,
        "hsbz": "0",
        "spbm": "1060301020100000000",
        "djmxxh": null,
        "bb": "",
        "zxbm": "",
        "yhzcbs": "0",
        "lslbs": "",
        "zzstsgl": "",
        "kprq": "20240619193407",
        "jqbh": "",
        "xhdwdm": "9111011457319202X9",
        "hsje": 1,
        "hsdj": 1,
        "kpdwdm": "9111011457319202X9",
        "cepzmx": null,
        "cqzsh": null
      }
    ],
    "jbrgjlx": "",
    "fhr": "",
    "fjys": null,
    "sjcjhsje": null,
    "hsslbs": "",
    "xhdwmc": "北京民諾科技有限公司",
    "jqbh": "",
    "tspz": "",
    "tzdbh": "",
    "xhdwyhzh": "中國(guó)工商銀行股份有限公司北京西三旗支行 0200240109200016984",
    "zsfs": "0"
  },
  "total": 0
}

返回結(jié)果

狀態(tài)碼	狀態(tài)碼含義	說(shuō)明	數(shù)據(jù)模型
200	OK	成功	Inline

返回?cái)?shù)據(jù)結(jié)構(gòu)

狀態(tài)碼 200

名稱(chēng)	類(lèi)型	必選	約束	說(shuō)明
? code	integer	true	none	none
? msg	string	true	none	none
? data	object	true	none	none
?? kdsbz	null	true	none	none
?? ceburl	string	true	none	none
?? zlqqz	null	true	none	none
?? tscbz	string	true	none	none
?? dqsj	string	true	none	none
?? kce	integer	true	none	none
?? swjgmc	string	true	none	none
?? hjje	number	true	none	none
?? fpcbh	null	true	none	none
?? swjgdm	string	true	none	none
?? tqm	string	true	none	none
?? yfphm	string	true	none	none
?? fwfsd	null	true	none	none
?? skm	string	true	none	none
?? yfpdm	string	true	none	none
?? ghdwdm	string	true	none	none
?? zzfphm	string	true	none	none
?? id	string	true	none	none
?? skr	string	true	none	none
?? scbz	string	true	none	none
?? qdbz	string	true	none	none
?? GFKHDH	string	true	none	none
?? hjzkje	null	true	none	none
?? zfrdm	string	true	none	none
?? bbh	string	true	none	none
?? zfdqsj	null	true	none	none
?? kpr	string	true	none	none
?? kpdwdm	string	true	none	none
?? fplxdm	string	true	none	none
?? fpzt	string	true	none	none
?? spbmjc	string	true	none	none
?? fullAddress	null	true	none	none
?? bmbbbh	string	true	none	none
?? qmcs	string	true	none	none
?? DZDH	string	true	none	none
?? ghdwyhzh	string	true	none	none
?? jshj	integer	true	none	none
?? tzdh	string	true	none	none
?? GFKHYX	string	true	none	none
?? zhsl	null	true	none	none
?? zffs	string	true	none	none
?? qmbz	string	true	none	none
?? spsm	string	true	none	none
?? hjzkse	null	true	none	none
?? slsm	string	true	none	none
?? tdyslxDm	null	true	none	none
?? czydm	string	true	none	none
?? zfr	string	true	none	none
?? yqbz	string	true	none	none
?? hssign	string	true	none	none
?? jzxmmc	null	true	none	none
?? ghdwdzdh	string	true	none	none
?? sfwzzfp	string	true	none	none
?? fpqqlsh	string	true	none	none
?? kpjh	string	true	none	none
?? se	number	true	none	none
?? tdzzsxmbh	null	true	none	none
?? zfrq	string	true	none	none
?? sccgsj	string	true	none	none
?? kprq	string	true	none	none
?? bz	string	true	none	none
?? ssyf	string	true	none	none
?? dxtsbz	string	true	none	none
?? qmz	string	true	none	none
?? ghdwmc	string	true	none	none
?? xhdwdm	string	true	none	none
?? fpdm	string	true	none	none
?? scbsbz	string	true	none	none
?? xhdwdzdh	string	true	none	none
?? hdjsjg	null	true	none	none
?? zbmx	[object]	true	none	none
??? id	string	false	none	none
??? mxid	string	false	none	none
??? fpdm	string	false	none	none
??? fphm	string	false	none	none
??? fpmxxh	string	false	none	none
??? xsdjbh	string	false	none	none
??? fphxz	string	false	none	none
??? je	string	false	none	none
??? sl	string	false	none	none
??? se	string	false	none	none
??? spmc	string	false	none	none
??? spsm	string	false	none	none
??? ggxh	string	false	none	none
??? dw	string	false	none	none
??? spsl	integer	false	none	none
??? spdj	number	false	none	none
??? hsbz	string	false	none	none
??? spbm	string	false	none	none
??? djmxxh	null	false	none	none
??? bb	string	false	none	none
??? zxbm	string	false	none	none
??? yhzcbs	string	false	none	none
??? lslbs	string	false	none	none
??? zzstsgl	string	false	none	none
??? kprq	string	false	none	none
??? jqbh	string	false	none	none
??? xhdwdm	null	false	none	none
??? hsje	integer	false	none	none
??? hsdj	integer	false	none	none
??? kpdwdm	string	false	none	none
??? cepzmx	null	false	none	none
??? cqzsh	null	false	none	none
?? kpddm	string	true	none	none
?? zkbz	string	true	none	none
?? fhr	string	true	none	none
?? sfsdts	string	true	none	none
?? zfyy	string	true	none	none
?? sjcjhsje	null	true	none	none
?? hsslbs	string	true	none	none
?? xhdwmc	string	true	none	none
?? jqbh	string	true	none	none
?? zyspmc	string	true	none	none
?? fphm	string	true	none	none
?? jym	string	true	none	none
?? tzdbh	string	true	none	none
?? wqhtbabh	null	true	none	none
?? xhdwyhzh	string	true	none	none
?? zsfs	string	true	none	none

POST 授信額度查詢(xún)

POST /qdjk/allElectricInvoice/getCreditLine

用于查詢(xún)企業(yè)剩余的可開(kāi)票額度（金額）

Body 請(qǐng)求參數(shù)

nsrsbh: "{{nsrsbh}}"
username: "{{username}}"

請(qǐng)求參數(shù)

名稱(chēng)	位置	類(lèi)型	必選	說(shuō)明
Authorization	header	string	否	none
body	body	object	否	none
? nsrsbh	body	string	是	納稅人識(shí)別號(hào)
? username	body	string	是	局端賬號(hào)

返回示例

成功

{
  "code": 200,
  "msg": "成功",
  "data": {
    "sysxed": "剩余授信額度-保留 2 位小數(shù)",
    "zsxed": "總授信額度-保留 2 為小數(shù)"
  },
  "total": 1
}

{
  "code": 200,
  "msg": "成功",
  "message": "成功",
  "data": {
    "zsxed": "3000000.00",
    "kjlpzs": "1",
    "sysxed": "2995145.63",
    "fpejse": "145.63",
    "ysysxed": "4854.37",
    "fphjje": "4854.37"
  },
  "total": 0
}

返回結(jié)果

狀態(tài)碼	狀態(tài)碼含義	說(shuō)明	數(shù)據(jù)模型
200	OK	成功	Inline

返回?cái)?shù)據(jù)結(jié)構(gòu)

狀態(tài)碼 200

名稱(chēng)	類(lèi)型	必選	約束	中文名	說(shuō)明
? code	integer	true	none		none
? msg	string	true	none		none
? data	object	true	none		none
?? sysxed	string	true	none	剩余授信額度	none
?? zsxed	string	true	none	總授信額度	none
?? kjlpzs	string	true	none		none
?? fpejse	string	true	none		none
?? ysysxed	string	true	none		none
?? fphjje	string	true	none		none
? total	integer	true	none		none
? message	string	true	none		none

POST 獲取是否需要人臉識(shí)別

POST /qdjk/fullApplets/queryFaceAuthState

用于開(kāi)票時(shí)判斷是否需要人臉識(shí)別授權(quán)認(rèn)證

目前，稅局要求開(kāi)票人在開(kāi)票時(shí)進(jìn)行授權(quán)認(rèn)證，48小時(shí)內(nèi)至少認(rèn)證一次

Body 請(qǐng)求參數(shù)

nsrsbh: 91510113MA6739XPX2
username: "{{username}}"

請(qǐng)求參數(shù)

名稱(chēng)	位置	類(lèi)型	必選	說(shuō)明
Authorization	header	string	否	none
body	body	object	否	none
? nsrsbh	body	string	是	納稅人識(shí)別號(hào)
? username	body	string	是	局端賬號(hào)

返回示例

成功

{
  "code": 200,
  "msg": "成功",
  "data": "eyJZampiIjoiMDEiLCJTeGxiIjoiMyIsIlNmc2wiOiJZIiwiSXRzU2NhbkZsYWciOiJOIn0=",
  "total": 0
}

返回結(jié)果

狀態(tài)碼	狀態(tài)碼含義	說(shuō)明	數(shù)據(jù)模型
200	OK	成功	Inline

返回?cái)?shù)據(jù)結(jié)構(gòu)

狀態(tài)碼 200

名稱(chēng)	類(lèi)型	必選	約束	說(shuō)明
? code	integer	true	none	none
? msg	string	true	none	none
? data	string	true	none	需要用base64解碼，如：{“yjjb”:“01”,“Sxlb”:“3”,“Sfsl”:“Y”,““ItsScanFlag”:“N”},其中，Sfsl（是否掃臉）值為N則不需要，值為Y則需要
? total	integer	true	none	none

數(shù)電票接口V1-企業(yè)版/開(kāi)具紅字發(fā)票

POST 申請(qǐng)紅字前查藍(lán)票信息

POST /qdjk/fullExteriorInvoke/retInviceMsg

申請(qǐng)紅字前查藍(lán)票信息

開(kāi)紅字發(fā)票前，需要首先查詢(xún)?cè)摪l(fā)票是否可紅沖

Body 請(qǐng)求參數(shù)

username: 135********
nsrsbh: "{{nsrsbh}}"
fphm: string
sqyy:
  - ""
xhdwsbh: string
kprq: string
tdyslxDm: string

請(qǐng)求參數(shù)

名稱(chēng)	位置	類(lèi)型	必選	說(shuō)明
Authorization	header	string	否	none
body	body	object	否	none
? username	body	string	是	局端賬號(hào)
? nsrsbh	body	string	是	納稅人識(shí)別號(hào)
? fphm	body	string	是	發(fā)票號(hào)碼
? sqyy	body	array	否	申請(qǐng)類(lèi)型，2：銷(xiāo)方紅沖；3：購(gòu)方紅沖
? xhdwsbh	body	string	否	（購(gòu)方申請(qǐng)時(shí)必填）原票銷(xiāo)方稅號(hào)
? kprq	body	string	否	（購(gòu)方申請(qǐng)時(shí)必填）原發(fā)票開(kāi)票日期，格式為：yyyy-MM-dd HH:mm:ss
? tdyslxDm	body	string	否	（購(gòu)方申請(qǐng)時(shí)必填）特定要素類(lèi)型代碼，原發(fā)票有就填寫(xiě)

返回示例

成功

{
  "code": 200,
  "msg": "成功",
  "message": "成功",
  "data": {
    "fphm": "24112000000064654320",
    "message": "成功,本張發(fā)票可以開(kāi)負(fù)數(shù)!",
    "xhdwsbh": "9111011457319202X9",
    "xhdwmc": "北京民諾科技有限公司",
    "ghdwsbh": null,
    "ghdwmc": "個(gè)人",
    "kprq": "2024-06-19 19:34:07",
    "hjje": -0.99,
    "hjse": -0.01,
    "fplxdm": "82",
    "tdyslxdm": null,
    "zsfs": "0",
    "jbr": null,
    "XfsytDm": "00",
    "ZzsytDm": "03",
    "FprzztDm": "00",
    "mxzb": [
      {
        "xh": 1,
        "sl": 0.01,
        "dw": "年",
        "spmc": "*軟件*票單云財(cái)稅管理系統(tǒng)",
        "se": -0.01,
        "je": -0.99,
        "spdj": "0.990099009901",
        "ggxh": "V1",
        "spsl": "-1",
        "spbm": "1060301020100000000",
        "zxbm": "",
        "hsbz": "",
        "yhzcbs": "0",
        "bb": "",
        "zzstsgl": null,
        "sqdh": "",
        "lslbs": ""
      }
    ]
  },
  "total": 0
}

返回結(jié)果

狀態(tài)碼	狀態(tài)碼含義	說(shuō)明	數(shù)據(jù)模型
200	OK	成功	Inline

返回?cái)?shù)據(jù)結(jié)構(gòu)

狀態(tài)碼 200

名稱(chēng)	類(lèi)型	必選	約束	說(shuō)明
? code	integer	true	none	none
? msg	string	true	none	none
? message	string	true	none	none
? data	object	true	none	none
?? fphm	string	true	none	發(fā)票號(hào)碼
?? message	string	true	none	none
?? xhdwsbh	string	true	none	銷(xiāo)方稅號(hào)
?? xhdwmc	string	true	none	銷(xiāo)方名稱(chēng)
?? ghdwsbh	null	true	none	購(gòu)方稅號(hào)
?? ghdwmc	string	true	none	購(gòu)方名稱(chēng)
?? kprq	string	true	none	開(kāi)票日期
?? hjje	number	true	none	合計(jì)金額
?? hjse	number	true	none	合計(jì)稅額
?? fplxdm	string	true	none	發(fā)票類(lèi)型代碼
?? tdyslxdm	string	true	none	特定要素類(lèi)型代碼
?? zsfs	string	true	none	征收方式
?? jbr	string	true	none	經(jīng)辦人
?? XfsytDm	string	true	none	消費(fèi)稅用途狀態(tài) 00 未勾選
?? ZzsytDm	string	true	none	增值稅用戶狀態(tài) 03 未勾選
?? FprzztDm	string	true	none	發(fā)票入賬狀態(tài) 00 未入賬
?? mxzb	[object]	true	none	none
??? xh	integer	false	none	none
??? sl	number	false	none	none
??? dw	string	false	none	none
??? spmc	string	false	none	none
??? se	number	false	none	none
??? je	number	false	none	none
??? spdj	string	false	none	none
??? ggxh	string	false	none	none
??? spsl	string	false	none	none
??? spbm	string	false	none	none
??? zxbm	string	false	none	none
??? hsbz	string	false	none	none
??? yhzcbs	string	false	none	none
??? bb	string	false	none	none
??? zzstsgl	null	false	none	none
??? sqdh	string	false	none	none
??? lslbs	string	false	none	none
? total	integer	true	none	none

POST 紅字發(fā)票開(kāi)具

POST /qdjk/fullExteriorInvoke/hzfpkj

開(kāi)紅字發(fā)票

需要先申請(qǐng)紅字信息表

Body 請(qǐng)求參數(shù)

username: 135*****
fpqqlsh: 1111_1111
xhdwsbh: "{{nsrsbh}}"
tzdbh: "11011424061000028528"
yfphm: "24112000000064654320"
tdyslxDm: string

請(qǐng)求參數(shù)

名稱(chēng)	位置	類(lèi)型	必選	說(shuō)明
Authorization	header	string	否	none
body	body	object	否	none
? username	body	string	是	局端賬號(hào)
? fpqqlsh	body	string	是	發(fā)票流水號(hào)，要求“稅號(hào)_自定義編號(hào)”
? xhdwsbh	body	string	是	銷(xiāo)方稅號(hào)
? tzdbh	body	string	是	紅字信息表編號(hào)
? yfphm	body	string	是	原發(fā)票號(hào)碼
? tdyslxDm	body	string	否	特殊票種

返回示例

成功

{
  "code": 200,
  "msg": "負(fù)數(shù)發(fā)票開(kāi)具成功",
  "message": "負(fù)數(shù)發(fā)票開(kāi)具成功",
  "data": {
    "fphm": "24112000000064636722",
    "kprq": "2024-06-19 19:55:40",
    "xhdwsbh": "9111011457319202X9",
    "ghdwsbh": "",
    "xhdwmc": "北京民諾科技有限公司",
    "ghdwmc": "個(gè)人",
    "jshj": -1,
    "xxbbh": "11011424061000028528"
  },
  "total": 0
}

返回結(jié)果

狀態(tài)碼	狀態(tài)碼含義	說(shuō)明	數(shù)據(jù)模型
200	OK	成功	Inline

返回?cái)?shù)據(jù)結(jié)構(gòu)

狀態(tài)碼 200

名稱(chēng)	類(lèi)型	必選	約束	說(shuō)明
? code	integer	true	none	none
? msg	string	true	none	none
? message	string	true	none	none
? data	object	true	none	none
?? fphm	string	true	none	紅字發(fā)票號(hào)碼
?? kprq	string	true	none	開(kāi)票日期
?? xhdwsbh	string	true	none	銷(xiāo)方稅號(hào)
?? ghdwsbh	string	true	none	購(gòu)方稅號(hào)
?? xhdwmc	string	true	none	銷(xiāo)方名稱(chēng)
?? ghdwmc	string	true	none	購(gòu)方名稱(chēng)
?? jshj	integer	true	none	價(jià)稅合計(jì)
?? xxbbh	string	true	none	紅字信息表編號(hào)
? total	integer	true	none	none

POST 申請(qǐng)紅字信息表

POST /qdjk/fullExteriorInvoke/hzxxbsq

申請(qǐng)紅字信息表

開(kāi)負(fù)數(shù)發(fā)票前，需要先申請(qǐng)紅字信息表

Body 請(qǐng)求參數(shù)

username: 135*******
xhdwsbh: "{{nsrsbh}}"
yfphm: 240****
chyydm: "01"
sqyy: "2"
sdfpbz: string
hzxxbcheck: string

請(qǐng)求參數(shù)

名稱(chēng)	位置	類(lèi)型	必選	說(shuō)明
Authorization	header	string	否	none
body	body	object	否	none
? username	body	string	是	局端賬號(hào)
? xhdwsbh	body	string	是	銷(xiāo)方稅號(hào)
? yfphm	body	string	是	發(fā)票號(hào)碼
? chyydm	body	string	是	申請(qǐng)紅字信息表原因代碼：01，開(kāi)票有誤；02，銷(xiāo)貨退回；03，服務(wù)中止；04，銷(xiāo)售折讓。目前局端部分沖紅只支持：02，銷(xiāo)貨退回；03，服務(wù)中止。商品服務(wù)編碼僅為服務(wù)時(shí)紅沖原因不允許選擇“02，銷(xiāo)售退回”如原藍(lán)字發(fā)票商品服務(wù)編碼僅為貨物或勞務(wù)時(shí)紅沖原因不允許選擇“03，服務(wù)中止”
? sqyy	body	string	是	（暫時(shí)只支持）2：銷(xiāo)方全額紅沖；3:購(gòu)方全額紅沖
? sdfpbz	body	string	否	數(shù)電發(fā)票標(biāo)志。只有數(shù)電紙票才需要該節(jié)點(diǎn)，藍(lán)票是數(shù)電紙票，開(kāi)具負(fù)數(shù)數(shù)電發(fā)票，該節(jié)點(diǎn)傳 1
? hzxxbcheck	body	string	否	紅字信息表校驗(yàn)標(biāo)志。傳 1 不校驗(yàn)，直接去 1局端申請(qǐng)，否則申請(qǐng)過(guò)紅字信息表返回申請(qǐng)過(guò)的數(shù)據(jù)

返回示例

成功

{
  "code": 200,
  "msg": "成功",
  "message": "成功",
  "data": {
    "sqsj": "2024-06-19 19:55:40",
    "xxbztDm": "01",
    "xxbbh": "11011424061000028528",
    "uuid": "4e75f060b492476383338a63aa96537a",
    "xxbzt": "無(wú)需確認(rèn)"
  },
  "total": 0
}

返回結(jié)果

狀態(tài)碼	狀態(tài)碼含義	說(shuō)明	數(shù)據(jù)模型
200	OK	成功	Inline

返回?cái)?shù)據(jù)結(jié)構(gòu)

狀態(tài)碼 200

名稱(chēng)	類(lèi)型	必選	約束	說(shuō)明
? code	integer	true	none	none
? msg	string	true	none	none
? message	string	true	none	none
? data	object	true	none	none
?? sqsj	string	true	none	申請(qǐng)時(shí)間
?? xxbztDm	string	true	none	紅字信息表狀態(tài)代碼見(jiàn)附件三
?? xxbbh	string	true	none	紅字信息表編號(hào)
?? uuid	string	true	none	紅字信息表狀態(tài)
?? xxbzt	string	true	none	none
? total	integer	true	none	none

自助開(kāi)票

多賬戶管理

API接入

智能增值

銷(xiāo)項(xiàng)管理

申報(bào)管理

進(jìn)項(xiàng)管理

面向終端商戶（SaaS）

面向企業(yè)集群（SaaS、FaaS）

面向平臺(tái)軟件（FaaS、API）

票單云WEB端

API

票單云

Authentication

數(shù)電票接口V1-基礎(chǔ)版/獲取訪問(wèn)令牌

POST 獲取訪問(wèn)令牌

請(qǐng)求參數(shù)

返回結(jié)果

返回?cái)?shù)據(jù)結(jié)構(gòu)

數(shù)電票接口V1-基礎(chǔ)版/數(shù)電票接口

GET 獲取人臉二維碼

用于獲取授權(quán)認(rèn)證人臉識(shí)別二維碼

請(qǐng)求參數(shù)

返回結(jié)果

返回?cái)?shù)據(jù)結(jié)構(gòu)

POST 藍(lán)字發(fā)票開(kāi)具

用于開(kāi)具藍(lán)字發(fā)票

請(qǐng)求參數(shù)

返回結(jié)果

返回?cái)?shù)據(jù)結(jié)構(gòu)

POST 獲取版式文件

用于獲取pdf、odf、xml等版式的發(fā)票文件

請(qǐng)求參數(shù)

返回結(jié)果

返回?cái)?shù)據(jù)結(jié)構(gòu)

POST 登錄電票平臺(tái)

用于接入電子稅局

請(qǐng)求參數(shù)

返回結(jié)果

返回?cái)?shù)據(jù)結(jié)構(gòu)

POST 發(fā)票詳細(xì)查詢(xún)

用于查詢(xún)發(fā)票的詳細(xì)信息

請(qǐng)求參數(shù)

返回結(jié)果

返回?cái)?shù)據(jù)結(jié)構(gòu)

POST 授信額度查詢(xún)

用于查詢(xún)企業(yè)剩余的可開(kāi)票額度（金額）

請(qǐng)求參數(shù)

返回結(jié)果

返回?cái)?shù)據(jù)結(jié)構(gòu)

POST 獲取是否需要人臉識(shí)別

用于開(kāi)票時(shí)判斷是否需要人臉識(shí)別授權(quán)認(rèn)證

請(qǐng)求參數(shù)

返回結(jié)果

返回?cái)?shù)據(jù)結(jié)構(gòu)

數(shù)電票接口V1-企業(yè)版/開(kāi)具紅字發(fā)票

POST 申請(qǐng)紅字前查藍(lán)票信息

申請(qǐng)紅字前查藍(lán)票信息

請(qǐng)求參數(shù)

返回結(jié)果

返回?cái)?shù)據(jù)結(jié)構(gòu)

POST 紅字發(fā)票開(kāi)具

開(kāi)紅字發(fā)票

請(qǐng)求參數(shù)

返回結(jié)果

返回?cái)?shù)據(jù)結(jié)構(gòu)

POST 申請(qǐng)紅字信息表

申請(qǐng)紅字信息表

請(qǐng)求參數(shù)

返回結(jié)果

返回?cái)?shù)據(jù)結(jié)構(gòu)

數(shù)據(jù)模型

面向企業(yè)集群（SaaS、FaaS）

用于獲取pdf、odf、xml等版式的發(fā)票文件