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