慧穗税控开放平台 HSOpenTax

慧穗财税开放平台(HSOpenTax)旨在为客户提供一站式的接入标准，降低各税控组件的接入成本，满足各行业客户平台财税需求，助力企业发展。

组件

HSOpenTax目前由SmarttaxClient 与 SmarttaxRestAPI 构成：

• SmarttaxClient 为运行在客户程序内部的通讯代理组件，代理客户系统的标准API通信至HS税控核心系统并接收其返回或推送的处理结果。SmarttaxClient 基于自定义的TCP协议，具有接入成本低，定制化程度高，通信迅捷，高安全，高可靠等特性。

仅需几行核心代码即可接入慧穗税控服务 e.g. [SmarttaxClient_JAVA 空白发票查询]

 // 发送获取空白发票信息请求
   smarttaxClient.blanks(ReqDTO.build(CommonUtils.buildUUID16(), taxCode, deviceCode, invoiceType));

... 

// 监听空白发票信息返回
    @Override
    public void blanks(RespDTO<List<InvoiceBlankEntity>> results) {

       log.info(results.toJSONFormat());

    }

• SmarttaxRestAPI

SmarttaxRestAPI 为客户提供统一的HTTP协议接入标准，不受客户系统语言的限制，更为自由的接入方案。

e.g. [SmarttaxRestAPI-发票查验]

> POST /v1/invoice/in/checking HTTP/1.1
> Host: example.com
> User-Agent: insomnia/2021.3.0
> Content-Type: application/json
> Access-Token: XTK_OzjHNuaMXhpREPXx
> Accept: */*
> Content-Length: 227

| {
|     "sid": 6427,
|     "taxCode": "91330105MA2H37K5XH",
|     "deviceCode": "",
|     "data":{
|         "amount":"265.49",
|         "checkCode":"82768334291746245012",
|         "createDate":"20200913",
|         "invoiceCode":"023001900111",
|         "invoiceNum":"52605910"
|     }
| }

* upload completely sent off: 227 out of 227 bytes
* Mark bundle as not supporting multiuse

< HTTP/1.1 200 
< Content-Type: application/json
< Transfer-Encoding: chunked
< Date: Wed, 23 Jun 2021 10:33:48 GMT