发票通开放注册平台

一、概述

1、目的

用于第三方企业通过关键字获取抬头信息。为满足第三方企业的需求，我方有以下接口需提供给第三方开票服务商开发人员、维护人员提供参考对接文档。

2、输出范围

技术输出仅针对第三方企业;

3、输出目标

4、接入流程

二、业务接口说明

1、第三方通过关键字获取抬头列表接口服务

1.1、请求报文

接口说明: 用于接收第三方开票服务商通过税号获取开票信息接口服务

调用方式:HTTPS 请求方式 POST 请求

测试环境 URL: https://ip:port/Entoauth/thirdInvoiceService?sign=queryInvoiceTitle&xml=

正式环境 URL: https://ip:port/Entoauth/thirdInvoiceService?sign=queryInvoiceTitle&xml=

参数

xml 需要进行 Base64 编码然后进行 URLEncoder.encode("","UTF-8" ),以下为 xml 参数 Base64 之前的字符串格式

<REQUEST>
  <HEAD>
    <client_id>企业的 client_id</client_id> 
    <access_token>二.1 接口获取到</access_token> 
    <openID>二.2 接口获取到</openID> 
    <sqm>授权码</sqm>
  </HEAD>
  <BODY>
    <key>抬头关键字,不可只输入省份，北京市等关键字查询</key> 
  </BODY>
</REQUEST>

请求参数说明

索引	ID	名称	必须	说明
1	client_id	发票通开放平台申请的 client_id	是	发票通开放平台申请的 client_id
2	access_token	访问 Token	是	通过二.1 接口获取到的
3	openID		是	通过二.2 接口获取到的
4	key	关键字	是
5	sqm	授权码

1.2、返回报文

返回参数:

<?xml version="1.0" encoding="utf-8"?>
<ROOT> 
  <HEAD>
    <SERVICE>
      <REPLYCODE>0000</REPLYCODE> 
      <REPLYMSG>成功</REPLYMSG>
    </SERVICE> 
  </HEAD>
  <BODY>
    <datalist size="2">
      <data>
        <id>id</id> 
        <GMF_MC>购买方名称</GMF_MC> 
        <GMF_DZDH>购买方地址电话 </GMF_DZDH> 
        <GMF_YHZH>购买方银行与账号</GMF_YHZH> 
        <GMF_NSRSBH>购买方税号</GMF_NSRSBH>
      </data> 
      <data>
        <id>id</id> 
        <GMF_MC>购买方名称</GMF_MC> 
        <GMF_DZDH>购买方地址电话 </GMF_DZDH> 
        <GMF_YHZH>购买方银行与账号</GMF_YHZH> 
        <GMF_NSRSBH >购买方税号</GMF_NSRSBH>
      </data> 
    </datalist>
  </BODY> 
</ROOT>

参数说明:

索引	ID	名称	长度	必须	说明
1	REPLYCODE	返回码	20	是	0000:申请提交成功， 100014:access token 过期。token 过期时间为 5 小时。请重新获取 access_token、OpenID，其他编码:失败
2	REPLYMSG	返回信息		否
3	GMF_MC	购买方名称
4	GMF_NSRSBH	购买方税号
5	GMF_YHZH	购买方银行与账号
6	GMF_DZDH	购买方地址电话

云抬头列表接口规范