Open-Agent-Api

12.1 发票申请

POST

/api/v2/invoice/create

Invoice

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

channel

string

可选

默认值:

benlai

shopId

string

商城id

可选

默认值:

123

Body 参数application/json

out_trade_no_list

array[string]

商户订单号列表

可选

与do_id_list 必传其一
优先以out_trade_no_list为准

do_id_list

array[string]

出库单列表

可选

与out_trade_no_list 必传其一
优先以out_trade_no_list为准

mark_id

string

第三方申请单号

必需

>= 0 字符<= 64 字符

invoice_type

string

发票类型

必需

SPECIAL ：增值税专票
POPULAR ：增值税普票

>= 0 字符<= 20 字符

content

string

开票内容

必需

目前只支持
DETAIL：明细

>= 0 字符<= 20 字符

invoice_ate

string

期望开票时间

可选

格式， 'yyyyMMdd'

>= 8 字符<= 8 字符

title

string

发票抬头

必需

>= 0 字符<= 64 字符

billing_address

string

注册地址

可选

增值税专票时必填

>= 0 字符<= 200 字符

billing_phone

string

注册电话

可选

增值税专票时必填

正则匹配:

^[1][0-9]{10}$

tax_no

string

税号

必需

>= 0 字符<= 30 字符

bank_name

string

银行名称

可选

增值税专票时必填

>= 0 字符<= 64 字符

bank_account

string

银行账户

可选

增值税专票时必填

>= 0 字符<= 64 字符

apply_amt

number <double>

申请未税金额

必需

apply_tax_amt

number <double>

申请含税金额

必需

bill

object (Benlai.Open.Models.Invoice.BillInfo)

可选

bill_contact

string

姓名

必需

>= 0 字符<= 20 字符

bill_phone

string

联系方式

必需

正则匹配:

^[1][0-9]{10}$

bill_province

string

省

必需

>= 0 字符<= 20 字符

bill_city

string

市

必需

>= 0 字符<= 20 字符

bill_county

string

县（区）

必需

>= 0 字符<= 20 字符

bill_address

string

收货地址

必需

>= 0 字符<= 200 字符

示例

{
    "out_trade_no_list":["4900012349"],
    "mark_id":"TEST_INVOICE_1742551587374",
    "invoice_type":"POPULAR",
    "content":"DETAIL",
    "invoice_ate":"20250321",
    "title":"本来生活",
    "billing_address":"现代大厦8喽",
	"billing_phone":"17966666666",
	"tax_no":"91310000XXXXXXXX1X",
	"bank_account":"10002000300040005000",
	"bank_name":"中国银行",
    "bill":
        {
            "bill_contact":"张三",
            "bill_phone":"13800138000",
            "bill_province":"广东省",
            "bill_city":"深圳市",
            "bill_county":"南山区",
            "bill_address":"科技园路1号"
        }
    
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open-agent-branch.benlai.com/api/v2/invoice/create' \
--header 'channel: benlai' \
--header 'shopId: 123' \
--header 'Content-Type: application/json' \
--data-raw '{
    "out_trade_no_list":["4900012349"],
    "mark_id":"TEST_INVOICE_1742551587374",
    "invoice_type":"POPULAR",
    "content":"DETAIL",
    "invoice_ate":"20250321",
    "title":"本来生活",
    "billing_address":"现代大厦8喽",
	"billing_phone":"17966666666",
	"tax_no":"91310000XXXXXXXX1X",
	"bank_account":"10002000300040005000",
	"bank_name":"中国银行",
    "bill":
        {
            "bill_contact":"张三",
            "bill_phone":"13800138000",
            "bill_province":"广东省",
            "bill_city":"深圳市",
            "bill_county":"南山区",
            "bill_address":"科技园路1号"
        }
    
}'

返回响应

🟢200成功

text/plain

Success

Body

invoice_id

string

发票申请单号

可选

示例

{
    "invoice_id": "string"
}

10.1 获取物流日志

12.2 发票查询