發(fā)票開具
接口規(guī)范包括通 用規(guī)范和業(yè)務(wù)規(guī)范。通用規(guī)范描述所有接口必須遵守的公共部分,業(yè)務(wù)規(guī)范根據(jù)具體業(yè)務(wù)交 互內(nèi)容不同,描述實際業(yè)務(wù)需要的詳細(xì)數(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)的負(fù)數(shù)發(fā)票號碼 |
XHFMC | 銷貨方名稱 | String | 否 | - | 默認(rèn)為空 |
XHFNSRSBH | 銷貨方納稅人識別號 | String | 否 | - | 默認(rèn)為空 |
XHFDZ | 銷貨方地址 | String | 否 | - | 默認(rèn)為空 |
XHFDH | 銷貨方電話 | String | 否 | - | 默認(rèn)為空 |
XHFKHYH | 銷貨方開戶銀行 | String | 否 | - | 默認(rèn)為空 |
XHFKHYHZH | 銷貨方開戶銀行賬號 | String | 否 | - | 默認(rèn)為空 |
KPR | 開票人 | String | 否 | - | 默認(rèn)為空 |
FHR | 復(fù)合人 | String | 否 | - | 默認(rèn)為空 |
SKR | 收款人 | String | 否 | - | 默認(rèn)為空 |
QDBZ | 清單標(biāo)志 | String | 是 | 1 | 默認(rèn)為 0 普通電子發(fā)票,其他類型參考擴展說明:清單標(biāo)志 |
SGBZ | 收購標(biāo)志 | String | 否 | - | 默認(rèn)為空,成品油發(fā)票填: C |
DKXX | 代開信息 | String | 否 | - | |
BZ | 備注 | String | 否 | 200 | 開票類型為1 或者開具 差額票時:參照擴展說明:備注說明規(guī)范 |
發(fā)票明細(xì)信息 | |||||
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 | 零稅率標(biāo)識 | String | 否 | 1 | 空:非零稅率0:出口零稅1:免稅2:不征稅3:普通零稅率 |
YHZCBS | 優(yōu)惠政策內(nèi)容 | String | 是 | 1 | 0:不使用,1:使用零稅率必享受優(yōu)惠政策 |
ZZSTSGL | 增值稅特殊管理 | String | 否 | 500 | YHZCBS:1時必填參照擴展說明:增值稅特殊管理 |
HSBZ | 含稅標(biāo)志 | String | 是 | 1 | 默認(rèn)填寫: 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ā)票報文: