发票获取

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

发票获取内层报文

请求地址:

环境 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报文示例(明文)

发票获取: