发票获取

接口规范包括通 用规范和业务规范。通用规范描述所有接口必须遵守的公共部分,业务规范根据具体业务交 互内容不同,描述实际业务需要的详细数据内容。

发票获取内层报文

请求地址:

环境 http请求地址 请求方式 接口编码
正式环境 http://IP:port/OpenApi/Buy/InvoiceGet POST

请求报文(DATA):


            

请求参数说明:

参数 参数名称 类型 是否必须 长度 说明
INVOICETYPE 发票类型 String 是 2 增值税专用发票:01 机动车销售统一发票:03 通讯费电子发票:14
BUYERTAXNO 购方税号 String 是 15/18
BATCHNO 批次号 String 是 32 32位如果多次重复的话,此值要一样,代表是一次请求
ACQUISITIONDATEBEGIN 发票采集开始时间 String 是 14 YYYYMMDDHHMMSS例如:20170101140245
ACQUISITIONDATEEND 发票采集结束时间 String 是 14 YYYYMMDDHHMMSS例如:20170101140245
STARTROW 开始行数 int 是 整数,第一次请求时为1
STATUS 状态标志 String 是 1 当给1时继续请求,0时结束请求

增值税专用发票

请求响应参数:


                

响应参数说明:

参数 参数名称 类型 是否必须 长度 说明
INVOICETYPE 发票类型 String 是 2 增值税专用发票:01 机动车销售统一发票:03 通讯费电子发票:14
TOTALROWS 总行数 Int 是 -
STARTROW 开始行数 Int 是 - 整数,第一次请求时为1
CONTENTROWS 本次请求返回行数 Int 是 -
INVOICES数据
INVOICETYPE 发票类型 String 是 2 增值税专用发票:01 机动车销售统一发票:03 通讯费电子发票:14
INVOICECODE 发票代码 String 是 10/12
INVOICENO 发票号码 String 是 8
CURRENTTAXPERIOD 当前税款所属期 String 是 6 YYYYMM
LEGALIZEENDDATE 当前税款所属期勾选截至日 String 是 8 YYYYMMDD
LEGALIZEINVOICEDATEBEGIN 当前税款所属期可勾选选发票开票日期起 String 是 8 YYYYMMDD
LEGALIZEINVOICEDATEEND 当前税款所属期可勾选发票开票日期止 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 发票金额 String 否 16
TAXAMOUNT 发票税额 String 否 16
TOTALAMOUNT 价税合计 String 否 16
REMARK 备注 String 否 200
INVOICESTATUS 发票状态 String 否 2 0-正常 1-失控 2-作废 3-红冲 4-异常
LEGALIZESTATE 认证状态 String 否 1 0-未认证 1-已认证
LEGALIZEDATE 认证日期 String 否 8 YYYYMMDD
LEGALIZETYPE 认证方式 String 否 1 1-勾选认证 2-扫描认证
SFDBTS 是否代办退税 String 否 1 0-否 1-是
RZLX 认证类型 String 否 1 1-抵扣 2-退税 3-代理退税(未认证是为0或为空)
LSLBZ 零税率标志 String 否 1 空-非零税率 1-免税 2-不征收 3-零税率
LEGALIZEBLONGDATE 认证归属期 String 否 6 YYYYMM
CHECKCODE 校验码 String 否 255
BUYERACOUNT 购方开户行及账号 String 否 100
SALERACOUNT 销方开户行及账号 String 否 100
DETAILLIST数据
DETAILNO 明细编号 String 是 90
GOODSNAME 货物名称 String 是 255
GOODSNUM 商品编码 String 否 19
SPECIFICATIONMODEL 规格型号 String 否 50
UNIT 计量单位 String 否 10
NUM 数量 String 否 24
DETAILAMOUNT 金额 String 否 22
TAXRATE 税率 String 否 24
TAXAMOUNT 税额 String 否 24
UNITPRICE 不含税单价 String 否 24

机动车销售统一发票

请求响应参数:


                

响应参数说明:

