發(fā)票開(kāi)具
接口規(guī)范包括通 用規(guī)范和業(yè)務(wù)規(guī)范。通用規(guī)范描述所有接口必須遵守的公共部分，業(yè)務(wù)規(guī)范根據(jù)具體業(yè)務(wù)交 互內(nèi)容不同，描述實(shí)際業(yè)務(wù)需要的詳細(xì)數(shù)據(jù)內(nèi)容。
請(qǐng)求地址：
| 環(huán)境 | http請(qǐng)求地址 | 請(qǐng)求方式 | 接口編碼 |
|---|---|---|---|
| 正式環(huán)境 | http://IP:port/OpenApi/InvoiceOpenApi/v2.0/InvoiceIssue | POST |
請(qǐng)求報(bào)文（DATA）：
請(qǐng)求參數(shù)說(shuō)明：
| 參數(shù) | 參數(shù)名稱(chēng) | 類(lèi)型 | 是否必須 | 長(zhǎng)度 | 說(shuō)明 |
|---|---|---|---|---|---|
| FPQQLSH | 請(qǐng)求流水號(hào) | String | 是 | 50 | 流水號(hào)（生成規(guī)則：稅號(hào) + 隨機(jī)數(shù) 長(zhǎng)度為30 唯一值） |
| ORDERNO | 企業(yè)訂單號(hào) | String | 否 | 50 | |
| GHFMC | 購(gòu)貨方名稱(chēng) | String | 是 | 100 | 必填 |
| GHFNSRSBH | 購(gòu)貨方納稅人識(shí)別號(hào) | String | 否 | 20 | |
| GHFDZ | 購(gòu)貨方地址 | String | 否 | 100 | |
| GHFDH | 購(gòu)貨方電話(huà) | String | 否 | 100 | |
| GHFKHYH | 購(gòu)貨方開(kāi)戶(hù)行 | String | 否 | 100 | |
| GHFKHYHZH | 購(gòu)貨方開(kāi)戶(hù)銀行賬號(hào) | String | 否 | 100 | |
| GHFSJ | 購(gòu)貨方手機(jī) | String | 否 | 20 | 消息推送 |
| GHFYX | 購(gòu)貨方郵箱 | String | 否 | 100 | 消息推送 |
| JSHJ | 價(jià)稅合計(jì) | Decimal | 是 | 20 | 保留2位小數(shù),開(kāi)票類(lèi)型為 1：對(duì)應(yīng)正數(shù)發(fā)票金額 * -1 |
| HJSE | 合計(jì)稅額 | Decimal | 是 | 20 | 保留2位小數(shù),開(kāi)票類(lèi)型為 1：對(duì)應(yīng)正數(shù)發(fā)票金額 * -1 |
| HJJE | 合計(jì)金額 | Decimal | 是 | 20 | 保留2位小數(shù),開(kāi)票類(lèi)型為 1：對(duì)應(yīng)正數(shù)發(fā)票金額 * -1 |
| KPLX | 開(kāi)票類(lèi)型 | String | 是 | 1 | 1：紅票，0：正票 |
| ORIGINFPDM | 原發(fā)票代碼 | String | 否 | 12 | 開(kāi)票類(lèi)型為1時(shí),必填,對(duì)應(yīng)的正數(shù)發(fā)票代碼 |
| ORIGINFPHM | 原發(fā)票號(hào)碼 | String | 否 | 8 | 開(kāi)票類(lèi)型為1時(shí),必填,對(duì)應(yīng)的負(fù)數(shù)發(fā)票號(hào)碼 |
| XHFMC | 銷(xiāo)貨方名稱(chēng) | String | 否 | - | 默認(rèn)為空 |
| XHFNSRSBH | 銷(xiāo)貨方納稅人識(shí)別號(hào) | String | 否 | - | 默認(rèn)為空 |
| XHFDZ | 銷(xiāo)貨方地址 | String | 否 | - | 默認(rèn)為空 |
| XHFDH | 銷(xiāo)貨方電話(huà) | String | 否 | - | 默認(rèn)為空 |
| XHFKHYH | 銷(xiāo)貨方開(kāi)戶(hù)銀行 | String | 否 | - | 默認(rèn)為空 |
| XHFKHYHZH | 銷(xiāo)貨方開(kāi)戶(hù)銀行賬號(hào) | String | 否 | - | 默認(rèn)為空 |
| KPR | 開(kāi)票人 | String | 否 | - | 默認(rèn)為空 |
| FHR | 復(fù)合人 | String | 否 | - | 默認(rèn)為空 |
| SKR | 收款人 | String | 否 | - | 默認(rèn)為空 |
| QDBZ | 清單標(biāo)志 | String | 是 | 1 | 默認(rèn)為 0 普通電子發(fā)票，其他類(lèi)型參考擴(kuò)展說(shuō)明：清單標(biāo)志 |
| SGBZ | 收購(gòu)標(biāo)志 | String | 否 | - | 默認(rèn)為空,成品油發(fā)票填： C |
| DKXX | 代開(kāi)信息 | String | 否 | - | |
| BZ | 備注 | String | 否 | 200 | 開(kāi)票類(lèi)型為1 或者開(kāi)具 差額票時(shí)：參照擴(kuò)展說(shuō)明：備注說(shuō)明規(guī)范 |
| 發(fā)票明細(xì)信息 | |||||
| SPMC | 商品名稱(chēng) | String | 是 | 90 | 如果存在折扣行，折扣行商品名稱(chēng)和被折扣行商品名稱(chēng)要一致，折扣行要緊挨著被折扣行 |
| SPBM | 商品編碼 | String | 是 | 19 | 商品編碼,根據(jù)商品編碼表獲得,長(zhǎng)度19位（不足末位補(bǔ)0） |
| SPBMJM | 商品簡(jiǎn)碼 | String | 是 | 50 | 商品簡(jiǎn)碼,根據(jù)商品編碼表獲得 格式如：”*服務(wù)費(fèi)*” ；前后用”*“+商品簡(jiǎn)碼連接 |
| SPSLV | 稅率 | Decimal | 是 | 10 | 保留2位小數(shù) |
| SPSL | 數(shù)量 | Decimal | 否 | 20 | |
| SPDJ | 單價(jià) | Decimal | 否 | 20 | |
| SPSE | 稅額 | Decimal | 是 | 20 | 單位：元(2位小數(shù)) |
| SPJE | 金額 | Decimal | 是 | 16 | 單位：元(2位小數(shù)) |
| SPGGXX | 規(guī)格型號(hào) | String | 否 | 20 | |
| SPJLDW | 計(jì)量單位 | String | 否 | 22 | |
| SPHXZ | 發(fā)票行性質(zhì) | String | 是 | 1 | 0：正常行1：折扣行2：被折扣行 |
| SPZKHBH | 折扣編號(hào) | String | 否 | 5 | 行性質(zhì)為 2 或 1 時(shí)必填,被折扣行與折扣行的折扣編號(hào)一致（編號(hào)示例:“ZK001”長(zhǎng)度為5）同一行商品不能被多次折扣 |
| LSLBS | 零稅率標(biāo)識(shí) | String | 否 | 1 | 空：非零稅率0：出口零稅1：免稅2：不征稅3：普通零稅率 |
| YHZCBS | 優(yōu)惠政策內(nèi)容 | String | 是 | 1 | 0：不使用,1：使用零稅率必享受優(yōu)惠政策 |
| ZZSTSGL | 增值稅特殊管理 | String | 否 | 500 | YHZCBS：1時(shí)必填參照擴(kuò)展說(shuō)明：增值稅特殊管理 |
| HSBZ | 含稅標(biāo)志 | String | 是 | 1 | 默認(rèn)填寫(xiě)： 1 ；0：不含稅,1：含稅 |
| KCE | 扣除額 | Decimal | 否 | - | 空：不處理,不為空：按差額發(fā)票處理，參照擴(kuò)展說(shuō)明：差額征稅 |
異步請(qǐng)求響應(yīng)參數(shù)：
響應(yīng)參數(shù)說(shuō)明：
| 參數(shù) | 參數(shù)名稱(chēng) | 類(lèi)型 | 是否必須 | 長(zhǎng)度 | 說(shuō)明 |
|---|---|---|---|---|---|
| RETURNCODE | 返回狀態(tài)碼 | String | 是 | - | 200 接收成功 |
| RETURNMESSAGE | 返回描述 | String | 是 | - |
異步結(jié)果響應(yīng)參數(shù)：
異步結(jié)果響應(yīng)參數(shù)說(shuō)明：
| 參數(shù) | 參數(shù)名稱(chēng) | 類(lèi)型 | 是否必須 | 長(zhǎng)度 | 說(shuō)明 |
|---|---|---|---|---|---|
| RETURNCODE | 返回碼 | String | 是 | - | 0000 成功,其他失敗 |
| RETURNMESSAGE | 返回描述 | String | 否 | - | |
| FPQQLSH | 流水號(hào) | String | 是 | - | 與請(qǐng)求提交流水號(hào)一致 |
| FPHM | 發(fā)票號(hào)碼 | String | 是 | - | |
| FPDM | 發(fā)票代碼 | String | 是 | - | |
| KPRQ | 開(kāi)票日期 | String | 是 | - | yyyy-MM-dd hh:mm:ss |
| JQBH | 機(jī)器編號(hào) | String | 是 | - | |
| FPMW | 發(fā)票密文 | String | 是 | - | |
| JYM | 校驗(yàn)碼 | String | 是 | - | |
| EWM | 二維碼 | String | 是 | - | |
| QZRQ | 簽章日期 | String | 否 | - | yyyy-MM-dd hh:mm:ss為空時(shí)：簽章失敗 |
| PDFURL | Pdf下載地址 | String | 否 | - | 簽章日期為空時(shí)：顯示簽章失敗異常原因 |
開(kāi)票報(bào)文：
差額征稅報(bào)文：
帶折扣行報(bào)文：
成品油發(fā)票報(bào)文：