订购产品

接口描述

产品订购是客户对接税号维度产品的起点，一个企业税号将在我们平台要使用什么产品，ISV可以通过接口来自行开通。对于首次订购产品的企业，该接口还会进行企业创建。该接口返回唯一标识aggOrgId，此aggOrgId作为双方平台企业关联的唯一标识，在之后的接口中都要用到，所以应该保存起来。

产品码说明

产品码值	产品码说明
0002	大企业发票归集
0009	电票平台归集
0003	发票认证
0004	数电开票
0005	版式文件下载
0020	小企业申报（含归集）
0024	小企业申报
0022	大企业申报
0021	个税申报
0030	智能登录
0035	办税人员管理
0050	企业信息采集(票税)
0051	企业数据采集（票）

错误码

错误代码	错误信息	示例	解决方案
PARAMETER_ERROR	纳税人识别号(nsrsbh)不能为空！
PARAMETER_ERROR	纳税人识别号只能包含数字和字母！
PARAMETER_ERROR	纳税人识别号只能为15位、17位、18位或20位！
PARAMETER_ERROR	企业纳税人识别号重复!
PARAMETER_ERROR	企业名称(aggOrgName)不能为空！
PARAMETER_ERROR	企业名称重复!
PARAMETER_ERROR	地区编码有误，请根据地区编码附录中限定的编码传参
PARAMETER_ERROR	产品列表(productCodeList)不能为空！
PARAMETER_ERROR	存在不能订购的产品码([XXX])！	存在不能订购的产品码([089,099])！	参考产品码说明

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

access_token

string

必需

通过调用access_token接口返回的access_token值

示例值:

req_date

string

必需

当前时间转为的毫秒数

示例值:

req_sign

string

签名算法得到的签名

必需

示例值:

Body 参数application/json

nsrsbh

string

税号

必需

aggOrgName

string

企业名称

必需

string

地区

必需

示例值:

productCodeList

string

产品码列表(英文逗号分割)

必需

示例值:

0002,0003,0020

示例

{
    "nsrsbh": "string",
    "aggOrgName": "string",
    "dq": "31",
    "productCodeList": "0002,0003,0020"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位

code

string | null

错误码

必需

示例值:

SUCCESS

success

boolean

是否成功标记

必需

接口是否成功（是否发生业务异常）

message

string | null

错误信息

必需

data

object | null

业务数据

可选

aggOrgId

integer | null

企业id

必需

purchaseDetailList

array [object {3}]

订购详情

必需

示例

{
    "reqId": "c835d3478de34f17b479e269fe96c826",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "aggOrgId": 5107*******5344,
        "purchaseDetailList": [
            {
                "productCode": "0002",
                "success": true,
                "message": "订购成功"
            },
            {
                "productCode": "0003",
                "success": false,
                "message": "订购失败"
            },
            {
                "productCode": "0020",
                "success": true,
                "message": "订购成功(已订购)"
            }
        ]
    }
}

接口描述#

产品码说明#

错误码#

请求参数

示例代码

返回响应

接口描述

产品码说明

错误码