1.01 产品订阅（平台服务商专用）

将废弃

快速开始环境

https://cosmic-sandbox.piaozone.com/jdpjykjyxgs

POST

/ierp/kapi/app/ocm/ThirdPlatOrderApi

请求参数

Query 参数

access_token

string

必需

{access_token}

Header 参数

access_token

string

可选

默认值:

Body 参数application/json

opType

enum<string>

必需

固定：addCosmicApiOrder

枚举值:

addCosmicApiOrder

systemSource

string

必需

来源；由发票云线下给出

callbackUrl

string

可选

回调地址，用于开票结果通知；订阅开票产品必填

thirdOrderNo

string

必需

订单id，由平台服务商生成，用来双方系统对账使用

data

object

必需

纳税人信息（整个data内容需要进行加密）

taxUserList

array [object {4}]

必需

账号列表，目前暂时用第一个

companyInfo

object

企业相关信息内容

必需

collectChannel

number

必需

收票通道：1: RPA, 2: 软证书； 3：乐企, 默认为：1 RPA

taxChannel

number

必需

税局开票通道：1: RPA, 2: 乐企, 3: 服务商；默认为: 1

taxDeviceList

array [object {2}]

税盘相关信息内容

必需

orderContent

array [object {4}]

订单内容

必需

product_end_date

string

可选

约定结束时间（格式：YYYY-MM-DD）

product_start_date

string

可选

约定开始时间（格式：YYYY-MM-DD）

subscribe_days

number

可选

订阅产品的服务周期（单位：天）

productName

number

可选

订阅产品：1: 云API开票, 2: 云API收票；默认为：1；元素类型是number

示例

{
    "opType": "addCosmicApiOrder",
    "systemSource": "string",
    "callbackUrl": "string",
    "thirdOrderNo": "string",
    "data": {
        "taxUserList": [
            {
                "middleNumber": {},
                "roleText": "string",
                "etaxPassword": "string",
                "etaxAccount": "string"
            }
        ],
        "companyInfo": {
            "contactEmail": "string",
            "companyName": "string",
            "taxNo": "string",
            "companyType": "string",
            "areaCode": "string",
            "registerAddress": "string",
            "bankName": "string",
            "bankAccount": {},
            "contactName": "string"
        },
        "collectChannel": 0,
        "taxChannel": 0,
        "taxDeviceList": [
            {
                "deviceType": 0,
                "deviceNo": "string"
            }
        ]
    },
    "orderContent": [
        {
            "product_end_date": "string",
            "product_start_date": "string",
            "subscribe_days": 0,
            "productName": 0
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/ierp/kapi/app/ocm/ThirdPlatOrderApi?access_token=' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "opType": "addCosmicApiOrder",
    "systemSource": "string",
    "callbackUrl": "string",
    "thirdOrderNo": "string",
    "data": {
        "taxUserList": [
            {
                "middleNumber": {},
                "roleText": "string",
                "etaxPassword": "string",
                "etaxAccount": "string"
            }
        ],
        "companyInfo": {
            "contactEmail": "string",
            "companyName": "string",
            "taxNo": "string",
            "companyType": "string",
            "areaCode": "string",
            "registerAddress": "string",
            "bankName": "string",
            "bankAccount": {},
            "contactName": "string"
        },
        "collectChannel": 0,
        "taxChannel": 0,
        "taxDeviceList": [
            {
                "deviceType": 0,
                "deviceNo": "string"
            }
        ]
    },
    "orderContent": [
        {
            "product_end_date": "string",
            "product_start_date": "string",
            "subscribe_days": 0,
            "productName": 0
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

data

object

必需

addressUrl

string

必需

RPA初始化的界面地址（即H5地址 addressUrl）

accountId

string

必需

数据中心id，用于获取access_token

appId

string

必需

应用授权id,用于获取access_token

appSecuret

string

必需

应用授权秘钥,用于获取access_token

user

string

用户

必需

businessSystemCode

string

业务系统编码

必需

aesKey

string

加密密钥

必需

userType

string

用户类型

必需

requestUrl

string

星瀚发票云平台地址

必需

message

string

描述

必需

errorCode

string

返回码

必需

success

boolean

返回成功状态

必需

示例

{
    "data": {
        "addressUrl": "string",
        "accountId": "string",
        "appId": "string",
        "appSecuret": "string",
        "user": "string",
        "businessSystemCode": "string",
        "aesKey": "string",
        "userType": "string",
        "requestUrl": "string"
    },
    "message": "string",
    "errorCode": "string",
    "success": true
}

修改于 2025-06-27 07:43:43

3.4、查询电子税局账号

发票云创建组织