订单开票

描述

对订单进行开票。

路径

/optimus/core/open/v1/order/createInvoice

入参说明（JSON 格式）

入参整体结构

参数 参数名称 类型 是否必传 描述 示例
appid 应用id String Y 固定值 见测试参数
mallID 商城信息 Object Y 固定值 见测试参数
orderID 订单信息 Object Y 前置操作获取
buyer 买家信息 Object N
invoice 发票信息 Object N

入参字段结构

mallID 字段明细

参数 参数名称 类型 是否必传 描述
mallSn 商城id String Y 固定值
signature 商城密码 String Y 固定值

buyer 字段明细

参数 参数名称 类型 是否必传
buyerId 买家id String Y

invoice 字段明细

参数 参数名称 类型 是否必传 描述 示例
buyerType 抬头类型 Byte Y 0 个人 1 企业 0
buyerName 抬头名称 String Y 发票抬头 李四
buyerRegisterNo 税号 String N
buyerAddress 地址 String N
buyerBankName 银行名称 String N
buyerBankAccount 银行账户 String N
buyerPhone 电话 String N
receiveType 接受方式 Byte N
receivePhone 接受手机号 String N
receiveEmail 接受邮箱 String N
invoiceBizType 发票类型 Byte N 1 普票 2 专票（只有开通了专票能力才能使用专票） 1

orderID 字段明细

参数 参数名称 类型 是否必传
sn 订单id String Y
signature 订单密码 String Y

seller 字段明细

参数 参数名称 类型 是否必传 描述 示例
merchantId 商户Id String Y 固定值
merchantUserId 商户userId String Y 固定值
role 角色 String Y 固定值 super_admin

出参说明（JSON 格式）

出参整体结构

参数 参数名称 类型 描述 示例
success 请求状态 Boolean true：成功；false：失败 TRUE
code 状态码 String 0000：成功；其他为异常码 "0000"
msg 状态描述 String 请求结果的描述信息 "处理成功"
data 订单数据 Object 结果数据

出参字段结构

data 字段明细

参数 参数名称 类型
createTransNo 开票申请编号 String
detailUrl 发票详情页地址 String

示例

{
    "orderID": {
        "sn": "7274068988529798",
        "signature": "hAAopsaoyVBzV65YV-y5"
    },
    "invoice": {
        "titleType": 1,
        "titleName": "12312",
        "titleRegisterNo": "231893",
        "titleAddress": "",
        "titleBankName": "",
        "titleBankAccount": "",
        "titlePhone": "",
        "invoiceType": 1,
        "receiveType": 0,
        "receivePhone": "13813173036",
        "receiveEmail": ""
    },
    "buyer": null,
    "mallID": {
        "mallSn": "2025042117531256230",
        "signature": "tKfaMSYAD78eji2ai4jO"
    },
    "appId": "2025082700005615",
    "seller": {
        "merchantId": "1c904b2d-f056-4afa-a819-0328a4774320",
        "merchantUserId": "6ce169d1-1289-4e98-b4a3-ea8b6145046f",
        "role": "super_admin"
    }
}

results matching ""

    No results matching ""