参数 参数名称 类型 是否必须 长度 说明
INVOICETYPE 发票类型 String 是 2 增值税专用发票:01 机动车销售统一发票:03 通讯费电子发票:14
TOTALROWS 总行数 Int 是 -
STARTROW 开始行数 Int 是 - 整数,第一次请求时为1
CONTENTROWS 本次请求返回行数 Int 是 -
INVOICES数据
INVOICECODE 发票代码 String 是 10/12
INVOICENO 发票号码 String 是 8
CURRENTTAXPERIOD 当前税款所属期 String 是 6 YYYYMM
LEGALIZEENDDATE 当前税款所属期勾选截至日 String 是 8 YYYYMMDD
LEGALIZEINVOICEDATEBEGIN 当前税款所属期可勾选选发票开票日期起 String 是 8 YYYYMMDD
LEGALIZEINVOICEDATEEND 当前税款所属期可勾选发票开票日期止 String 是 8 YYYYMMDD
BUYERNAME 购方名称 String 否 100
BUYERTAXNO 购方税号 String 否 15/18
BUYERADDRESSPHONE 购方地址、电话 String 否 100
SALERNAME 销方名称 String 否 100
INVOICEDATE 开票日期 String 否 8 YYYYMMDD
REMARK 备注 String 否 200
LEGALIZESTATE 认证状态 String 否 1 0-未认证 1-已认证
LEGALIZEDATE 认证日期 String 否 8 YYYYMMDD
LEGALIZETYPE 认证方式 String 否 1 1-勾选认证 2-扫描认证
SFDBTS 是否代办退税 String 否 1 0-否 1-是
RZLX 认证类型 String 否 1 1-抵扣 2-退税 3-代理退税(未认证是为0或为空)
BUYERIDNUM 购买方身份证号码/组织机构代码 String 否 240
VEHICLETYPE 车辆类型 String 否 80
FACTORYMODEL 厂牌型号 String 否 100
PRODUCTPLACE 产地 String 否 80
CERTIFICATE 合格证书 String 否 100
CERTIFICATEIMPORT 进口证明书号 String 否 80
INSPECTIONNUM 商检单号 String 否 80
ENGINENO 发动机号码 String 否 120
VEHICLENO 车架号码/车辆识别号 String 否 40
TOTALAMOUNT 价税合计 String 否 16 2位小数
PHONE 电话 String 否 80
TAXNUM 纳税人识别号 String 是 20
BUYERACOUNT 账号 String 否 80
BUYERBANK 开户银行 String 否 160
TAXRATE 税率 String 是 10 正数如税率17%,填写17
TAXAMOUNT 税额 String 是 16 2位小数
TAXBUREAUCODE 主管税务机关代码 String 否 11
TAXBUREAUNAME 主管税务机关名称 String 否 80
INVOICEAMOUNT 合计金额 String 是 16 2位小数
TAXRECORDS 完税凭证号码 String 否 100
TONNAGE 吨位 String 否 40
LIMITPEOPLE 限乘人数 String 否 40
INVOICESTATUS 发票状态 String 是 1 0-正常 1-失控 2-作废 3-冲红4-异常
TAXPERIOD 税款所属期 String 否 4 YYYYMM
LEGALIZETYPE 认证方式 String 否 1 1-勾选认证 2-扫描认证

通行费电子发票

请求响应参数:


                

响应参数说明:

参数 参数名称 类型 是否必须 长度 说明
INVOICETYPE 发票类型 String 是 2 增值税专用发票:01 机动车销售统一发票:03 通讯费电子发票:14
TOTALROWS 总行数 Int 是 -
STARTROW 开始行数 Int 是 - 整数,第一次请求时为1
CONTENTROWS 本次请求返回行数 Int 是 -
INVOICES数据
INVOICETYPE 发票类型 String 是 2 增值税专用发票:01 机动车销售统一发票:03 通讯费电子发票:14
INVOICECODE 发票代码 String 是 10/12
INVOICENO 发票号码 String 是 8
CURRENTTAXPERIOD 当前税款所属期 String 是 6 YYYYMM
LEGALIZEENDDATE 当前税款所属期勾选截至日 String 是 8 YYYYMMDD
LEGALIZEINVOICEDATEBEGIN 当前税款所属期可勾选选发票开票日期起 String 是 8 YYYYMMDD
LEGALIZEINVOICEDATEEND 当前税款所属期可勾选发票开票日期止 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 发票金额 String 否 16
TAXAMOUNT 发票税额 String 否 16
TOTALAMOUNT 价税合计 String 否 16
REMARK 备注 String 否 200
INVOICESTATUS 发票状态 String 否 2 0-正常 1-失控 2-作废 3-红冲 4-异常
LEGALIZESTATE 认证状态 String 否 1 0-未认证 1-已认证
LEGALIZEDATE 认证日期 String 否 8 YYYYMMDD
LEGALIZETYPE 认证方式 String 否 1 1-勾选认证 2-扫描认证
SFDBTS 是否代办退税 String 否 1 0-否 1-是
RZLX 认证类型 String 否 1 1-抵扣 2-退税 3-代理退税(未认证是为0或为空)
LSLBZ 零税率标志 String 否 1 空-非零税率 1-免税 2-不征收 3-零税率
LEGALIZEBLONGDATE 认证归属期 String 否 6 YYYYMM
CHECKCODE 校验码 String 否 255
BUYERACOUNT 购方开户行及账号 String 否 100
SALERACOUNT 销方开户行及账号 String 否 100
TXFBZ 通行费标志 String 否 1 N-不可抵扣通行费 Y-可抵扣通行费
DETAILLIST数据
DETAILNO 明细编号 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

DATA报文示例(明文)

发票获取: