發(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/Buy/InvoiceGet | POST |
請求報文(DATA)：
請求參數(shù)說明：
| 參數(shù) | 參數(shù)名稱 | 類型 | 是否必須 | 長度 | 說明 |
|---|---|---|---|---|---|
| INVOICETYPE | 發(fā)票類型 | String | 是 | 2 | 增值稅專用發(fā)票：01 機(jī)動車銷售統(tǒng)一發(fā)票：03 通訊費電子發(fā)票：14 |
| BUYERTAXNO | 購方稅號 | String | 是 | 15/18 | |
| BATCHNO | 批次號 | String | 是 | 32 | 32位如果多次重復(fù)的話，此值要一樣，代表是一次請求 |
| ACQUISITIONDATEBEGIN | 發(fā)票采集開始時間 | String | 是 | 14 | YYYYMMDDHHMMSS例如：20170101140245 |
| ACQUISITIONDATEEND | 發(fā)票采集結(jié)束時間 | String | 是 | 14 | YYYYMMDDHHMMSS例如：20170101140245 |
| STARTROW | 開始行數(shù) | int | 是 | 整數(shù)，第一次請求時為1 | |
| STATUS | 狀態(tài)標(biāo)志 | String | 是 | 1 | 當(dāng)給1時繼續(xù)請求，0時結(jié)束請求 |
請求響應(yīng)參數(shù)：
響應(yīng)參數(shù)說明：
| 參數(shù) | 參數(shù)名稱 | 類型 | 是否必須 | 長度 | 說明 |
|---|---|---|---|---|---|
| INVOICETYPE | 發(fā)票類型 | String | 是 | 2 | 增值稅專用發(fā)票：01 機(jī)動車銷售統(tǒng)一發(fā)票：03 通訊費電子發(fā)票：14 |
| TOTALROWS | 總行數(shù) | Int | 是 | - | |
| STARTROW | 開始行數(shù) | Int | 是 | - | 整數(shù)，第一次請求時為1 |
| CONTENTROWS | 本次請求返回行數(shù) | Int | 是 | - | |
| INVOICES數(shù)據(jù) | |||||
| INVOICETYPE | 發(fā)票類型 | String | 是 | 2 | 增值稅專用發(fā)票：01 機(jī)動車銷售統(tǒng)一發(fā)票：03 通訊費電子發(fā)票：14 |
| INVOICECODE | 發(fā)票代碼 | String | 是 | 10/12 | |
| INVOICENO | 發(fā)票號碼 | String | 是 | 8 | |
| CURRENTTAXPERIOD | 當(dāng)前稅款所屬期 | String | 是 | 6 | YYYYMM |
| LEGALIZEENDDATE | 當(dāng)前稅款所屬期勾選截至日 | String | 是 | 8 | YYYYMMDD |
| LEGALIZEINVOICEDATEBEGIN | 當(dāng)前稅款所屬期可勾選選發(fā)票開票日期起 | String | 是 | 8 | YYYYMMDD |
| LEGALIZEINVOICEDATEEND | 當(dāng)前稅款所屬期可勾選發(fā)票開票日期止 | String | 是 | 8 | YYYYMMDD |
| BUYERNAME | 購方名稱 | String | 否 | 100 | |
| BUYERTAXNO | 購方稅號 | String | 否 | 15/18 | |
| BUYERADDRESSPHONE | 購方地址、電話 | String | 否 | 100 | |
| SALERNAME | 銷方名稱 | String | 否 | 100 | |
| SALERTAXNO | 銷方稅號 | String | 否 | 15/18 | |
| SALERADDRESSPHONE | 銷方地址、電話 | String | 否 | 100 | |
| INVOICEDATE | 開票日期 | String | 否 | 8 | YYYYMMDD |
| INVOICEAMOUNT | 發(fā)票金額 | String | 否 | 16 | |
| TAXAMOUNT | 發(fā)票稅額 | String | 否 | 16 | |
| TOTALAMOUNT | 價稅合計 | String | 否 | 16 | |
| REMARK | 備注 | String | 否 | 200 | |
| INVOICESTATUS | 發(fā)票狀態(tài) | String | 否 | 2 | 0-正常 1-失控 2-作廢 3-紅沖 4-異常 |
| LEGALIZESTATE | 認(rèn)證狀態(tài) | String | 否 | 1 | 0-未認(rèn)證 1-已認(rèn)證 |
| LEGALIZEDATE | 認(rèn)證日期 | String | 否 | 8 | YYYYMMDD |
| LEGALIZETYPE | 認(rèn)證方式 | String | 否 | 1 | 1-勾選認(rèn)證 2-掃描認(rèn)證 |
| SFDBTS | 是否代辦退稅 | String | 否 | 1 | 0-否 1-是 |
| RZLX | 認(rèn)證類型 | String | 否 | 1 | 1-抵扣 2-退稅 3-代理退稅（未認(rèn)證是為0或為空） |
| LSLBZ | 零稅率標(biāo)志 | String | 否 | 1 | 空-非零稅率 1-免稅 2-不征收 3-零稅率 |
| LEGALIZEBLONGDATE | 認(rèn)證歸屬期 | String | 否 | 6 | YYYYMM |
| CHECKCODE | 校驗碼 | String | 否 | 255 | |
| BUYERACOUNT | 購方開戶行及賬號 | String | 否 | 100 | |
| SALERACOUNT | 銷方開戶行及賬號 | String | 否 | 100 | |
| DETAILLIST數(shù)據(jù) | |||||
| DETAILNO | 明細(xì)編號 | String | 是 | 90 | |
| GOODSNAME | 貨物名稱 | String | 是 | 255 | |
| GOODSNUM | 商品編碼 | String | 否 | 19 | |
| SPECIFICATIONMODEL | 規(guī)格型號 | String | 否 | 50 | |
| UNIT | 計量單位 | String | 否 | 10 | |
| NUM | 數(shù)量 | String | 否 | 24 | |
| DETAILAMOUNT | 金額 | String | 否 | 22 | |
| TAXRATE | 稅率 | String | 否 | 24 | |
| TAXAMOUNT | 稅額 | String | 否 | 24 | |
| UNITPRICE | 不含稅單價 | String | 否 | 24 | |
請求響應(yīng)參數(shù)：
響應(yīng)參數(shù)說明：
| 參數(shù) | 參數(shù)名稱 | 類型 | 是否必須 | 長度 | 說明 |
|---|---|---|---|---|---|
| INVOICETYPE | 發(fā)票類型 | String | 是 | 2 | 增值稅專用發(fā)票：01 機(jī)動車銷售統(tǒng)一發(fā)票：03 通訊費電子發(fā)票：14 |
| TOTALROWS | 總行數(shù) | Int | 是 | - | |
| STARTROW | 開始行數(shù) | Int | 是 | - | 整數(shù)，第一次請求時為1 |
| CONTENTROWS | 本次請求返回行數(shù) | Int | 是 | - | |
| INVOICES數(shù)據(jù) | |||||
| INVOICECODE | 發(fā)票代碼 | String | 是 | 10/12 | |
| INVOICENO | 發(fā)票號碼 | String | 是 | 8 | |
| CURRENTTAXPERIOD | 當(dāng)前稅款所屬期 | String | 是 | 6 | YYYYMM |
| LEGALIZEENDDATE | 當(dāng)前稅款所屬期勾選截至日 | String | 是 | 8 | YYYYMMDD |
| LEGALIZEINVOICEDATEBEGIN | 當(dāng)前稅款所屬期可勾選選發(fā)票開票日期起 | String | 是 | 8 | YYYYMMDD |
| LEGALIZEINVOICEDATEEND | 當(dāng)前稅款所屬期可勾選發(fā)票開票日期止 | String | 是 | 8 | YYYYMMDD |
| BUYERNAME | 購方名稱 | String | 否 | 100 | |
| BUYERTAXNO | 購方稅號 | String | 否 | 15/18 | |
| BUYERADDRESSPHONE | 購方地址、電話 | String | 否 | 100 | |
| SALERNAME | 銷方名稱 | String | 否 | 100 | |
| INVOICEDATE | 開票日期 | String | 否 | 8 | YYYYMMDD |
| REMARK | 備注 | String | 否 | 200 | |
| LEGALIZESTATE | 認(rèn)證狀態(tài) | String | 否 | 1 | 0-未認(rèn)證 1-已認(rèn)證 |
| LEGALIZEDATE | 認(rèn)證日期 | String | 否 | 8 | YYYYMMDD |
| LEGALIZETYPE | 認(rèn)證方式 | String | 否 | 1 | 1-勾選認(rèn)證 2-掃描認(rèn)證 |
| SFDBTS | 是否代辦退稅 | String | 否 | 1 | 0-否 1-是 |
| RZLX | 認(rèn)證類型 | String | 否 | 1 | 1-抵扣 2-退稅 3-代理退稅（未認(rèn)證是為0或為空） |
| BUYERIDNUM | 購買方身份證號碼/組織機(jī)構(gòu)代碼 | String | 否 | 240 | |
| VEHICLETYPE | 車輛類型 | String | 否 | 80 | |
| FACTORYMODEL | 廠牌型號 | String | 否 | 100 | |
| PRODUCTPLACE | 產(chǎn)地 | String | 否 | 80 | |
| CERTIFICATE | 合格證書 | String | 否 | 100 | |
| CERTIFICATEIMPORT | 進(jìn)口證明書號 | String | 否 | 80 | |
| INSPECTIONNUM | 商檢單號 | String | 否 | 80 | |
| ENGINENO | 發(fā)動機(jī)號碼 | String | 否 | 120 | |
| VEHICLENO | 車架號碼/車輛識別號 | String | 否 | 40 | |
| TOTALAMOUNT | 價稅合計 | String | 否 | 16 | 2位小數(shù) |
| PHONE | 電話 | String | 否 | 80 | |
| TAXNUM | 納稅人識別號 | String | 是 | 20 | |
| BUYERACOUNT | 賬號 | String | 否 | 80 | |
| BUYERBANK | 開戶銀行 | String | 否 | 160 | |
| TAXRATE | 稅率 | String | 是 | 10 | 正數(shù)如稅率17%，填寫17 |
| TAXAMOUNT | 稅額 | String | 是 | 16 | 2位小數(shù) |
| TAXBUREAUCODE | 主管稅務(wù)機(jī)關(guān)代碼 | String | 否 | 11 | |
| TAXBUREAUNAME | 主管稅務(wù)機(jī)關(guān)名稱 | String | 否 | 80 | |
| INVOICEAMOUNT | 合計金額 | String | 是 | 16 | 2位小數(shù) |
| TAXRECORDS | 完稅憑證號碼 | String | 否 | 100 | |
| TONNAGE | 噸位 | String | 否 | 40 | |
| LIMITPEOPLE | 限乘人數(shù) | String | 否 | 40 | |
| INVOICESTATUS | 發(fā)票狀態(tài) | String | 是 | 1 | 0-正常 1-失控 2-作廢 3-沖紅4-異常 |
| TAXPERIOD | 稅款所屬期 | String | 否 | 4 | YYYYMM |
| LEGALIZETYPE | 認(rèn)證方式 | String | 否 | 1 | 1-勾選認(rèn)證 2-掃描認(rèn)證 |
請求響應(yīng)參數(shù)：
響應(yīng)參數(shù)說明：
| 參數(shù) | 參數(shù)名稱 | 類型 | 是否必須 | 長度 | 說明 |
|---|---|---|---|---|---|
| INVOICETYPE | 發(fā)票類型 | String | 是 | 2 | 增值稅專用發(fā)票：01 機(jī)動車銷售統(tǒng)一發(fā)票：03 通訊費電子發(fā)票：14 |
| TOTALROWS | 總行數(shù) | Int | 是 | - | |
| STARTROW | 開始行數(shù) | Int | 是 | - | 整數(shù)，第一次請求時為1 |
| CONTENTROWS | 本次請求返回行數(shù) | Int | 是 | - | |
| INVOICES數(shù)據(jù) | |||||
| INVOICETYPE | 發(fā)票類型 | String | 是 | 2 | 增值稅專用發(fā)票：01 機(jī)動車銷售統(tǒng)一發(fā)票：03 通訊費電子發(fā)票：14 |
| INVOICECODE | 發(fā)票代碼 | String | 是 | 10/12 | |
| INVOICENO | 發(fā)票號碼 | String | 是 | 8 | |
| CURRENTTAXPERIOD | 當(dāng)前稅款所屬期 | String | 是 | 6 | YYYYMM |
| LEGALIZEENDDATE | 當(dāng)前稅款所屬期勾選截至日 | String | 是 | 8 | YYYYMMDD |
| LEGALIZEINVOICEDATEBEGIN | 當(dāng)前稅款所屬期可勾選選發(fā)票開票日期起 | String | 是 | 8 | YYYYMMDD |
| LEGALIZEINVOICEDATEEND | 當(dāng)前稅款所屬期可勾選發(fā)票開票日期止 | String | 是 | 8 | YYYYMMDD |
| BUYERNAME | 購方名稱 | String | 否 | 100 | |
| BUYERTAXNO | 購方稅號 | String | 否 | 15/18 | |
| BUYERADDRESSPHONE | 購方地址、電話 | String | 否 | 100 | |
| SALERNAME | 銷方名稱 | String | 否 | 100 | |
| SALERTAXNO | 銷方稅號 | String | 否 | 15/18 | |
| SALERADDRESSPHONE | 銷方地址、電話 | String | 否 | 100 | |
| INVOICEDATE | 開票日期 | String | 否 | 8 | YYYYMMDD |
| INVOICEAMOUNT | 發(fā)票金額 | String | 否 | 16 | |
| TAXAMOUNT | 發(fā)票稅額 | String | 否 | 16 | |
| TOTALAMOUNT | 價稅合計 | String | 否 | 16 | |
| REMARK | 備注 | String | 否 | 200 | |
| INVOICESTATUS | 發(fā)票狀態(tài) | String | 否 | 2 | 0-正常 1-失控 2-作廢 3-紅沖 4-異常 |
| LEGALIZESTATE | 認(rèn)證狀態(tài) | String | 否 | 1 | 0-未認(rèn)證 1-已認(rèn)證 |
| LEGALIZEDATE | 認(rèn)證日期 | String | 否 | 8 | YYYYMMDD |
| LEGALIZETYPE | 認(rèn)證方式 | String | 否 | 1 | 1-勾選認(rèn)證 2-掃描認(rèn)證 |
| SFDBTS | 是否代辦退稅 | String | 否 | 1 | 0-否 1-是 |
| RZLX | 認(rèn)證類型 | String | 否 | 1 | 1-抵扣 2-退稅 3-代理退稅（未認(rèn)證是為0或為空） |
| LSLBZ | 零稅率標(biāo)志 | String | 否 | 1 | 空-非零稅率 1-免稅 2-不征收 3-零稅率 |
| LEGALIZEBLONGDATE | 認(rèn)證歸屬期 | String | 否 | 6 | YYYYMM |
| CHECKCODE | 校驗碼 | String | 否 | 255 | |
| BUYERACOUNT | 購方開戶行及賬號 | String | 否 | 100 | |
| SALERACOUNT | 銷方開戶行及賬號 | String | 否 | 100 | |
| TXFBZ | 通行費標(biāo)志 | String | 否 | 1 | N-不可抵扣通行費 Y-可抵扣通行費 |
| DETAILLIST數(shù)據(jù) | |||||
| DETAILNO | 明細(xì)編號 | String | 否 | 90 | |
| GOODSNAME | 貨物名稱 | String | 否 | 255 | |
| DETAILAMOUNT | 金額 | String | 否 | 22 | |
| TAXRATE | 稅率 | String | 否 | 24 | |
| TAXAMOUNT | 稅額 | String | 否 | 24 | |
| CPH | 車牌號 | String | 否 | 50 | |
| LX | 類型 | String | 否 | 50 | |
| TXRQQ | 通行時間起 | String | 否 | 50 | |
| TXRQZ | 通行時間止 | String | 否 | 50 | |
發(fā)票獲取：